Comment utiliser les scripts - Amazon Timestream

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.

Comment utiliser les scripts

Voici un exemple simple d'exécution du script :

python3 influx_migration.py --src-host <source host> --src-bucket <source bucket> --dest-host <destination host>

Qui fait migrer un seul bucket.

Toutes les options peuvent être consultées en exécutant :

python3 influx_migration.py -h

Utilisation

shell influx_migration.py [-h] [--src-bucket SRC_BUCKET] [--dest-bucket DEST_BUCKET] [--src-host SRC_HOST] --dest-host DEST_HOST [--full] [--confirm-full] [--src-org SRC_ORG] [--dest-org DEST_ORG] [--csv] [--retry-restore-dir RETRY_RESTORE_DIR] [--dir-name DIR_NAME] [--log-level LOG_LEVEL] [--skip-verify] [--s3-bucket S3_BUCKET]

Options

  • -confirm-full (facultatif) : l'utilisation de --full without --csv remplacera tous les jetons, utilisateurs, compartiments, tableaux de bord et toute autre donnée clé-valeur de la base de données de destination par les jetons, utilisateurs, compartiments, tableaux de bord et toute autre donnée clé-valeur de la base de données source. --fullavec migre --csv uniquement toutes les métadonnées du bucket et du bucket, y compris les organisations du bucket. Cette option (--confirm-full) confirmera une migration complète et se poursuivra sans intervention de l'utilisateur. Si cette option n'est pas fournie, --full qu'elle a été fournie et --csv non fournie, le script s'interrompt pour s'exécuter et attend la confirmation de l'utilisateur. Il s'agit d'une action critique, procédez avec prudence. La valeur par défaut est false.

  • -csv (facultatif) : s'il faut utiliser des fichiers csv pour la sauvegarde et la restauration. S'il --full est également adopté, tous les compartiments définis par l'utilisateur de toutes les organisations seront migrés, et non les compartiments système, les utilisateurs, les jetons ou les tableaux de bord. Si une organisation unique est souhaitée pour tous les compartiments du serveur de destination au lieu de leurs organisations source existantes, utilisez. --dest-org

  • -dest-bucket DEST _ BUCKET (facultatif) : le nom du bucket InfluxDB sur le serveur de destination ne doit pas être un bucket déjà existant. La valeur par défaut est la valeur de --src-bucket ou None si elle --src-bucket n'est pas fournie.

  • -dest-host DEST _ HOST : L'hôte du serveur de destination. Exemple : http://localhost:8086.

  • -dest-org DEST _ ORG (facultatif) : nom de l'organisation vers laquelle restaurer les buckets sur le serveur de destination. Si cette option est omise, tous les buckets migrés depuis le serveur source conserveront leur organisation d'origine et les buckets migrés risquent de ne pas être visibles sur le serveur de destination sans création ou changement d'organisation. Cette valeur sera utilisée dans toutes les formes de restauration, qu'il s'agisse d'un bucket unique, d'une migration complète ou de toute migration utilisant des fichiers CSV pour la sauvegarde et la restauration.

  • -dir-name DIR _ NAME (facultatif) : nom du répertoire de sauvegarde à créer. La valeur par défaut est influxdb-backup-<timestamp>. Il ne doit pas déjà exister.

  • -full (facultatif) : s'il faut effectuer une restauration complète, en remplaçant toutes les données du serveur de destination par toutes les données du serveur source de toutes les organisations, y compris toutes les données clé-valeur telles que les jetons, les tableaux de bord, les utilisateurs, etc. Dérogations --src-bucket et. --dest-bucket S'il est utilisé avec--csv, migre uniquement les données et les métadonnées des buckets. La valeur par défaut est false.

  • h, --help : affiche le message d'aide et sort.

  • -log-level LOG _ LEVEL (facultatif) : niveau de journalisation à utiliser lors de l'exécution. Les options sont debug, error et info. La valeur par défaut est info.

  • - retry-restore-dir RETRY _ RESTORE _ DIR (facultatif) : répertoire à utiliser pour la restauration en cas d'échec d'une restauration précédente, ignorera la sauvegarde et la création de répertoire, échouera si le répertoire n'existe pas, peut être un répertoire dans un compartiment S3. Si une restauration échoue, le chemin du répertoire de sauvegarde qui peut être utilisé pour la restauration sera indiqué par rapport au répertoire en cours. Les compartiments S3 seront sous la formeinfluxdb-backups/<s3 bucket>/<backup directory>. Le nom du répertoire de sauvegarde par défaut estinfluxdb-backup-<timestamp>.

  • -s3-bucket S3_ BUCKET (facultatif) : nom du compartiment S3 à utiliser pour stocker les fichiers de sauvegarde. Sous Linux, il s'agit simplement du nom du compartiment S3, par exemplemy-bucket, donné AWS_ACCESS_KEY_ID et les variables d'AWS_SECRET_ACCESS_KEYenvironnement ont été définies ou ${HOME}/.aws/credentials existent. Sous Windows, il s'agit de la télécommande et du nom du bucket rclone configurés, par exemplemy-remote:my-bucket. Tous les fichiers de sauvegarde seront conservés dans le compartiment S3 après la migration dans un influxdb-backups-<timestamp> répertoire créé. Un répertoire de montage temporaire nommé influx-backups sera créé dans le répertoire à partir duquel ce script est exécuté. S'ils ne sont pas fournis, tous les fichiers de sauvegarde seront stockés localement dans un influxdb-backups-<timestamp> répertoire créé à partir duquel ce script est exécuté.

  • -skip-verify (facultatif) : ignore TLS la vérification du certificat.

  • -src-bucket SRC _ BUCKET (facultatif) : nom du bucket InfluxDB sur le serveur source. Si ce n'est pas le cas, il --full doit être fourni.

  • -src-host SRC _ HOST (facultatif) : hôte du serveur source. La valeur par défaut est http://localhost:8086.

Comme indiqué précédemment, mountpoint-s3 rclone elles sont nécessaires si --s3-bucket elles doivent être utilisées, mais peuvent être ignorées si l'utilisateur ne fournit pas de valeur pour--s3-bucket, auquel cas les fichiers de sauvegarde seront stockés localement dans un répertoire unique.