Use um índice Lastpoint para recuperar rapidamente 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. Ao criá-lo, especifique os nomes da tabela de séries temporais e do índice Lastpoint. Você também pode definir se deseja incluir os dados existentes da tabela 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 tabelas de séries temporais.
Observações de uso
O Tablestore SDK for Java V5.17.1 ou posterior oferece suporte ao recurso de índice Lastpoint. Para usar esse recurso, obtenha o Tablestore SDK for Java V5.17.1 ou versão superior. Para obter detalhes sobre o histórico de versões, consulte Histórico de versões do Tablestore SDK for Java.
-
Após criar um índice Lastpoint para uma tabela de séries temporais, sempre que houver gravação de dados nessa tabela, o Tablestore sincronizará automaticamente e de forma assíncrona os dados do ponto temporal mais recente para o índice. Geralmente, a latência de sincronização é de 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 do índice Lastpoint é gratuita. No entanto, há cobrança pelo armazenamento dos índices Lastpoint e pela leitura de dados neles contidos. Para mais informações, consulte Itens faturáveis do modelo TimeSeries.
Se você consultar ou recuperar dados em um índice Lastpoint por meio de instruções SQL ou de um índice de pesquisa, serão aplicadas taxas correspondentes conforme as regras de faturamento de cada recurso. Para mais informações, consulte Itens faturáveis de consulta SQL e Itens faturáveis de índices de pesquisa.
O total combinado de índices Lastpoint e analytical stores em uma única tabela de séries temporais não pode exceder 10.
Pré-requisitos
Crie uma instância do modelo TimeSeries em uma região compatível com o recurso de índice Lastpoint. Para mais informações, consulte Criar uma instância para o modelo TimeSeries.
Inicialize um TimeseriesClient. Para mais informações, consulte Inicializar um cliente Tablestore.
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 |
Especifica se os dados existentes da tabela de séries temporais devem ser incluídos no índice Lastpoint. Tipo: Booleano. Valores válidos:
|
Exemplos
O exemplo de código a seguir cria um índice Lastpoint chamado last_point_index para uma tabela de séries temporais chamada timeseries_table. Neste exemplo, o índice Lastpoint inclui os dados existentes da tabela.
public void createTimeseriesLastpointIndex(TimeseriesClient client) {
CreateTimeseriesLastpointIndexRequest request =
new CreateTimeseriesLastpointIndexRequest("timeseries_table", "last_point_index", true);
client.createTimeseriesLastpointIndex(request);
}Referências
-
Após criar um índice Lastpoint, leia os dados dele usando um dos métodos a seguir:
Use as operações de leitura de tabelas de dados. Para mais informações, consulte Ler dados.
Crie um índice de pesquisa para o índice Lastpoint e use os recursos de consulta desse índice para ler os dados.
Crie uma tabela de mapeamento SQL para o índice Lastpoint e execute a instrução SELECT para ler os dados.
Se não precisar mais de um índice Lastpoint, exclua-o. Para mais informações, consulte Excluir um índice Lastpoint.