ファイルのエクスポートとインポートを並行して行う

MySQL | PostgreSQL | SQL Server

このページでは、Cloud SQL インスタンスへのファイルのエクスポートとインポートを並行して行う方法について説明します。

注: サポートされているデータベースサーバー（オンプレミス、AWS、Cloud SQL）から新しい Cloud SQL インスタンスにデータベース全体を移行する場合は、ファイルのエクスポートとインポートを並行して行うのではなく、Database Migration Service を使用してください。エクスポートしたファイルから新しいインスタンスを作成するためにエクスポートする場合は、バックアップから別のインスタンスに復元するか、インスタンスのクローンを作成することを検討してください。

複数のファイルを並行してインポートまたはエクスポートするオペレーションが正常に完了したかどうかは、オペレーションのステータスを確認して判断できます。また、Cloud SQL インスタンスへのデータのインポートおよびインスタンスからのデータのエクスポートをキャンセルすることもできます。インポートオペレーションやエクスポートオペレーションのキャンセルについて詳しくは、データのインポートとエクスポートをキャンセルするをご覧ください。

始める前に

エクスポートまたはインポートオペレーションを開始する前に、次のことを行います。

データベースに十分な空き容量があることを確認します。

エクスポートオペレーションとインポートオペレーションでは、データベースリソースが使用されますが、インスタンスのプロビジョニングが不足していない限り、通常のデータベースオペレーションが妨げられることはありません。

データのエクスポートとインポートのベストプラクティスに従います。
インポートオペレーションが完了したら、結果を確認します。

Cloud SQL for PostgreSQL から複数のファイルに並行してデータをエクスポートする

以降のセクションでは、Cloud SQL for PostgreSQL から複数のファイルに並行してデータをエクスポートすることについての情報が含まれます。

Cloud SQL for PostgreSQL から複数のファイルに並行してデータをエクスポートするために必要なロールと権限

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 インスタンス内のデータベースの名前。データベースは 1 つだけ指定する必要があります。
- TABLE_EXPRESSION: 指定したデータベースからエクスポートするテーブル。
注: 最大 2 つのスレッドでサーバーレスエクスポートを使用する場合は、offload パラメータを使用します。複数のファイルを並行してエクスポートする場合は、parallel パラメータを使用します。それ以外の場合は、これらのパラメータをコマンドから削除します。

export sql コマンドには、トリガーやストアドプロシージャは含まれませんが、ビューは含まれます。トリガーやストアドプロシージャをエクスポートするには、そのエクスポートにスレッドを 1 つ使用します。このスレッドでは pg_dump ツールを使用します。

エクスポートが完了すると、pg_dump ディレクトリ形式で Cloud Storage バケット内のフォルダにファイルが存在するはずです。
Cloud SQL for PostgreSQL からのエクスポートに必要なロールと権限で設定した 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 インスタンス内のデータベースの名前。データベースは 1 つだけ指定する必要があります。
- 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"
}
```

エクスポートが完了すると、pg_dump ディレクトリ形式で Cloud Storage バケット内のフォルダにファイルが存在するはずです。

Cloud SQL for PostgreSQL からのエクスポートに必要なロールと権限で設定した 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 インスタンス内のデータベースの名前。データベースは 1 つだけ指定する必要があります。
- 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"
}
```

エクスポートが完了すると、pg_dump ディレクトリ形式で Cloud Storage バケット内のフォルダにファイルが存在するはずです。

Cloud SQL for PostgreSQL からのエクスポートに必要なロールと権限で設定した IAM ロールが不要な場合は、取り消します。

リクエストのパラメータの完全な一覧については、Cloud SQL Admin API ページをご覧ください。

複数のファイルから Cloud SQL for PostgreSQL に並行してデータをインポートする

以降のセクションでは、複数のファイルから Cloud SQL for PostgreSQL に並行してデータをインポートすることについての情報が含まれます。

複数のファイルから Cloud SQL for PostgreSQL に並行してデータをインポートするために必要なロールと権限

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 をご覧ください。

Cloud SQL for PostgreSQL にデータをインポートする

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 インスタンス内のデータベースの名前。データベースは 1 つだけ指定する必要があります。
注: 最大 2 つのスレッドでサーバーレスインポートを使用する場合は、offload パラメータを使用します。複数のファイルを並行してインポートする場合は、parallel パラメータを使用します。

parallel パラメータを使用して、データベースオブジェクトを再作成する前に削除（クリーンアップ）する場合は、clean パラメータを使用します。parallel パラメータを使用し、clean パラメータによって生成された各 DROP ステートメントに IF EXISTS SQL ステートメントを配置する場合は、if-exists パラメータを使用します。

それ以外の場合は、これらのパラメータをコマンドから削除します。

コマンドから ERROR_RDBMS のようなエラーが返された場合は、権限を確認してください。このエラーの原因は多くの場合、権限の問題にあります。
Cloud SQL for PostgreSQL へのインポートに必要なロールと権限で設定した 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 インスタンス内のデータベースの名前。データベースは 1 つだけ指定する必要があります。
- 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 ページをご覧ください。
Cloud SQL for PostgreSQL へのインポートに必要なロールと権限で設定した 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 インスタンス内のデータベースの名前。データベースは 1 つだけ指定する必要があります。
- 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 ページをご覧ください。
Cloud SQL for PostgreSQL へのインポートに必要なロールと権限で設定した IAM 権限が必要ない場合は、gcloud storage buckets remove-iam-policy-binding を使用して削除します。

制限事項

データを複数のファイルから並行してインポートまたはエクスポートする場合、指定したスレッドが多すぎると、Cloud SQL インスタンスが備えているメモリよりも多くのメモリを使用する可能性があります。この場合、内部エラーメッセージが表示されます。インスタンスのメモリ使用量を確認し、必要に応じてインスタンスのサイズを増やしてください。詳細については、インスタンスの設定についてをご覧ください。
エクスポートを実行する場合、databases フィールドや tables フィールドで、データベース名やテーブル名にカンマを使用することはサポートされていません。
最初のダンプファイルのダウンロード用に十分なディスク容量があることを確認してください。容量が十分にない場合は、no space left on disk エラーが表示されます。
インスタンスに仮想 CPU（vCPU）が 1 つしかない場合、複数のファイルを並行してインポートやエクスポートすることはできません。インスタンスの vCPU の数は、インポートまたはエクスポートのオペレーションに使用するスレッド数より小さくすることはできません。また、スレッド数は 2 以上にする必要があります。
pg_dump ユーティリティは、エクスポートするテーブルをまとまりにできません。そのため、非常に大きなテーブルが 1 つある場合、エクスポートオペレーションの速度のボトルネックになる可能性があります。

次のステップ

インポートとエクスポートの各オペレーションのステータスのチェック方法を確認する。
データのインポートとエクスポートをキャンセルする方法を確認する。
データのインポートとエクスポートのベストプラクティスについて確認する。
インポートとエクスポートに関する既知の問題について確認する。

ファイルのエクスポートとインポートを並行して行う

始める前に

Cloud SQL for PostgreSQL から複数のファイルに並行してデータをエクスポートする

Cloud SQL for PostgreSQL から複数のファイルに並行してデータをエクスポートするために必要なロールと権限

データを複数のファイルに並行してエクスポートする

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

複数のファイルから Cloud SQL for PostgreSQL に並行してデータをインポートする

複数のファイルから Cloud SQL for PostgreSQL に並行してデータをインポートするために必要なロールと権限

Cloud SQL for PostgreSQL にデータをインポートする

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

制限事項

次のステップ