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.
NotaUma 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.
-
Acesse a página Instance Management.
Faça login no console do Tablestore.
Na barra de navegação superior, selecione um grupo de recursos e uma região.
Na página Overview, clique em Manage Instance na coluna Actions da instância desejada.
Na aba Instance Details, clique em Time Series Tables.
-
Na aba Time Series Tables, clique em Create Time Series Table.
NotaAlternativamente, 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.
-
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.
NotaEm 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
NotaEste 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.
ImportanteApós a criação da tabela, não é mais possível alterar os campos identificadores personalizados. Configure com atenção.
Primary Key Fields
NotaEsta 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
correspondente.ImportanteDepois 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.
NotaO 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.
-
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
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 |
|
Modificar o TTL dos metadados |
|
Definir permissão de alteração nos atributos dos metadados |
|
Consultar informações da tabela |
|
Excluir uma tabela de séries temporais |
|
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 |