Perguntas frequentes sobre como escrever e consultar dados para o Amazon Timestream for InfluxDB 3

Perguntas sobre como gravar e consultar dados do Amazon Timestream para InfluxDB 3, APIs incluindo suporte, linguagens de consulta e autenticação. Para guias completos, consulte Gravar dados em seu cluster Timestream para InfluxDB 3 Consultar dados do Timestream para InfluxDB 3 e.

Como faço para gravar dados no InfluxDB 3?

O InfluxDB 3 suporta vários métodos de gravação: a API de gravação v3 nativa, a API de compatibilidade do InfluxDB v2 e a API de compatibilidade do InfluxDB v1. Todos os métodos aceitam o formato de protocolo de linha. As bibliotecas oficiais do cliente estão disponíveis para Python, Go JavaScript, Java e C#. Para obter instruções detalhadas de gravação, consulte o guia de dados de gravação do InfluxDB 3 Enterprise.

Quais linguagens de consulta o InfluxDB 3 suporta?

O InfluxDB 3 suporta SQL e InfluxQL por meio da API de consulta HTTP v3. SQL é a principal linguagem de consulta, alimentada pelo DataFusion mecanismo Apache. O InfluxQL é compatível com versões anteriores. Você também pode consultar usando a ferramenta influxdb3 CLI. Para obter exemplos e sintaxe de consulta, consulte o guia de dados de consulta do InfluxDB 3 Enterprise.

Exemplo de consulta SQL:

SELECT time, temperature, location
FROM weather
WHERE time > now() - INTERVAL '1 hour'
ORDER BY time DESC
LIMIT 100

Como a autenticação funciona para consultas?

O InfluxDB 3 usa autenticação baseada em tokens. Ao configurar seu cluster pela primeira vez, você cria uma conta de usuário principal e uma senha. Na edição Enterprise, você pode criar vários tokens com diferentes níveis de acesso:

• Tokens de administração — conceda acesso total a todas as ações do servidor, incluindo comandos CLI e endpoints de API. O primeiro token de administrador criado é o token do operador, que tem privilégios administrativos completos.

• Tokens de recursos — conceda permissões granulares em recursos específicos, como bancos de dados e tabelas individuais. Você pode atribuir acesso somente leitura, somente gravação ou leitura por banco de dados, permitindo um controle de acesso refinado para diferentes aplicativos e usuários.

Os tokens funcionam com a API de consulta HTTP v3, a influxdb3 CLI e a compatibilidade v1/v2. APIs Para obter mais detalhes, consulte a documentação de gerenciamento de tokens do InfluxDB 3 Enterprise.

Posso gerenciar bancos de dados e tabelas por meio do plano de dados?

Sim. No InfluxDB 3 Enterprise, você pode criar, listar e excluir bancos de dados e tabelas diretamente usando a influxdb3 CLI ou a API HTTP. Você também pode gerenciar caches de último valor, caches de valores distintos e índices de arquivos personalizados para otimização de consultas. Essas operações de plano de dados permitem que você administre seu cluster sem usar o. Console de gerenciamento da AWS Para obter a lista completa de operações administrativas, consulte o guia de administração do InfluxDB 3 Enterprise.

Por que minha consulta está retornando um erro 401 não autorizado?

Um erro 401 significa que seu token de autenticação está ausente, expirou ou não tem as permissões necessárias. Verifique se você está passando o token no Authorization: Bearer cabeçalho (ou por meio da variável de INFLUXDB3_AUTH_TOKEN ambiente da CLI). Se estiver usando tokens de recursos, confirme se o token tem permissão de leitura no banco de dados de destino. Regenere o token se ele tiver sido revogado.

Por que minhas consultas estão lentas?

As causas comuns incluem escanear muitos arquivos do Parquet (verificaçãoquery-file-limit), DataFusion threads insuficientes para o tamanho da instância ou um cache de memória frio do Parquet após uma reinicialização. Para clusters corporativos, verifique se a compactação está em execução — sem compactação, arquivos pequenos se acumulam e degradam o desempenho da consulta. Consulte Referência detalhada de parâmetros para obter orientações de ajuste.

O que é protocolo de linha?

O protocolo de linha é um formato baseado em texto para gravar dados de séries temporais no InfluxDB. Cada linha representa um único ponto de dados com um nome de medida, conjunto de tags opcional, conjunto de campos e registro de data e hora opcional. Para obter a especificação completa, consulte a referência do protocolo de linha InfluxDB 3.

Exemplo de protocolo de linha:

weather,location=us-east,station=A1 temperature=82.0,humidity=71.2 1465839830100400200
weather,location=us-west,station=B2 temperature=68.5,humidity=45.8 1465839830100400200