Amazon Timestream for LiveAnalytics와 유사한 기능을 원하는 경우 Amazon Timestream for InfluxDB를 고려해 보세요. 간소화된 데이터 수집과 실시간 분석을 위한 10밀리초 미만의 쿼리 응답 시간을 제공합니다. [여기](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)에서 자세히 알아보세요.

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

# 스크립트 사용 방법
<a name="timestream-for-influx-getting-started-migrating-data-using-script"></a>

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

```
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\$1BUCKET**(선택 사항): 대상 서버의 InfluxDB 버킷 이름은 이미 존재하는 버킷이 아니어야 합니다. `--src-bucket`이 제공되지 않는 경우 기본값은 `--src-bucket` 또는 `None`입니다.
+ **-dest-host DEST\$1HOST**: 대상 서버의 호스트입니다. 예를 들면 http://localhost:8086입니다.
+ **-dest-org DEST\$1ORG**(선택 사항): 대상 서버에서 버킷을 복원할 조직의 이름입니다. 이 옵션을 생략하면 소스 서버에서 마이그레이션된 모든 버킷이 원래 조직을 유지하며, 조직을 생성하고 전환하지 않으면 대상 서버에서 마이그레이션된 버킷이 표시되지 않을 수 있습니다. 이 값은 단일 버킷, 전체 마이그레이션 또는 백업 및 복원을 위해 csv 파일을 사용하는 마이그레이션 등 모든 형태의 복원에 사용됩니다.
+ **-dir-name DIR\$1NAME**(선택 사항): 생성할 백업 디렉터리의 이름입니다. 기본값은 `influxdb-backup-<timestamp>`입니다. 이미 존재해서는 안 됩니다.
+ **-full**(선택 사항): 토큰, 대시보드, 사용자 등의 모든 키-값 데이터를 포함하여 모든 조직의 소스 서버에 있는 모든 데이터로 대상 서버에 있는 모든 데이터를 바꿔서 전체 복원을 수행할지 여부입니다. `--src-bucket`과 `--dest-bucket`을 재정의합니다. `--csv`와 함께 사용하면 버킷의 데이터와 메타데이터만 마이그레이션합니다. 기본값은 false입니다.
+ **h, --help**: 도움말 메시지를 표시하고 종료합니다.
+ **-log-level LOG\$1LEVEL**(선택 사항): 실행 중 사용될 로그 수준입니다. 옵션은 debug, error, info입니다. 기본값은 info입니다.
+ **-retry-restore-dir RETRY\$1RESTORE\$1DIR**(선택 사항): 이전 복원이 실패했을 때 복원에 사용할 디렉터리입니다. 백업과 디렉터리 생성을 건너뛰고, 디렉터리가 없으면 실패합니다. S3 버킷 내의 디렉터리일 수 있습니다. 복원이 실패할 경우 복원에 사용할 수 있는 백업 디렉터리 경로가 현재 디렉터리를 기준으로 하는 상대 경로로 표시됩니다. S3 버킷은 `influxdb-backups/<s3 bucket>/<backup directory>` 형식입니다. 기본 백업 디렉터리 이름은 `influxdb-backup-<timestamp>`입니다.
+ **-s3-bucket S3\$1BUCKET**(선택 사항): 백업 파일을 저장하는 데 사용할 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\$1BUCKET**(선택 사항): 소스 서버의 InfluxDB 버킷 이름입니다. 이 옵션을 지정하지 않을 경우 `--full`을 지정해야 합니다.
+ **-src-host SRC\$1HOST**(선택 사항): 소스 서버의 호스트입니다. 기본값은 http://localhost:8086입니다.

앞서 언급한 바와 같이 `--s3-bucket`을 사용할 경우 `mountpoint-s3` 및 `rclone`이 필요하지만, 사용자가 `--s3-bucket` 값을 지정하지 않으면 무시할 수 있습니다. 이 경우 백업 파일은 로컬의 고유한 디렉터리에 저장됩니다.