Tablestore：Kolom virtual

Setelah menentukan suatu bidang sebagai kolom virtual saat membuat indeks pencarian di Konsol Tablestore, gunakan kolom virtual tersebut untuk mengkueri data.

1. Buka tab Indexes.

   1. Masuk ke Tablestore console.

   2. Pada bilah navigasi atas, pilih wilayah dan kelompok sumber daya.

   3. Pada halaman Overview, klik nama instans yang ingin Anda kelola atau klik Manage Instance di kolom Actions instans tersebut.

   4. Di bagian Tables pada tab Instance Details, klik nama tabel data tempat Anda ingin membuat indeks pencarian. Pada halaman Manage Table, klik Indexes. Anda juga dapat mengklik Indexes di kolom Actions tabel data tersebut.

2. Pada tab Indexes, klik Create Search Index.

3. Pada dialog Create Index, tentukan kolom virtual saat membuat indeks pencarian.

   

   1. Secara default, sistem menghasilkan nama untuk indeks pencarian. Anda juga dapat menentukan nama sendiri untuk indeks tersebut.

   2. Konfigurasikan parameter Schema Generation Type.

      • Jika Anda mengatur Schema Generation Type ke Manual, masukkan nama bidang serta tentukan tipe bidang dan apakah Array diaktifkan untuk setiap bidang yang ingin ditambahkan.

      • Jika Anda mengatur Schema Generation Type ke Auto Generate, sistem secara otomatis menggunakan kolom kunci primer dan kolom atribut dari tabel data sebagai bidang indeks. Tentukan tipe bidang dan apakah Array diaktifkan untuk setiap bidang yang ditambahkan secara otomatis oleh sistem sesuai kebutuhan bisnis Anda.

      Catatan

      Nilai Field Name dan Field Type harus sesuai dengan yang ada di tabel data. Untuk informasi tentang pemetaan antara tipe bidang di tabel data dan tipe bidang di indeks pencarian, lihat Data types.

   3. Buat kolom virtual.

      Penting

      Untuk membuat kolom virtual, tabel data harus berisi bidang sumber dan tipe data bidang sumber harus sesuai dengan tipe data kolom virtual.

      1. Klik ikon .

      2. Konfigurasikan parameter Field Name dan Field Type.

      3. Aktifkan Virtual Field untuk bidang tersebut dan tentukan nilai untuk Index Field Name.

   4. Jika ingin menentukan routing key, masa hidup data (TTL), atau metode presorting untuk indeks pencarian, aktifkan Advanced Settings. Untuk informasi selengkapnya, lihat Create a search index.

   5. Klik OK.

      Setelah membuat indeks pencarian, klik Index Details di kolom Actions indeks pencarian pada tab Indexes. Di halaman Index Details, lihat pengaturan parameter di bagian Basic Index Information, Index Meters, Routing Key, Index Fields, dan Pre-sorting.

4. Gunakan kolom virtual untuk mengkueri data.

   1. Klik Manage Data di kolom Actions indeks pencarian.

   2. Pada dialog Search, konfigurasikan parameter-parameter berikut.

      

      1. Secara default, sistem mengembalikan semua kolom atribut. Untuk mengembalikan kolom atribut tertentu, nonaktifkan All Columns dan tentukan kolom atribut yang ingin dikembalikan. Pisahkan kolom atribut dengan koma (,).

      2. Pilih bidang indeks dan klik Add untuk menambahkan bidang indeks sebagai kondisi kueri. Tentukan tipe kueri dan nilai untuk bidang indeks tersebut. Ulangi langkah ini untuk menambahkan lebih banyak kondisi kueri sesuai kebutuhan bisnis Anda.

      3. Secara default, fitur pengurutan dinonaktifkan. Untuk mengaktifkannya, aktifkan Sort dan tambahkan bidang indeks yang digunakan untuk mengurutkan hasil kueri, lalu konfigurasikan metode pengurutannya.

      4. Secara default, fitur agregasi dinonaktifkan. Jika ingin mengumpulkan statistik pada bidang tertentu, aktifkan Collect Statistics, tentukan bidang yang ingin dikumpulkan statistiknya, lalu konfigurasikan informasi yang diperlukan untuk pengumpulan statistik tersebut.

      5. Klik OK.

         Data yang memenuhi kondisi kueri akan ditampilkan sesuai urutan yang ditentukan pada tab Indexes.

Setelah menentukan suatu bidang sebagai kolom virtual saat menggunakan SDK Tablestore untuk membuat indeks pencarian, gunakan kolom virtual tersebut untuk mengkueri data.

1. Buat indeks pencarian dan tentukan kolom virtual.

   Catatan

   Untuk informasi tentang parameter, lihat Create a search index.

   Kode contoh berikut menunjukkan cara membuat indeks pencarian yang terdiri dari kolom Col_Keyword dan Col_Long. Masing-masing kolom memiliki kolom virtual. Kolom Col_Keyword_Virtual_Long dipetakan ke kolom Col_Keyword di tabel data, dan kolom Col_Long_Virtual_Keyword dipetakan ke kolom Col_Long di tabel data.

   private static void createSearchIndex(SyncClient client) {
       CreateSearchIndexRequest request = new CreateSearchIndexRequest();
       // Specify the name of the data table. 
       request.setTableName("<TABLE_NAME>"); 
       // Specify the name of the search index. 
       request.setIndexName("<SEARCH_INDEX_NAME>"); 
       IndexSchema indexSchema = new IndexSchema();
       indexSchema.setFieldSchemas(Arrays.asList(
           // Specify the name and type of the field. 
           new FieldSchema("Col_Keyword", FieldType.KEYWORD), 
           // Specify the name and type of the field. 
           new FieldSchema("Col_Keyword_Virtual_Long", FieldType.LONG) 
                // Specify whether the field is a virtual column. 
               .setVirtualField(true) 
                // Specify the name of the source field to which the virtual column is mapped in the data table. 
               .setSourceFieldName("Col_Keyword"), 
           new FieldSchema("Col_Long", FieldType.LONG),
           new FieldSchema("Col_Long_Virtual_Keyword", FieldType.KEYWORD)
               .setVirtualField(true)
               .setSourceFieldName("Col_Long")));
       request.setIndexSchema(indexSchema);
       // Call a client to create the search index. 
       client.createSearchIndex(request); 
   }

2. Gunakan kolom virtual untuk mengkueri data.

   Kode contoh berikut menunjukkan cara mengkueri baris-baris yang nilai kolom Col_Long_Virtual_Keyword-nya sesuai dengan "1000". Dalam contoh ini, sebagian baris yang cocok dan jumlah total baris yang cocok dikembalikan.

   private static void query(SyncClient client) {
       SearchQuery searchQuery = new SearchQuery();
       TermsQuery termsQuery = new TermsQuery(); // Set the query method to TermsQuery. 
       termsQuery.setFieldName("Col_Long_Virtual_Keyword"); // Specify the name of the field that you want to match. 
       termsQuery.addTerm(ColumnValue.fromString("1000")); // Set the value that you want to match. 
       searchQuery.setQuery(termsQuery);
       searchQuery.setGetTotalCount(true); // Specify that the total number of matched rows is returned. 
       SearchRequest searchRequest = new SearchRequest("<TABLE_NAME>", "<SEARCH_INDEX_NAME>", searchQuery);
       SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
       columnsToGet.setReturnAll(true); // Set ReturnAll to true to return all columns without returning the virtual columns. 
       searchRequest.setColumnsToGet(columnsToGet);
   
       SearchResponse resp = client.search(searchRequest);
       System.out.println("TotalCount: " + resp.getTotalCount()); // Specify that the total number of rows that meet the query conditions instead of the number of returned rows is displayed. 
       System.out.println("Row: " + resp.getRows());
   }