スクリプトの使用方法 - Amazon Timestream

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

スクリプトの使用方法

スクリプトを実行する簡単な例は、 コマンドです。

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

1 つのバケットを移行する 。

すべてのオプションは、以下を実行することで表示できます。

python3 influx_migration.py -h

使用方法

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]

オプション

  • -confirm-full (オプション): --fullなしで を使用すると、送信先データベース内のすべてのトークン、ユーザー、バケット、ダッシュボード、およびその他のキーバリューデータが、送信元データベースのトークン、ユーザー、バケット、ダッシュボード、およびその他のキーバリューデータ--csvに置き換えられます。 --full では、バケット組織を含むすべてのバケットとバケットメタデータ--csvのみが移行されます。このオプション (--confirm-full) は完全な移行を確認し、ユーザー入力なしで続行します。このオプションが指定されておらず、 --fullも指定--csvされていない場合、スクリプトは実行を一時停止し、ユーザーの確認を待ちます。これは重要なアクションです。注意して続行してください。デフォルトは false です。

  • -csv (オプション): バックアップと復元に csv ファイルを使用するかどうか。も--full渡されると、システムバケット、ユーザー、トークン、ダッシュボードではなく、すべての組織内のすべてのユーザー定義バケットが移行されます。既存のソース組織ではなく、送信先サーバー内のすべてのバケットに単一の組織が必要な場合は、 を使用します--dest-org

  • -dest-bucket DEST_BUCKET (オプション): 送信先サーバーの InfluxDB バケットの名前は、既存のバケットであってはなりません。指定None--src-bucketされていない場合、デフォルト値は --src-bucketまたは になります。

  • -dest-host DEST_HOST: 送信先サーバーのホスト。例: http://localhost:8086.

  • -dest-org DEST_ORG (オプション): レプリケート先サーバーのバケットを復元する組織の名前。これを省略すると、ソースサーバーから移行されたすべてのバケットが元の組織を保持し、組織を作成して切り替えない限り、移行されたバケットが宛先サーバーに表示されない可能性があります。この値は、単一のバケット、完全な移行、またはバックアップと復元に csv ファイルを使用する移行など、あらゆる形式の復元に使用されます。

  • -dir-name DIR_NAME (オプション): 作成するバックアップディレクトリの名前。デフォルトは influxdb-backup-<timestamp> です。まだ存在してはいけません。

  • -full (オプション): 完全な復元を実行するかどうか、送信先サーバーのすべてのデータを、トークン、ダッシュボード、ユーザーなどのすべてのキーバリューデータを含む、すべての組織のソースサーバーからのすべてのデータに置き換えます。--src-bucket と をオーバーライドします--dest-bucket。と共に使用する場合--csv、 はバケットのデータとメタデータのみを移行します。デフォルトは false です。

  • h, --help: ヘルプメッセージを表示して終了します。

  • -log-level LOG_LEVEL(オプション): 実行中に使用されるログレベル。オプションは、デバッグ、エラー、情報です。デフォルトは info です。

  • -retry-restore-dir _RETRYRESTORE_DIR(オプション): 以前の復元が失敗したときに復元に使用するディレクトリはバックアップとディレクトリの作成をスキップし、ディレクトリが存在しない場合は失敗します。S3 バケット内のディレクトリにすることができます。復元に失敗すると、復元に使用できるバックアップディレクトリパスが現在のディレクトリに対して表示されます。S3 バケットは の形式になりますinfluxdb-backups/<s3 bucket>/<backup directory>。デフォルトのバックアップディレクトリ名は ですinfluxdb-backup-<timestamp>

  • -s3-bucket S3_BUCKET (オプション): バックアップファイルの保存に使用する S3 バケットの名前。Linux では、これは AWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEY 環境変数が設定されているか、${HOME}/.aws/credentials存在する場合などmy-bucket、S3 バケットの名前にすぎません。Windows では、これは など、rclone設定されたリモート名とバケット名ですmy-remote:my-bucket。すべてのバックアップファイルは、作成されたinfluxdb-backups-<timestamp>ディレクトリの移行後に S3 バケットに残ります。という名前の一時マウントディレクトリはinflux-backups、このスクリプトが実行されたディレクトリに作成されます。指定しない場合、すべてのバックアップファイルは、このスクリプトが実行される作成されたinfluxdb-backups-<timestamp>ディレクトリにローカルに保存されます。

  • -skip-verify(オプション): TLS 証明書の検証をスキップします。

  • -src-bucket SRC_BUCKET(オプション): ソースサーバーの InfluxDB バケットの名前。指定しない場合は、 を指定--fullする必要があります。

  • -src-host SRC_HOST(オプション): ソースサーバーのホスト。デフォルトは http://localhost:8086.

前述のように、 rclone --s3-bucketを使用する場合は mountpoint-s3と が必要ですが、ユーザーが の値を指定しない場合、無視できます。その場合--s3-bucket、バックアップファイルは一意のディレクトリにローカルに保存されます。