Use um Lastpoint index para recuperar rapidamente os dados do ponto de tempo mais recente em séries temporais de uma tabela de séries temporais. Chame a operação CreateTimeseriesLastpointIndex para criar um Lastpoint index para uma tabela de séries temporais. Ao criar um Lastpoint index, especifique os nomes da tabela de séries temporais e do Lastpoint index. Opcionalmente, indique se os dados existentes da tabela de séries temporais devem ser incluídos no Lastpoint index.
Também é possível criar um Lastpoint index ao criar uma tabela de séries temporais. Para obter mais informações, consulte Create a time series table.
Notas de uso
O Tablestore sdk for Go V1.7.15 ou posterior oferece suporte ao recurso Lastpoint index. Para usar esse recurso, obtenha o Tablestore sdk for Go V1.7.15 ou posterior.
-
Após criar um Lastpoint index para uma tabela de séries temporais, quando dados forem gravados na tabela, o Tablestore sincroniza automaticamente os dados do ponto de tempo mais recente das séries temporais para o Lastpoint index de forma assíncrona. Na maioria dos casos, a latência de sincronização é de milissegundos.
Após a sincronização dos dados para o Lastpoint index, este passa a conter a chave de partição (o campo
_#h) gerada pelo Tablestore para a série temporal, os identificadores das séries temporais e os dados do ponto de tempo mais recente da série. -
A criação de um Lastpoint index não é cobrada. As cobranças referem-se ao uso de armazenamento dos Lastpoint indexes e à leitura de dados neles. Para obter mais informações, consulte Billable items of the TimeSeries model.
Ao consultar ou recuperar dados em um Lastpoint index via instruções SQL ou search index, serão cobradas taxas relacionadas a consultas SQL ou a search index, conforme as regras de faturamento de cada recurso. Para obter mais informações, consulte Billable items of SQL query e Billable items of search indexes.
O número total de Lastpoint indexes e analytical stores criados para uma tabela de séries temporais não pode exceder 10.
Pré-requisitos
Crie uma instância para o modelo TimeSeries em uma região que ofereça suporte ao recurso Lastpoint index. Para obter mais informações, consulte Create an instance for the TimeSeries model.
Inicialize um TimeseriesClient. Para obter mais informações, consulte Initialize a Tablestore client.
Parâmetros
|
Parâmetro |
Obrigatório |
Descrição |
|
timeseriesTableName |
Sim |
O nome da tabela de séries temporais. |
|
lastpointIndexName |
Sim |
O nome do Lastpoint index. |
|
includeBaseData |
Não |
Indica se os dados existentes da tabela de séries temporais devem ser incluídos no Lastpoint index. Tipo: Boolean. Valores válidos:
|
Exemplos
O código de exemplo a seguir demonstra como criar um Lastpoint index chamado last_point_index para uma tabela de séries temporais chamada timeseries_table. Neste exemplo, o Lastpoint index inclui os dados existentes da tabela de séries temporais.
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 Lastpoint index, leia os dados nele pelos seguintes métodos:
Use as operações de leitura de dados para tabelas de dados. Para obter mais informações, consulte Read data.
Crie um search index para o Lastpoint index e use os recursos de consulta do search index para ler os dados.
Crie uma tabela de mapeamento SQL para o Lastpoint index e execute a instrução selecione para ler os dados.
Caso não queira mais usar um Lastpoint index, exclua-o. Para obter mais informações, consulte Delete a lastpoint index.