Use um índice Lastpoint para recuperar rapidamente os dados do ponto temporal mais recente das séries temporais em uma tabela de séries temporais. Chame a operação CreateTimeseriesLastpointIndex para criar esse índice. Durante a criação, especifique os nomes da tabela de séries temporais e do índice Lastpoint. Também é possível definir se os dados existentes na tabela devem ser incluídos no índice.
Também é possível criar um índice Lastpoint durante a criação da tabela de séries temporais. Para mais informações, consulte Criar uma tabela de séries temporais.
Observações de uso
O recurso de índice Lastpoint requer o Tablestore SDK for Go V1.7.15 ou posterior. Certifique-se de obter essa versão ou uma superior para utilizar a funcionalidade.
-
Após a criação do índice Lastpoint para uma tabela de séries temporais, o Tablestore sincroniza automaticamente e de forma assíncrona os dados do ponto temporal mais recente sempre que novos dados são gravados na tabela. Na maioria dos casos, a latência de sincronização fica na casa dos milissegundos.
Depois da sincronização, o índice Lastpoint contém a chave de partição (campo
_#h) gerada pelo Tablestore para a série temporal, os identificadores da série temporal e os dados do ponto temporal mais recente dessa série. -
A criação de um índice Lastpoint não gera custos. No entanto, há cobrança pelo armazenamento utilizado pelos índices e pela leitura de dados neles contidos. Para mais detalhes, consulte Itens faturáveis do modelo TimeSeries.
Consultas ou recuperações de dados em um índice Lastpoint por meio de instruções SQL ou de um search index geram taxas específicas, conforme as regras de faturamento de cada recurso. Para saber mais, veja Itens faturáveis de consulta SQL e Itens faturáveis de search indexes.
O limite máximo combinado de índices Lastpoint e analytical stores por tabela de séries temporais é 10.
Pré-requisitos
Crie uma instância do modelo TimeSeries em uma região com suporte ao recurso de índice Lastpoint. Consulte Criar uma instância para o modelo TimeSeries para mais informações.
Inicialize um TimeseriesClient. Veja Inicializar um cliente Tablestore para detalhes.
Parâmetros
|
Parâmetro |
Obrigatório |
Descrição |
|
timeseriesTableName |
Sim |
Nome da tabela de séries temporais. |
|
lastpointIndexName |
Sim |
Nome do índice Lastpoint. |
|
includeBaseData |
Não |
Define se os dados existentes na tabela de séries temporais serão incluídos no índice Lastpoint. Tipo: Booleano. Valores válidos:
|
Exemplos
O código abaixo demonstra como criar um índice Lastpoint chamado last_point_index para uma tabela de séries temporais denominada timeseries_table. Neste cenário, o índice incorpora os dados já existentes na tabela.
func createTimeseriesLastpointIndex(client *tablestore.TimeseriesClient) {
request := tablestore.NewCreateTimeseriesLastpointIndexRequest("test_timeseries_table", "last_point_index", true)
_, err := client.CreateTimeseriesLastpointIndex(request)
if err != nil {
log.Fatal(err)
}
}Referências
-
Após criar um índice Lastpoint, leia os dados armazenados nele utilizando um dos métodos a seguir:
Utilize as operações de leitura de tabelas de dados. Consulte Ler dados para mais detalhes.
Crie um search index para o índice Lastpoint e aproveite os recursos de consulta desse índice para acessar os dados.
Configure uma tabela de mapeamento SQL para o índice Lastpoint e execute a instrução SELECT para extrair as informações.
Se o índice Lastpoint não for mais necessário, exclua-o. Veja Excluir um índice Lastpoint para instruções.