Todos os produtos
Search
Central de documentação

Tablestore:Criar um analytical store

Última atualização: Aug 04, 2026

Use o Tablestore SDK for Java para criar um analytical store em uma tabela de séries temporais existente. Isso permite armazenar e analisar dados de séries temporais a longo prazo com custo reduzido.

Pré-requisitos

  • Instale o Tablestore SDK for Java e inicialize um cliente do modelo de séries temporais. As operações de analytical store exigem o Tablestore SDK for Java 5.15.0 ou posterior. Recomendamos usar a versão mais recente.

  • Crie uma instância do modelo de séries temporais em uma região compatível com analytical stores. Para obter informações sobre as regiões suportadas e o recurso, consulte Analytical store.

Descrição do recurso

Chame o método createTimeseriesAnalyticalStore para criar um analytical store em uma tabela de séries temporais existente. O analytical store sincroniza automaticamente os dados da tabela de séries temporais. Seu TTL é independente do TTL da tabela de séries temporais, e as consultas no analytical store não afetam as leituras ou gravações na tabela de origem.

public CreateTimeseriesAnalyticalStoreResponse createTimeseriesAnalyticalStore(CreateTimeseriesAnalyticalStoreRequest request) throws TableStoreException, ClientException

Ao criar um analytical store, escolha um dos seguintes modos de sincronização:

    • SYNC_TYPE_FULL: sincroniza os dados existentes e os dados gravados após a criação do analytical store. Este é o modo padrão.

    • SYNC_TYPE_INCR: sincroniza apenas os dados gravados após a criação do analytical store.

Importante
  • Não é possível alterar o modo de sincronização após a criação do analytical store. Selecione o modo conforme a necessidade de analisar dados históricos.

  • Crie apenas um analytical store por tabela de séries temporais. Uma tabela de séries temporais pode ter, no total, até 10 índices Lastpoint e analytical stores combinados.

O exemplo de código a seguir cria um analytical store chamado example_analytical_store para a tabela example_timeseries_table. Os dados no analytical store não expiram e a sincronização completa está habilitada.

TimeseriesClient timeseriesClient = client.asTimeseriesClient();

TimeseriesAnalyticalStore analyticalStore =
        new TimeseriesAnalyticalStore("example_analytical_store");
analyticalStore.setTimeToLive(-1);
analyticalStore.setSyncOption(AnalyticalStoreSyncType.SYNC_TYPE_FULL);

CreateTimeseriesAnalyticalStoreRequest request =
        new CreateTimeseriesAnalyticalStoreRequest(
                "example_timeseries_table", analyticalStore);

timeseriesClient.createTimeseriesAnalyticalStore(request);

Após a criação do analytical store, a sincronização dos dados ocorre em segundo plano. Para verificar o status da sincronização, chame describeTimeseriesAnalyticalStore. Para mais detalhes, consulte Query analytical store information.

Parâmetros

CreateTimeseriesAnalyticalStoreRequest contém os seguintes parâmetros.

Nome

Tipo

Descrição

timeseriesTableName (obrigatório)

String

Nome da tabela de séries temporais.

analyticalStore (obrigatório)

TimeseriesAnalyticalStore

Configuração do analytical store.

Configuração do analytical store

O parâmetro analyticalStore é do tipo TimeseriesAnalyticalStore e possui os seguintes parâmetros.

Nome

Tipo

Descrição

analyticalStoreName (obrigatório)

String

Nome do analytical store.

timeToLive (opcional)

int

TTL do analytical store em segundos. Valor padrão: -1. Defina o valor como -1 ou um inteiro int32 de pelo menos 2592000. O valor -1 indica que os dados não expiram. O Tablestore determina a expiração dos dados com base nos timestamps das colunas de dados, e não no momento da gravação, e exclui automaticamente os dados expirados.

syncOption (opcional)

AnalyticalStoreSyncType

Modo de sincronização de dados. Valor padrão: SYNC_TYPE_FULL. Valores válidos: SYNC_TYPE_FULL e SYNC_TYPE_INCR.