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á.

Conectando-se 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 o API InfluxDB, o CLI Influx ou qualquer cliente ou utilitário compatível com o InfluxDB para se conectar à instância de banco de dados.

Encontrando as informações de conexão para uma instância de banco de dados Amazon Timestream for 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 todo o token de acesso. Por exemplo, para uma instância de banco de dados InfluxDB, suponha que o valor do endpoint seja. influxdb1-123456789.us-east-1.timestream-influxdb.amazonaws.com Nesse caso, o valor da porta é 8086 e o usuário do banco de dados é admin. Com essas informações, você especifica os seguintes valores em uma string de conexão:

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 o InfluxCLI, o Influx API ou qualquer outro 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) ou a describe-db-instances operação API GetDBInstance Timestream-InfluxDB.

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

Criação de tokens de acesso

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

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

export INFLUX_HOST=https://influxdb1-123456789.us-east-1.timestream-influxdb.amazonaws.com
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 oferece suporte às seguintes formas de autenticar usuários do banco de dados:

Conexões criptografadas

Você pode usar Secure Socket Layer (SSL) ou Transport Layer Security (TLS) do seu aplicativo para criptografar uma conexão com uma instância de banco de dados. Os certificados necessários para o TLS handshake 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 parameter groups

Database parameters (Parâmetros do banco de dados) especifica 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 seu banco de dados associando suas instâncias de banco de dados a 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 o AWS Management Console AWS Command Line Interface, o ou o TimestreamAPI.

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, salva o grupo de parâmetros do banco de dados e o atribui a uma instância, a alteração do parâmetro entra em vigor automaticamente após a reinicialização da instância.

Quando você associa 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 com 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 Visualização de 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. Experimente as alterações na configuração do grupo de parâmetros em uma instância de banco de dados de teste antes de aplicar essas alterações em 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 o AWS Management Console, o ou o AWS Command Line Interface API Timestream-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 obter informações sobre como modificar 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-parameters comando com o seguinte parâmetro obrigatório.

--db-parameter-group-name

Usando o API

Para visualizar os valores dos parâmetros de um grupo de parâmetros do banco de dados, use o API GetDBParameters comando Timestream com o seguinte parâmetro obrigatório.

DBParameterGroupName