SQL ダンプファイルを使用したエクスポートとインポート

MySQL | PostgreSQL | SQL Server

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

Cloud SQL から SQL ダンプファイルへのエクスポートは、SQL Server ではサポートされていません。

始める前に

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

ベストプラクティスについては、データのインポートとエクスポートのベストプラクティスをご覧ください。

インポートオペレーションが完了したら、結果を確認します。

Cloud SQL for SQL Server からデータをエクスポートする

Cloud SQL から SQL ダンプファイルへのエクスポートは、SQL Server ではサポートされていません。

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

Cloud SQL for SQL Server へのインポートに必要なロールと権限

Cloud Storage から Cloud SQL にデータをインポートするには、Cloud SQL インスタンスのサービスアカウントまたはユーザーに次のいずれかのロールセットが必要です。

Cloud SQL 管理者のロールと storage.objectAdmin IAM ロール
次の権限を含むカスタムロール:
- cloudsql.instances.get
- cloudsql.instances.import
- storage.buckets.get
- storage.objects.get
- storage.objects.list（ファイルの並列インポートの場合のみ）
- storage.objects.list（ストライプエクスポートの場合のみ）

IAM ロールについては、Identity and Access Management をご覧ください。

Cloud SQL for SQL Server に SQL ダンプファイルをインポートする

SQL ファイルは、SQL コマンドのシーケンスを記述した書式なしテキストファイルです。

以下の手順では、SQL ファイルのインポート元となる既存のデータベースを指定します。

コンソール

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 フィールドをコピーします。
gsutil iam を使用して、バケットのサービスアカウントに storage.objectAdmin IAM ロールを付与します。
```
gsutil iam ch serviceAccount:SERVICE-ACCOUNT:objectAdmin \
gs://BUCKET_NAME
  
```
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 の権限を保持する必要がない場合は、gsutil iam を使用して削除してください。

REST v1

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）

注: 次のコマンドは、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/import"
```
PowerShell（Windows）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に 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/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": "user@example.com",
  "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

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）

注: 次のコマンドは、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-id/instances/instance-id/import"
```
PowerShell（Windows）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に 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-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": "user@example.com",
  "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 の権限を保持する必要がない場合は、今すぐ削除してください。

次のステップ

インポートとエクスポートの各オペレーションのステータスのチェック方法について学習する
データのインポートとエクスポートのベストプラクティスについて確認する
Cloud Storage に関する詳細
インポートとエクスポートの既知の問題