Tablestore:Tipos de dados Array e Nested

Formatos de Array

A tabela a seguir descreve os formatos de array para tipos de dados primitivos em índices de busca.

Observações de uso

Para campos do tipo Array em um índice de busca, o campo correspondente na tabela de dados deve ser do tipo String, e o campo no índice de busca deve ser do tipo primitivo correspondente, como Long ou Double.

Por exemplo, se o campo price for do tipo Double Array, o campo price na tabela de dados deverá ser do tipo String. No índice de busca, defina o tipo do campo como Double e adicione a propriedade isArray=true.

Exemplos

Considere uma tabela de dados chamada array_search_table contendo os seguintes dados de amostra.

A tabela de dados inclui a coluna de chave primária pk (tipo String) e duas colunas de atributo: col_keyword_array (tipo String) e col_long_array (tipo String).

1. Crie um índice de busca.

   Crie um índice de busca chamado array_query_table_index. O índice inclui duas colunas: col_keyword_array (tipo String Array) e col_long_array (tipo Long Array).

   Em Schema Generation Method, selecione Auto-generate. Em seguida, na tabela de configuração de campos, verifique se o alternador Array está ativado para os campos correspondentes.

2. Consulte dados do tipo Array usando o índice de busca.

   O código Java a seguir consulta dados de array em que a coluna col_keyword_array contém um elemento correspondente exatamente a "Cloud server" e a coluna col_long_array contém um elemento igual a 2024.

   Nota

   Para consultar dados do tipo Array em um índice de busca por meio de instruções SQL, consulte Executar instruções SQL para consultar dados usando o índice de busca.

   private static void query(SyncClient client) {
       // Condition 1: The col_keyword_array field contains an element that is an exact match for "ECS".
       TermQuery keywordTermQuery = new TermQuery(); 
       keywordTermQuery.setFieldName("col_keyword_array"); 
       keywordTermQuery.setTerm(ColumnValue.fromString("ECS")); 
       // Condition 2: The col_long_array field contains an element equal to 2024.
       TermQuery longTermQuery = new TermQuery(); 
       longTermQuery.setFieldName("col_long_array"); 
       longTermQuery.setTerm(ColumnValue.fromLong(2024l)); 
       SearchQuery searchQuery = new SearchQuery();
       // Require both conditions to be true.
       BoolQuery boolQuery = new BoolQuery();
       boolQuery.setMustQueries(Arrays.asList(keywordTermQuery, longTermQuery));
       searchQuery.setQuery(boolQuery);
       //searchQuery.setGetTotalCount(true); // Set to return the total number of matched rows.
       SearchRequest searchRequest = new SearchRequest("<TABLE_NAME>", "<SEARCH_INDEX_NAME>", searchQuery);
       // You can configure the columnsToGet parameter to specify the columns to return or return all columns. If this parameter is not configured, only primary key columns are returned by default.
       //SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
       //columnsToGet.setReturnAll(true); // Set to return all columns.
       //columnsToGet.setColumns(Arrays.asList("ColName1","ColName2")); // Set to return specified columns.
       //searchRequest.setColumnsToGet(columnsToGet);
       SearchResponse resp = client.search(searchRequest);
       //System.out.println("TotalCount: " + resp.getTotalCount()); // Print the total number of matched rows, not the number of returned rows.
       System.out.println("Row: " + resp.getRows());
   }

Formatos Nested

Os campos Nested dividem-se em tipos de nível único e multinível.

[
    {
        "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"
            }
        ]
    }
]

Observações de uso

Para campos do tipo Nested em um índice de busca, o campo correspondente na tabela de dados deve ser do tipo String, e o campo no índice de busca deve ser do tipo Nested. Use consultas aninhadas para pesquisar campos do tipo Nested.

Ao gravar dados na tabela de dados, formate o valor do campo aninhado como um array JSON de objetos. Por exemplo, [{"tagName":"tag1", "score":0.8,"time": 1730690237000 }, {"tagName":"tag2", "score":0.2,"time": 1730691557000}].

Exemplos

// Create FieldSchema objects for the fields in a child row.
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")));
// Set the child row FieldSchema objects to the subFieldSchemas of the nested field.
FieldSchema nestedFieldSchema = new FieldSchema("tags", FieldType.NESTED)
    .setSubFieldSchemas(subFieldSchemas);

// Define subfield schemas for the 'address' nested field. The query path for these fields is 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));
// Define subfield schemas for the 'user' nested field. Each child row contains four primitive type fields and one nested field '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));
// Add the 'user' nested field schema to the list of main field schemas.
List<FieldSchema> fieldSchemas = new ArrayList<>();
fieldSchemas.add(new FieldSchema("user",FieldType.NESTED).setSubFieldSchemas(subFieldSchemas));

Limites

• Índices de busca com campos Nested não suportam IndexSort, recurso que melhora o desempenho de consultas em diversos cenários.

• Ao paginar resultados de consulta em um índice de busca com campos Nested, especifique um método de ordenação nas condições da consulta. Caso contrário, o Tablestore não retornará nextToken quando apenas resultados parciais forem lidos.

• Consultas aninhadas apresentam desempenho inferior ao de outros tipos de consulta.

Exceto por essas limitações, o tipo Nested suporta todos os tipos de consulta, ordenação e agregação.