Todos os produtos
Search
Central de documentação

Tablestore:Gerencie tabelas de séries temporais

Última atualização: Aug 26, 2026

O modelo TimeSeries usa tabelas de séries temporais para armazenar dados desse tipo. Uma única tabela suporta gravações e consultas de alta concorrência e oferece armazenamento de baixo custo para petabytes de dados. 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 limite inclui tabelas de dados, índices secundários, tabelas de séries temporais, índices Lastpoint e analytical stores. Para mais informações sobre limites, consulte Limits of the TimeSeries model.

    Nota

    Uma tabela de séries temporais consiste em uma tabela de metadados e uma tabela de dados de séries temporais. Portanto, cada tabela de séries temporais conta como duas tabelas no limite da instância.

  • O modelo TimeSeries está disponível nas seguintes regiões: China (Hangzhou), China (Shanghai), China (Beijing), China (Zhangjiakou), China (Ulanqab), China (Shenzhen), China (Chengdu), China (Hong Kong), Japan (Tokyo), Malaysia (Kuala Lumpur), Germany (Frankfurt), Indonesia (Jakarta), UK (London), US (Silicon Valley), US (Virginia), SAU (Riyadh - Partner Region), e Singapore.

  • A personalização de identificadores de séries temporais, o uso de campos de dados como campos de chave primária e a criação de índices Lastpoint e analytical stores estão disponíveis nas seguintes regiões: China (Hangzhou), China (Shanghai), China (Beijing) 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 uma tabela de séries temporais, especifique as configurações da tabela e de seus metadados. Também é possível personalizar o identificador da série temporal, definir campos de dados como campos de chave primária, criar um analytical store e criar um índice Lastpoint conforme as necessidades do negócio.

Atualizar uma tabela de séries temporais

Modifique o tempo de vida (TTL) de uma tabela de séries temporais e atualize as configurações de seus metadados, como o TTL dos metadados e a permissão para atualização de atributos.

Listar tabelas de séries temporais

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

Descrever uma tabela de séries temporais

Consulte os detalhes de configuração de uma tabela de séries temporais, como TTL e status, além das configurações de metadados, como o TTL dos metadados e a possibilidade de atualização de atributos.

Excluir uma tabela de séries temporais

Exclua uma tabela de séries temporais específica.

Procedimento

Criar uma tabela de séries temporais

Siga estas etapas 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 no alias de uma instância ou clique em Manage Instance na coluna Actions da instância desejada.

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

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

    Nota

    Você também pode clicar 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 em tabelas de teste recém-criadas. Aguarde algumas dezenas de segundos até que a série temporal apareça.

  4. Na caixa de diálogo Create Time Series Table, configure os parâmetros da tabela de séries temporais.

    Parâmetro

    Descrição

    Nome da tabela de séries temporais

    Nome da tabela de séries temporais. O nome deve ser único na instância.

    • O nome deve ter entre 1 e 128 caracteres, conter apenas letras, dígitos e sublinhados (_) e começar com uma letra ou um sublinhado (_).

    • O nome da tabela não pode ser igual ao de nenhuma tabela de dados, índice secundário ou outra tabela de séries temporais existente na instância atual.

    Tempo de vida (TTL)

    Período de retenção dos dados na tabela de séries temporais, em segundos. O valor mínimo é 86400 (1 dia). Defina este parâmetro como -1 para indicar que os dados nunca expiram.

    O sistema exclui automaticamente os pontos de dados que excedem o TTL especificado.

    Nota

    O sistema determina o horário de geração dos dados com base na coluna de tempo fornecida pelo usuário, e não no momento em que os dados são gravados na tabela.

    Identificador de série temporal

    Nota

    Este parâmetro só é configurável quando você ativa Custom Time Series Identifiers and Primary Key.

    Por padrão, um identificador de série temporal consiste em um nome de métrica, uma fonte de dados e tags. Você pode definir um identificador de série temporal personalizado para atender aos requisitos específicos do seu negócio.

    • O nome de um campo de identificador de série temporal personalizado deve ter entre 1 e 128 bytes, conter apenas letras minúsculas, dígitos e sublinhados (_) e não pode começar com um dígito.

    • É possível especificar no máximo seis campos de identificador de série temporal personalizados.

    Clique em Add Time Series Identifier para adicionar vários campos de identificador personalizados. Para remover um campo, clique em no ícone fig_20221020_delete ao lado dele.

    Importante

    Não é possível modificar os campos de identificador de série temporal personalizados após a criação da tabela. Proceda com cautela.

    Campos de chave primária

    Nota

    Este parâmetro só é configurável quando você ativa Custom Time Series Identifiers and Primary Key.

    Se o seu negócio exigir o armazenamento de diferentes dados de séries temporais para o mesmo identificador e timestamp, você pode configurar campos de dados como parte da chave primária.

    • O nome de um campo de chave primária deve ter entre 1 e 128 bytes, conter apenas letras minúsculas, dígitos e sublinhados (_) e não pode começar com um dígito.

    • É possível especificar no máximo quatro campos de dados como campos de chave primária.

    • O tipo de dado de um campo de chave primária pode ser STRING ou INTEGER.

    Clique em Add Primary Key Field para adicionar vários campos de chave primária. Para remover um campo, clique em no ícone fig_20221020_delete ao lado dele.

    Importante

    Não é possível modificar os campos de chave primária após a criação da tabela. Proceda com cautela.

    Criar analytical store

    Um analytical store foi projetado para armazenamento de longo prazo e análise de dados de séries temporais. Ele ajuda a armazenar dados de séries temporais a um baixo custo e permite consultas e análises rápidas.

    Por padrão, a opção de criar um analytical store está ativada. Configure-a conforme as necessidades do seu negócio.

    • Se você não precisar de um analytical store, desative a chave Create Analytical Store.

    • Para criar um analytical store padrão, mantenha a chave Create Analytical Store ativada.

    • Para criar um analytical store personalizado, mantenha a chave Create Analytical Store ativada, ative a chave Advanced Settings e configure o Name e o TTL.

    Criar índice Lastpoint

    Um Lastpoint index foi projetado para recuperar rapidamente o estado mais recente de cada série temporal em uma tabela. Isso é útil para buscar o ponto de dados mais recente de alvos monitorados.

    Por padrão, a opção de criar um índice Lastpoint está desativada. Configure-a conforme as necessidades do seu negócio.

    • Se você não precisar de um índice Lastpoint, mantenha a configuração padrão.

    • Para criar um índice Lastpoint, ative a chave Create LastPoint Index e especifique um LastPoint Index Name.

      Nota
      • O nome do índice deve ter entre 1 e 128 bytes, pode conter letras, dígitos e sublinhados (_) e não pode começar com um dígito.

      • O número total de índices Lastpoint e analytical stores em uma tabela de séries temporais não pode exceder 10.

  5. Clique em Create.

    Após a criação da tabela, visualize-a na aba Time Series Tables. Se a nova tabela não aparecer na lista, clique em no ícone fig_tablestore_002 para atualizá-la.

Gerenciar tabelas de séries temporais

Use os procedimentos a seguir para gerenciar suas tabelas de séries temporais.

Tarefa

Descrição

Listar tabelas de séries temporais

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

Atualizar o TTL de dados

  1. Na aba Time Series Tables, clique em no nome da tabela de séries temporais.

  2. Na aba Basic Information, na seção Description, clique em no ícone de edição image.png ao lado de Data Lifecycle.

  3. Na caixa de diálogo exibida, modifique o TTL dos dados.

    O tempo de vida (TTL) é o período de retenção dos dados, em segundos. O valor mínimo é 86400 (1 dia). Defina-o como -1 para indicar que os dados nunca expiram.

    Nota

    Após a atualização do TTL de uma tabela de séries temporais, o Tablestore exclui automática e assincronamente quaisquer dados que excedam o novo TTL.

  4. Clique em OK.

Atualizar o TTL de metadados

  1. Na aba Time Series Tables, clique em no nome da tabela de séries temporais.

  2. Na aba Basic Information, na seção Description, clique em no ícone de edição image.png ao lado de TTL of Time Series Metadata.

  3. Na caixa de diálogo exibida, modifique o TTL dos metadados.

    Período de retenção dos metadados de séries temporais, em segundos. O valor mínimo é 604800 (7 dias). Defina-o como -1 para indicar que os metadados nunca expiram.

    Nota
    • O TTL padrão para metadados de séries temporais é -1 (nunca expira).

      • O TTL dos metadados de séries temporais deve ser maior ou igual ao TTL dos dados da tabela.

      • Se você definir o TTL dos metadados com um valor diferente de -1, defina Whether to Update Attributes of Time Series Metadata como No e garanta que a lógica do seu aplicativo não exija atualizações de atributos de metadados.

      • Se você definir Whether to Update Attributes of Time Series Metadata como Yes, defina o TTL dos metadados como -1 (nunca expira).

    • Após a atualização do TTL dos metadados, o Tablestore exclui automática e assincronamente quaisquer metadados de séries temporais que excedam o novo TTL. Os dados correspondentes da série temporal não são excluídos e ainda podem ser consultados pelo identificador da série temporal.

  4. Clique em OK.

Atualizar configurações de atributos de metadados

  1. Na aba Time Series Tables, clique em no nome da tabela de séries temporais.

  2. Na aba Basic Information, na seção Description, clique em no ícone de edição image.png ao lado de Whether to Update Attributes of Time Series Metadata.

  3. Na caixa de diálogo exibida, selecione se deseja permitir atualizações nos atributos de metadados.

    Nota

    Se você permitir atualizações nos atributos de metadados, defina o TTL dos metadados como -1 (nunca expira).

  4. Clique em Yes.

Descrever uma tabela de séries temporais

  1. Na aba Time Series Tables, clique em no nome da tabela de séries temporais.

  2. Na aba Basic Information, visualize os detalhes nas seções Basic Information, Time series identifier, Primary key fields, Analytical store e Lastpoint index.

Excluir uma tabela de séries temporais

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

  2. Na caixa de diálogo de confirmação, clique em OK.

    Importante
    • Esta operação é irreversível. Não é possível recuperar uma tabela de séries temporais excluída. Proceda com cautela.

    • A exclusão de uma tabela de séries temporais também exclui automaticamente seus analytical stores e índices Lastpoint associados.

Integração de desenvolvimento

Recurso

Método

Criar uma tabela de séries temporais

Atualizar uma tabela de séries temporais

Listar tabelas de séries temporais

Descrever uma tabela de séries temporais

Excluir uma tabela de séries temporais