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

MySQL | PostgreSQL | SQL Server

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

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

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

始める前に

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

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

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

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

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

以降のセクションでは、データを Cloud SQL for MySQL から複数のファイルに並行してエクスポートする方法について説明します。

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

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 へ並行してエクスポートできます。これを行うには、dumpInstance ユーティリティを使用します。

Cloud Storage に保存されたファイルを別の Cloud SQL データベースにインポートできます。ローカルでファイル内のデータにアクセスする場合は、そのデータを Cloud Storage からローカル環境にダウンロードします。

ファイルに DEFINER 句（ビュー、トリガー、stored_procedures など）が含まれている場合、これらのステートメントが実行される順序によっては、これらのファイルを使用したインポートが失敗する可能性があります。Cloud SQL での DEFINER の使用方法と回避策をご覧ください。

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 ロールを付与するために、gsutil iam ユーティリティを使用します。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 インスタンス内のデータベース名。データベースを指定しない場合、Cloud SQL はインスタンスのすべてのデータベースをエクスポートします。
- TABLE_EXPRESSION: 指定したデータベースからエクスポートするテーブル。
注: 最大 2 つのスレッドでサーバーレスエクスポートを使用する場合は、offload パラメータを使用します。複数のファイルを並行してエクスポートする場合は、parallel パラメータを使用します。それ以外の場合は、これらのパラメータをコマンドから削除します。

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

エクスポートが完了すると、Cloud Storage バケット内のフォルダには MySQL Shell ダンプ形式のファイルが作成されているはずです。
Cloud SQL for MySQL からのエクスポートに必要なロールと権限で設定した IAM ロールが不要な場合は、それを取り消します。

REST v1

データを Cloud SQL から複数のファイルに並行してエクスポートするには、次の操作を行います。

Cloud Storage バケットを作成します。
```
gsutil mb -p PROJECT_NAME -l LOCATION_NAME gs://BUCKET_NAME
```
次のように置き換えます。
- PROJECT_NAME: 作成する Cloud Storage バケットを含む Google Cloud プロジェクトの名前。
- LOCATION_NAME: エクスポートするファイルを保存するバケットのロケーション。例: us-east1
- BUCKET_NAME: 命名要件に基づくバケットの名前。例: my-bucket
注: バケットにフォルダを作成する必要はありません。フォルダが存在しない場合は、複数のファイルを並行してエクスポートするプロセスの一環として、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 インスタンス内のデータベース名。データベースを指定しない場合、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 バケット内のフォルダには MySQL Shell ダンプ形式のファイルが作成されているはずです。

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

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

REST v1beta4

データを Cloud SQL から複数のファイルに並行してエクスポートするには、次の操作を行います。

Cloud Storage バケットを作成します。
```
gsutil mb -p PROJECT_NAME -l LOCATION_NAME gs://BUCKET_NAME
```
次のように置き換えます。
- PROJECT_NAME: 作成する Cloud Storage バケットを含む Google Cloud プロジェクトの名前。
- LOCATION_NAME: エクスポートするファイルを保存するバケットのロケーション。例: us-east1
- BUCKET_NAME: 命名要件に基づくバケットの名前。例: my-bucket
注: バケットにフォルダを作成する必要はありません。フォルダが存在しない場合は、複数のファイルを並行してエクスポートするプロセスの一環として、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 インスタンス内のデータベース名。データベースを指定しない場合、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 バケット内のフォルダには MySQL Shell ダンプ形式のファイルが作成されているはずです。

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

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

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

以降のセクションでは、データを複数のファイルから Cloud SQL for MySQL に並行してインポートする方法について説明します。

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

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 MySQL にデータをインポートする

データは、Cloud Storage にある複数のファイルからデータベースに並行してインポートできます。これを行うには、loadDump ユーティリティを使用します。

gcloud

データを複数のファイルから Cloud SQL に並行してインポートするには、次の操作を行います。

Cloud Storage バケットを作成します。
ファイルをバケットにアップロードします。

注: アップロードするファイルが MySQL Shell ダンプ形式であることを確認してください。詳細については、データを複数のファイルから並行してエクスポートするをご覧ください。

ファイルをバケットにアップロードする方法については、ファイルからオブジェクトをアップロードするをご覧ください。
ファイルのインポート先の Cloud SQL インスタンスのサービスアカウントを確認するために、gcloud sql instances describe コマンドを使用します。
```
gcloud sql instances describe INSTANCE_NAME
```

INSTANCE_NAME は、Cloud SQL インスタンスの名前に置き換えます。

出力で、serviceAccountEmailAddress フィールドに関連付けられた値を探します。

サービスアカウントに storage.objectAdmin IAM ロールを付与するために、gsutil iam ユーティリティを使用します。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 インスタンス内のデータベース名。データベースを指定しない場合、Cloud SQL はインスタンスのすべてのデータベースをインポートします。
注: 最大 2 つのスレッドでサーバーレスインポートを使用する場合は、offload パラメータを使用します。複数のファイルを並行してインポートする場合は、parallel パラメータを使用します。それ以外の場合は、これらのパラメータをコマンドから削除します。

コマンドから ERROR_RDBMS のようなエラーが返された場合は、権限を確認してください。このエラーの原因は多くの場合、権限の問題にあります。
Cloud SQL for MySQL へのインポートに必要なロールと権限で設定した IAM 権限が不要な場合は、gsutil iam を使用して削除します。

REST v1

データを複数のファイルから Cloud SQL に並行してインポートするには、次の操作を行います。

Cloud Storage バケットを作成します。
```
gsutil mb -p PROJECT_NAME -l LOCATION_NAME gs://BUCKET_NAME
```
次のように置き換えます。
- PROJECT_NAME: 作成する Cloud Storage バケットを含む Google Cloud プロジェクトの名前。
- LOCATION_NAME: インポートするファイルを保存するバケットのロケーション。例: us-east1
- BUCKET_NAME: 命名要件に基づくバケットの名前。例: my-bucket
ファイルをバケットにアップロードします。

注: アップロードするファイルが MySQL Shell ダンプ形式であることを確認してください。詳細については、データを複数のファイルから並行してエクスポートするをご覧ください。

ファイルをバケットにアップロードする方法については、ファイルからオブジェクトをアップロードするをご覧ください。
インスタンスにバケットに対する 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 インスタンス内のデータベース名。データベースを指定しない場合、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/import
```
リクエストの本文（JSON）:
```
{
 "importContext":
   {
      "fileType": "SQL",
      "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
      "databases": ["DATABASE_NAME"],
      "offload": [TRUE|FALSE],
      "sqlImportOptions": {
        "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/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"
}
```
リクエストのパラメータの一覧については、Cloud SQL Admin API ページをご覧ください。
Cloud SQL for MySQL へのインポートに必要なロールと権限で設定した IAM 権限が不要な場合は、gsutil iam を使用して削除します。

REST v1beta4

データを複数のファイルから Cloud SQL に並行してインポートするには、次の操作を行います。

Cloud Storage バケットを作成します。
```
gsutil mb -p PROJECT_NAME -l LOCATION_NAME gs://BUCKET_NAME
```
次のように置き換えます。
- PROJECT_NAME: 作成する Cloud Storage バケットを含む Google Cloud プロジェクトの名前。
- LOCATION_NAME: インポートするファイルを保存するバケットのロケーション。例: us-east1
- BUCKET_NAME: 命名要件に基づくバケットの名前。例: my-bucket
ファイルをバケットにアップロードします。

注: アップロードするファイルが MySQL Shell ダンプ形式であることを確認してください。詳細については、データを複数のファイルから並行してエクスポートするをご覧ください。

ファイルをバケットにアップロードする方法については、ファイルからオブジェクトをアップロードするをご覧ください。
インスタンスにバケットに対する 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 インスタンス内のデータベース名。データベースを指定しない場合、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/import
```
リクエストの本文（JSON）:
```
{
 "importContext":
   {
      "fileType": "SQL",
      "uri": "gs://BUCKET_NAME/BUCKET_PATH/FOLDER_NAME",
      "databases": ["DATABASE_NAME"],
      "offload": [TRUE|FALSE],
      "sqlImportOptions": {
        "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/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"
}
```
リクエストのパラメータの一覧については、Cloud SQL Admin API ページをご覧ください。
Cloud SQL for MySQL へのインポートに必要なロールと権限で設定した IAM 権限が不要な場合は、gsutil iam を使用して削除します。

制限事項

データを複数のファイルから並行してインポートまたはエクスポートする場合、指定したスレッドが多すぎると、Cloud SQL インスタンスが備えているメモリよりも多くのメモリを使用する可能性があります。この場合、内部エラーメッセージが表示されます。インスタンスのメモリ使用量を確認し、必要に応じてインスタンスのサイズを増やしてください。詳細については、インスタンスの設定についてをご覧ください。
エクスポートを実行する場合、databases フィールドや tables フィールドで、データベース名やテーブル名にカンマを使用することはサポートされていません。
最初のダンプファイルのダウンロード用に十分なディスク容量があることを確認してください。容量が十分にない場合は、no space left on disk エラーが表示されます。
インスタンスに仮想 CPU（vCPU）が 1 つしかない場合、複数のファイルを並行してインポートやエクスポートすることはできません。インスタンスの vCPU の数は、インポートやエクスポートのオペレーションに使用するスレッド数より小さくすることはできません。また、スレッド数は 2 以上にする必要があります。
エクスポートオペレーションの際、データ定義言語（DDL）ステートメント（CREATE、DROP、ALTER など）を記述すると、オペレーションが失敗する可能性や、エクスポートされたデータがポイントインタイムリカバリスナップショットと一致しなくなる可能性があります。
インポートオペレーションが失敗した場合、部分的にインポートされたデータが残っている可能性があります。DDL ステートメントの場合、MySQL は自動的に commit します。このような場合は、データを再度インポートする前に、部分的にインポートされたデータをクリーンアップしてください。

次のステップ

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

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

始める前に

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

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

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

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

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

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

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

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

制限事項

次のステップ