Todos os produtos
Search
Central de documentação

Tablestore:Diferenças entre o uso das APIs GetRange e Search para consultas de intervalo

Última atualização: Sep 09, 2026

Diferença

API GetRange

API Search

Desempenho de consulta em tempo real

As consultas são executadas diretamente na tabela de dados, sem necessidade de índice. É possível consultar os dados imediatamente após a gravação.

Para obter mais informações sobre a API GetRange, consulte Read data e GetRange.

As consultas são executadas em um índice de pesquisa. O índice de pesquisa e a tabela de dados sincronizam de forma assíncrona. Após gravar os dados, aguarde a conclusão da sincronização antes de consultá-los. A sincronização geralmente termina em até 3 segundos.

Para obter mais informações sobre a API Search, consulte Introduction to Search Index e Search.

Consumo de recursos de computação e escalabilidade

O sistema localiza as partições da tabela de dados com base no intervalo de carimbo de data/hora especificado. As operações de leitura ocorrem apenas nessas partições. Esse processo consome poucos recursos de computação e oferece boa escalabilidade.

O consumo de recursos de computação e a escalabilidade variam conforme a especificação de uma chave de roteamento durante a criação do índice de pesquisa.

  • Sem a definição de uma chave de roteamento, o sistema realiza operações de leitura em todas as partições. Isso aumenta o consumo de recursos de computação e limita a escalabilidade.

  • Ao definir uma chave de roteamento, o sistema identifica as partições específicas para executar as operações de leitura, o que reduz o consumo de recursos de computação. A capacidade de consulta pode ser ampliada conforme o número de partições. No entanto, como as partições de índice não permitem divisão dinâmica, não há suporte à escalabilidade dinâmica.

Para obter mais informações sobre como crie um índice de pesquisa, consulte Create a search index.

Suporte a filtragem de dados

Realiza apenas varreduras de dados e não suporta filtragem complexa.

Permite filtragem por qualquer combinação de condições de coluna, oferecendo maior flexibilidade.