Todos os produtos
Search
Central de documentação

Tablestore:Consulta por polígono geográfico

Última atualização: Sep 20, 2026

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 latitude,longitude. Valores válidos para a latitude: [-90,+90]. Valores válidos para a longitude: [-180,+180]. Exemplo: 35.8,-45.91.

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 o console do Tablestore

  1. Acesse a aba Index Management.

    1. Faça login no console do Table Store.

    2. Na barra de navegação superior, selecione um grupo de recursos e uma região.

    3. Na página Overview, clique no nome da instância ou clique em Instance Management na coluna Actions.

    4. Na aba Instance Details, na aba Data Table List, clique no nome da tabela de dados ou clique em Index Management na coluna Actions.

  2. Na aba Index Management, localize o Search Index de destino e clique em Search na coluna Actions.

  3. Na caixa de diálogo Search, configure a consulta.

    1. Por padrão, todas as colunas são retornadas. Para retornar colunas específicas, desative a opção Retrieve All Columns e insira os nomes das colunas, separados por vírgulas.

      Nota

      Por padrão, o Table Store retorna as colunas de chave primária da tabela de dados.

    2. Selecione um operador lógico: And, Or ou Not.

      Ao selecionar And, a consulta retorna os dados que atendem a todas as condições especificadas. Ao selecionar Or, a consulta retorna os dados que atendem a pelo menos uma das condições. Ao selecionar Not, a consulta retorna os dados que não atendem às condições especificadas.

    3. Selecione um campo de índice do tipo Geopoint e clique em Add.

    4. Defina o tipo de consulta para o campo de índice como GeoPolygonQuery. Insira as coordenadas geográficas dos vértices do polígono.

    5. Por padrão, a ordenação está desativada. Para ordenar os resultados por um campo específico, ative a opção Enable Sorting, adicione o campo de ordenação e configure a ordem de classificação.

    6. Por padrão, a agregação está desativada. Para executar uma agregação estatística em um campo específico, ative a opção Enable Aggregation, adicione o campo para agregação e configure as definições de agregação.

  4. Clique em OK.

    Os resultados da consulta são exibidos na aba Index Management.

Use a CLI do Tablestore

Use a CLI do Tablestore para executar o comando search e consultar dados usando índices de pesquisa. Para mais informações, consulte Índice de pesquisa.

  1. Execute o comando search para usar o índice de pesquisa search_index, consultar dados e retornar todas as colunas indexadas de cada linha que atenda às condições da consulta.

    search -n search_index --return_all_indexed
  2. Insira as condições de consulta conforme solicitado pelo sistema:

    {
        "Offset": -1,
        "Limit": 10,
        "Collapse": null,
        "Sort": null,
        "GetTotalCount": true,
        "Token": null,
        "Query": {
            "Name": "GeoPolygonQuery",
            "Query": {
                "FieldName": "col_geopoint",
                "Points": ["0,0","5,5","5,0"]
            }
        }
    }

Use os SDKs do Tablestore

É possível executar consultas por polígono geográfico usando Tablestore SDK for Java, Tablestore SDK for Go, Tablestore SDK for Python, Tablestore SDK for Node.js, Tablestore SDK for .NET e Tablestore SDK for PHP. No exemplo a seguir, o Tablestore SDK for Java é usado para demonstrar como executar essas consultas.

O exemplo a seguir consulta as linhas nas quais o campo location está contido no polígono definido pelos pontos de coordenadas -1,-1, -1,2, 2,2 e 2,-1.

GeoPolygonQuery geoPolygonQuery = new GeoPolygonQuery();
geoPolygonQuery.setFieldName("location");
geoPolygonQuery.setPoints(
        Arrays.asList("-1,-1", "-1,2", "2,2", "2,-1"));

SearchQuery searchQuery = new SearchQuery();
searchQuery.setQuery(geoPolygonQuery);

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