Tablestore：Kolom virtual

Setelah menentukan suatu bidang sebagai kolom virtual saat membuat indeks pencarian di Konsol Tablestore, Anda dapat menggunakan kolom virtual tersebut untuk melakukan kueri data.

1. Buka tab Index Management.

   1. Masuk ke Konsol Tablestore.

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

   3. Pada halaman Overview, klik nama instans atau klik Manage Instance di kolom Actions.

   4. Di bagian Data Table List pada tab Instance Details, klik nama tabel data atau klik Index Management di kolom Actions.

2. Pada tab Index Management, klik Create Search Index.

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

   

   1. Sistem secara otomatis menghasilkan nama indeks. Anda juga dapat memasukkan Index Name kustom.

   2. Pilih Schema Generation Method.

      • Jika Anda mengatur Schema Generation Method ke Manual Entry, masukkan nama bidang secara manual, pilih tipe bidang, dan tentukan apakah akan mengaktifkan Array.

      • Jika Anda mengatur Schema Generation Method ke Automatic Generation, sistem secara otomatis menggunakan kolom kunci primer dan kolom atribut dari tabel data sebagai bidang indeks. Anda kemudian dapat memilih tipe bidang dan menentukan apakah akan mengaktifkan Array sesuai kebutuhan.

      Catatan

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

   3. Buat kolom virtual.

      Penting

      Saat membuat kolom virtual, nama bidang sumber harus ada di tabel data, dan tipe data bidang sumber harus kompatibel dengan tipe data kolom virtual.

      1. Klik ikon .

      2. Masukkan Field Name dan pilih Field Type.

      3. Aktifkan sakelar Virtual Column untuk bidang tersebut dan masukkan Source Field Name.

   4. Untuk mengonfigurasi routing key, masa hidup data, atau metode pra-pengurutan untuk indeks pencarian, aktifkan sakelar Advanced Options dan ubah parameter sesuai kebutuhan. Untuk informasi selengkapnya, lihat Buat indeks pencarian.

   5. Klik OK.

      Setelah indeks pencarian dibuat, Anda dapat mengklik Index Details di kolom Actions indeks pencarian untuk melihat informasi dasar, metering, routing key, bidang indeks, dan informasi pra-pengurutan untuk indeks tersebut.

4. Lakukan kueri data menggunakan kolom virtual.

   1. Di kolom Actions indeks pencarian, klik Search.

   2. Pada dialog Query Data, konfigurasikan kueri.

      

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

      2. Pilih bidang indeks, klik Add, lalu atur tipe kueri dan nilainya untuk bidang indeks tersebut.

      3. Secara default, fitur pengurutan dinonaktifkan. Untuk mengurutkan hasil kueri berdasarkan bidang indeks, aktifkan sakelar Sort, lalu tambahkan bidang indeks dan konfigurasikan metode pengurutan sesuai kebutuhan.

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

      5. Klik OK.

         Data yang memenuhi kondisi kueri ditampilkan pada tab Index Management.

Setelah menentukan suatu bidang sebagai kolom virtual saat membuat indeks pencarian menggunakan SDK, Anda dapat menggunakan kolom virtual tersebut untuk melakukan kueri data.

1. Tentukan kolom virtual saat membuat indeks pencarian.

   Catatan

   Untuk informasi selengkapnya tentang parameter, lihat Buat indeks pencarian.

   Contoh berikut membuat indeks pencarian yang berisi kolom Col_Keyword dan Col_Long. Contoh ini juga membuat dua kolom virtual: Col_Keyword_Virtual_Long, yang dipetakan ke kolom Col_Keyword di tabel data, dan Col_Long_Virtual_Keyword, yang dipetakan ke kolom Col_Long di tabel data.

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

2. Lakukan kueri data menggunakan kolom virtual.

   Contoh berikut menunjukkan cara melakukan kueri untuk baris-baris yang nilai kolom Col_Long_Virtual_Keyword-nya adalah "1000". Kueri ini mengembalikan jumlah total baris yang cocok dan beberapa baris yang cocok.

   private static void query(SyncClient client) {
       SearchQuery searchQuery = new SearchQuery();
       TermsQuery termsQuery = new TermsQuery(); // Set the query type to TermsQuery.
       termsQuery.setFieldName("Col_Long_Virtual_Keyword"); // Set the field to match.
       termsQuery.addTerm(ColumnValue.fromString("1000")); // Set the value to match.
       searchQuery.setQuery(termsQuery);
       searchQuery.setGetTotalCount(true); // Set to return the total number of matched rows.
       SearchRequest searchRequest = new SearchRequest("<TABLE_NAME>", "<SEARCH_INDEX_NAME>", searchQuery);
       SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
       columnsToGet.setReturnAll(true); // Set to return all columns. Virtual columns are not returned.
       searchRequest.setColumnsToGet(columnsToGet);
   
       SearchResponse resp = client.search(searchRequest);
       System.out.println("TotalCount: " + resp.getTotalCount()); // The total number of matched rows, not the number of returned rows.
       System.out.println("Row: " + resp.getRows());
   }