Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Connexion à une instance de base de données Amazon Timestream pour InfluxDB

Avant de pouvoir vous connecter à une instance de base de données, vous devez créer l'instance de base de données. Pour plus d’informations, veuillez consulter Création d'une instance de base de données. Une fois qu'Amazon Timestream a approvisionné votre instance de base de données, utilisez API InfluxDB, CLI Influx ou tout autre client ou utilitaire compatible permettant à InfluxDB de vous connecter à l'instance de base de données.

Recherche des informations de connexion pour une instance de base de données Amazon Timestream pour InfluxDB

Les informations de connexion d'une instance de base de données incluent son point de terminaison, son port, son nom d'utilisateur, son mot de passe et un jeton d'accès valide, tel que l'opérateur ou le jeton d'accès complet. Par exemple, pour une instance de base de données InfluxDB, supposons que la valeur du point de terminaison soit. influxdb1-123456789.us-east-1.timestream-influxdb.amazonaws.com Dans ce cas, la valeur du port est 8086 et l'utilisateur de la base de données est admin. Compte tenu de ces informations, vous spécifiez les valeurs suivantes dans une chaîne de connexion :

Le point de terminaison est unique pour chaque instance de base de données, et les valeurs du port et de l'utilisateur peuvent varier. Pour vous connecter à une instance de base de données, vous pouvez utiliser InfluxCLI, Influx API ou tout autre client compatible avec InfluxDB.

Pour trouver les informations de connexion d'une instance de base de données, utilisez la console AWS de gestion. Vous pouvez également utiliser la AWS commande Command Line Interface (AWS CLI) describe-db-instances ou l'opération API GetDBInstance Timestream-InfluxDB.

Si vous avez besoin des informations relatives au nom d'utilisateur et au mot de passe, cliquez sur l'onglet Détails de configuration, puis sur le influxAuthParametersSecretArn pour accéder à votre Secrets Manager.

Création de jetons d'accès

Avec ces informations, vous allez pouvoir vous connecter à votre instance pour récupérer ou créer vos jetons d'accès. Il existe plusieurs moyens d'y parvenir :

L'exemple suivant utilise curl et l'InfluxDB API pour générer un jeton d'accès universel :

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"}}
    ]
  }
'

Options d'authentification de base de données

Amazon Timestream pour InfluxDB prend en charge les méthodes suivantes pour authentifier les utilisateurs de base de données :

Connexions chiffrées

Vous pouvez utiliser Secure Socket Layer (SSL) ou Transport Layer Security (TLS) depuis votre application pour chiffrer une connexion à une instance de base de données. Les certificats nécessaires à la prise de TLS contact entre InfluxDB et les applications créées et gérées par le service Kronos. Lorsque le certificat est renouvelé, l'instance est automatiquement mise à jour avec la dernière version sans intervention de l'utilisateur.

Utilisation des groupes de paramètres

Les paramètres de base de données spécifient comment la base de données est configurée. Par exemple, les paramètres de base de données peuvent spécifier la quantité de ressources, telles que la mémoire, à allouer à une base de données.

Vous gérez la configuration de votre base de données en associant vos instances de base de données à des groupes de paramètres. Amazon Timestream pour InfluxDB définit des groupes de paramètres avec des paramètres par défaut. Vous pouvez également définir vos propres groupes de paramètres à l'aide de paramètres personnalisés.

Présentation des groupes de paramètres

Un groupe de paramètres de base de données sert de conteneur pour les valeurs de configuration du moteur qui sont appliquées à une ou plusieurs instances de base de données.

Groupes de paramètres par défaut et personnalisés

Les instances de base de données utilisent des groupes de paramètres de base de données. Les sections suivantes décrivent la configuration et la gestion des groupes de paramètres d'une instance de base de données.

Création d'un groupe de paramètres de bases de données

Vous pouvez créer un nouveau groupe de paramètres de base de données à l'aide du AWS Management Console AWS Command Line Interface, du ou du TimestreamAPI.

Les limites suivantes s'appliquent aux noms de groupes de paramètres de base de données :

Vous ne pouvez pas modifier les valeurs de paramètre d'un groupe de paramètres de base de données par défaut. Au lieu de cela, vous pouvez effectuer les actions suivantes :

Paramètres d'instance de bases de données statiques et dynamiques

Les paramètres de l'instance de base de données InfluxDB sont toujours statiques. Ils se comportent comme suit :

Lorsque vous modifiez un paramètre statique, enregistrez le groupe de paramètres de base de données et que vous l'attribuez à une instance, la modification du paramètre prend effet automatiquement après le redémarrage de l'instance.

Lorsque vous associez un nouveau groupe de paramètres de base de données à une instance de base de données, Timestream applique les paramètres statiques modifiés uniquement après le redémarrage de l'instance de base de données. Actuellement, la seule option est d'appliquer immédiatement.

Pour de plus amples informations sur la modification du groupe de paramètres de base de données, veuillez consulter Mise à jour des instances de base de données.

Paramètres et valeurs de paramètres pris en charge

Pour déterminer les paramètres pris en charge pour votre instance de base de données, consultez les paramètres du groupe de paramètres de base de données utilisé par l'instance de base de données. Pour plus d'informations, consultez la section Affichage des valeurs des paramètres d'un groupe de paramètres de base de données.

Pour plus d'informations sur tous les paramètres pris en charge par la version open source d'InfluxDB, consultez les options de configuration d'InfluxDB. Actuellement, vous ne pouvez modifier que les paramètres InfluxDB suivants :

La configuration incorrecte de paramètres dans un groupe de paramètres peut avoir des effets contraires involontaires, dont une dégradation de la performance et une instabilité du système. Soyez toujours prudent lorsque vous modifiez les paramètres de base de données. Essayez de modifier les paramètres de groupe de paramètres sur une instance de base de données de test avant d'appliquer ces modifications de groupe de paramètres à une instance de base de données de production.

Utilisation des groupes de paramètres DB

Les instances de base de données utilisent des groupes de paramètres de base de données. Les sections suivantes décrivent la configuration et la gestion des groupes de paramètres d'une instance de base de données.

Création d'un groupe de paramètres de bases de données

Association d'un groupe de paramètres de base de données à une instance de base de données

Vous pouvez créer vos propres groupes de paramètres de base de données avec des paramètres personnalisés. Vous pouvez associer un groupe de paramètres de base de données à une instance de base de données en utilisant le AWS Management Console, le ou le AWS Command Line Interface API Timestream-InfluxDB. Vous pouvez le faire lorsque vous créez ou modifiez une instance de base de données.

Pour plus d'informations sur la création d'un groupe de paramètres de base de données, consultez Création d'un groupe de paramètres de bases de données. Pour de plus amples informations sur la création d'une instance de base de données, veuillez consulter Création d'une instance de base de données. Pour plus d'informations sur la modification d'une instance de base de données, consultezMise à jour des instances de base de données..

En utilisant le AWS Command Line Interface

Pour 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 }}"

Pour 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 }}"
                        
 

Liste des groupes de paramètres de bases de données

Vous pouvez répertorier les groupes de paramètres de base de données que vous avez créés pour votre AWS compte.

En utilisant le AWS Command Line Interface

Pour répertorier tous les groupes de paramètres de base de données d'un AWS compte, utilisez la AWS Command Line Interface list-db-parameter-groups commande.

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

Pour renvoyer des groupes de paramètres de base de données spécifiques pour un AWS compte, utilisez la AWS Command Line Interface get-db-parameter-group commande.

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

Affichage des valeurs de paramètres pour un groupe de paramètres de bases de données

Vous pouvez obtenir une liste de tous les paramètres dans un groupe de paramètres DB et de leurs valeurs.

En utilisant le AWS Command Line Interface

Pour afficher les valeurs des paramètres d'un groupe de paramètres de base de données, utilisez la AWS Command Line Interface get-db-parameters commande avec le paramètre obligatoire suivant.

--db-parameter-group-name

En utilisant le API

Pour afficher les valeurs des paramètres d'un groupe de paramètres de base de données, utilisez la API GetDBParameters commande Timestream avec le paramètre obligatoire suivant.

DBParameterGroupName