동시에 파일 내보내기 및 가져오기

MySQL | PostgreSQL | SQL Server

이 페이지에서는 파일을 Cloud SQL 인스턴스로 동시에 내보내고 가져오는 방법을 설명합니다.

참고: 지원되는 데이터베이스 서버(온프레미스, AWS 또는 Cloud SQL)에서 전체 데이터베이스를 새로운 Cloud SQL 인스턴스로 마이그레이션하는 경우 파일을 동시에 내보내고 가져오는 대신 Database Migration Service를 사용할 수 있습니다. 내보낸 파일에서 새 인스턴스를 만들기 위해 내보내려는 경우 백업에서 다른 인스턴스로 복원이나 인스턴스 클론을 고려하세요.

작업 상태를 확인하여 여러 파일의 동시 가져오기 또는 내보내기 작업이 완료되었는지 확인할 수 있습니다. Cloud SQL 인스턴스로 데이터 가져오기와 인스턴스에서 데이터 내보내기를 취소할 수도 있습니다. 가져오기 또는 내보내기 작업 취소에 대한 자세한 내용은 데이터 가져오기 및 내보내기 취소를 참조하세요.

시작하기 전에

내보내기 또는 가져오기 작업을 시작하기 전에 다음 사항을 확인하세요.

데이터베이스에 충분한 여유 공간이 있는지 확인합니다.

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

데이터 내보내기 및 가져오기 권장사항을 따르세요.
가져오기 작업을 완료한 후 결과를 확인합니다.

PostgreSQL용 Cloud SQL에서 여러 파일로 동시에 데이터 내보내기

다음 섹션에는 PostgreSQL용 Cloud SQL에서 여러 파일로 동시에 데이터를 내보내는 방법에 대한 정보가 포함되어 있습니다.

PostgreSQL용 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를 참조하세요.

여러 파일로 데이터 동시에 내보내기

Cloud SQL에 있는 여러 파일에서 Cloud Storage로 데이터를 동시에 내보낼 수 있습니다. 이렇게 하려면 --jobs 옵션과 함께 pg_dump 유틸리티를 사용합니다.

Cloud SQL로 데이터를 가져오려면 파일 형식이 Cloud SQL에 맞게 지정되도록 외부 데이터베이스 서버에서 데이터 내보내기에 나와 있는 안내를 따라야 합니다.

gcloud

Cloud SQL에서 여러 파일로 데이터를 동시에 내보내려면 다음 단계를 완료하세요.

Cloud Storage 버킷을 만듭니다.
참고: 버킷에 폴더를 만들 필요는 없습니다. 폴더가 없으면 Cloud SQL에서 여러 파일을 동시에 내보내는 과정에서 자동으로 폴더를 만듭니다. 하지만 폴더가 있는 경우에는 비어 있어야 하며, 그렇지 않으면 내보내기 작업이 실패합니다.
파일을 내보낼 Cloud SQL 인스턴스의 서비스 계정을 찾으려면
gcloud sql instances describe 명령어를 사용합니다.
```
gcloud sql instances describe INSTANCE_NAME
```

INSTANCE_NAME을 Cloud SQL 인스턴스의 이름으로 바꿉니다.

출력에서 serviceAccountEmailAddress 필드와 연결된 값을 찾습니다.

서비스 계정에 storage.objectAdmin IAM 역할을 부여하려면 gcloud storage buckets add-iam-policy-binding 명령어를 사용합니다. IAM 권한 설정에 대한 도움말은 IAM 권한 사용을 참조하세요.
Cloud SQL에서 여러 파일로 데이터를 동시에 내보내려면 gcloud sql export sql 명령어를 사용합니다.
```
gcloud sql export sql INSTANCE_NAME gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME \
--offload \
--parallel \
--threads=THREAD_NUMBER \
--database=DATABASE_NAME \
--table=TABLE_EXPRESSION
```
다음을 바꿉니다.
- INSTANCE_NAME: 파일을 동시에 내보내는 Cloud SQL 인스턴스의 이름입니다.
- BUCKET_NAME: Cloud Storage 버킷의 이름입니다.
- BUCKET_PATH: 내보내기 파일이 저장된 버킷의 경로입니다.
- FOLDER_NAME: 내보내기 파일이 저장된 폴더입니다.
- THREAD_NUMBER: Cloud SQL에서 파일을 동시에 내보내는 데 사용하는 스레드 수입니다. 예를 들어 한 번에 파일 3개를 동시에 내보내려면 이 매개변수의 값으로 3을 지정합니다.
- DATABASE_NAME: 내보내기가 수행된 Cloud SQL 인스턴스 내 데이터베이스의 이름입니다. 데이터베이스는 하나만 지정해야 합니다.
- TABLE_EXPRESSION: 지정된 데이터베이스에서 내보낼 테이블입니다.
참고: 최대 2개의 스레드에 대해 서버리스 내보내기를 사용하려면 offload 매개변수를 사용합니다. 여러 파일을 동시에 내보내려면 parallel 매개변수를 사용하세요. 그렇지 않으면 명령어에서 이러한 매개변수를 삭제합니다.

export sql 명령어에는 트리거 또는 저장 프로시저가 포함되지 않지만 뷰가 포함됩니다. 트리거 또는 저장 프러시저를 내보내려면 내보내기에 단일 스레드를 사용하세요. 이 스레드에서는 pg_dump 도구를 사용합니다.

내보내기가 완료되면 Cloud Storage 버킷의 폴더에 pg_dump 디렉터리 형식의 파일이 생성됩니다.
PostgreSQL용 Cloud SQL에서 내보내기에 필요한 역할 및 권한에서 설정한 IAM 역할이 필요하지 않으면 취소합니다.

REST v1

Cloud SQL에서 여러 파일로 데이터를 동시에 내보내려면 다음 단계를 완료하세요.

Cloud Storage 버킷을 만듭니다.
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
다음을 바꿉니다.
- BUCKET_NAME: 이름 지정 요구사항이 적용되는 버킷의 이름입니다. 예를 들면 my-bucket입니다.
- PROJECT_NAME: 만들려는 Cloud Storage 버킷이 포함된 Google Cloud 프로젝트의 이름입니다.
- LOCATION_NAME: 내보낼 파일을 저장할 버킷의 위치입니다. 예를 들면 us-east1입니다.
참고: 버킷에 폴더를 만들 필요는 없습니다. 폴더가 없으면 Cloud SQL에서 여러 파일을 동시에 내보내는 과정에서 자동으로 폴더를 만듭니다. 하지만 폴더가 있는 경우에는 비어 있어야 하며, 그렇지 않으면 내보내기 작업이 실패합니다.
인스턴스에 버킷의 legacyBucketWriter IAM 역할을 제공합니다. IAM 권한 설정에 대한 도움말은 IAM 권한 사용을 참조하세요.
Cloud SQL에서 여러 파일로 데이터를 동시에 내보냅니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_NAME: 생성한 Cloud Storage 버킷이 포함된 Google Cloud 프로젝트의 이름입니다.
- INSTANCE_NAME: 파일을 동시에 내보내는 Cloud SQL 인스턴스의 이름입니다.
- BUCKET_NAME: Cloud Storage 버킷의 이름입니다.
- BUCKET_PATH: 내보내기 파일이 저장된 버킷의 경로입니다.
- FOLDER_NAME: 내보내기 파일이 저장된 폴더입니다.
- DATABASE_NAME: 내보내기가 수행된 Cloud SQL 인스턴스 내 데이터베이스의 이름입니다. 데이터베이스는 하나만 지정해야 합니다.
- THREAD_NUMBER: Cloud SQL에서 파일을 동시에 내보내는 데 사용하는 스레드 수입니다. 예를 들어 한 번에 파일 3개를 동시에 내보내려면 이 매개변수의 값으로 3을 지정합니다.
참고: offload 매개변수를 사용하면 최대 2개의 스레드에 대해 서버리스 내보내기를 사용할 수 있습니다. parallel 매개변수를 사용하면 여러 파일을 동시에 내보낼 수 있습니다. 이러한 기능을 사용하려면 이러한 매개변수의 값을 TRUE로 설정합니다. 그렇지 않으면 값을 FALSE로 설정합니다.

HTTP 메서드 및 URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/instances/INSTANCE_NAME/export
```
JSON 요청 본문:
```
{
 "exportContext":
   {
      "fileType": "SQL",
      "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
      "databases": ["DATABASE_NAME"],
      "offload": [TRUE|FALSE],
      "sqlExportOptions": {
        "parallel": [TRUE|FALSE],
        "threads": [THREAD_NUMBER]
       }
   }
}
```
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
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_NAME/instances/INSTANCE_NAME/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_NAME/instances/INSTANCE_NAME/export" | Select-Object -Expand Content
```
다음과 비슷한 JSON 응답이 표시됩니다.
응답
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/operations/OPERATION_ID",
  "targetProject": "PROJECT_NAME"
}
```

내보내기가 완료되면 Cloud Storage 버킷의 폴더에 pg_dump 디렉터리 형식의 파일이 생성됩니다.

PostgreSQL용 Cloud SQL에서 내보내기에 필요한 역할 및 권한에서 설정한 IAM 역할이 필요하지 않으면 취소합니다.

이 요청에 대한 전체 매개변수 목록은 Cloud SQL Admin API 페이지를 참조하세요.

REST v1beta4

Cloud SQL에서 여러 파일로 데이터를 동시에 내보내려면 다음 단계를 완료하세요.

Cloud Storage 버킷을 만듭니다.
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
다음을 바꿉니다.
- BUCKET_NAME: 이름 지정 요구사항이 적용되는 버킷의 이름입니다. 예를 들면 my-bucket입니다.
- PROJECT_NAME: 만들려는 Cloud Storage 버킷이 포함된 Google Cloud 프로젝트의 이름입니다.
- LOCATION_NAME: 내보낼 파일을 저장할 버킷의 위치입니다. 예를 들면 us-east1입니다.
참고: 버킷에 폴더를 만들 필요는 없습니다. 폴더가 없으면 Cloud SQL에서 여러 파일을 동시에 내보내는 과정에서 자동으로 폴더를 만듭니다. 하지만 폴더가 있는 경우에는 비어 있어야 하며, 그렇지 않으면 내보내기 작업이 실패합니다.
인스턴스에 버킷의 storage.objectAdmin IAM 역할을 제공합니다. IAM 권한 설정에 대한 도움말은 IAM 권한 사용을 참조하세요.
Cloud SQL에서 여러 파일로 데이터를 동시에 내보냅니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_NAME: 생성한 Cloud Storage 버킷이 포함된 Google Cloud 프로젝트의 이름입니다.
- INSTANCE_NAME: 파일을 동시에 내보내는 Cloud SQL 인스턴스의 이름입니다.
- BUCKET_NAME: Cloud Storage 버킷의 이름입니다.
- BUCKET_PATH: 내보내기 파일이 저장된 버킷의 경로입니다.
- FOLDER_NAME: 내보내기 파일이 저장된 폴더입니다.
- DATABASE_NAME: 내보내기가 수행된 Cloud SQL 인스턴스 내 데이터베이스의 이름입니다. 데이터베이스는 하나만 지정해야 합니다.
- THREAD_NUMBER: Cloud SQL에서 파일을 동시에 내보내는 데 사용하는 스레드 수입니다. 예를 들어 한 번에 파일 3개를 동시에 내보내려면 이 매개변수의 값으로 3을 지정합니다.
참고: offload 매개변수를 사용하면 최대 2개의 스레드에 대해 서버리스 내보내기를 사용할 수 있습니다. parallel 매개변수를 사용하면 여러 파일을 동시에 내보낼 수 있습니다. 이러한 기능을 사용하려면 이러한 매개변수의 값을 TRUE로 설정합니다. 그렇지 않으면 값을 FALSE로 설정합니다.

HTTP 메서드 및 URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/instances/INSTANCE_NAME/export
```
JSON 요청 본문:
```
{
 "exportContext":
   {
      "fileType": "SQL",
      "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
      "databases": ["DATABASE_NAME"],
      "offload": [TRUE|FALSE],
      "sqlExportOptions": {
        "parallel": [TRUE|FALSE],
        "threads": [THREAD_NUMBER]
       }
   }
}
```
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
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/sql/v1beta4/projects/PROJECT_NAME/instances/INSTANCE_NAME/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/sql/v1beta4/projects/PROJECT_NAME/instances/INSTANCE_NAME/export" | Select-Object -Expand Content
```
다음과 비슷한 JSON 응답이 표시됩니다.
응답
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/operations/OPERATION_ID",
  "targetProject": "PROJECT_NAME"
}
```

내보내기가 완료되면 Cloud Storage 버킷의 폴더에 pg_dump 디렉터리 형식의 파일이 생성됩니다.

PostgreSQL용 Cloud SQL에서 내보내기에 필요한 역할 및 권한에서 설정한 IAM 역할이 필요하지 않으면 취소합니다.

이 요청에 대한 전체 매개변수 목록은 Cloud SQL Admin API 페이지를 참조하세요.

여러 파일에서 PostgreSQL용 Cloud SQL로 동시에 데이터 가져오기

다음 섹션에는 여러 파일에서 PostgreSQL용 Cloud SQL로 동시에 데이터를 가져오는 방법에 대한 정보가 포함되어 있습니다.

여러 파일에서 데이터를 PostgreSQL용 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를 참조하세요.

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

Cloud Storage에 있는 여러 파일에서 데이터베이스로 데이터를 동시에 가져올 수 있습니다. 이렇게 하려면 --jobs 옵션과 함께 pg_restore 유틸리티를 사용합니다.

gcloud

여러 파일의 데이터를 Cloud SQL로 동시에 가져오려면 다음 단계를 완료하세요.

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

참고: 업로드하는 파일이 pg_dump 디렉터리 형식이어야 합니다. 자세한 내용은 여러 파일에서 동시에 데이터 내보내기를 참조하세요.

버킷에 파일 업로드에 대한 도움말은 파일에서 객체 업로드를 참조하세요.
파일을 가져올 Cloud SQL 인스턴스의 서비스 계정을 찾으려면
gcloud sql instances describe 명령어를 사용합니다.
```
gcloud sql instances describe INSTANCE_NAME
```

INSTANCE_NAME을 Cloud SQL 인스턴스의 이름으로 바꿉니다.

출력에서 serviceAccountEmailAddress 필드와 연결된 값을 찾습니다.

서비스 계정에 storage.objectAdmin IAM 역할을 부여하려면 gcloud storage buckets add-iam-policy-binding 유틸리티를 사용합니다. IAM 권한 설정에 대한 도움말은 IAM 권한 사용을 참조하세요.
여러 파일의 데이터를 Cloud SQL로 동시에 가져오려면 gcloud sql import sql 명령어를 사용합니다.
```
gcloud sql import sql INSTANCE_NAME gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME \
--offload \
--parallel \ 
--threads=THREAD_NUMBER \
--database=DATABASE_NAME
```
다음을 바꿉니다.
- INSTANCE_NAME: 파일을 동시에 가져올 Cloud SQL 인스턴스의 이름입니다.
- BUCKET_NAME: Cloud Storage 버킷의 이름입니다.
- BUCKET_PATH: 가져오기 파일이 저장된 버킷의 경로입니다.
- FOLDER_NAME: 가져오기 파일이 저장된 폴더입니다.
- THREAD_NUMBER: Cloud SQL에서 파일을 동시에 가져오는 데 사용하는 스레드 수입니다. 예를 들어 한 번에 파일 3개를 동시에 가져오려면 이 매개변수의 값으로 3을 지정합니다.
- DATABASE_NAME: 가져오기가 수행되는 Cloud SQL 인스턴스 내 데이터베이스의 이름. 데이터베이스는 하나만 지정해야 합니다.
참고: 스레드 최대 2개의 서버리스 가져오기를 사용하려면 offload 매개변수를 사용하세요. 파일 여러 개를 동시에 가져오려면 parallel 매개변수를 사용하세요.

parallel 매개변수를 사용하고 데이터베이스 객체를 다시 만들기 전에 삭제(정리)하려면 clean 매개변수를 사용합니다. parallel 매개변수를 사용하고 clean 매개변수로 생성된 각 DROP 문에 IF EXISTS SQL 문을 포함하려면 if-exists 매개변수를 사용합니다.

그렇지 않으면 명령어에서 이러한 매개변수를 삭제합니다.

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

REST v1

여러 파일의 데이터를 Cloud SQL로 동시에 가져오려면 다음 단계를 완료하세요.

Cloud Storage 버킷을 만듭니다.
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
다음을 바꿉니다.
- BUCKET_NAME: 이름 지정 요구사항이 적용되는 버킷의 이름입니다. 예를 들면 my-bucket입니다.
- PROJECT_NAME: 만들려는 Cloud Storage 버킷이 포함된 Google Cloud 프로젝트의 이름입니다.
- LOCATION_NAME: 가져올 파일을 저장할 버킷의 위치입니다. 예를 들면 us-east1입니다.
파일을 버킷에 업로드합니다.

참고: 업로드하는 파일이 pg_dump 디렉터리 형식이어야 합니다. 자세한 내용은 여러 파일에서 동시에 데이터 내보내기를 참조하세요.

버킷에 파일 업로드에 대한 도움말은 파일에서 객체 업로드를 참조하세요.
인스턴스에 버킷의 storage.objectAdmin IAM 역할을 제공합니다. IAM 권한 설정에 대한 도움말은 IAM 권한 사용을 참조하세요.
여러 파일에서 Cloud SQL로 데이터를 동시에 가져옵니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_NAME: 생성한 Cloud Storage 버킷이 포함된 Google Cloud 프로젝트의 이름입니다.
- INSTANCE_NAME: 파일을 동시에 가져올 Cloud SQL 인스턴스의 이름입니다.
- BUCKET_NAME: Cloud Storage 버킷의 이름입니다.
- BUCKET_PATH: 가져오기 파일이 저장된 버킷의 경로입니다.
- FOLDER_NAME: 가져오기 파일이 저장된 폴더입니다.
- DATABASE_NAME: 가져오기가 수행되는 Cloud SQL 인스턴스 내 데이터베이스의 이름. 데이터베이스는 하나만 지정해야 합니다.
- THREAD_NUMBER: Cloud SQL에서 파일을 동시에 가져오는 데 사용하는 스레드 수입니다. 예를 들어 한 번에 파일 3개를 동시에 가져오려면 이 매개변수의 값으로 3을 지정합니다.
참고: offload 매개변수를 사용하면 스레드 최대 2개까지 서버리스 가져오기를 사용할 수 있습니다. parallel 매개변수를 사용하면 파일 여러 개를 동시에 가져올 수 있습니다.
parallel 매개변수를 사용하는 경우 clean 매개변수를 사용하면 데이터베이스 객체를 다시 만들기 전에 삭제(정리)할 수 있습니다. parallel 매개변수를 사용하는 경우 ifExists 매개변수를 사용하면 clean 매개변수로 생성된 각 DROP 문에 IF EXISTS SQL 문을 포함할 수 있습니다.

이러한 기능을 사용하려면 이러한 매개변수의 값을 TRUE로 설정합니다. 그렇지 않으면 값을 FALSE로 설정합니다.

HTTP 메서드 및 URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/instances/INSTANCE_NAME/import
```
JSON 요청 본문:
```
{
  "importContext":
    {
       "fileType": "SQL",
       "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
       "databases": ["DATABASE_NAME"],
       "offload": [TRUE|FALSE],
       "sqlImportOptions": {
         "parallel": [TRUE|FALSE],
         "clean": [TRUE|FALSE],
         "ifExists": [TRUE|FALSE],
         "threads": [THREAD_NUMBER]
        }
    }
 }
```
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
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_NAME/instances/INSTANCE_NAME/import"
```
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_NAME/instances/INSTANCE_NAME/import" | Select-Object -Expand Content
```
다음과 비슷한 JSON 응답이 표시됩니다.
응답
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_NAME/operations/OPERATION_ID",
  "targetProject": "PROJECT_NAME"
}
```
가져오기에 다른 사용자를 사용하려면 importContext.importUser 속성을 지정합니다.
이 요청에 대한 전체 매개변수 목록은 Cloud SQL Admin API 페이지를 참조하세요.
PostgreSQL용 Cloud SQL로 가져오기에 필요한 역할 및 권한에서 설정한 IAM 권한이 필요하지 않으면 gcloud storage buckets remove-iam-policy-binding을 사용하여 삭제합니다.

REST v1beta4

여러 파일의 데이터를 Cloud SQL로 동시에 가져오려면 다음 단계를 완료하세요.

Cloud Storage 버킷을 만듭니다.
```
gcloud storage buckets create gs://BUCKET_NAME --project=PROJECT_NAME --location=LOCATION_NAME
```
다음을 바꿉니다.
- BUCKET_NAME: 이름 지정 요구사항이 적용되는 버킷의 이름입니다. 예를 들면 my-bucket입니다.
- PROJECT_NAME: 만들려는 Cloud Storage 버킷이 포함된 Google Cloud 프로젝트의 이름입니다.
- LOCATION_NAME: 가져올 파일을 저장할 버킷의 위치입니다. 예를 들면 us-east1입니다.
파일을 버킷에 업로드합니다.

참고: 업로드하는 파일이 pg_dump 디렉터리 형식이어야 합니다. 자세한 내용은 여러 파일에서 동시에 데이터 내보내기를 참조하세요.

버킷에 파일 업로드에 대한 도움말은 파일에서 객체 업로드를 참조하세요.
인스턴스에 버킷의 storage.objectAdmin IAM 역할을 제공합니다. IAM 권한 설정에 대한 도움말은 IAM 권한 사용을 참조하세요.
여러 파일에서 Cloud SQL로 데이터를 동시에 가져옵니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_NAME: 생성한 Cloud Storage 버킷이 포함된 Google Cloud 프로젝트의 이름입니다.
- INSTANCE_NAME: 파일을 동시에 가져오는 Cloud SQL 인스턴스의 이름입니다.
- BUCKET_NAME: Cloud Storage 버킷의 이름입니다.
- BUCKET_PATH: 가져오기 파일이 저장된 버킷의 경로입니다.
- FOLDER_NAME: 가져오기 파일이 저장된 폴더입니다.
- DATABASE_NAME: 가져오기가 수행되는 Cloud SQL 인스턴스 내 데이터베이스의 이름. 데이터베이스는 하나만 지정해야 합니다.
- THREAD_NUMBER: Cloud SQL에서 파일을 동시에 가져오는 데 사용하는 스레드 수입니다. 예를 들어 한 번에 파일 3개를 동시에 가져오려면 이 매개변수의 값으로 3을 지정합니다.
참고: offload 매개변수를 사용하면 스레드 최대 2개까지 서버리스 가져오기를 사용할 수 있습니다. parallel 매개변수를 사용하면 파일 여러 개를 동시에 가져올 수 있습니다.
parallel 매개변수를 사용하는 경우 clean 매개변수를 사용하면 데이터베이스 객체를 다시 만들기 전에 삭제(정리)할 수 있습니다. parallel 매개변수를 사용하는 경우 ifExists 매개변수를 사용하면 clean 매개변수로 생성된 각 DROP 문에 IF EXISTS SQL 문을 포함할 수 있습니다.

이러한 기능을 사용하려면 이러한 매개변수의 값을 TRUE로 설정합니다. 그렇지 않으면 값을 FALSE로 설정합니다.

HTTP 메서드 및 URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/instances/INSTANCE_NAME/import
```
JSON 요청 본문:
```
 {
   "importContext":
     {
        "fileType": "SQL",
        "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
        "databases": ["DATABASE_NAME"],
        "offload": [TRUE|FALSE],
        "sqlImportOptions": {
          "parallel": [TRUE|FALSE],
          "clean": [TRUE|FALSE],
          "ifExists": [TRUE|FALSE],
          "threads": [THREAD_NUMBER]
         }
     }
  }
```
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
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/sql/v1beta4/projects/PROJECT_NAME/instances/INSTANCE_NAME/import"
```
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/sql/v1beta4/projects/PROJECT_NAME/instances/INSTANCE_NAME/import" | Select-Object -Expand Content
```
다음과 비슷한 JSON 응답이 표시됩니다.
응답
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/instances/DESTINATION_INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_NAME/operations/OPERATION_ID",
  "targetProject": "PROJECT_NAME"
}
```
가져오기에 다른 사용자를 사용하려면 importContext.importUser 속성을 지정합니다.
이 요청에 대한 전체 매개변수 목록은 Cloud SQL Admin API 페이지를 참조하세요.
PostgreSQL용 Cloud SQL로 가져오기에 필요한 역할 및 권한에서 설정한 IAM 권한이 필요하지 않으면 gcloud storage buckets remove-iam-policy-binding을 사용하여 삭제합니다.

제한사항

여러 파일에서 데이터를 동시에 가져오거나 내보낼 때 스레드를 너무 많이 지정하면 Cloud SQL 인스턴스의 메모리 용량을 초과하여 사용할 수 있습니다. 이 경우 내부 오류 메시지가 표시됩니다. 인스턴스의 메모리 사용량을 확인하고 필요에 따라 인스턴스 크기를 늘립니다. 자세한 내용은 인스턴스 설정 정보를 참조하세요.
내보내기를 수행할 때 databases 또는 tables 필드의 데이터베이스 이름 또는 테이블 이름에 쉼표가 지원되지 않습니다.
초기 덤프 파일 다운로드를 위한 디스크 공간이 충분한지 확인합니다. 그렇지 않으면 no space left on disk 오류가 표시됩니다.
인스턴스에 가상 CPU(vCPU)가 하나만 있으면 여러 파일을 동시에 가져오거나 내보낼 수 없습니다. 인스턴스의 vCPU 수는 가져오기 또는 내보내기 작업에 사용하는 스레드 수보다 작을 수 없으며 스레드 수는 2개 이상이어야 합니다.
pg_dump 유틸리티는 사용자가 내보내기한 어떤 테이블도 청킹할 수 없습니다. 따라서 매우 큰 테이블이 하나 있으면 내보내기 작업 속도에 병목 현상이 발생할 수 있습니다.

동시에 파일 내보내기 및 가져오기

시작하기 전에

PostgreSQL용 Cloud SQL에서 여러 파일로 동시에 데이터 내보내기

PostgreSQL용 Cloud SQL에서 여러 파일로 데이터를 동시에 내보내는 데 필요한 역할 및 권한

여러 파일로 데이터 동시에 내보내기

gcloud

REST v1

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

응답

REST v1beta4

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

응답

여러 파일에서 PostgreSQL용 Cloud SQL로 동시에 데이터 가져오기

여러 파일에서 데이터를 PostgreSQL용 Cloud SQL로 동시에 가져오는 데 필요한 역할 및 권한

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

gcloud

REST v1

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

응답

REST v1beta4

cURL(Linux, macOS, Cloud Shell)

PowerShell(Windows)

응답

제한사항

다음 단계