Tablestore:Tipe data Array dan Nested

Format Array

Tabel berikut menjelaskan format array untuk tipe data primitif dalam indeks pencarian.

Catatan penggunaan

Untuk bidang bertipe Array dalam indeks pencarian, bidang yang sesuai di tabel data harus bertipe String, dan bidang dalam indeks pencarian harus bertipe primitif yang sesuai, seperti Long atau Double.

Sebagai contoh, jika bidang price bertipe Double Array, maka bidang price di tabel data harus bertipe String. Di indeks pencarian, atur tipe bidang menjadi Double dan tambahkan properti isArray=true.

Contoh

Asumsikan tabel data bernama array_search_table berisi data sampel berikut.

Tabel data mencakup kolom kunci primer pk (tipe String) dan dua kolom atribut: col_keyword_array (tipe String) dan col_long_array (tipe String).

1. Buat indeks pencarian.

   Buat indeks pencarian bernama array_query_table_index. Indeks ini mencakup dua kolom: col_keyword_array (tipe String Array) dan col_long_array (tipe Long Array).

   Untuk Schema Generation Method, pilih Auto-generate. Kemudian, di tabel konfigurasi bidang, pastikan tombol Array diaktifkan untuk bidang yang sesuai.

2. Kueri data bertipe Array menggunakan indeks pencarian.

   Kode Java berikut melakukan kueri data array di mana kolom col_keyword_array berisi elemen yang persis sesuai dengan "Cloud server" dan kolom col_long_array berisi elemen yang nilainya sama dengan 2024.

   Catatan

   Untuk melakukan kueri data bertipe Array dalam indeks pencarian menggunakan pernyataan SQL, lihat Eksekusi pernyataan SQL untuk mengkueri data menggunakan indeks pencarian.

   private static void query(SyncClient client) {
       // Kondisi 1: Bidang col_keyword_array berisi elemen yang persis sesuai dengan "ECS".
       TermQuery keywordTermQuery = new TermQuery(); 
       keywordTermQuery.setFieldName("col_keyword_array"); 
       keywordTermQuery.setTerm(ColumnValue.fromString("ECS")); 
       // Kondisi 2: Bidang col_long_array berisi elemen yang nilainya sama dengan 2024.
       TermQuery longTermQuery = new TermQuery(); 
       longTermQuery.setFieldName("col_long_array"); 
       longTermQuery.setTerm(ColumnValue.fromLong(2024l)); 
       SearchQuery searchQuery = new SearchQuery();
       // Kedua kondisi harus terpenuhi.
       BoolQuery boolQuery = new BoolQuery();
       boolQuery.setMustQueries(Arrays.asList(keywordTermQuery, longTermQuery));
       searchQuery.setQuery(boolQuery);
       //searchQuery.setGetTotalCount(true); // Atur agar mengembalikan jumlah total baris yang cocok.
       SearchRequest searchRequest = new SearchRequest("<TABLE_NAME>", "<SEARCH_INDEX_NAME>", searchQuery);
       // Anda dapat mengonfigurasi parameter columnsToGet untuk menentukan kolom yang dikembalikan atau mengembalikan semua kolom. Jika parameter ini tidak dikonfigurasi, hanya kolom kunci primer yang dikembalikan secara default.
       //SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
       //columnsToGet.setReturnAll(true); // Atur agar mengembalikan semua kolom.
       //columnsToGet.setColumns(Arrays.asList("ColName1","ColName2")); // Atur agar mengembalikan kolom tertentu.
       //searchRequest.setColumnsToGet(columnsToGet);
       SearchResponse resp = client.search(searchRequest);
       //System.out.println("TotalCount: " + resp.getTotalCount()); // Cetak jumlah total baris yang cocok, bukan jumlah baris yang dikembalikan.
       System.out.println("Row: " + resp.getRows());
   }

Format Nested

Bidang nested diklasifikasikan menjadi tipe single-level dan multi-level.

[
    {
        "tagName": "tag1",
        "score": 0.8
    },
    {
        "tagName": "tag2",
        "score": 0.2
    }
]

[
    {
        "name": "Zhang San",
        "age": 20,
        "phone": "1390000****",
        "address": [
            {
                "province": "Zhejiang Province",
                "city": "Hangzhou City",
                "street": "No. 1201, Xingfu Community, Sunshine Avenue"
            }
        ]
    }
]

Contoh

// Buat objek FieldSchema untuk bidang dalam baris anak.
List<FieldSchema> subFieldSchemas = new ArrayList<FieldSchema>();
subFieldSchemas.add(new FieldSchema("tagName", FieldType.KEYWORD)
    .setIndex(true).setEnableSortAndAgg(true));
subFieldSchemas.add(new FieldSchema("score", FieldType.DOUBLE)
    .setIndex(true).setEnableSortAndAgg(true));
subFieldSchemas.add(new FieldSchema("time", FieldType.DATE)
    .setDateFormats(Arrays.asList("epoch_millis")));
// Tetapkan objek FieldSchema baris anak ke subFieldSchemas bidang nested.
FieldSchema nestedFieldSchema = new FieldSchema("tags", FieldType.NESTED)
    .setSubFieldSchemas(subFieldSchemas);

// Definisikan skema subfield untuk bidang nested 'address'. Jalur kueri untuk bidang-bidang ini adalah user.address.
List<FieldSchema> addressSubFiledSchemas = new ArrayList<>();
addressSubFiledSchemas.add(new FieldSchema("province",FieldType.KEYWORD));
addressSubFiledSchemas.add(new FieldSchema("city",FieldType.KEYWORD));
addressSubFiledSchemas.add(new FieldSchema("street",FieldType.KEYWORD));
// Definisikan skema subfield untuk bidang nested 'user'. Setiap baris anak berisi empat bidang tipe primitif dan satu bidang nested 'address'.
List<FieldSchema> subFieldSchemas = new ArrayList<>();
subFieldSchemas.add(new FieldSchema("name",FieldType.KEYWORD));
subFieldSchemas.add(new FieldSchema("age",FieldType.LONG));
subFieldSchemas.add(new FieldSchema("birth",FieldType.DATE).setDateFormats(Arrays.asList("yyyy-MM-dd HH:mm:ss.SSS")));
subFieldSchemas.add(new FieldSchema("phone",FieldType.KEYWORD));
subFieldSchemas.add(new FieldSchema("address",FieldType.NESTED).setSubFieldSchemas(addressSubFiledSchemas));
// Tambahkan skema bidang nested 'user' ke daftar skema bidang utama.
List<FieldSchema> fieldSchemas = new ArrayList<>();
fieldSchemas.add(new FieldSchema("user",FieldType.NESTED).setSubFieldSchemas(subFieldSchemas));