SQL 덤프 파일을 사용하여 내보내기 및 가져오기

MySQL | PostgreSQL | SQL Server

이 페이지에서는 SQL 덤프 파일을 사용하여 Cloud SQL 인스턴스로 데이터를 내보내고 가져오는 방법을 설명합니다.

참고: 지원되는 데이터베이스 서버(온프레미스, AWS 또는 Cloud SQL)에서 전체 데이터베이스를 새로운 Cloud SQL 인스턴스로 마이그레이션하는 경우 파일을 내보낸 후 가져오는 대신 Database Migration Service를 사용하면 됩니다. 내보낸 파일에서 새 인스턴스를 만들도록 내보내는 경우 백업에서 다른 인스턴스로 복원하거나 인스턴스를 클론하는 것이 좋습니다.

Cloud SQL 인스턴스로 데이터 가져오기와 인스턴스에서 데이터 내보내기를 취소할 수 있습니다. 이 데이터는 SQL 덤프 파일에 포함되어 있습니다. 가져오기 또는 내보내기 작업 취소에 대한 자세한 내용은 데이터 가져오기 및 내보내기 취소를 참조하세요.

시작하기 전에

내보내기는 데이터베이스 리소스를 사용하지만 인스턴스가 프로비저닝되지 않는 한 일반적인 데이터베이스 작업에 지장을 주지 않습니다.

권장사항은 데이터 가져오기 및 내보내기 권장사항을 참조하세요.

가져오기 작업을 완료한 후 결과를 확인합니다.

참고: Cloud SQL용 MySQL 8.0에서는 caching_sha2_password 대신 mysql_native_password를 신규 사용자의 기본 인증 플러그인으로 사용합니다. 하지만 외부 인스턴스에서 가져온 사용자는 인증에 caching_sha2_password 플러그인을 사용하도록 구성되어 있을 수 있습니다. 따라서 연결 시 문제가 발생할 수 있습니다. 자세한 내용은 MySQL 8.0 인증을 참조하세요.

MySQL용 Cloud SQL에서 데이터 내보내기

MySQL용 Cloud SQL에서 내보내기에 필요한 역할 및 권한

데이터를 Cloud SQL에서 Cloud Storage로 내보내려면 내보내기를 시작하는 사용자에게 다음 역할 중 하나가 있어야 합니다.

Cloud SQL 편집자 역할
다음 권한이 포함된 맞춤 역할:
- cloudsql.instances.get
- cloudsql.instances.export

또한 Cloud SQL 인스턴스의 서비스 계정에는 다음 역할 중 하나가 있어야 합니다.

storage.objectAdmin Identity and Access Management(IAM) 역할
다음 권한이 포함된 맞춤 역할:
- storage.objects.create
- storage.objects.list(파일을 동시에 내보내는 경우에만)
- storage.objects.delete(파일을 동시에 내보내는 경우에만)

IAM 역할에 대한 도움말은 Identity and Access Management를 참조하세요.

MySQL용 Cloud SQL에서 SQL 덤프 파일로 내보내기

SQL 덤프 파일을 만들려면 Cloud SQL에서 Cloud Storage로 데이터를 내보냅니다. 파일이 Cloud Storage에 저장되면 다른 Cloud SQL 데이터베이스로 가져올 수 있습니다. 데이터를 로컬로 액세스할 수 있도록 Cloud Storage에서 로컬 환경으로 다운로드할 수도 있습니다.

Cloud SQL에서 내보내는 경우 mysqldump 유틸리티와 --single-transaction 및 --hex-blob 옵션을 사용합니다. --single-transaction 옵션을 사용하면 mysqldump가 실행되기 전에 트랜잭션을 시작합니다. 전체 데이터베이스를 잠그는 대신 mysqldump가 현재 상태에서 데이터베이스를 읽을 수 있으므로 일관된 데이터 덤프가 가능합니다.

SQL 덤프 파일에 DEFINER 절(조회, 트리거, 저장된 프로시저 등)이 포함된 경우 해당 문이 실행되는 순서에 따라 이 파일을 가져오기에 사용하는 데 실패할 수 있습니다. Cloud SQL에서 DEFINER사용 및 우회적 해결 방법에 대해 자세히 알아보세요.

Cloud SQL 인스턴스의 데이터베이스에서 Cloud Storage 버킷의 SQL 덤프 파일로 데이터를 내보내려면 다음 안내를 따르세요.

Console

Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

Cloud SQL 인스턴스로 이동
인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
내보내기를 클릭합니다.
파일 형식 섹션에서 SQL을 클릭하여 SQL 덤프 파일을 만듭니다.
내보낼 데이터 섹션에서 이 인스턴스에 있는 하나 이상의 데이터베이스를 클릭하여 특정 데이터베이스를 내보냅니다.
드롭다운 메뉴를 사용하여 내보낼 데이터베이스를 선택합니다.
대상 섹션에서 찾아보기를 선택하여 내보낼 Cloud Storage 버킷 또는 폴더를 검색합니다.
내보내기를 클릭하여 시작합니다.

gcloud

Cloud Storage 버킷을 만듭니다.
내보낼 Cloud SQL 인스턴스의 서비스 계정을 찾습니다. gcloud sql instances describe 명령어를 실행하여 수행할 수 있습니다. 출력에서 serviceAccountEmailAddress 필드를 찾습니다.
```
gcloud sql instances describe INSTANCE_NAME
  
```
gcloud storage buckets add-iam-policy-binding을 사용하여 서비스 계정에 storage.objectAdmin IAM 역할을 부여합니다. IAM 권한 설정에 대한 도움말은 IAM 권한 사용을 참조하세요.
데이터베이스를 Cloud Storage 버킷으로 내보냅니다.
참고: 서버리스 내보내기를 사용하려면 offload 매개변수를 사용하세요. 그 밖의 경우에는 다음 명령어에서 이 플래그를 삭제하세요.
```
gcloud sql export sql INSTANCE_NAME gs://BUCKET_NAME/sqldumpfile.gz \
--database=DATABASE_NAME \
--offload
  
```
export sql 명령어에는 트리거 또는 저장 프로시저가 포함되지 않지만 뷰가 포함됩니다. 트리거 또는 저장 프로시저를 내보내려면 mysqldump 도구를 사용합니다.

export sql 명령어 사용 방법에 대한 자세한 내용은 sql export sql 명령어 참조 페이지를 확인하세요.
이전에 설정한 IAM 역할을 유지할 필요가 없으면 지금 취소합니다.

REST v1

내보내기에 사용할 버킷을 만듭니다.
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
이 단계는 필수 사항은 아니지만 다른 데이터에 대한 액세스를 열지 않아도 되기 때문에 적극 권장됩니다.
인스턴스에 버킷의 legacyBucketWriter IAM 역할을 제공합니다. IAM 권한 설정에 대한 도움말은 IAM 권한 사용을 참조하세요.
데이터베이스를 내보냅니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: 프로젝트 ID입니다.
- INSTANCE_ID: 인스턴스 ID
- BUCKET_NAME: Cloud Storage 버킷 이름
- PATH_TO_DUMP_FILE: SQL 덤프 파일의 경로
- DATABASE_NAME_1: Cloud SQL 인스턴스 내 데이터베이스의 이름
- DATABASE_NAME_2: Cloud SQL 인스턴스 내 데이터베이스의 이름
참고: 서버리스 내보내기를 사용하려면 offload 매개변수 값을 TRUE로 설정하세요. 서버리스 내보내기에는 추가 요금이 발생합니다. 가격 책정 페이지를 참조하세요.

HTTP 메서드 및 URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/export

JSON 요청 본문:

{
 "exportContext":
   {
      "fileType": "SQL",
      "uri": "gs://BUCKET_NAME/PATH_TO_DUMP_FILE",
      "databases": ["DATABASE_NAME"],
      "offload": TRUE | FALSE
    }
}

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

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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/export"

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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/export" | Select-Object -Expand Content

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

응답

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

이전에 설정한 IAM 역할을 유지할 필요가 없으면 지금 삭제합니다.

이 요청에 대한 전체 매개변수 목록은 instances:export 페이지를 참조하세요.

REST v1beta4

내보내기에 사용할 버킷을 만듭니다.
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
이 단계는 필수 사항은 아니지만 다른 데이터에 대한 액세스를 열지 않아도 되기 때문에 적극 권장됩니다.
인스턴스에 버킷의 storage.objectAdmin IAM 역할을 제공합니다. IAM 권한 설정에 대한 도움말은 IAM 권한 사용을 참조하세요.
데이터베이스를 내보냅니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: 프로젝트 ID입니다.
- INSTANCE_ID: 인스턴스 ID
- BUCKET_NAME: Cloud Storage 버킷 이름
- PATH_TO_DUMP_FILE: SQL 덤프 파일의 경로
- DATABASE_NAME_1: Cloud SQL 인스턴스 내 데이터베이스의 이름
- DATABASE_NAME_2: Cloud SQL 인스턴스 내 데이터베이스의 이름
참고: 서버리스 내보내기를 사용하려면 offload 매개변수 값을 TRUE로 설정하세요. 서버리스 내보내기에는 추가 요금이 발생합니다. 가격 책정 페이지를 참조하세요.

HTTP 메서드 및 URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/export

JSON 요청 본문:

{
  "exportContext":
    {
       "fileType": "SQL",
       "uri": "gs://BUCKET_NAME/PATH_TO_DUMP_FILE",
       "databases": ["DATABASE_NAME"],
       "offload": TRUE | FALSE
     }
 }

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

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/export"

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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/export" | Select-Object -Expand Content

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

응답

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

이전에 설정한 IAM 역할을 유지할 필요가 없으면 지금 취소합니다.

이 요청에 대한 전체 매개변수 목록은 instances:export 페이지를 참조하세요.

mysqldump를 사용하여 로컬 MySQL 서버에서 내보내기

Cloud SQL 데이터베이스로 가져올 데이터를 온프레미스 MySQL 데이터베이스에서 내보내는 경우 다음 플래그와 함께 mysqldump 유틸리티를 사용해야 합니다.

--databases 내보낼 데이터베이스의 명시적 목록을 지정하려면 --databases 옵션을 사용해야 합니다. 이 목록에 mysql 시스템 데이터베이스가 포함되면 안 됩니다.
--hex-blob 데이터베이스에 바이너리 필드가 포함된 경우 이 플래그를 사용하여 바이너리 필드를 올바르게 가져와야 합니다.
--set-gtid-purged=OFF GTID 정보는 SQL 덤프 파일에 포함되면 안 되고, SQL 덤프 파일로 바이너리 로깅이 사용 중지되어도 안 됩니다. (MySQL 5.5 또는 외부 복제에는 필요하지 않음)
--single-transaction 실행하기 전에 트랜잭션을 시작합니다. 전체 데이터베이스를 잠그는 대신 mysqldump가 현재 상태에서 데이터베이스를 읽을 수 있으므로 일관된 데이터 덤프가 가능합니다.

명령줄에서 mysqldump를 실행합니다.

mysqldump --databases DATABASE_NAME -h INSTANCE_IP -u USERNAME -p \
--hex-blob --single-transaction --set-gtid-purged=OFF \
--default-character-set=utf8mb4 > SQL_FILE.sql

참고: Cloud SQL 인스턴스에서 저장 프로시저를 내보내려면 --routines 플래그를 포함하세요. Cloud SQL 인스턴스에서 트리거를 내보내려면 --skip-triggers가 지정되지 않았는지 확인하세요. 바이너리 로깅이 사용 설정된 상태에서 트리거 및 저장 프로시저를 내보내려면 MySQL 데이터베이스에서 log_bin_trust_function_creators 플래그도 설정해야 합니다.

mysqldump에 대한 도움말은 mysqldump 참조를 확인하세요.

MySQL용 Cloud SQL로 외부 복제

외부 서버 구성에 사용할 덤프 파일을 만들려면 외부 서버에서 복제를 참조하세요.

MySQL용 Cloud SQL로 데이터 가져오기

MySQL용 Cloud SQL로 가져오기에 필요한 역할 및 권한

데이터를 Cloud Storage에서 Cloud SQL로 가져오려면 가져오기를 시작하는 사용자에게 다음 역할 중 하나가 있어야 합니다.

Cloud SQL 관리자 역할
다음 권한이 포함된 맞춤 역할:
- cloudsql.instances.get
- cloudsql.instances.import

또한 Cloud SQL 인스턴스의 서비스 계정에는 다음 역할 중 하나가 있어야 합니다.

storage.objectAdmin IAM 역할
다음 권한이 포함된 맞춤 역할:
- storage.objects.get
- storage.objects.list(동시에 파일을 가져오는 경우에만)

IAM 역할에 대한 도움말은 Identity and Access Management를 참조하세요.

MySQL용 Cloud SQL로 SQL 덤프 파일 가져오기

SQL 파일은 일련의 SQL 명령어가 포함된 일반 텍스트 파일입니다.

Console

Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

Cloud SQL 인스턴스로 이동
인스턴스의 개요 페이지를 열려면 인스턴스 이름을 클릭합니다.
가져오기를 클릭합니다.
데이터를 가져오려는 파일 선택 섹션에서 가져오기에 사용할 버킷과 SQL 덤프 파일의 경로를 입력하거나 기존 파일을 찾습니다.
압축된 파일(.gz) 또는 압축되지 않은 파일(.sql)을 가져올 수 있습니다.
형식에 SQL을 선택합니다.
데이터를 가져올 데이터베이스를 선택합니다.

이렇게 하면 가져오기 전에 Cloud SQL이 USE DATABASE 문을 실행합니다.

SQL 덤프 파일에 USE DATABASE 문이 포함되어 있으면 Google Cloud 콘솔에서 설정된 데이터베이스를 재정의합니다.
가져오기를 수행할 사용자를 지정하려면 사용자를 선택합니다.

가져오기 파일에 특정 사용자가 수행해야 하는 문이 포함되어 있다면, 이 필드를 사용하여 해당 사용자를 지정합니다.
가져오기를 클릭하여 가져오기를 시작합니다.

gcloud

Cloud Storage 버킷을 만듭니다.
파일을 버킷에 업로드합니다.

버킷에 파일 업로드하기에 대한 도움말은 객체 업로드를 참조하세요.
가져오기의 대상 인스턴스를 설명합니다.
```
gcloud sql instances describe INSTANCE_NAME
```
serviceAccountEmailAddress 필드를 복사합니다.
gcloud storage buckets add-iam-policy-binding을 사용하여 버킷의 서비스 계정에 storage.objectAdmin IAM 역할을 부여합니다.
```
gcloud storage buckets add-iam-policy-binding gs://BUCKET_NAME \
  --member=serviceAccount:SERVICE-ACCOUNT \
  --role=roles/storage.objectAdmin
  
```
IAM 권한 설정에 대한 도움말은 IAM 권한 사용을 참고하세요.
데이터베이스를 가져옵니다.
```
gcloud sql import sql INSTANCE_NAME gs://BUCKET_NAME/IMPORT_FILE_NAME \
--database=DATABASE_NAME
```
import sql 명령어 사용에 대한 자세한 내용은 sql import sql 명령어 참조 페이지를 확인하세요.

명령어가 ERROR_RDBMS와 같은 오류를 반환할 경우 권한을 검토하세요. 이 오류는 권한 문제로 인해 발생하는 경우가 자주 있습니다.
이전에 설정한 IAM 권한을 유지할 필요가 없으면 gcloud storage buckets remove-iam-policy-binding을 사용하여 삭제합니다.

REST v1

SQL 덤프 파일을 만듭니다. 링크된 안내에서는 덤프 파일이 Cloud SQL과 호환되도록 하는 특정 플래그를 설정합니다.
- 온프레미스 MySQL 서버에서 데이터를 가져오는 경우:
- 다른 Cloud SQL 인스턴스에서 데이터를 가져오는 경우 Cloud SQL에서 SQL 덤프 파일로 데이터 내보내기의 안내를 참조하세요.
Cloud Storage 버킷을 만듭니다.
파일을 버킷에 업로드합니다.

버킷에 파일 업로드하기에 대한 도움말은 객체 업로드를 참조하세요.
인스턴스에 버킷의 legacyBucketWriter 및 objectViewer IAM 역할을 제공합니다. IAM 권한 설정에 대한 도움말은 IAM 권한 사용을 참조하세요.

덤프 파일을 가져옵니다.

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

project-id: 프로젝트 ID
instance-id: 인스턴스 ID
bucket_name: Cloud Storage 버킷 이름
path_to_sql_file: SQL 파일 경로
database_name: Cloud SQL 인스턴스 내 데이터베이스의 이름

HTTP 메서드 및 URL:

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import

JSON 요청 본문:

{
 "importContext":
   {
      "fileType": "SQL",
      "uri": "gs://bucket_name/path_to_sql_file",
      "database": "database_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://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import"

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://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import" | Select-Object -Expand Content

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

응답

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

이 요청을 위한 매개변수의 전체 목록은 instances:import 페이지를 참조하세요.

이전에 설정한 IAM 권한을 유지할 필요가 없으면 지금 삭제합니다.

REST v1beta4

SQL 덤프 파일을 만듭니다. 링크된 안내에서는 덤프 파일이 Cloud SQL과 호환되도록 하는 특정 플래그를 설정합니다.
- 온프레미스 MySQL 서버에서 데이터를 가져오는 경우:
- 다른 Cloud SQL 인스턴스에서 데이터를 가져오는 경우 Cloud SQL에서 SQL 덤프 파일로 데이터 내보내기의 안내를 참조하세요.
Cloud Storage 버킷을 만듭니다.
파일을 버킷에 업로드합니다.

버킷에 파일 업로드하기에 대한 도움말은 객체 업로드를 참조하세요.
인스턴스에 버킷의 storage.objectAdmin IAM 역할을 제공합니다. IAM 권한 설정에 대한 도움말은 IAM 권한 사용을 참조하세요.

덤프 파일을 가져옵니다.

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

project-id: 프로젝트 ID
instance-id: 인스턴스 ID
bucket_name: Cloud Storage 버킷 이름
path_to_sql_file: SQL 파일 경로
database_name: Cloud SQL 인스턴스 내 데이터베이스의 이름

HTTP 메서드 및 URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/import

JSON 요청 본문:

{
 "importContext":
   {
      "fileType": "SQL",
      "uri": "gs://bucket_name/path_to_sql_file",
      "database": "database_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://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/import"

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://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/import" | Select-Object -Expand Content

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

응답

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

이 요청을 위한 매개변수의 전체 목록은 instances:import 페이지를 참조하세요.

이전에 설정한 IAM 권한을 유지할 필요가 없으면 지금 삭제합니다.

SQL 덤프 파일을 사용하여 내보내기 및 가져오기

시작하기 전에

MySQL용 Cloud SQL에서 데이터 내보내기

MySQL용 Cloud SQL에서 내보내기에 필요한 역할 및 권한

MySQL용 Cloud SQL에서 SQL 덤프 파일로 내보내기

Console

gcloud

REST v1

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

응답

REST v1beta4

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

응답

mysqldump를 사용하여 로컬 MySQL 서버에서 내보내기

MySQL용 Cloud SQL로 외부 복제

MySQL용 Cloud SQL로 데이터 가져오기

MySQL용 Cloud SQL로 가져오기에 필요한 역할 및 권한

MySQL용 Cloud SQL로 SQL 덤프 파일 가져오기

Console

gcloud

REST v1

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

응답

REST v1beta4

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

응답

다음 단계