이 페이지는 Cloud Translation API를 통해 번역되었습니다.

API를 사용하여 이전 작업 관리

MySQL | PostgreSQL | PostgreSQL to AlloyDB

개요

이 페이지에서는 Database Migration Service API를 사용하여 MySQL 소스 데이터베이스의 마이그레이션 작업을 관리하는 방법을 알아봅니다.

Database Migration Service API는 두 가지 방법으로 사용할 수 있습니다. REST API 호출을 수행하거나 Google Cloud CLI(CLI)를 사용할 수 있습니다.

gcloud를 사용하여 Database Migration Service 이전 작업을 관리하는 방법에 대한 대략적인 정보를 보려면 여기를 클릭하세요.

마이그레이션 작업의 초안 만들기

다음은 답안 모드로 이전 작업을 만들기 위한 요청을 보여줍니다. 이렇게 하면 마이그레이션 작업을 한 번에 모두 만들 필요가 없습니다. 일부를 만든 다음 PATCH 연산을 사용하여 업데이트할 수 있습니다.

예를 들어 이전 작업을 만들고 싶지만 대상 데이터베이스나 네트워크 연결 방법이 없는 경우 다음 코드를 사용할 수 있습니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
region: 프로젝트 리전
migration-job-id: 이전 작업 ID
migration-job-name: 이전 작업 이름
source-connection-profile-id: 소스 연결 프로필 ID
destination-connection-profile-id: 대상 연결 프로필 ID
provider: 소스 데이터베이스의 분류 유형과 연결된 제공업체입니다.
- 독립형 MySQL 인스턴스의 경우 DATABASE_PROVIDER_UNSPECIFIED를 사용합니다. 이 값은 온프레미스 데이터베이스와 연결되어 있기 때문입니다.
- MySQL용 Cloud SQL 인스턴스의 경우 CLOUDSQL을 사용합니다.
- 관리형 데이터베이스 서비스의 경우 해당하는 ENUM 값을 사용합니다. DatabaseProvider 객체 참조를 참고하세요.
cloud-storage-bucket (선택사항): 덤프 파일을 저장하는 Cloud Storage의 버킷입니다.
dump-file (선택사항): Cloud Storage의 버킷에 저장하는 덤프 파일입니다.
자체 덤프 파일을 제공하려면 Cloud Storage에 파일을 저장한 후 경로를 제공합니다.

압축된 덤프 파일 또는 압축되지 않은 덤프 파일을 Cloud Storage의 버킷에 저장할 수 있습니다.
- 압축된 파일의 경우 gzip_filename.gz을 사용합니다. 예를 들면 gzip_dump.gz입니다.
- 압축을 푼 파일의 경우 filename.sql를 사용합니다. 예를 들면 dump.sql입니다.
flag-name 및 flag-value (선택사항): mysqldump 유틸리티에 추가하는 플래그의 이름과 값입니다. 이 유틸리티는 덤프 파일을 만듭니다.
덤프 파일에 하나 이상의 플래그를 추가할 수 있습니다. 예를 들어 파일에 max-allowed-packet, ignore-error, add-locks 플래그를 추가하려면 다음 코드 줄을 사용합니다.
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
이러한 플래그와 덤프 파일에 추가할 수 있는 다른 플래그에 관한 자세한 내용은 MySQL 8.0 참조 설명서의 mysqldump 유틸리티에 관한 문서를 참고하세요.

HTTP 메서드 및 URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id

JSON 요청 본문:


{
  "displayName": "migration-job-name",
  "state": "DRAFT",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
  //"destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
  "sourceDatabase": {
    "engine": "MYSQL",
    "provider": "provider"
  },
  //"vpcPeeringConnectivity": {
  //"vpc": "default"
  //},
    "dump_path": "gs://cloud-storage-bucket/dump-file"
    "dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/project-id/locations/region/operations/operation-1591975557292-5a7e4b195623c-e350e3da-713dee7d",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T15:25:57.430715421Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

VPC 피어링 연결을 사용하여 연속 마이그레이션 작업 만들기

다음은 VPC 피어링 연결을 사용하여 MySQL 데이터베이스 (Google Compute Engine VM에서 실행됨)를 MySQL용 Cloud SQL로 마이그레이션하기 위한 연속 마이그레이션 작업을 만들기 위한 요청을 보여줍니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
region: 프로젝트 리전
migration-job-id: 이전 작업 ID
migration-job-name: 이전 작업 이름
source-connection-profile-id: 소스 연결 프로필 ID
destination-connection-profile-id: 대상 연결 프로필 ID
provider: 소스 데이터베이스의 분류 유형과 연결된 제공업체입니다.
- 독립형 MySQL 인스턴스의 경우 DATABASE_PROVIDER_UNSPECIFIED를 사용합니다. 이 값은 온프레미스 데이터베이스와 연결되어 있기 때문입니다.
- MySQL용 Cloud SQL 인스턴스의 경우 CLOUDSQL을 사용합니다.
- 관리형 데이터베이스 서비스의 경우 해당하는 ENUM 값을 사용합니다. DatabaseProvider 객체 참조를 참고하세요.
cloud-storage-bucket (선택사항): 덤프 파일을 저장하는 Cloud Storage의 버킷입니다.
dump-file (선택사항): Cloud Storage의 버킷에 저장하는 덤프 파일입니다.
자체 덤프 파일을 제공하려면 Cloud Storage에 파일을 저장한 후 경로를 제공합니다.

압축된 덤프 파일 또는 압축되지 않은 덤프 파일을 Cloud Storage의 버킷에 저장할 수 있습니다.
- 압축된 파일의 경우 gzip_filename.gz을 사용합니다. 예를 들면 gzip_dump.gz입니다.
- 압축을 푼 파일의 경우 filename.sql를 사용합니다. 예를 들면 dump.sql입니다.
flag-name 및 flag-value (선택사항): mysqldump 유틸리티에 추가하는 플래그의 이름과 값입니다. 이 유틸리티는 덤프 파일을 만듭니다.
덤프 파일에 하나 이상의 플래그를 추가할 수 있습니다. 예를 들어 파일에 max-allowed-packet, ignore-error, add-locks 플래그를 추가하려면 다음 코드 줄을 사용합니다.
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
이러한 플래그와 덤프 파일에 추가할 수 있는 다른 플래그에 관한 자세한 내용은 MySQL 8.0 참조 설명서의 mysqldump 유틸리티에 관한 문서를 참고하세요.

HTTP 메서드 및 URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id

JSON 요청 본문:


{
  "displayName": "migration-job-name",
  "state": "NOT_STARTED",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
  "destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
  "sourceDatabase": {
    "engine": "MYSQL",
    "provider": "provider"
  },
  "vpcPeeringConnectivity": {
    "vpc": "default"
  },
  "dump_path": "gs://cloud-storage-bucket/dump-file"
  "dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/project-id/locations/region/operations/operation-1591975557292-5a7e4b195623c-e350e3da-713dee7d",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T15:25:57.430715421Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

gcloud를 사용하여 Database Migration Service 마이그레이션 작업을 만드는 방법에 대한 자세한 내용은 여기를 클릭하세요.

역방향 SSH 연결을 사용하여 연속 마이그레이션 작업 만들기

다음은 역방향 SSH 연결을 사용하여 MySQL용 Amazon RDS 데이터베이스를 MySQL용 Cloud SQL로 마이그레이션하기 위한 연속 실행 마이그레이션 작업을 만드는 요청을 보여줍니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
region: 프로젝트 리전
migration-job-id: 이전 작업 ID
migration-job-name: 이전 작업 이름
source-connection-profile-id: 소스 연결 프로필 ID
destination-connection-profile-id: 대상 연결 프로필 ID
vm-name: SSH VM의 이름입니다. 예를 들어 dms-ssh-bastion입니다.
vm-ip-address: SSH VM의 IP 주소입니다. 예를 들어 11.22.33.44입니다.
vm-port: SSH VM의 연결 포트입니다. 예를 들면 3306입니다.
vpc-name: VPC 네트워크 이름 예를 들어 projects/project-id/global/networks/test-network입니다.
provider: 소스 데이터베이스의 분류 유형과 연결된 제공업체입니다.
- 독립형 MySQL 인스턴스의 경우 DATABASE_PROVIDER_UNSPECIFIED를 사용합니다. 이 값은 온프레미스 데이터베이스와 연결되어 있기 때문입니다.
- MySQL용 Cloud SQL 인스턴스의 경우 CLOUDSQL을 사용합니다.
- 관리형 데이터베이스 서비스의 경우 해당하는 ENUM 값을 사용합니다. DatabaseProvider 객체 참조를 참고하세요.
cloud-storage-bucket (선택사항): 덤프 파일을 저장하는 Cloud Storage의 버킷입니다.
dump-file (선택사항): Cloud Storage의 버킷에 저장하는 덤프 파일입니다.
자체 덤프 파일을 제공하려면 Cloud Storage에 파일을 저장한 후 경로를 제공합니다.

압축된 덤프 파일 또는 압축되지 않은 덤프 파일을 Cloud Storage의 버킷에 저장할 수 있습니다.
- 압축된 파일의 경우 gzip_filename.gz을 사용합니다. 예를 들면 gzip_dump.gz입니다.
- 압축을 푼 파일의 경우 filename.sql를 사용합니다. 예를 들면 dump.sql입니다.
flag-name 및 flag-value (선택사항): mysqldump 유틸리티에 추가하는 플래그의 이름과 값입니다. 이 유틸리티는 덤프 파일을 만듭니다.
덤프 파일에 하나 이상의 플래그를 추가할 수 있습니다. 예를 들어 파일에 max-allowed-packet, ignore-error, add-locks 플래그를 추가하려면 다음 코드 줄을 사용합니다.
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
이러한 플래그와 덤프 파일에 추가할 수 있는 다른 플래그에 관한 자세한 내용은 MySQL 8.0 참조 설명서의 mysqldump 유틸리티에 관한 문서를 참고하세요.

HTTP 메서드 및 URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id

JSON 요청 본문:


{
  "displayName": "migration-job-name",
  "state": "NOT_STARTED",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
  "destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
  "sourceDatabase": {
    "engine": "MYSQL",
    "provider": "provider"
  },
  "reverseSshConnectivity": {
    "vm": "vm-name",
    "vm_ip": "vm-ip-address",
    "vm_port": vm-port,
    "vpc": "vpc-name"
  },
  "dump_path": "gs://cloud-storage-bucket/dump-file"
  "dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

gcloud를 사용하여 Database Migration Service 마이그레이션 작업을 만드는 방법에 대한 자세한 내용은 여기를 클릭하세요.

IP 허용 목록 연결을 사용하여 이전 작업 만들기

다음은 IP 허용 목록을 사용하여 독립형 MySQL 인스턴스 또는 관리형 데이터베이스 서비스를 MySQL용 Cloud SQL 데이터베이스로 마이그레이션하기 위한 마이그레이션 작업을 만드는 요청을 보여줍니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
region: 프로젝트 리전
migration-job-id: 이전 작업 ID
migration-job-name: 이전 작업 이름
source-connection-profile-id: 소스 연결 프로필 ID
destination-connection-profile-id: 대상 연결 프로필 ID
provider: 소스 데이터베이스의 분류 유형과 연결된 제공업체입니다.
- 독립형 MySQL 인스턴스의 경우 DATABASE_PROVIDER_UNSPECIFIED를 사용합니다. 이 값은 온프레미스 데이터베이스와 연결되어 있기 때문입니다.
- MySQL용 Cloud SQL 인스턴스의 경우 CLOUDSQL을 사용합니다.
- 관리형 데이터베이스 서비스의 경우 해당하는 ENUM 값을 사용합니다. DatabaseProvider 객체 참조를 참고하세요.
cloud-storage-bucket (선택사항): 덤프 파일을 저장하는 Cloud Storage의 버킷입니다.
dump-file (선택사항): Cloud Storage의 버킷에 저장하는 덤프 파일입니다.
자체 덤프 파일을 제공하려면 Cloud Storage에 파일을 저장한 후 경로를 제공합니다.

압축된 덤프 파일 또는 압축되지 않은 덤프 파일을 Cloud Storage의 버킷에 저장할 수 있습니다.
- 압축된 파일의 경우 gzip_filename.gz을 사용합니다. 예를 들면 gzip_dump.gz입니다.
- 압축을 푼 파일의 경우 filename.sql를 사용합니다. 예를 들면 dump.sql입니다.
flag-name 및 flag-value (선택사항): mysqldump 유틸리티에 추가하는 플래그의 이름과 값입니다. 이 유틸리티는 덤프 파일을 만듭니다.
덤프 파일에 하나 이상의 플래그를 추가할 수 있습니다. 예를 들어 파일에 max-allowed-packet, ignore-error, add-locks 플래그를 추가하려면 다음 코드 줄을 사용합니다.
```
      "dump_flags": {"dump_flags":[
         {"name": "max-allowed-packet", "value": "24MB"},
         {"name": "ignore-error", "value": "12345, 34567"},
         {"name": "add-locks", "value": ""}, ]}
```
이러한 플래그와 덤프 파일에 추가할 수 있는 다른 플래그에 관한 자세한 내용은 MySQL 8.0 참조 설명서의 mysqldump 유틸리티에 관한 문서를 참고하세요.

HTTP 메서드 및 URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id

JSON 요청 본문:


{
  "displayName": "migration-job-name",
  "state": "NOT_STARTED",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/source-connection-profile-id",
  "destination":"projects/project-id/locations/region/connectionProfiles/destination-connection-profile-id",
  "sourceDatabase": {
    "engine": "MYSQL",
    "provider": "provider"
  },
  "staticIpConnectivity": {}
    "dump_path": "gs://cloud-storage-bucket/dump-file"
    "dump_flags": {"dump_flags":[{"name": "flag-name", "value": "flag-value"}]}
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs?migrationJobId=migration-job-id" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

gcloud를 사용하여 Database Migration Service 마이그레이션 작업을 만드는 방법에 대한 자세한 내용은 여기를 클릭하세요.

이전 작업에 대한 정보 가져오기

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
region: 프로젝트 리전
migration-job-id: 이전 작업 ID

HTTP 메서드 및 URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id"

PowerShell(Windows)

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/project-id/locations/region/migrationJobs/one-time-vpc-job",
  "createTime": "2020-06-12T15:48:39.666093835Z",
  "updateTime": "2020-06-12T15:48:39.666093835Z",
  "displayName": "migration-job-display-name",
  "state": "CREATING",
  "type": "CONTINUOUS",
  "source": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
  "destination": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
  
  "sourceDatabase": {
    "engine": "MYSQL"
  },
  "destinationDatabase": {
    "provider": "CLOUDSQL"
  },
  
  "vpcPeeringConnectivity": {
    "vpc": "default"
  }
}

gcloud

gcloud를 사용하여 이전 작업에 대한 정보를 검색하는 방법에 대한 자세한 내용은 여기를 클릭하세요.

마이그레이션 작업 나열

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
region: 프로젝트 리전

다음과 같이 Database Migration Service에서 가져오는 마이그레이션 작업 목록을 필터링할 수도 있습니다.

orderBy: 이 필터를 사용하면 특정 지역의 모든 이전 작업 목록을 알파벳순으로 검색할 수 있습니다. 예를 들어 orderBy=name 필터는 모든 이전 작업을 이름순으로 알파벳순으로 반환합니다.
pageSize: 이 필터를 사용하여 Database Migration Service가 페이지에서 가져와 표시하는 최대 마이그레이션 작업 수를 지정합니다. 예를 들어 pageSize=10를 설정하면 Database Migration Service는 페이지에 대해 최대 10개의 마이그레이션 작업을 반환합니다.

마이그레이션 작업이 10개를 초과하면 다른 페이지에 표시됩니다. 각 페이지 끝에 nextPageToken 매개변수와 고유 식별자 (예: oasndfoasdnoasun1241243ojsandf)가 표시됩니다. 식별자를 사용하여 다음 페이지의 이전 작업 목록을 가져옵니다. 최종 페이지에는 nextPageToken 매개변수와 고유 식별자가 표시되지 않습니다.

HTTP 메서드 및 URL:

GET https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs"

PowerShell(Windows)

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "migrationJobs": [
    {
      "name": "projects/project-id/locations/region/migrationJobs/name-of-first-migration-job",
      "createTime": "2020-06-12T15:48:39.666093835Z",
      "updateTime": "2020-06-12T15:48:39.666093835Z",
      "displayName": "display-name-of-first-migration-job",
      "state": "NOT_STARTED",
      "type": "CONTINUOUS",
      "source": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      "destination": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      
      "sourceDatabase": {
        "engine": "MYSQL"
      },
      "destinationDatabase": {
        "provider": "CLOUDSQL"
      },
      
      "vpcPeeringConnectivity": {
        "vpc": "default"
      }
    }
    {
      "name": "projects/project-id/locations/region/migrationJobs/name-of-second-migration-job",
      "createTime": "2021-02-13T11:59:39.104613835Z",
      "updateTime": "2021-02-13T12:01:38.666093835Z",
      "displayName": "display-name-of-second-migration-job",
      "state": "RUNNING",
      "type": "CONTINUOUS",
      "source": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      "destination": "projects/project-id/locations/region/connectionProfiles/connection-profile-id",
      
      "sourceDatabase": {
        "engine": "MYSQL"
      },
      "destinationDatabase": {
        "provider": "CLOUDSQL"
      },
      
      "staticIpConnectivity": {}
        "vpc": "default"
    }
  ],
  "nextPageToken": "unique-identifier"
}

gcloud

gcloud를 사용하여 모든 이전 작업에 대한 정보를 검색하는 방법을 보려면 여기를 클릭하세요.

마이그레이션 작업의 SSH 터널 구성 스크립트 생성

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
region: 프로젝트 리전
migration-job-id: 이전 작업 ID

HTTP 메서드 및 URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:generateSshScript

JSON 요청 본문:

{
  "vm":"vm-name",
  "vmCreationConfig":{
    "vmMachineType":"machine-type",
    "subnet":"subnet-name"
	}
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:generateSshScript"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:generateSshScript" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "generate",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

gcloud를 사용하여 이전 작업의 SSH 스크립트를 생성하는 방법을 보려면 여기를 클릭하세요.

마이그레이션 작업 확인

다음은 이전 작업을 확인하는 요청을 보여줍니다. 마이그레이션 작업을 확인하면 작업이 성공적으로 시작되고 실행되는지 확인할 수 있습니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
region: 프로젝트 리전
migration-job-id: 이전 작업 ID

HTTP 메서드 및 URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:verify

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:verify"

PowerShell(Windows)

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:verify" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "verify",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

gcloud를 사용하여 이전 작업을 확인하는 방법에 대한 자세한 내용은 여기를 클릭하세요.

마이그레이션 작업 업데이트

다음은 기존 이전 작업의 표시 이름을 업데이트하기 위한 요청을 보여줍니다. 요청에서 updateMask 매개변수를 사용하여 이러한 필드만 요청 본문에 포함하면 됩니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
region: 프로젝트 리전
migration-job-id: 이전 작업 ID

HTTP 메서드 및 URL:

PATCH https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?updateMask=displayName

JSON 요청 본문:

{
  "displayName": "updated-display-name",
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?updateMask=displayName"

PowerShell(Windows)

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/connectionProfiles/connection-profile-id?updateMask=displayName" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

gcloud를 사용하여 이전 작업을 업데이트하는 방법에 대한 자세한 내용은 여기를 클릭하세요.

마이그레이션 작업 시작

다음은 이전 작업 시작 요청을 보여줍니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
region: 프로젝트 리전
migration-job-id: 이전 작업 ID

HTTP 메서드 및 URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:start

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:start"

PowerShell(Windows)

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:start" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "start",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

gcloud를 사용하여 이전 작업을 시작하는 방법에 대한 자세한 내용은 여기를 클릭하세요.

실패한 마이그레이션 작업 다시 시작

다음은 마이그레이션 작업을 다시 시작하는 요청을 보여줍니다. 마이그레이션에 실패하여 복구할 수 없거나 전체 덤프 중에 중지된 경우 마이그레이션 작업을 처음부터 다시 시작할 수 있습니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
region: 프로젝트 리전
migration-job-id: 이전 작업 ID

HTTP 메서드 및 URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:restart

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:restart"

PowerShell(Windows)

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:restart" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "restart",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

gcloud를 사용하여 이전 작업을 다시 시작하는 방법을 보려면 여기를 클릭하세요.

마이그레이션 작업 중지

다음은 이전 작업을 중지하는 요청을 보여줍니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
region: 프로젝트 리전
migration-job-id: 이전 작업 ID

HTTP 메서드 및 URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:stop

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:stop"

PowerShell(Windows)

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:stop" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "stop",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

gcloud를 사용하여 이전 작업을 중지하는 방법에 대한 자세한 내용은 여기를 클릭하세요.

마이그레이션 작업 재개

다음은 이전 작업을 재개하는 요청을 보여줍니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
region: 프로젝트 리전
migration-job-id: 이전 작업 ID

HTTP 메서드 및 URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:resume

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:resume"

PowerShell(Windows)

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:resume" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "resume",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

gcloud를 사용하여 이전 작업을 재개하는 방법을 보려면 여기를 클릭하세요.

마이그레이션 작업 승격

다음은 마이그레이션 작업을 승격하는 요청을 보여줍니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
region: 프로젝트 리전
migration-job-id: 이전 작업 ID

HTTP 메서드 및 URL:

POST https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:promote

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:promote"

PowerShell(Windows)

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id:promote" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "promote",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

gcloud를 사용하여 이전 작업을 승격하는 방법을 보려면 여기를 클릭하세요.

마이그레이션 작업 삭제

다음은 이전 작업을 삭제하는 요청을 보여줍니다.

REST

요청 데이터를 사용하기 전에 다음을 바꿉니다.

project-id: 프로젝트 ID
region: 프로젝트 리전
migration-job-id: 이전 작업 ID

HTTP 메서드 및 URL:

DELETE https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

다음 명령어를 실행합니다.

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id"

PowerShell(Windows)

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://datamigration.googleapis.com/v1/projects/project-id/locations/region/migrationJobs/migration-job-id" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/project-id/locations/region/operations/operation-1591973161667-5a7e422cb0ba4-3004980d-2ae97165",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.clouddms.v1.OperationMetadata",
    "createTime": "2020-06-12T14:46:01.744267779Z",
    "target": "projects/project-id/locations/region/migrationJobs/migration-job-id",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

gcloud

gcloud를 사용하여 이전 작업을 삭제하는 방법을 보려면 여기를 클릭하세요.