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

Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、こちらを参照してください。

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

スクリプトの使用方法

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

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

このコマンドで単一のバケットが移行します。

すべてのオプションは、次を実行することで確認できます。

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 バケットの名前を、既存のバケットの名前にすることはできません。デフォルト値は --src-bucket です。--src-bucket を指定しない場合は None になります。

  • -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 (オプション): 実行中に使用されるログレベル。オプションは、debug、error、info です。デフォルトは info です。

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

  • -s3-bucket S3_BUCKET (オプション): バックアップファイルの保存に使用する S3 バケットの名前。Linux では、AWS_ACCESS_KEY_ID と AWS_SECRET_ACCESS_KEY の環境変数が設定されているか ${HOME}/.aws/credentials がある場合、これは amzn-s3-demo-bucket1 などの S3 バケットの名前になります。Windows では、my-remote:amzn-s3-demo-bucket1 など、rclone 設定されたリモート名とバケット名になります。すべてのバックアップファイルは、作成済みの 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 です。

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