Tablestore:Array and nested data types

Formatos de Array

A continuación se describen los formatos de array para los tipos de datos primitivos en los índices de búsqueda.

Notas de uso

Para los campos de tipo Array en un índice de búsqueda, el campo correspondiente en la tabla de datos debe ser de tipo String, mientras que el campo en el índice de búsqueda debe ser del tipo primitivo correspondiente, como Long o Double.

Por ejemplo, si el campo price es de tipo Double Array, el campo price en la tabla de datos debe ser de tipo String. En el índice de búsqueda, establezca el tipo de campo como Double y agregue la propiedad isArray=true.

Ejemplos

Suponga que una tabla de datos llamada array_search_table contiene los siguientes datos de muestra.

La tabla de datos incluye la columna de clave principal pk (tipo String) y dos columnas de atributos: col_keyword_array (tipo String) y col_long_array (tipo String).

1. Cree un índice de búsqueda.

   Cree un índice de búsqueda denominado array_query_table_index. El índice incluye dos columnas: col_keyword_array (tipo String Array) y col_long_array (tipo Long Array).

   En Schema Generation Method, seleccione Auto-generate. Luego, en la tabla de configuración de campos, compruebe que el interruptor Array esté habilitado para los campos correspondientes.

2. Consulte datos de tipo Array mediante el índice de búsqueda.

   El siguiente código Java consulta datos de array donde la columna col_keyword_array contiene un elemento que coincide exactamente con "Cloud server" y la columna col_long_array contiene un elemento igual a 2024.

   Nota

   Para consultar datos de tipo Array en un índice de búsqueda mediante sentencias SQL, consulte Execute SQL statements to query data using the search index.

   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

Los campos anidados se clasifican en tipos de un solo nivel y multinivel.

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

Notas de uso

Para los campos de tipo Nested en un índice de búsqueda, el campo correspondiente en la tabla de datos debe ser de tipo String, y el campo en el índice de búsqueda debe ser de tipo Nested. Utilice consultas anidadas para consultar campos de tipo Nested.

Al escribir datos en la tabla de datos, formatee el valor del campo anidado como un array JSON de objetos. Por ejemplo, [{"tagName":"tag1", "score":0.8,"time": 1730690237000 }, {"tagName":"tag2", "score":0.2,"time": 1730691557000}].

Ejemplos

// 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));

Límites

• Los índices de búsqueda que contienen campos Nested no admiten IndexSort, una función que mejora el rendimiento de las consultas en diversos escenarios.

• Al paginar resultados de consulta de un índice de búsqueda con campos Nested, especifique un método de ordenamiento en las condiciones de consulta. De lo contrario, Tablestore no devuelve nextToken cuando solo se leen resultados parciales.

• Las consultas anidadas ofrecen un rendimiento inferior al de otros tipos de consultas.

Además de estos límites, el tipo Nested admite todos los tipos de consulta, ordenamiento y agregación.