Uma geo-bounding box query permite especificar uma área geográfica retangular como condição de consulta. O Tablestore retorna as linhas em que o valor do campo especificado está dentro dessa área geográfica retangular.
Operações de API
Defina o tipo de consulta como GeoBoundingBoxQuery na operação Search ou ParallelScan para executar geo-bounding box queries.
Parâmetros
|
Parâmetro |
Descrição |
|
fieldName |
Nome da coluna a ser consultada. O valor deste parâmetro é do tipo de dados GEOPOINT. |
|
topLeft |
Par de coordenadas do canto superior esquerdo da área geográfica retangular. |
|
bottomRight |
Par de coordenadas do canto inferior direito da área geográfica retangular. Uma área geográfica retangular pode ser definida por meio de um canto superior esquerdo e um canto inferior direito. O formato é |
|
query |
Instrução de consulta para o search index. Defina este parâmetro como GeoBoundingBoxQuery. |
|
getTotalCount |
Especifica se o número total de linhas que atendem às condições de consulta deve ser retornado. O valor padrão é false, indicando que o total não é retornado. Definir este parâmetro como true reduz o desempenho da consulta. |
|
tableName |
Nome da tabela de dados. |
|
indexName |
Nome do search index. |
|
columnsToGet |
Especifica se todas as colunas de cada linha que atende às condições de consulta devem ser retornadas. Configure os campos returnAll e columns para este parâmetro. O valor padrão do campo returnAll é false, indicando que nem todas as colunas são retornadas. Nesse caso, utilize o campo columns para especificar as colunas desejadas. Se nenhuma coluna for especificada, apenas as colunas de chave primária serão retornadas. Definir o campo returnAll como true retorna todas as colunas. |
Métodos
Execute geo-bounding box queries por meio do console do Tablestore, do Tablestore CLI ou dos SDKs do Tablestore. Antes de executar as consultas, verifique se os seguintes pré-requisitos foram atendidos:
-
Use uma conta Alibaba Cloud ou um usuário RAM com as permissões necessárias para operações no Table Store. Para conceder permissões a um usuário RAM, consulte Grant permissions to a RAM user by using a RAM policy.
Se utilizar um SDK ou uma ferramenta de linha de comando, create an AccessKey para sua conta Alibaba Cloud ou usuário RAM, caso ainda não possua.
Você já created a data table.
Um Search Index foi criado para a tabela de dados.
Se utilizar um SDK, initialize the Tablestore Client.
Se utilizar a ferramenta de linha de comando, baixe e inicie a ferramenta, configure a conexão com sua instância e selecione a tabela de destino. Para mais informações, consulte Download the command-line tool, Start the tool and configure connection information e Data table operations.
Faturamento
A consulta de dados por meio de um Search Index consome throughput de leitura. Para mais informações, consulte Search Index metering and billing.
Perguntas frequentes
Referências
O Search Index oferece suporte a diversos tipos de consulta para pesquisas multidimensionais, incluindo term query, terms query, match all query, match query, phrase match query, range query, prefix query, suffix query, wildcard query, token-based wildcard query, boolean query, geo query, nested query, vector search, e exists query.
Durante a consulta de dados, é possível sort and paginate o conjunto de resultados ou realizar collapsing (deduplication).
Para análise de dados — como localizar o valor máximo ou mínimo, calcular uma soma ou contar linhas — utilize os recursos statistical aggregation ou SQL query.
Para exportar dados rapidamente, independentemente da ordem do conjunto de resultados, utilize o recurso Parallel Scan.