A consulta por polígono geográfico permite especificar uma área geográfica poligonal como condição de consulta. O Tablestore retorna as linhas nas quais o valor do campo especificado está contido na área geográfica do polígono.
Operações de API
Para executar consultas por polígono geográfico, defina o tipo de consulta como GeoPolygonQuery na operação Search ou ParallelScan.
Parâmetros
|
Parâmetro |
Descrição |
|
fieldName |
O nome da coluna que você deseja consultar. O valor deste parâmetro é do tipo de dados GEOPOINT. |
|
points |
Os pares de coordenadas dos pontos que definem a área geográfica do polígono. O valor deste parâmetro deve estar no formato |
|
query |
A instrução de consulta para o índice de pesquisa. Defina este parâmetro como GeoPolygonQuery. |
|
getTotalCount |
Especifica se o número total de linhas que atendem às condições de consulta será retornado. O valor padrão é false, que não retorna o número total de linhas. Definir este parâmetro como true compromete o desempenho da consulta. |
|
tableName |
O nome da tabela de dados. |
|
indexName |
O nome do índice de pesquisa. |
|
columnsToGet |
Especifica se todas as colunas de cada linha que atende às condições de consulta serão retornadas. Especifique os campos returnAll e columns para este parâmetro. O valor padrão do campo returnAll é false, que não retorna todas as colunas. Nesse caso, use o campo columns para especificar as colunas a serem retornadas. Se você não especificar as colunas, apenas as colunas de chave primária serão retornadas. Se você definir o campo returnAll como true, todas as colunas serão retornadas. |
Métodos
Execute consultas por polígono geográfico usando o console do Tablestore, a CLI do Tablestore e os SDKs do Tablestore. Antes de executar essas consultas, certifique-se de atender aos seguintes pré-requisitos:
-
Use uma conta Alibaba Cloud ou um usuário RAM com as permissões necessárias para operações do Tablestore. Para conceder permissões a um usuário RAM, consulte Conceda permissões a um usuário RAM usando uma política RAM.
Se você usar um SDK ou uma ferramenta de linha de comando, crie um AccessKey para sua conta Alibaba Cloud ou usuário RAM, caso ainda não tenha um.
Crie uma tabela de dados.
Crie um Search Index para a tabela de dados.
Se usar um SDK, inicialize o Tablestore Client.
Se usar a ferramenta de linha de comando, baixe e inicie a ferramenta, configure a conexão com a sua instância e selecione a tabela de destino. Para mais informações, consulte baixe a ferramenta de linha de comando, Inicie a ferramenta e configure as informações de conexão e Operações de tabela de dados.
Faturamento
Consultar dados usando um Search Index consome throughput de leitura. Para mais informações, consulte Medição e faturamento do Search Index.
Perguntas frequentes
Referências
O Search Index oferece suporte a vários tipos de consulta para dados multidimensionais, incluindo consulta de termo, consulta de termos, consulta de correspondência total, consulta de correspondência, consulta de correspondência de frase, consulta de intervalo, consulta de prefixo, consulta de sufixo, consulta de curinga, consulta de curinga baseada em token, consulta booleana, consulta geográfica, consulta aninhada, pesquisa vetorial, e consulta de existência.
Ao consultar dados, você pode ordenar e paginar o conjunto de resultados ou executar colapso (deduplicação).
Para analisar dados, como encontrar o valor máximo ou mínimo, calcular uma soma ou contar linhas, use os recursos de agregação estatística ou consulta SQL.
Para exportar dados rapidamente, independentemente da ordem do conjunto de resultados, use o recurso Parallel Scan.