Todos os produtos
Search
Central de documentação

Tablestore:Search index limits

Última atualização: Jul 03, 2026

Este tópico descreve os limites aplicáveis a índices secundários.

Limites das tabelas de índice

Item

Limite

Descrição

Nome do índice secundário

Único por instância

Convenções de nomenclatura para índices secundários:

  • O nome deve ter entre 1 e 255 bytes e pode conter letras, dígitos e sublinhados (_). O nome diferencia maiúsculas de minúsculas.

  • O nome deve começar com uma letra ou um sublinhado (_).

Quantidade de índices secundários

5

Caso esse limite não atenda aos requisitos do seu negócio, envie um ticket.

Número de campos de índice

36

  • A chave primária de um índice secundário é composta pelas colunas de índice e por todas as colunas de chave primária da tabela de dados associada ao índice. Essa chave primária pode ter até oito colunas, sendo no máximo quatro delas colunas de índice. As colunas de índice podem ser colunas de chave primária ou colunas predefinidas da tabela de dados.

  • Um índice secundário comporta até 32 colunas de atributo, correspondentes às colunas predefinidas da tabela de dados.

Tipos de dados aceitos nas colunas de índice

String, Integer e Binary

  • String: cadeia codificada em UTF-8 com tamanho máximo de 1 KB.

  • Integer: inteiro assinado de 64 bits, ocupando 8 bytes.

  • Binary: dados binários com tamanho máximo de 1 KB.

Tipos de dados aceitos nas colunas de atributo

String, Integer, Double, Boolean e Binary

  • String: cadeia codificada em UTF-8 com tamanho máximo de 2 MB.

  • Integer: inteiro assinado de 64 bits, ocupando 8 bytes.

  • Double: valor Double de 64 bits, ocupando 8 bytes.

  • Boolean: valor True ou False, ocupando 1 byte.

  • Binary: dados binários com tamanho máximo de 2 MB.

Outros limites

Item

Limite

Descrição

Coluna de índice

Todas as colunas, exceto chaves primárias autoincrementais

A primeira coluna de chave primária de uma tabela de índice não pode ser uma coluna de chave primária autoincremental.

Operação em dados de tabelas de índice

Somente leitura

É possível apenas ler dados das tabelas de índice. A escrita de dados nessas tabelas não é permitida.

Versões máximas

Não suportado

Nenhum

Tempo de vida (TTL)

Suportado

Proíba atualizações na tabela de dados para garantir que o TTL da tabela de dados seja igual ao TTL da tabela de índice criada para ela.

Stream

Não suportado

Nenhum

Consulta a partir de tabelas de dados

Não suportado

Consultas diretas às tabelas de dados são obrigatórias.