스크립트 사용 방법 - Amazon Timestream

Amazon Timestream for LiveAnalytics와 유사한 기능을 원하는 경우 Amazon Timestream for InfluxDB를 고려해 보세요. 간소화된 데이터 수집과 실시간 분석을 위한 10밀리초 미만의 쿼리 응답 시간을 제공합니다. 여기에서 자세히 알아보세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

스크립트 사용 방법

다음 명령은 스크립트를 실행하는 간단한 예입니다.

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(선택 사항): --csv 없이 --full을 사용하면 대상 데이터베이스의 모든 토큰, 사용자, 버킷, 대시보드 및 기타 키-값 데이터가 소스 데이터베이스의 해당 데이터로 바뀝니다. --csv와 함께 --full을 사용하면 버킷 조직을 포함한 모든 버킷과 버킷 메타데이터만 마이그레이션됩니다. 이 옵션(--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가 존재하는 경우 이는 단순히 S3 버킷의 이름(예: amzn-s3-demo-bucket1)입니다. Windows에서는 rclone으로 구성된 원격 및 버킷 이름(예: my-remote:amzn-s3-demo-bucket1)입니다. 모든 백업 파일은 마이그레이션 후 생성된 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 값을 지정하지 않으면 무시할 수 있습니다. 이 경우 백업 파일은 로컬의 고유한 디렉터리에 저장됩니다.