Todos os produtos
Search
Central de documentação

Tablestore:Operações em tabelas de séries temporais

Última atualização: Jul 03, 2026

O modelo TimeSeries utiliza tabelas de séries temporais para armazenar dados desse tipo. Uma única tabela suporta gravações e consultas de alta concorrência, além do armazenamento de petabytes de dados a baixo custo. Este tópico descreve como criar e gerenciar tabelas de séries temporais.

Observações de uso

  • É possível criar no máximo 64 tabelas em uma única instância. Esse total inclui tabelas de dados, índices secundários, tabelas de séries temporais, índices Lastpoint e analytical stores. Para mais informações sobre os limites, consulte Limites do modelo TimeSeries.

    Nota

    Uma tabela de séries temporais compreende dois componentes: uma tabela de metadados e uma tabela de dados. Ao calcular o número total de tabelas em uma instância, o sistema conta cada tabela de séries temporais como duas tabelas separadas.

  • O modelo TimeSeries tem suporte nas seguintes regiões: China (Hangzhou), China (Xangai), China (Pequim), China (Zhangjiakou), China (Ulanqab), China (Shenzhen), China (Chengdu), China (Hong Kong), Japão (Tóquio), Malásia (Kuala Lumpur), Alemanha (Frankfurt), Indonésia (Jacarta), Reino Unido (Londres), EUA (Vale do Silício), EUA (Virgínia), Arábia Saudita (Riade - Região Parceira), e Singapura.

  • Especifique identificadores e campos de dados personalizados como colunas de chave primária e utilize os recursos de índice Lastpoint e analytical store nas seguintes regiões: China (Hangzhou), China (Xangai), China (Pequim) e China (Zhangjiakou).

Recursos

A tabela a seguir descreve os recursos compatíveis com as tabelas de séries temporais.

Recurso

Descrição

Criar uma tabela de séries temporais

Ao criar a tabela, especifique as configurações relacionadas a ela e aos metadados da série temporal. Além disso, defina identificadores e campos de dados personalizados como colunas de chave primária, crie um analytical store e configure um índice Lastpoint conforme as necessidades do negócio.

Atualizar uma tabela de séries temporais

Modifique informações de configuração, como o tempo de vida (TTL) da tabela. Altere também as configurações dos metadados, incluindo o TTL dos metadados e a permissão para modificar colunas de atributos da tabela de metadados.

Consultar tabelas de séries temporais

Liste os nomes e as configurações de todas as tabelas de séries temporais na instância atual.

Consultar informações de uma tabela de séries temporais

Visualize o status e detalhes de configuração, como o TTL da tabela. Consulte também dados sobre os metadados, como seu TTL e se as colunas de atributos podem ser alteradas.

Excluir uma tabela de séries temporais

Remova permanentemente uma tabela de séries temporais existente.

Procedimento

Criar uma tabela de séries temporais

Execute as operações a seguir para criar uma tabela de séries temporais no console do Tablestore.

  1. Acesse a página Instance Management.

    1. Faça login no console do Tablestore.

    2. Na barra de navegação superior, selecione um grupo de recursos e uma região.

    3. Na página Overview, clique em Manage Instance na coluna Actions da instância desejada.

  2. Na aba Instance Details, clique em Time Series Tables.

  3. Na aba Time Series Tables, clique em Create Time Series Table.

    Nota

    Alternativamente, clique em Generate Demo with One Click para criar uma tabela de teste com dados de amostra e experimentar rapidamente os recursos. O sistema executa operações específicas de inicialização para novas tabelas de teste. Aguarde algumas dezenas de segundos até que a série temporal seja exibida.

  4. Na caixa de diálogo Create Time Series Table, configure os parâmetros. A tabela abaixo detalha cada opção.

    Parâmetro

    Descrição

    Name

    Nome da tabela de séries temporais, utilizado para identificá-la exclusivamente na instância.

    • Deve ter entre 1 e 128 caracteres, contendo apenas letras, dígitos e sublinhados (_). É obrigatório iniciar com uma letra ou sublinhado (_).

    • O nome precisa ser diferente de qualquer tabela de dados, índice secundário ou outra tabela de séries temporais já existente na instância atual.

    Time to Live

    Período de retenção dos dados na tabela, medido em segundos. O valor mínimo é 86.400 segundos (um dia). Defina como -1 para indicar que os dados nunca expiram.

    Caso a diferença entre o horário atual e o timestamp fornecido à coluna de dados ultrapasse o TTL definido, o sistema exclui automaticamente os registros vencidos.

    Nota

    Em tabelas de séries temporais, o momento de geração do dado é determinado pela coluna de tempo informada na ingestão, e não pelo instante da gravação no banco.

    Time Series Identifier

    Nota

    Este parâmetro só fica disponível quando a chave Custom Time Series Identifiers and Primary Key está ativada.

    Por padrão, os identificadores são formados pelo nome da métrica, fonte de dados e tags. Se necessário, defina identificadores personalizados conforme sua regra de negócio. Para mais detalhes, veja Especificar identificadores personalizados de séries temporais.

    • O nome do campo identificador personalizado deve conter apenas letras minúsculas, dígitos e sublinhados (_), sem começar por dígito. O tamanho permitido varia de 1 a 128 bytes.

    • São aceitos até seis campos de identificação customizados.

    Utilize o botão Add Time Series Identifier para adicionar múltiplos campos. Para remover um campo, clique em ao lado dele.

    Importante

    Após a criação da tabela, não é mais possível alterar os campos identificadores personalizados. Configure com atenção.

    Primary Key Fields

    Nota

    Esta opção só pode ser ajustada se a chave Custom Time Series Identifiers and Primary Key estiver ligada.

    Para armazenar várias linhas com os mesmos identificadores e timestamp, utilize campos de dados customizados como chaves primárias. Consulte Especificar identificadores e campos de dados personalizados como colunas de chave primária para saber mais.

    • Campos usados como chave primária devem ter nomes compostos por letras minúsculas, números e sublinhados (_), iniciando sempre com letra ou sublinhado. Limite de 1 a 128 bytes.

    • No máximo quatro campos de dados podem atuar como chave primária.

    • Os tipos de dados aceitos para essas colunas são STRING ou INTEGER.

    Adicione novos campos clicando em Add Primary Key Field. Remova um campo existente através do ícone fig_20221020_delete correspondente.

    Importante

    Depois que a tabela for criada, as colunas definidas como chave primária não poderão ser modificadas. Tenha cautela.

    Create Analytical Store

    O analytical store permite armazenar dados de séries temporais com baixo custo e realizar consultas analíticas rápidas. Esse recurso é ideal para retenção prolongada e análise histórica. Veja mais em Analytical store.

    A opção Create Analytical Store vem habilitada por padrão. Ajuste conforme necessário.

    • Desative a chave Create Analytical Store caso não precise dessa funcionalidade.

    • Mantenha a configuração padrão da chave Create Analytical Store para provisionar um repositório analítico padrão.

    • Para personalizar o analytical store, mantenha a chave Create Analytical Store ativa, ligue a opção Advanced Settings e preencha os campos Name e TTL.

    Create LastPoint Index

    Índices Lastpoint servem para recuperar rapidamente o estado mais recente de cada série temporal dentro da tabela. Eles aceleram o acesso ao ponto de dados mais atual. Saiba mais em Lastpoint index.

    A chave Create LastPoint Index inicia desativada. Altere essa configuração segundo seus requisitos.

    • Se não precisar desse índice, deixe a chave Create LastPoint Index desligada.

    • Para habilitá-lo, ative a chave Create LastPoint Index e informe o parâmetro LastPoint Index Name.

      Nota
      • O nome do índice deve conter letras, números e sublinhados (_), não podendo começar com número. Tamanho entre 1 e 128 bytes.

      • A soma de índices Lastpoint e analytical stores associados a uma mesma tabela não pode passar de 10.

  5. Clique em Create.

    Após a criação, a nova tabela aparecerá na aba Time Series Tables. Caso ela não surja imediatamente na lista, clique em fig_tablestore_002 para atualizar a visualização.

Gerenciar tabelas de séries temporais

Realize as operações correspondentes para gerenciar as tabelas de acordo com suas necessidades.

Recurso

Descrição

Listar tabelas de séries temporais

Na aba Time Series Tables, visualize todas as tabelas de séries temporais da instância.

Modificar o TTL dos dados

  1. Na aba Time Series Tables, clique em Time Series Tables que deseja gerenciar.

  2. Na seção Description da aba Basic Information, clique em ao lado do parâmetro Data Lifecycle.

  3. Altere o valor do TTL na caixa de diálogo exibida.

    Esse valor representa o período de retenção dos dados em segundos. O mínimo é 86.400 segundos (um dia). Use -1 para definir que os dados nunca expiram.

    Nota

    Após a atualização do TTL, o Tablestore remove assincronamente os registros cujo tempo de retenção tenha sido excedido.

  4. Clique em Yes.

Modificar o TTL dos metadados

  1. Na aba Time Series Tables, selecione a tabela alvo.

  2. Dentro da seção Description da aba Basic Information, clique em próximo ao parâmetro TTL of Time Series Metadata.

  3. Edite o TTL dos metadados na janela que se abriu.

    Define quanto tempo os metadados são retidos, em segundos. O valor mínimo é 604.800 segundos (sete dias). Configure como -1 para retenção infinita.

    Nota
    • O padrão é -1, indicando que os metadados nunca expiram.

      • O TTL dos metadados deve ser sempre maior ou igual ao TTL dos dados da tabela.

      • Ao mudar o TTL dos metadados para um valor finito (mínimo de 604.800 segundos), certifique-se de que sua lógica de negócio não exige atualizações nos atributos dos metadados e defina Whether to Update Attributes of Time Series Metadata como No.

      • Caso precise manter Whether to Update Attributes of Time Series Metadata como Yes, o TTL dos metadados obrigatoriamente deve permanecer em -1.

    • Quando o TTL dos metadados é atualizado, o Tablestore apaga assincronamente as séries temporais expiradas, mas preserva os dados correspondentes. Você ainda poderá consultar esses dados usando os identificadores da série.

  4. Confirme clicando em Yes.

Definir permissão de alteração nos atributos dos metadados

  1. Na aba Time Series Tables, escolha a tabela desejada.

  2. Localize a seção Description na aba Basic Information e clique em ao lado de Whether to Update Attributes of Time Series Metadata.

  3. Na caixa de diálogo, indique se as atualizações nos atributos dos metadados serão permitidas.

    Nota

    Para permitir tais alterações, é mandatório configurar o TTL of Time Series Metadata como -1, garantindo que os metadados nunca expirem.

  4. Finalize clicando em Yes.

Consultar informações da tabela

  1. Na aba Time Series Tables, clique em Time Series Tables que deseja inspecionar.

  2. Verifique os detalhes nas seções Description, Time Series Identifier, Primary Key Fields, Analytical Store e LastPoint Index da aba Basic Information.

Excluir uma tabela de séries temporais

  1. Na aba Time Series Tables, localize a tabela e clique em Delete na coluna Actions.

  2. Na mensagem de confirmação, clique em OK.

    Importante
    • A exclusão é irreversível. Proceda com cuidado.

    • Ao remover a tabela, o sistema apaga automaticamente todos os analytical stores e índices Lastpoint vinculados a ela.

Integração de desenvolvimento

Recurso

Método de chamada

Criar uma tabela de séries temporais

Atualizar uma tabela de séries temporais

Listar tabelas de séries temporais

Consultar informações de uma tabela de séries temporais

Excluir uma tabela de séries temporais