Todos os produtos
Search
Central de documentação

Tablestore:Definição de tipos de dados

Última atualização: Jun 30, 2026

As operações da API do Tablestore utilizam os seguintes tipos de dados.

Lista de tipos de dados

A tabela a seguir lista os tipos de dados utilizados nas operações da API do Tablestore.

Tipo de dado

Descrição

ActionType

Tipo de operação na resposta da operação GetStreamRecord.

Aggregation

Configurações de uma única agregação.

AggregationResult

Resultados retornados de uma única agregação.

Aggregations

Configurações de agregação.

AggregationsResult

Resultados de agregação retornados.

AggregationType

Tipo da agregação.

AnalyticalStoreStorageSize

Tamanho do analytical store e timestamp de coleta dessa métrica.

AnalyticalStoreSyncStat

Status de sincronização de armazenamento do analytical store.

AnalyticalStoreSyncType

Tipo de sincronização do analytical store. Este tipo de dado especifica a opção de sincronização do analytical store em TimeseriesAnalyticalStore e define o status de sincronização em AnalyticalStoreSyncStat.

AvgAggregation

Operação de agregação do índice de pesquisa para obter o valor médio de um campo. Semelhante à função AVG no SQL.

BaseTable

Informações sobre a tabela base de uma tabela global.

BoolQuery

Configuração de consulta booleana. O BoolQuery consulta linhas com base em uma ou mais subconsultas. O Tablestore retorna as linhas correspondentes. A subconsulta pode ser de qualquer tipo, inclusive BoolQuery.

CapacityUnit

Número de unidades de capacidade (CUs) consumidas por uma operação ou throughput de leitura/gravação reservado definido para uma tabela.

ChannelInfo

Informações do canal na resposta da operação DescribeTunnel.

Collapse

Configuração de coluna para o recurso de colapso (distinct).

ColumnPaginationFilter

Condições de filtro para operações de leitura de coluna larga.

ComparatorType

Operador relacional.

ColumnReturnType

Tipo da coluna a retornar.

ColumnsToGet

Colunas a retornar.

CompositeColumnValueFilter

Os recursos de Atualização Condicional e Filtro aceitam combinações de condições, como column_a > 5 AND column_b = 10.

Condition

Condição obrigatória antes de chamar PutRow, UpdateRow ou DeleteRow para executar operações específicas em uma linha.

ConsumedCapacity

Número de CUs consumidas pela operação.

CountAggregation

Retorna o total de valores de um campo específico ou o total de linhas em um índice de pesquisa. Funciona de modo semelhante à função COUNT no SQL.

DataBlockType

Tipo de codificação do bloco de dados retornado.

DateTimeUnit

Unidade do intervalo estatístico.

DateTimeValue

Configurações do intervalo estatístico.

DefinedColumnSchema

Schema da coluna predefinida.

DefinedColumnType

Tipo da coluna predefinida.

Direction

Ordem de consulta de dados na operação GetRange.

DistinctCountAggregation

Operação de agregação do índice de pesquisa para retornar a quantidade de valores distintos de um campo. Semelhante à função COUNT(DISTINCT) no SQL.

Error

Mensagem de erro retornada na resposta quando uma operação falha. Também especifica erros de operação de linha única nas respostas de BatchGetRow, BatchWriteRow e BulkImport.

ExistsQuery

Configurações de consulta de existência (também chamada de consulta NULL ou de valor NULL). Usada em dados esparsos para verificar se uma coluna existe na linha. Exemplo: consultar linhas onde a coluna de endereço não está vazia.

FailedRowInfo

Informações sobre a linha cuja gravação falhou.

FieldRange

Intervalo estatístico.

FieldSchema

Configurações de todos os campos de índice em um índice de pesquisa.

FieldSort

Configuração de ordenação para um campo em um índice de pesquisa.

FieldType

Tipo de um campo em um índice de pesquisa.

Filter

Condições baseadas em colunas, usadas nos recursos de atualização condicional e filtro.

FilterType

Tipo do recurso de atualização condicional ou filtro.

FuzzyAnalyzerParameter

Configurações opcionais no índice de pesquisa ao usar tokenização difusa.

GeoBoundingBoxQuery

Configurações de consulta de caixa delimitadora geográfica. Define uma área retangular como condição; o Tablestore retorna linhas cujo valor da coluna esteja dentro dessa área.

GeoDistanceQuery

Configurações de consulta de distância geográfica. Define uma área circular (ponto central e raio) como condição; o Tablestore retorna linhas cujo valor da coluna esteja dentro dessa área.

GeoDistanceSort

Método de ordenação baseado em localizações geográficas.

GeoDistanceType

Método de cálculo de distância.

GeoPoint

Longitude e latitude do ponto central.

GlobalTableStatus

Status da tabela global.

GroupByDateHistogram

Agrupa resultados de consulta por intervalos de data específicos. Valores no mesmo intervalo formam um grupo. Retorna o intervalo e a contagem de valores de cada grupo.

GroupByDateHistogramItem

Resultados de agrupamento para um único intervalo no histograma de datas.

GeoPolygonQuery

Configurações de consulta de polígono geográfico. Define uma área poligonal como condição; o Tablestore retorna linhas cujo valor da coluna esteja dentro dessa área.

GroupBy

Configuração de um único grupo.

GroupByField

Agrupa resultados de consulta por valor de campo. Valores idênticos são reunidos no mesmo grupo. Retorna o valor e a contagem de itens de cada grupo.

GroupByFieldResultItem

Resultado de agrupamento para um único valor de campo.

GroupByHistogram

Agrupa resultados de consulta por intervalos de dados específicos. Valores no mesmo intervalo formam um grupo. Retorna o intervalo e a contagem de valores de cada grupo.

GroupByHistogramItem

Resultado de agrupamento para um único intervalo no histograma.

GroupByFilter

Agrupa resultados de consulta conforme condições de filtro específicas e os retorna na ordem definida dessas condições.

GroupByFilterResultItem

Resultado de agrupamento para uma única condição de filtro.

GroupByGeoDistance

Agrupa resultados de consulta por localização geográfica, conforme a distância de um ponto central. Valores na mesma faixa de distância formam um grupo. Retorna o intervalo e a contagem de valores de cada grupo.

GroupByGeoDistanceResultItem

Resultado de agrupamento para um único intervalo de distância geográfica.

GroupByRange

Agrupa resultados de consulta por intervalo de valores de um campo. Valores no mesmo intervalo formam um grupo. Retorna o valor e a contagem de itens de cada grupo.

GroupByRangeResultItem

Resultado de agrupamento para um único intervalo.

GroupByResult

Resultados retornados de uma única operação GroupBy.

GroupBys

Configurações de agrupamento dos resultados de um índice de pesquisa.

GroupBySort

Método de ordenação definido para valores no grupo.

GroupBySorter

Método de ordenação para valores no grupo. Por padrão, usa-se row_count_sort.

GroupBysResult

Resultados retornados da operação GroupBy.

GroupByType

Tipo do grupo.

GroupKeySort

Regra de ordenação para os valores de campo em cada grupo.

Highlight

Configurações de resumo e destaque.

HighlightEncoder

Método de codificação para fragmentos de texto destacados.

HighlightField

Informações sobre fragmentos de texto destacados de um campo.

HighlightFragmentOrder

Ordem de classificação para múltiplos fragmentos de um campo destacado.

HighlightParameter

Parâmetros de destaque.

HighlightResult

Resultados destacados de um campo não aninhado (non-Nested).

IndexInfo

Detalhes da lista de índices.

IndexMeta

Schema da tabela de índice.

IndexSchema

Schema do índice de pesquisa. Inclui configurações (campos, opções) e a regra de pré-ordenação.

IndexSetting

Informações de configuração do índice de pesquisa, como campos de roteamento.

IndexSyncPhase

Informações sobre a fase de sincronização do índice.

IndexType

Tipo do índice.

IndexUpdateMode

Modo de atualização do índice.

InnerHits

Configurações dos subcampos do campo Nested.

JsonType

Tipo do campo JSON.

KnnVectorQuery

Recurso de consulta vetorial k-nearest neighbor (KNN) para busca aproximada do vizinho mais próximo. Encontra itens com maior similaridade ao vetor consultado em grandes conjuntos de dados.

LastpointIndexMetaForCreate

Informações de configuração para criação do índice Lastpoint.

LogicalOperator

Operador lógico.

MatchAllQuery

Configurações de consulta match all. Obtém o total de linhas da tabela ou retorna linhas aleatórias ao corresponder a todas as linhas.

MatchPhraseQuery

Configurações de consulta match phrase. Busca dados por correspondência aproximada, avaliando a posição dos tokens. A linha só atende à condição se a ordem e a posição dos tokens coincidirem com as da palavra-chave.

MatchQuery

Configurações de consulta match. Busca dados na tabela por correspondência aproximada.

MaxAggregation

Operação de agregação do índice de pesquisa para retornar o valor máximo de um campo. Semelhante à função MAX no SQL.

MetaQueryCondition

Condição para recuperar metadados de séries temporais.

MetaQueryConditionType

Tipo de condição para recuperar metadados de séries temporais.

MetaUpdateMode

Modo de atualização para metadados de séries temporais.

MetaUpdateStatus

Status de atualização de metadados.

MeteringInfo

Informações de medição do índice de pesquisa.

MinAggregation

Operação de agregação do índice de pesquisa para retornar o valor mínimo de um campo. Semelhante à função MIN no SQL.

NestedFilter

Condição de filtragem para um campo Nested.

NestedQuery

Configurações de consulta aninhada. Consulta dados nas linhas filhas de campos Nested. Como esses campos não são diretamente consultáveis, especifique o caminho e uma subconsulta (de qualquer tipo) no objeto NestedQuery.

PartitionRange

Intervalo da partição.

PhyTable

Lista detalhada das tabelas físicas em uma tabela global.

PhyTableStatus

Status das tabelas físicas em uma tabela global.

Placement

Lista de configurações de localização de distribuição para tabelas em uma tabela global.

PercentilesAggregation

Estatísticas de percentil da agregação em índices de pesquisa. Indica a posição relativa de um valor no conjunto de dados. Útil para analisar distribuição de tempo de resposta (ex.: p25, p50, p90, p99) em O&M rotineiro.

PercentilesAggregationItem

Informações sobre um percentil nas estatísticas.

OperationType

Método de modificação para uma coluna nas operações UpdateRow e BulkImport.

PlainBuffer

Oferece melhor desempenho que Protocol Buffer na serialização e análise de objetos pequenos. Por isso, formata dados no Tablestore.

PrefixQuery

Configurações de consulta de prefixo. Busca dados contendo um prefixo específico. Em campos Text, os valores são tokenizados; a linha atende à condição se algum token contiver o prefixo.

PrimaryKeySort

Ordem de classificação da chave primária.

PrimaryKeyOption

Atributo de uma coluna de chave primária. Apenas AUTO_INCREMENT é compatível.

PrimaryKeySchema

Configurações de uma coluna de chave primária.

PrimaryKeyType

Tipo de uma coluna de chave primária.

Query

Condição de consulta do índice de pesquisa.

QueryFlowWeight

Configuração de peso para consultas de dados.

QueryOperator

Operador de consulta.

QueryType

Tipo de consulta do índice de pesquisa.

Range

Informações de configuração de intervalo de um único grupo.

RangeQuery

Configurações de consulta de intervalo. Busca dados dentro de um intervalo especificado. Em campos Text, a string é tokenizada; a linha atende à condição se algum token estiver no intervalo.

Removal

Localização de distribuição da réplica a remover de uma tabela global.

ReservedThroughput

Throughput de leitura e gravação reservado definido para uma tabela.

ReservedThroughputDetails

Informações sobre o throughput de leitura e gravação reservado para uma tabela.

ReturnContent

Dados retornados.

ReturnType

Tipo dos dados retornados.

RowCountSort

Classifica grupos pelo número de linhas.

RowExistenceExpectation

Condição de existência da linha.

RowInBatchGetRowResponse

Linha de dados na resposta da operação BatchGetRow.

RowInBatchWriteRowRequest

Informações sobre a linha a inserir, atualizar ou excluir via operação BatchWriteRow.

RowInBatchWriteRowResponse

Resultado da operação de gravação para uma linha na resposta da operação BatchWriteRow.

RowInBulkImportRequest

Informações sobre a linha a inserir, atualizar ou excluir via operação BulkImport.

RowInBulkImportResponse

Resultado de uma operação de gravação em lote na resposta da operação BulkImport.

RowsSerializeType

Tipo de serialização para linhas de dados de séries temporais.

ScanQuery

Configurações de varredura definidas ao chamar a operação ParallelScan.

SearchFilter

Configuração de filtro pós-consulta na API Search para índices de pesquisa.

SearchHit

Dados retornados que atendem às condições de consulta. Presente apenas ao usar destaque ou consulta vetorial KNN.

SearchInnerHit

Informações sobre fragmentos de texto destacados de um campo Nested.

SearchIndexSplitsOptions

Informações de configuração do índice de pesquisa na operação ComputeSplits.

SearchQuery

Configurações de consulta definidas ao chamar a operação Search de índices de pesquisa.

ServeMode

Modo de serviço da tabela global.

ScoreSort

Ordem de classificação das pontuações.

Sort

Método de pré-ordenação do índice de pesquisa ou de ordenação dos resultados retornados.

Sorter

Método de pré-ordenação do índice. Índices sem campos Nested usam PrimaryKeySort por padrão. Índices com campos Nested não possuem pré-ordenação padrão.

SortMode

Método de ordenação para campos com múltiplos valores (baseado no valor máximo, mínimo ou médio).

SortOrder

Ordem de classificação dos valores de campo (decrescente ou crescente).

SingleColumnValueFilter

Os recursos ConditionUpdate e Filter usam uma única condição, como column_a>5.

SingleWordAnalyzerParameter

Configurações opcionais no índice de pesquisa ao usar tokenização de palavra única.

SQLPayloadVersion

Método de codificação dos dados retornados pela operação SQLQuery.

SQLStatementType

Tipo da instrução SQL no resultado da operação SQLQuery.

SplitAnalyzerParameter

Configurações opcionais no índice de pesquisa ao usar tokenização por delimitador.

SSEDetails

Informações sobre criptografia no lado do servidor.

SSEKeyType

Tipo da chave de criptografia.

SSESpecification

Configurações de criptografia da tabela de dados.

StartOffsetFlag

Deslocamento inicial.

Stream

Informações do Stream.

StreamDetails

Informações do Stream de uma tabela.

SplitLocation

Localização do ponto de divisão.

StreamRecord

Linha de dados na resposta da operação GetStreamRecord.

StreamTunnelConfig

Configuração do Stream do túnel.

StreamShard

Informações de shard do Stream.

StreamSpecification

Informações do Stream de uma tabela.

SubAggSort

Ordenação baseada nos resultados da subagregação.

SuffixQuery

Configurações de consulta de sufixo. Busca dados especificando condições de sufixo no índice de pesquisa. Exemplo: buscar pacotes pelos últimos quatro dígitos de um telefone celular.

SumAggregation

Operação de agregação do índice de pesquisa para obter a soma dos valores de um campo. Semelhante à função SUM no SQL.

SyncMode

Modo de sincronização de dados da tabela global.

SyncPhase

Fase de sincronização do índice de pesquisa.

SyncStage

Estágio de sincronização de dados das tabelas físicas em uma tabela global.

SyncStat

Status de sincronização do índice de pesquisa.

TableConsumedCapacity

Número de CUs consumidas pela operação SQLQuery.

TableInBatchGetRowRequest

Configurações para leitura de dados de uma única tabela na operação BatchGetRow.

TableInBatchGetRowResponse

Dados lidos de uma tabela na resposta da operação BatchGetRow.

TableInBatchWriteRowRequest

Configurações para gravar, atualizar ou excluir dados em uma tabela na operação BatchWriteRow.

TableInBatchWriteRowResponse

Resultados de gravação para uma tabela na operação BatchWriteRow.

TableMeta

Informações de schema de uma tabela.

TableOptions

Configurações opcionais de uma tabela, incluindo TTL dos dados e número máximo de versões.

TermQuery

Configurações de consulta term. Busca linhas onde o valor do campo corresponde exatamente à palavra-chave. Semelhante à correspondência de strings. Em campos Text, os valores são tokenizados; a linha atende à condição se algum token corresponder à palavra-chave.

TermsQuery

Configurações de consulta terms. Similar à consulta term, mas aceita múltiplas palavras-chave. Retorna a linha se o valor do campo corresponder a pelo menos uma delas. Equivalente ao operador IN no SQL.

TimeRange

Intervalo de timestamp ou timestamp específico definido para a consulta de dados.

TimeseriesAnalyticalStore

Configuração de armazenamento do analytical store.

TimeseriesFieldsToGet

Nome e tipo de dado da coluna de série temporal a consultar.

TimeseriesKey

Identificadores da série temporal.

TimeseriesLastpointIndex

Informações de configuração do índice Lastpoint.

TimeseriesMeta

Metadados da linha do tempo.

TimeseriesMetaOptions

Configurações dos metadados de séries temporais.

TimeseriesRows

Linhas de dados de séries temporais.

TimeseriesTableMeta

Schema e configurações da tabela de séries temporais.

TimeseriesTableOptions

Configurações da tabela de séries temporais.

TimeseriesTag

Tags da série temporal.

TopRowsAggregation

Operação de agregação para consultar linhas obtidas dos resultados de agregação em cada grupo. Semelhante à função ANY_VALUE(field) no MySQL.

Tunnel

Informações de configuração do túnel.

TunnelInfo

Informações do túnel nas respostas das operações ListTunnel e DescribeTunnel.

TunnelType

Tipo do túnel.

UpdatePhyTable

Informações sobre a tabela física a atualizar em uma tabela global.

ValueTransferRule

Converte uma string para o tipo String, Integer ou Double após correspondência por expressão regular.

VariantType

Tipos de dados resultantes da conversão de string.

VectorDataType

Tipo de dado do vetor.

VectorMetricType

Algoritmo para medir a distância entre vetores.

VectorOptions

Propriedades do campo Vector.

WildcardQuery

Configurações de consulta wildcard. Recupera dados correspondentes a uma string com caracteres curinga: asterisco () para qualquer sequência e ponto de interrogação (?) para um único caractere. O curinga pode aparecer no início, meio ou fim. Exemplo: "tablee" corresponde a "tablestore".