Para recursos semelhantes aos do Amazon Timestream para, considere o Amazon Timestream LiveAnalytics para InfluxDB. Ele oferece ingestão de dados simplificada e tempos de resposta de consulta de um dígito em milissegundos para análises em tempo real. Saiba mais aqui.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Conectar a uma instância de banco de dados Amazon Timestream para InfluxDB

Antes de se conectar a uma instância de banco de dados, você deve criar a instância de banco de dados. Para obter mais informações, consulte Criar uma instância de banco de dados. Depois que o Amazon Timestream provisionar sua instância de banco de dados, use a API do InfluxDB, o Influx CLI ou qualquer cliente ou utilitário compatível para o InfluxDB e conecte-se à instância de banco de dados.

Localizando as informações de conexão para uma instância de DB do Amazon Timestream para InfluxDB

As informações de conexão de uma instância de banco de dados incluem seu endpoint, porta, nome de usuário, senha e um token de acesso válido, como o operador ou o token de acesso total. Por exemplo, para uma instância de banco de dados Timestream for InfluxDB, suponha que o valor do endpoint seja c5vasdqn0b-3ksj4dla5nfjhi.timestream-influxdb.us-east-1.on.aws. Nesse caso, o valor da porta é 8086, e o usuário do banco de dados é admin. Com essas informações, para acessar a instância, você usará:

As instâncias criadas antes de 9 de dezembro de 2024 terão um endpoint que contém o nome da instância em vez do ID da instância. Por exemplo: influxdb1-123456789.us-east-1.timestream-influxdb.amazonaws.com.

O endpoint é exclusivo para cada instância de banco de dados e os valores da porta e do usuário podem variar. Para se conectar a uma instância de banco de dados, você pode usar a CLI Influx, a API do InfluxDB ou qualquer cliente compatível com o InfluxDB.

Para encontrar as informações de conexão de uma instância de banco de dados, use o AWS Management Console. Você também pode usar o AWS comando Command Line Interface (AWS CLI) describe-db-instances ou o Timestream para a operação da API InfluxDB. GetDBInstance

Se você precisar encontrar as informações de nome de usuário e senha, escolha a guia Detalhes da configuração e escolha influxAuthParametersSecretArn para acessar seu Secrets Manager.

Criação de um token de acesso

Com essas informações, você poderá se conectar à sua instância para recuperar ou criar seus tokens de acesso. Há várias maneiras de fazer isso:

O exemplo a seguir usa curl e a API InfluxDB para gerar um token de acesso total:

export INFLUX_HOST=https://instanceid-123456789.timestream-influxdb.us-east-1.on.aws
export INFLUX_ORG_ID=<YOUR_INFLUXDB_ORG_ID>
export INFLUX_TOKEN=<YOUR_INFLUXDB_OPERATOR_TOKEN>

curl --request POST \
"$INFLUX_HOST/api/v2/authorizations" \
  --header "Authorization: Token $INFLUX_TOKEN" \
  --header "Content-Type: text/plain; charset=utf-8" \
  --data '{
    "status": "active",
    "description": "All access token for get started tutorial",
    "orgID": "'"$INFLUX_ORG_ID"'",
    "permissions": [
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "authorizations"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "authorizations"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "buckets"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "buckets"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dashboards"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dashboards"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "orgs"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "orgs"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "sources"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "sources"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "tasks"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "tasks"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "telegrafs"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "telegrafs"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "users"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "users"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "variables"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "variables"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "scrapers"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "scrapers"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "secrets"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "secrets"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "labels"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "labels"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "views"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "views"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "documents"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "documents"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationRules"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationRules"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationEndpoints"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationEndpoints"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "checks"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "checks"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dbrp"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dbrp"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notebooks"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notebooks"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "annotations"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "annotations"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "remotes"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "remotes"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "replications"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "replications"}}
    ]
  }
'

Opções de autenticação do banco de dados

O Amazon Timestream para InfluxDB suporta as seguintes maneiras de autenticar usuários do banco de dados:

Conexões criptografadas

É possível usar o Security Socket Layer (SSL) ou o Transport Layer Security (TLS) na aplicação para criptografar uma conexão com a uma instância de banco de dados. Os certificados necessários para o handshake TLS entre o InfluxDB e os aplicativos criados e gerenciados pelo serviço Kronos. Quando o certificado é renovado, a instância é atualizada automaticamente com a versão mais recente sem exigir nenhuma intervenção do usuário.

Trabalhar com grupos de parâmetros

Parâmetros do banco de dados especificam como o banco de dados é configurado. Por exemplo, os parâmetros do banco de dados podem especificar a quantidade de recursos, como memória, a serem alocados para um banco de dados.

Você gerencia a configuração do banco de dados associando suas instâncias de banco de dados com grupos de parâmetros. O Amazon Timestream para InfluxDB define grupos de parâmetros com configurações padrão. Você também pode definir seus próprios grupos de parâmetros com configurações personalizadas.

Visão geral dos grupos de parâmetros

Um grupo de parâmetros de banco de dados atua como um contêiner para valores de configuração de mecanismo que são aplicados a uma ou mais instâncias de bancos de dados.

Grupos de parâmetros padrão e personalizados

As instâncias de banco de dados usam grupos de parâmetros de banco de dados. As seções a seguir descrevem a configuração e o gerenciamento de grupos de parâmetros de instância de banco de dados.

Criar um grupo de parâmetros de banco de dados

Você pode criar um novo grupo de parâmetros de banco de dados usando a API Console de gerenciamento da AWS AWS Command Line Interface, the ou Timestream.

As seguintes limitações se aplicam ao nome do grupo de parâmetros de banco de dados:

Não é possível modificar as configurações de parâmetros de um grupo de parâmetros padrão. Em vez disso, você pode fazer o seguinte:

Parâmetros estáticos e dinâmicos de instância de banco de dados

Os parâmetros da instância de banco de dados InfluxDB são sempre estáticos. Eles se comportam da seguinte maneira:

Quando você altera um parâmetro estático e salva o grupo de parâmetros do banco de dados da instância, a alteração do parâmetro entra em vigor automaticamente depois que você reinicia a instância.

Ao associar um novo grupo de parâmetros de banco de dados a uma instância de banco de dados, o Timestream aplica os parâmetros estáticos modificados somente após a reinicialização da instância de banco de dados. Atualmente, a única opção é aplicar imediatamente.

Para obter mais informações sobre como alterar o grupo de parâmetros de banco de dados, consulte Atualizar instâncias de banco de dados.

Parâmetros e valores de parâmetros compatíveis

Para determinar os parâmetros compatíveis para sua instância de banco de dados, visualize os parâmetros no grupo de parâmetros de banco de dados usado pela instância de banco de dados. Para obter mais informações, consulte Visualizar valores de parâmetros para um grupo de parâmetros de banco de dados.

Para obter mais informações sobre todos os parâmetros suportados pela versão de código aberto do InfluxDB, consulte as opções de configuração do InfluxDB. Atualmente você só poderá modificar os seguintes parâmetros do InfluxDB:

Definir incorretamente os parâmetros em um grupo de parâmetros pode causar efeitos adversos não intencionais, inclusive diminuição da performance e instabilidade no sistema. Sempre tenha cuidado ao modificar os parâmetros do banco de dados. Teste alterações de configuração de grupos de parâmetros em uma instância de banco de dados de teste antes de aplicar essas alterações de grupos de parâmetros a uma instância de banco de dados de produção.

Trabalhar com grupos de parâmetros de banco de dados

As instâncias de banco de dados usam grupos de parâmetros de banco de dados. As seções a seguir descrevem a configuração e o gerenciamento de grupos de parâmetros de instância de banco de dados.

Criar um grupo de parâmetros de banco de dados

Associando um grupo de parâmetros de banco de dados a uma instância de banco de dados

Você pode criar seus próprios grupos de parâmetros de banco de dados com configurações personalizadas. Você pode associar um grupo de parâmetros de banco de dados a uma instância de banco de dados usando a API Console de gerenciamento da AWS AWS Command Line Interface, the ou Timestream for InfluxDB. Você pode fazer isso ao criar ou modificar uma instância de banco de dados.

Para obter mais informações sobre como criar um parameter group de banco de dados, consulte Criar um grupo de parâmetros de banco de dados. Para obter informações sobre como criar uma instância de banco de dados, consulte Criar uma instância de banco de dados. Para mais informações sobre a modificação de uma instância de banco de dados , consulte Atualizar instâncias de banco de dados.

Usando o AWS Command Line Interface

Para Linux, macOS ou Unix:

aws timestream-influxdb update-db-instance 
--identifier YOUR_DB_INSTANCE_ID \
--region YOUR_REGION \
--db-parameter-group-identifier YOUR_PARAM_GROUP_ID \
--log-delivery-configuration "{\"s3Configuration\": {\"bucketName\": \"${LOGGING_BUCKET}\", \"enabled\": false }}"

Para Windows:

aws timestream-influxdb update-db-instance 
--identifier YOUR_DB_INSTANCE_ID ^
--region YOUR_REGION ^
--db-parameter-group-identifier YOUR_PARAM_GROUP_ID ^
--log-delivery-configuration "{\"s3Configuration\": {\"bucketName\": \"${LOGGING_BUCKET}\", \"enabled\": false }}"
                        
 

Listar grupos de parâmetros de banco de dados

Você pode listar os grupos de parâmetros de banco de dados que você criou para sua AWS conta.

Usando o AWS Command Line Interface

Para listar todos os grupos de parâmetros de banco de dados de uma AWS conta, use o AWS Command Line Interface list-db-parameter-groups comando.

aws timestream-influxdb list-db-parameter-groups --region region

Para retornar grupos de parâmetros de banco de dados específicos para uma AWS conta, use o AWS Command Line Interface get-db-parameter-group comando.

aws timestream-influxdb get-db-parameter-group --region region --identifier identifier

Visualizar valores de parâmetros para um grupo de parâmetros de banco de dados

Você pode obter uma lista de todos os parâmetros em um grupo de parâmetros de banco de dados e seus valores.

Usando o AWS Command Line Interface

Para visualizar os valores dos parâmetros de um grupo de parâmetros do banco de dados, use o AWS Command Line Interface get-db-parameter-group comando. parameter-group-identifierSubstitua por suas próprias informações.

get-db-parameter-group --identifier parameter-group-identifier

Uso da API

Para visualizar os valores de parâmetros para um grupo de parâmetro de banco de dados, use o comando da API GetDbParameterGroup Timestream. parameter-group-identifierSubstitua por suas próprias informações.

GetDbParameterGroup parameter-group-identifier