BAK ファイルとトランザクションログファイルを使用したエクスポートとインポート

MySQL | PostgreSQL | SQL Server

このページでは、BAK ファイルを使用して Cloud SQL インスタンスにデータのエクスポートとインポートを行う方法について説明します。また、トランザクションログファイルを使用して Cloud SQL インスタンスにデータをインポートする方法も説明します。

始める前に

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

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

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

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

Cloud SQL は、組み込みの BAK ファイルのエクスポートをサポートしています。

エクスポートされたファイルから新しいインスタンスを作成する場合は、バックアップから別のインスタンスに復元またはインスタンスのクローン作成を検討してください。

エクスポートオペレーション中に、選択したデータベースのフルバックアップが Cloud SQL によって実行されます。

Cloud SQL for SQL Server からのエクスポートに必要なロールと権限

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（ストライプエクスポートの場合のみ）
- storage.buckets.getIamPolicy（トランザクションログのエクスポートの場合のみ）
- storage.buckets.setIamPolicy（トランザクションログのエクスポートの場合のみ）

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

Cloud SQL for SQL Server から BAK ファイルにデータをエクスポートする

コンソール

Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

Cloud SQL の [インスタンス] に移動
インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
[エクスポート] をクリックします。
[ファイル形式] セクションで [BAK] をクリックします。
[エクスポートするデータ] セクションでプルダウンメニューを使用して、エクスポートするデータベースを選択します。
[送信先] セクションで [BROWSE] を選択して、エクスポート先の 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 権限の使用をご覧ください。
データベースをエクスポートします。
```
gcloud sql export bak INSTANCE_NAME gs://BUCKET_NAME/FILENAME \
--database=DATABASE_NAME
  
```
gcloud sql export bak コマンドの使用方法については、コマンドのリファレンスページをご覧ください。
以前に設定した IAM ロールを保持する必要がない場合は、この時点で取り消してください。

REST v1

エクスポート用の Cloud Storage バケットを作成します。
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_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 インスタンス内のデータベースの名前
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/export
```
リクエストの本文（JSON）:
リクエストを送信するには、次のいずれかのオプションを開きます。
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": "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"
}
```
以前に設定した IAM ロールを保持する必要がない場合は、この時点で削除してください。

リクエストのパラメータの一覧については、instances:export ページをご覧ください。

REST v1beta4

エクスポート用の Cloud Storage バケットを作成します。
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_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 インスタンス内のデータベースの名前
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/export
```
リクエストの本文（JSON）:
リクエストを送信するには、次のいずれかのオプションを開きます。
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/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_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": "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"
}
```
以前に設定した IAM ロールを保持する必要がない場合は、この時点で取り消してください。

リクエストのパラメータの一覧については、instances:export ページをご覧ください。

差分データベースバックアップをエクスポートする

差分データベースバックアップをエクスポートする前に、差分ベースをエクスポートする必要があります。

ポイントインタイムリカバリやリードレプリカなどの他のサービスや機能では、フルバックアップエクスポートと差分バックアップエクスポートの間でフルバックアップをトリガーする場合は、フルバックアップエクスポートを再度トリガーする必要があります。

次の例を考えてみましょう。

午前 7 時にフルバックアップリクエストを発行します。
ポイントインタイムリカバリを午前 9 時に有効にします。これにより、インスタンスのフルバックアップがトリガーされます。
午後 5 時に差分バックアップを作成しようとします。最後のフルバックアップがポイントインタイムリカバリによってトリガーされたため、このエクスポートリクエストは失敗し、エラーメッセージが表示されます。

Cloud SQL は、レプリカインスタンスの --differential-base または --bak-type=DIFF を使用したデータベースエクスポートリクエストをサポートしていません。

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 権限の使用をご覧ください。
データベースを差分ベースとしてエクスポートします。
```
gcloud sql export bak INSTANCE_NAME gs://BUCKET_NAME/DIFFERENTIAL_BASE_FILENAME \
--database=DATABASE_NAME --differential-base
```
gcloud sql export bak コマンドの使用方法については、コマンドのリファレンスページをご覧ください。
差分バックアップをエクスポートします。
```
gcloud sql export bak INSTANCE_NAME gs://BUCKET_NAME/DIFFERENTIAL_BACKUP_FILENAME \
--database=DATABASE_NAME --bak-type=DIFF
  
```
gcloud sql export bak コマンドの使用方法については、コマンドのリファレンスページをご覧ください。
以前に設定した IAM ロールを保持する必要がない場合は、この時点で取り消してください。

REST v1

エクスポート用の Cloud Storage バケットを作成します。
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME
```
このステップは必須ではありませんが、他のデータへ一切アクセスできないようにするために、実行することを強くおすすめします。
バケットに対する legacyBucketWriter IAM ロールをインスタンスに付与します。IAM 権限の設定の詳細については、IAM 権限の使用をご覧ください。
データベースのフルバックアップを差分ベースとしてエクスポートします。
データをリクエストする前に、次のように置き換えます。
- PROJECT_ID: プロジェクト ID
- INSTANCE_ID: インスタンス ID
- BUCKET_NAME: Cloud Storage バケット名
- PATH_TO_BAK_FILE: SQL BAK ファイルのパス
- DATABASE_NAME: Cloud SQL インスタンス内のデータベースの名前
- offload: サーバーレスエクスポートを有効にして使用するには、この値を TRUE に設定します。
  注: サーバーレスエクスポートに対しては追加料金が発生します。料金ページをご覧ください。
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/export
```
リクエストの本文（JSON）:
```
{
 "exportContext":
   {
      "fileType": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "databases": ["DATABASE_NAME"]
      "offload": TRUE | FALSE
      "bakExportOptions": {
        "differentialBase":true
      }
   }
}
```
リクエストを送信するには、次のいずれかのオプションを選択します。
curl

注: 次のコマンドは、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

注: 次のコマンドは、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": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "EXPORT",
  "exportContext": {
    "uri": {uri},
    "databases": [
    DATABASE_NAME
    ],
    "kind": "sql#exportContext",
    "fileType": "BAK",
    "bakExportOptions": {
      "bakType": FULL,
      "differentialBase": true,
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```
差分バックアップをエクスポートします。
データをリクエストする前に、次のように置き換えます。
- 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": "BAK",
      "uri": "gs://bucket_name/path_to_dump_file",
      "databases": ["database_name"]
      "offload": true | false
      "bakExportOptions": {
        bakType:"DIFF"
      }

    }
}
```
リクエストを送信するには、次のいずれかのオプションを選択します。
curl

注: 次のコマンドは、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

注: 次のコマンドは、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": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "EXPORT",
  "exportContext": {
    "uri": {uri},
    "databases": [
    database_name
    ],
    "kind": "sql#exportContext",
    "fileType": "BAK",
    "bakExportOptions": {
      "bakType": DIFF,
      "differentialBase": false,
    }
  },
  "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

エクスポート用の Cloud Storage バケットを作成します。
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_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": "BAK",
       "uri": "gs://bucket_name/path_to_dump_file",
       "databases": ["database_name"]
       "offload": true | false
       "bakExportOptions": {
         "differentialBase":true
       }

     }
}
```
リクエストを送信するには、次のいずれかのオプションを選択します。
curl

注: 次のコマンドは、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/export"
PowerShell

注: 次のコマンドは、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-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": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "EXPORT",
  "exportContext": {
    "uri": {uri},
    "databases": [
    database_name
    ],
    "kind": "sql#exportContext",
    "fileType": "BAK",
    "bakExportOptions": {
      "bakType": FULL,
      "differentialBase": true,
    }
  },
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}
```
差分バックアップをエクスポートします。
データをリクエストする前に、次のように置き換えます。
- 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": "BAK",
       "uri": "gs://bucket_name/path_to_dump_file",
       "databases": ["database_name"]
       "offload": true | false
       "bakExportOptions": {
        bakType:"DIFF"
       }

     }
}
```
リクエストを送信するには、次のいずれかのオプションを選択します。
curl

注: 次のコマンドは、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/export"
PowerShell

注: 次のコマンドは、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-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": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "EXPORT",
  "exportContext": {
    "uri": {uri},
    "databases": [
    database_name
    ],
    "kind": "sql#exportContext",
    "fileType": "BAK",
    "bakExportOptions": {
      "bakType": DIFF,
      "differentialBase": false,
    }
  },
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}
```
以前に設定した IAM ロールを保持する必要がない場合は、この時点で取り消してください。

リクエストのパラメータの一覧については、instances:export ページをご覧ください。

トランザクションログをエクスポートする

ポイントインタイムリカバリ（PITR）が有効になっており、ログが Cloud Storage に保存されている Cloud SQL Enterprise Plus エディションインスタンスのトランザクションログをエクスポートできます。

gcloud

エクスポート用の Cloud Storage バケットを作成します。
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME
```
このステップは必須ではありませんが、他のデータへ一切アクセスできないようにするために、実行することを強くおすすめします。
エクスポート元の Cloud SQL インスタンスのサービスアカウントを見つけます。これを行うには、gcloud sql instances describe コマンドを実行します。出力で serviceAccountEmailAddress フィールドを探します。
```
gcloud sql instances describe INSTANCE_NAME
  
```
gcloud storage buckets add-iam-policy-binding を使用して、サービスアカウントに storage.Admin IAM ロールを付与します。IAM 権限の設定の詳細については、バケットでの IAM ポリシーの設定と管理をご覧ください。
トランザクションログをエクスポートします。
```
gcloud sql export bak INSTANCE_NAME gs://BUCKET_NAME/FOLDER_PATH
--export-log-start-time=START_DATE_AND_TIME /
--export-log-end-time=END_DATE_AND_TIME /
--database=DATABASE_NAME --bak-type=TLOG
  
```
注: export-log-start-time パラメータと export-log-end-time パラメータは省略可能です。これらのパラメータの値は、UTC タイムゾーンで、RFC 3339 形式で指定する必要があります。例: 2024-05-26T16:19:00:094Z

パラメータに開始日時と終了日時を指定しない場合、Cloud SQL は Cloud Storage バケット内のすべてのトランザクションログをエクスポートします。

トランザクションログを継続的にエクスポートする場合は、
--export-log-start-time パラメータを使用せずに、常に Cloud Storage 内の同じ場所にエクスポートします。Cloud SQL は、宛先にすでに存在するログファイルを繰り返しエクスポートしません。

gcloud sql export bak コマンドの使用方法については、コマンドのリファレンスページをご覧ください。
以前に設定した IAM ロールを保持する必要がない場合は、この時点で取り消してください。

REST

Cloud Storage バケットを作成します。

このステップは必須ではありませんが、他のデータへ一切アクセスできないようにするために、実行することを強くおすすめします。
バケットに対する storage.Admin IAM ロールをインスタンスに付与します。IAM 権限の設定の詳細については、バケットでの IAM ポリシーの設定と管理をご覧ください。
トランザクションログをエクスポートします。
リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: プロジェクト ID。
- INSTANCE_ID: インスタンス ID。
- BUCKET_NAME: Cloud Storage バケット名。
- FOLDER_PATH: Cloud Storage バケット内のフォルダのパス。Cloud SQL は、このフォルダにトランザクションログをエクスポートします。
- DATABASE_NAME: Cloud SQL インスタンス内のデータベースの名前。
- exportLogStartTime: エクスポートするトランザクションログの開始日時。
- exportLogEndTime: エクスポートするトランザクションログの終了日時。
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/export
```
リクエストの本文（JSON）:
```
{
 "exportContext":
   {
      "fileType": "BAK",
      "uri": "gs://BUCKET_NAME/FOLDER_PATH",
      "databases": ["DATABASE_NAME"]
      "bakExportOptions": {
        bakType:"TLOG"
        exportLogStartTime: START_DATE_AND_TIME
        exportLogEndTime: END_DATE_AND_TIME
      }
   }
}
```
リクエストを送信するには、次のいずれかのオプションを選択します。
curl

注: 次のコマンドは、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

注: 次のコマンドは、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": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "EXPORT",
  "exportContext": {
    "uri": {uri},
    "databases": [
    DATABASE_NAME
    ],
    "kind": "sql#exportContext",
    "fileType": "BAK",
    "bakExportOptions": {
      "bakType": TLOG,
      "differentialBase": false,
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```
以前に設定した IAM ロールを保持する必要がない場合は、この時点で削除してください。

リクエストのパラメータの全一覧については、instances.export ページをご覧ください。

ストライプエクスポートを使用する

ストライプエクスポートの利点は次のとおりです。

オペレーション完了までに必要な時間の短縮
5 TB を超えるデータベースをエクスポート可能

ストライプエクスポートを使用すると、1 つのファイルで構成されたバックアップではなく、複数のファイルに分割されるというデメリットがあります。このセットは「ストライプセット」と呼ばれます。ストライプ化されたメディアセット（ストライプセット）でデバイスをバックアップするをご覧ください。Cloud SQL では、単一のファイルを生成する代わりに、Cloud Storage の空のフォルダにエクスポートします。詳細については、ストライプエクスポートの使用方法をご覧ください。

運用の計画

ストライプエクスポートを使用すると、エクスポートのパフォーマンスが向上します。ただし、ユースケースで単一の出力ファイルが必要な場合、またはデータベースのサイズが 5 TB 未満の場合で、高速なパフォーマンスが重要でない場合は、ストライプ化されていないエクスポートを使用することをおすすめします。

ストライプエクスポートを使用する場合は、ストライプの数を考慮してください。この値は、gcloud CLI コマンドまたは REST API 呼び出しで指定できます。ただし、パフォーマンスに最適なストライプ数が必要な場合や、数値がわからない場合は、数値を省略します。最適なストライプ数が自動的に設定されます。

Cloud SQL for SQL Server で現在サポートされているストライプの最大数は 64 です。

ストライプエクスポートの使用方法

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 権限の使用をご覧ください。
データベースをエクスポートするには、--striped パラメータを指定するか、--stripe_count の値を指定します。--stripe_count の値を設定することは、--striped パラメータが意図したものであることを意味します。--no-striped を指定して --stripe_count の値を指定すると、エラーが発生します。
```
gcloud beta sql export bak INSTANCE_NAME \
gs://BUCKET_NAME/STRIPED_EXPORT_FOLDER \
--database=DATABASE_NAME --striped --stripe_count=NUMBER
  
```
gcloud beta sql export bak コマンドの使用方法については、コマンドのリファレンスページをご覧ください。
以前に設定した IAM ロールを保持する必要がない場合は、この時点で取り消してください。

REST v1

エクスポート用の Cloud Storage バケットを作成します。
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME
```
このステップは必須ではありませんが、他のデータへ一切アクセスできないようにするために、実行することを強くおすすめします。
バケットに対する legacyBucketWriter IAM ロールをインスタンスに付与します。IAM 権限の設定の詳細については、IAM 権限の使用をご覧ください。
データベースをエクスポートします。
データをリクエストする前に、次のように置き換えます。
- project-id: プロジェクト ID
- instance-id: インスタンス ID
- bucket_name: Cloud Storage バケット名
- path_to_folder: ストライプセットのエクスポート先フォルダ（Cloud Storage バケット内）のパス
- database_name: Cloud SQL インスタンス内のデータベースの名前
- true | false: ストライプエクスポートを使用するには、true に設定します。ストライプ数を指定せずに true を指定すると、最適なストライプ数が自動的に設定されます
- number_of_stripes: 使用するストライプの数。指定すると、striped は true として暗黙的に指定されます。
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/export
```
リクエストの本文（JSON）:
```
{
 "exportContext":
   {
      "fileType": "BAK",
      "uri": "gs://bucket_name/path_to_folder",
      "databases": ["database_name"],
      "bakExportOptions": {
        "striped": true | false,
        "stripe_count": ["number_of_stripes"]
      }
    }
}
```
リクエストを送信するには、次のいずれかのオプションを開きます。
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": "user@example.com",
  "insertTime": "2022-09-29T22: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

エクスポート用の Cloud Storage バケットを作成します。
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME
```
このステップは必須ではありませんが、他のデータへ一切アクセスできないようにするために、実行することを強くおすすめします。
バケットに対する legacyBucketWriter IAM ロールをインスタンスに付与します。IAM 権限の設定の詳細については、IAM 権限の使用をご覧ください。
データベースをエクスポートします。
データをリクエストする前に、次のように置き換えます。
- project-id: プロジェクト ID
- instance-id: インスタンス ID
- bucket_name: Cloud Storage バケット名
- path_to_folder: ストライプセットのエクスポート先フォルダ（Cloud Storage バケット内）のパス
- database_name: Cloud SQL インスタンス内のデータベースの名前
- true | false: ストライプエクスポートを使用するには、true に設定します。ストライプ数を指定せずに true を指定すると、最適なストライプ数が自動的に設定されます
- number_of_stripes: 使用するストライプの数。指定すると、striped は true として暗黙的に指定されます。
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/export
```
リクエストの本文（JSON）:
```
{
 "exportContext":
   {
      "fileType": "BAK",
      "uri": "gs://bucket_name/path_to_folder",
      "databases": ["database_name"],
      "bakExportOptions": {
        "striped": true | false,
        "stripe_count": ["number_of_stripes"]
      }
    }
}
```
リクエストを送信するには、次のいずれかのオプションを開きます。
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/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-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": "user@example.com",
  "insertTime": "2022-09-29T22: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 ページをご覧ください。

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

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

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

BAK ファイルから Cloud SQL for SQL Server にデータをインポートする

ストライプインポートを使用するには、ストライプインポートを使用するをご覧ください。

さまざまなインポートフレームワークを利用できます。たとえば、Cloud SQL for SQL Server は、次のデータベースバージョンの変更データキャプチャ（CDC）をサポートしています。

SQL Server 2017 Standard
SQL Server 2017 Enterprise
SQL Server 2019 Standard
SQL Server 2019 Enterprise

CDC 対応データベースをインポートする場合、KEEP_CDC フラグが保持されます。

インスタンスのバージョンが Microsoft SQL Server Enterprise Edition の場合、暗号化された BAK ファイルをインポートできます。

Microsoft SQL Server Standard Edition インスタンスも、暗号化された BAK ファイルをインポートしますが、これは gcloud CLI でのみ使用できます。

サポートされている BAK 拡張機能は .bak と .bak.gz だけです。現在、GPG 暗号化バックアップはサポートされていません。

以下の手順では、新しいデータベースを指定する準備を行います。BAK ファイルのインポートを開始する前にデータベースを作成しないでください。

BAK ファイルを使用して Cloud SQL インスタンスにデータをインポートするには:

コンソール

Google Cloud コンソールで Cloud SQL の [インスタンス] ページに移動します。

Cloud SQL の [インスタンス] に移動
インスタンスの [概要] ページを開くには、インスタンス名をクリックします。
[インポート] をクリックします。
データのインポート元となるファイルを選択するフィールドで、インポートに使用するバケットと BAK ファイルのパスを入力します。
圧縮ファイル（.gz）または非圧縮ファイルをインポートできます。
[ファイル形式] セクションで [BAK] を選択します。
BAK ファイルをインポートする Cloud SQL インスタンスで [データベース] を指定します。
[インポート] をクリックしてインポートを開始します。

gcloud

インポート用の Cloud Storage バケットを作成します。
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME
```
このステップは必須ではありませんが、他のデータへ一切アクセスできないようにするために、実行することを強く推奨します。
必要なロールと権限を構成済みであることを確認してください。
BAK ファイルからのデータをバケットにアップロードします。
インポート先のインスタンスを記述します。
```
gcloud sql instances describe INSTANCE_NAME
```
serviceAccountEmailAddress フィールドをコピーします。
gcloud storage buckets add-iam-policy-binding を使用して、バケットのサービスアカウントに storage.objectViewer IAM ロールを付与します。IAM 権限の設定の詳細については、IAM 権限の使用をご覧ください。

ファイルからデータをインポートします。

gcloud sql import bak INSTANCE_NAME gs://BUCKET_NAME/FILE_NAME \
--database=DATABASE_NAME

暗号化されたインポートの場合は、次のコマンドを使用します。

gcloud sql import bak INSTANCE_NAME gs://BUCKET_NAME/FILE_NAME
--database=DATABASE_NAME --cert-path=gs://BUCKET_NAME/CERTIFICATE_NAME
 --pvk-path=gs://BUCKET_NAME/KEY_NAME --prompt-for-pvk-password

以前に設定した IAM 権限を保持する必要がない場合は、gcloud storage buckets remove-iam-policy-binding を使用して削除します。

REST v1

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

ファイルをバケットにアップロードする方法については、オブジェクトのアップロードをご覧ください。
インスタンスにバケットに対する storage.objectAdmin IAM のロールを付与します。IAM 権限の設定の詳細については、IAM 権限の使用をご覧ください。
ファイルからデータをインポートします。
データをリクエストする前に、次のように置き換えます。
- project-id: プロジェクト ID
- instance-id: インスタンス ID
- bucket_name: Cloud Storage バケット名
- path_to_bak_file: BAK ファイルへのパス
- database_name: Cloud SQL インスタンス内のデータベースの名前
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import
```
リクエストの本文（JSON）:
```
{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://bucket_name/path_to_bak_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 にログインしていることを前提としています。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"
}
```
別のユーザーがインポートするには、importContext.importUser プロパティを指定します。
リクエストのパラメータの一覧については、instances:import ページをご覧ください。
以前に設定した IAM 権限を保持する必要がない場合は、権限を削除します。

REST v1beta4

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

ファイルをバケットにアップロードする方法については、オブジェクトのアップロードをご覧ください。
インスタンスにバケットに対する storage.objectAdmin IAM のロールを付与します。IAM 権限の設定の詳細については、IAM 権限の使用をご覧ください。
ファイルからデータをインポートします。
データをリクエストする前に、次のように置き換えます。
- project-id: プロジェクト ID
- instance-id: インスタンス ID
- bucket_name: Cloud Storage バケット名
- path_to_bak_file: BAK ファイルへのパス
- database_name: Cloud SQL インスタンス内のデータベースの名前
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/import
```
リクエストの本文（JSON）:
```
{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://bucket_name/path_to_bak_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 にログインしていることを前提としています。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"
}
```
別のユーザーがインポートするには、importContext.importUser プロパティを指定します。
このリクエストのパラメータの一覧については、instances:import ページをご覧ください。
以前に設定した IAM 権限を保持する必要がない場合は、権限を削除します。

ERROR_RDBMS などのエラーが表示した場合は、BAK ファイルがバケットに存在し、バケットに対して正しい権限があることを確認してください。Cloud Storage のアクセス制御の構成について詳しくは、アクセス制御リストの作成と管理をご覧ください。

差分データベースバックアップをインポートする

差分データベースバックアップをインポートするには、フルバックアップをインポートする必要があります。フルバックアップをインポートした後、データベースが RESTORING 状態になっている必要があります。

Cloud SQL では、ポイントインタイムリカバリが有効になっているインスタンスにデータベースの差分バックアップをインポートすることはできません。これは、--no-recovery を使用したデータベースバックアップのインポートが、差分データベースバックアップのインポートの前提条件であるためです。また、データベースが RESTORING 状態の場合、インスタンスでポイントインタイムリカバリを有効にすることはできません。インポートに失敗した場合は、次のいずれかの方法でポイントインタイムリカバリを有効にします。

--recovery-only フラグを使用して、RESTORING 状態のデータベースをオンラインにします。
データベースを削除します。

差分データベースバックアップを使用して Cloud SQL インスタンスにデータをインポートするには、次の手順を行います。

gcloud

インポート用の Cloud Storage バケットを作成します。
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME
```
このステップは必須ではありませんが、他のデータへ一切アクセスできないようにするために、実行することを強くおすすめします。
必要なロールと権限を構成済みであることを確認してください。
BAK ファイルからのデータをバケットにアップロードします。
インポート先のインスタンスを記述します。
```
gcloud sql instances describe INSTANCE_NAME
```
serviceAccountEmailAddress フィールドをコピーします。
gcloud storage buckets add-iam-policy-binding を使用して、バケットのサービスアカウントに storage.objectViewer IAM ロールを付与します。IAM 権限の設定の詳細については、IAM 権限の使用をご覧ください。

--no-recovery を使用してフルバックアップをインポートします。

gcloud sql import bak INSTANCE_NAME gs://BUCKET_NAME/DIFFERENTIAL_BASE_FILENAME \
--database=DATABASE_NAME --bak-type=FULL --no-recovery

差分データベースバックアップをインポートします。

gcloud sql import bak INSTANCE_NAME gs://BUCKET_NAME/DIFFERENTIAL_BACKUP_FILENAME \
--database=DATABASE_NAME --bak-type=DIFF --no-recovery

インポートされたデータベースをオンラインにするには、--recovery-only フラグを使用します。このステップは省略可能です。データベースが RESTORING 状態の場合にのみ実行する必要があります。
```
gcloud sql import bak INSTANCE_NAME \
--database=DATABASE_NAME --recovery-only
```
以前に設定した IAM 権限を保持する必要がない場合は、gcloud storage buckets remove-iam-policy-binding を使用して削除します。

REST v1

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

ファイルをバケットにアップロードする方法については、オブジェクトのアップロードをご覧ください。
インスタンスにバケットに対する storage.objectAdmin IAM のロールを付与します。IAM 権限の設定の詳細については、IAM 権限の使用をご覧ください。

注: 次の手順では、importContext.importUser プロパティを指定して、インポートに別のユーザーを使用します。リクエストのパラメータの一覧については、instances:import ページをご覧ください。

noRecovery を使用してフルバックアップをインポートします。

データをリクエストする前に、次のように置き換えます。

PROJECT_ID: プロジェクト ID。
INSTANCE_ID: インスタンス ID。
BUCKET_NAME: Cloud Storage バケット名。
PATH_TO_BAK_FILE: BAK ファイルへのパス。
DATABASE_NAME: Cloud SQL インスタンス内のデータベースの名前。

HTTP メソッドと URL:

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

リクエストの本文（JSON）:

{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "noRecovery": true,
        "bakType": "FULL",
      }

    }
}

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

注: 次のコマンドは、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

注: 次のコマンドは、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/import" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

レスポンス

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID",
  "status": "PENDING",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "noRecovery": true,
      "bakType": FULL,
      "recoveryOnly": false
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

差分データベースバックアップをインポートします。

データをリクエストする前に、次のように置き換えます。

project-id: プロジェクト ID
instance-id: インスタンス ID
bucket_name: Cloud Storage バケット名
path_to_bak_file: BAK ファイルへのパス
database_name: Cloud SQL インスタンス内のデータベースの名前

HTTP メソッドと URL:

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

リクエストの本文（JSON）:

{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://bucket_name/path_to_bak_file",
      "database": "database_name"
      "bakImportOptions": {
        "bakType": "DIFF",
        "noRecovery": true,
      }

    }
}

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

リクエスト本文を 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

リクエスト本文を 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",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": database_name,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "noRecovery": false,
      "bakType": DIFF,
      "recoveryOnly": false
    }
  },
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

recoveryOnly を使用して、インポートしたデータベースをオンラインにします。このステップは省略可能です。データベースが RESTORING 状態の場合にのみ実行する必要があります。

リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: プロジェクト ID
- INSTANCE_ID: インスタンス ID
- BUCKET_NAME: Cloud Storage バケット名
- PATH_TO_BAK_FILE: BAK ファイルへのパス
- DATABASE_NAME: Cloud SQL インスタンス内のデータベースの名前
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/import
```
リクエストの本文（JSON）:
```
{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "recoveryOnly": true,
      }

    }
}
```
リクエストを送信するには、次のいずれかのオプションを選択します。
curl

注: 次のコマンドは、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

注: 次のコマンドは、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/import" | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
レスポンス
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET-INSTANCE_ID",
  "status": "PENDING",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "recoveryOnly": true
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```
以前に設定した IAM 権限を保持する必要がない場合は、権限を削除します。

REST v1beta4

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

ファイルをバケットにアップロードする方法については、オブジェクトのアップロードをご覧ください。
インスタンスにバケットに対する storage.objectAdmin IAM のロールを付与します。IAM 権限の設定の詳細については、IAM 権限の使用をご覧ください。

noRecovery を使用してフルバックアップをインポートします。

データをリクエストする前に、次のように置き換えます。

PROJECT-ID: プロジェクト ID。
INSTANCE_ID: インスタンス ID。
BUCKET_NAME: Cloud Storage バケット名。
PATH_TO_BAK_FILE: BAK ファイルへのパス。
DATABASE_NAME: Cloud SQL インスタンス内のデータベースの名前。

HTTP メソッドと URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/INSTANCE_ID/import

リクエストの本文（JSON）:

{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "noRecovery": true,
        "bakType": "FULL",
      }
    }
}

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

リクエスト本文を 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

リクエスト本文を 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": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "noRecovery": true,
      "bakType": FULL,
      "recoveryOnly": false
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT-ID/operations/operation-id",
  "targetProject": "PROJECT-ID"
}

差分データベースバックアップをインポートします。

データをリクエストする前に、次のように置き換えます。

project-id: プロジェクト ID
instance-id: インスタンス ID
bucket_name: Cloud Storage バケット名
path_to_bak_file: BAK ファイルへのパス
database_name: Cloud SQL インスタンス内のデータベースの名前

HTTP メソッドと URL:

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

リクエストの本文（JSON）:

{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://bucket_name/path_to_bak_file",
      "database": "database_name"
      "bakImportOptions": {
        "bakType": "DIFF",
        "noRecovery": true,
      }
    }
}

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

リクエスト本文を 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

リクエスト本文を 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": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": database_name,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "noRecovery": false,
      "bakType": DIFF,
      "recoveryOnly": false
    }
  },
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

recoveryOnly を使用して、インポートしたデータベースをオンラインにします。このステップは省略可能です。データベースが RESTORING 状態の場合にのみ実行する必要があります。

リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: プロジェクト ID
- INSTANCE_ID: インスタンス ID
- BUCKET_NAME: Cloud Storage バケット名
- PATH_TO_BAK_FILE: BAK ファイルへのパス
- DATABASE_NAME: Cloud SQL インスタンス内のデータベースの名前
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/import
```
リクエストの本文（JSON）:
```
{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "recoveryOnly": true,
      }
    }
}
```
リクエストを送信するには、次のいずれかのオプションを選択します。
curl

注: 次のコマンドは、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

注: 次のコマンドは、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_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": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "recoveryOnly": true
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```
以前に設定した IAM 権限を保持する必要がない場合は、権限を削除します。

トランザクションログのバックアップをインポートする

トランザクションログには、データベースのトランザクションと各トランザクションで行われた変更が記録されます。これにより、システム障害が発生した場合にデータベースの整合性を再確立できます。

注:

Cloud SQL は、トランザクションログのバックアップのストライプインポートをサポートしていません。
Cloud SQL では、ポイントインタイムリカバリが有効になっているインスタンスにトランザクションログのバックアップをインポートすることはできません。これは、--no-recovery を使用したデータベースのバックアップのインポートが、トランザクションログのバックアップのインポートの前提条件であるためです。また、データベースが RESTORING 状態の場合、インスタンスでポイントインタイムリカバリを有効にすることはできません。インポートに失敗した場合は、次のいずれかの方法でポイントインタイムリカバリを有効にします。
- --recovery-only フラグを使用して、RESTORING 状態のデータベースをオンラインにします。
- データベースを削除します。

トランザクションログのバックアップを使用して Cloud SQL インスタンスにデータをインポートするには、次の手順を行います。

gcloud

インポート用のオプション: Cloud Storage バケットを作成します。

gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME

バックアップファイルをバケットにアップロードします。
インポート先のインスタンスを記述します。
```
gcloud sql instances describe INSTANCE_NAME
```
serviceAccountEmailAddress フィールドをコピーします。
gcloud storage buckets add-iam-policy-binding を使用して、バケットのサービスアカウントに storage.objectViewer IAM ロールを付与します。IAM 権限の設定の詳細については、IAM 権限の使用をご覧ください。
--no-recovery パラメータを使用してフルバックアップをインポートします。フルバックアップのインポート後、データベースが RESTORING 状態であることを確認します。
```
gcloud sql import bak INSTANCE_NAME gs://BUCKET_NAME/BACKUP_FILENAME \
--database=DATABASE_NAME --bak-type=FULL --no-recovery
```
オプション: 差分バックアップをインポートします。
トランザクションログのバックアップをインポートします。
```
gcloud sql import bak INSTANCE_NAME gs://BUCKET_NAME/BACKUP_FILENAME \
--database=DATABASE_NAME --bak-type=TLOG
--stop-at=STOP_AT_TIMESTAMP --stop-at-mark=STOP_AT_MARK_NAME
--no-recovery
```
次のように置き換えます。
- INSTANCE_NAME: インスタンス名。
- BUCKET_NAME: Cloud Storage バケット名。
- BACKUP_FILENAME: バックアップファイルの名前。
- DATABASE_NAME: Cloud SQL インスタンス内のデータベースの名前。
- STOP_AT_TIMESTAMP: トランザクションログのインポートを停止するタイムスタンプ。これはオプションのフィールドです。値には RFC 3339 形式を使用する必要があります。
- STOP_AT_MARK_NAME: トランザクションログのインポートを停止するマーク付きトランザクション。これはオプションのフィールドで、値として任意の文字列を指定できます。値が lsn:log-sequence-number の形式の場合、トランザクションログのインポートは、指定されたログシーケンス番号で停止します。
すべてのトランザクションログのバックアップをインポートするまで、このステップを繰り返します。
オプション: インポートされたデータベースをオンラインにするには、--recovery-only フラグを使用します。このステップは、データベースが RESTORING 状態の場合にのみ行ってください。
```
gcloud sql import bak INSTANCE_NAME \
--database=DATABASE_NAME --recovery-only
```
以前に設定した IAM 権限を保持する必要がない場合は、gcloud storage buckets remove-iam-policy-binding を使用して削除します。

REST v1

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

ファイルをバケットにアップロードする方法については、オブジェクトのアップロードをご覧ください。
インスタンスにバケットに対する storage.objectAdmin IAM のロールを付与します。IAM 権限の設定の詳細については、IAM 権限の使用をご覧ください。

instances:import

noRecovery を使用してフルバックアップをインポートします。フルバックアップのインポート後、データベースが RESTORING 状態であることを確認します。

リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: プロジェクト ID。
- INSTANCE_ID: インスタンス ID。
- BUCKET_NAME: Cloud Storage バケット名。
- PATH_TO_BAK_FILE: BAK ファイルへのパス。
- DATABASE_NAME: Cloud SQL インスタンス内のデータベースの名前。
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/import
```
リクエストの本文（JSON）:
```
{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "noRecovery": true,
        "bakType": "FULL",
      }

    }
}
```
リクエストを送信するには、次のいずれかのオプションを選択します。
curl

注: 次のコマンドは、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

注: 次のコマンドは、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/import" | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
レスポンス
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID",
  "status": "PENDING",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "noRecovery": true,
      "bakType": FULL,
      "recoveryOnly": false
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```
オプション: 差分バックアップをインポートします。
トランザクションログのバックアップをインポートします。
データをリクエストする前に、次のように置き換えます。
- PROJECT_ID: プロジェクト ID。
- INSTANCE_ID: インスタンス ID。
- BUCKET_NAME: Cloud Storage バケット名。
- PATH_TO_TLOG_FILE: トランザクションログファイルへのパス。
- DATABASE_NAME: Cloud SQL インスタンス内のデータベースの名前。
- STOP_AT_TIMESTAMP: トランザクションログのインポートを停止するタイムスタンプ。これはオプションのフィールドです。値には RFC 3339 形式を使用する必要があります。
- STOP_AT_MARK_NAME: トランザクションログのインポートを停止するマーク付きトランザクション。これはオプションのフィールドで、値として任意の文字列を指定できます。値が lsn:log-sequence-number の形式の場合、トランザクションログのインポートは、指定されたログシーケンス番号で停止します。
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/import
```
リクエストの本文（JSON）:
```
{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_TLOG_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "bakType": "TLOG",
        "stopAt": STOP_AT_TIMESTAMP,
        "stopAtMark": STOP_AT_MARK_NAME,
        "noRecovery": true,
      }

    }
}
```
リクエストを送信するには、次のいずれかのオプションを選択します。
curl

注: 次のコマンドは、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

注: 次のコマンドは、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/import" | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
レスポンス
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID",
  "status": "PENDING",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "noRecovery": false,
      "bakType": TLOG,
      "recoveryOnly": false
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```
すべてのトランザクションログのバックアップをインポートするまで、このステップを繰り返します。
オプション: recoveryOnly を使用して、インポートしたデータベースをオンラインにします。このステップは、データベースが RESTORING 状態の場合にのみ行ってください。

リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: プロジェクト ID
- INSTANCE_ID: インスタンス ID
- BUCKET_NAME: Cloud Storage バケット名
- PATH_TO_BAK_FILE: BAK ファイルへのパス
- DATABASE_NAME: Cloud SQL インスタンス内のデータベースの名前
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/import
```
リクエストの本文（JSON）:
```
{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "recoveryOnly": true,
      }

    }
}
```
リクエストを送信するには、次のいずれかのオプションを選択します。
curl

注: 次のコマンドは、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

注: 次のコマンドは、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/import" | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
レスポンス
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET-INSTANCE_ID",
  "status": "PENDING",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "recoveryOnly": true
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```
以前に設定した IAM 権限を保持する必要がない場合は、権限を削除します。

REST v1beta4

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

ファイルをバケットにアップロードする方法については、オブジェクトのアップロードをご覧ください。
インスタンスにバケットに対する storage.objectAdmin IAM のロールを付与します。IAM 権限の設定の詳細については、IAM 権限の使用をご覧ください。

noRecovery を使用してフルバックアップをインポートします。フルバックアップのインポート後、データベースが RESTORING 状態であることを確認します。

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT-ID: プロジェクト ID。
INSTANCE_ID: インスタンス ID。
BUCKET_NAME: Cloud Storage バケット名。
PATH_TO_BAK_FILE: BAK ファイルへのパス。
DATABASE_NAME: Cloud SQL インスタンス内のデータベースの名前。

HTTP メソッドと URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/INSTANCE_ID/import

リクエストの本文（JSON）:

{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "noRecovery": true,
        "bakType": "FULL",
      }
    }
}

リクエストを送信するには、次のいずれかのオプションを選択します。

curl

リクエスト本文を 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

リクエスト本文を 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": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "noRecovery": true,
      "bakType": FULL,
      "recoveryOnly": false
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT-ID/operations/operation-id",
  "targetProject": "PROJECT-ID"
}

オプション: 差分バックアップをインポートします。
トランザクションログのバックアップをインポートします。ここで、stopAt と stopAtMark はオプションフィールドです。
データをリクエストする前に、次のように置き換えます。
- PROJECT_ID: プロジェクト ID。
- INSTANCE_ID: インスタンス ID。
- BUCKET_NAME: Cloud Storage バケット名。
- PATH_TO_BAK_FILE: BAK ファイルへのパス。
- DATABASE_NAME: Cloud SQL インスタンス内のデータベースの名前。
- STOP_AT_TIMESTAMP: トランザクションログのインポートを停止するタイムスタンプ。これはオプションのフィールドです。値には RFC 3339 形式を使用する必要があります。
- STOP_AT_MARK_NAME: トランザクションログのインポートを停止するマーク付きトランザクション。これはオプションのフィールドで、値として任意の文字列を指定できます。値が lsn:log-sequence-number の形式の場合、トランザクションログのインポートは、指定されたログシーケンス番号で停止します。
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/import
```
リクエストの本文（JSON）:
```
{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "bakType": "TLOG",
        "stopAt": STOP_AT_TIMESTAMP,
        "stopAtMark":STOP_AT_MARK_NAME,
        "noRecovery": true,
      }

    }
}
```
リクエストを送信するには、次のいずれかのオプションを選択します。
curl

注: 次のコマンドは、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

注: 次のコマンドは、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/import" | Select-Object -Expand Content
次のような JSON レスポンスが返されます。
レスポンス
```
{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID",
  "status": "PENDING",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "noRecovery": false,
      "bakType": TLOG,
      "recoveryOnly": false
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```
すべてのトランザクションログのバックアップをインポートするまで、このステップを繰り返します。
オプション: recoveryOnly を使用して、インポートしたデータベースをオンラインにします。このステップは、データベースが RESTORING 状態の場合にのみ行ってください。

リクエストのデータを使用する前に、次のように置き換えます。
- PROJECT_ID: プロジェクト ID
- INSTANCE_ID: インスタンス ID
- BUCKET_NAME: Cloud Storage バケット名
- PATH_TO_BAK_FILE: BAK ファイルへのパス
- DATABASE_NAME: Cloud SQL インスタンス内のデータベースの名前
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/import
```
リクエストの本文（JSON）:
```
{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://BUCKET_NAME/PATH_TO_BAK_FILE",
      "database": "DATABASE_NAME"
      "bakImportOptions": {
        "recoveryOnly": true,
      }
    }
}
```
リクエストを送信するには、次のいずれかのオプションを選択します。
curl

注: 次のコマンドは、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

注: 次のコマンドは、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_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": "IMPORT",
  "importContext": {
    "uri": {uri},
    "database": DATABASE_NAME,
    "kind": "sql#importContext",
    "fileType": "BAK",
    "bakImportOptions": {
      "recoveryOnly": true
    }
  },
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
```
以前に設定した IAM 権限を保持する必要がない場合は、権限を削除します。

ストライプインポートを使用する

ストライプインポートの利点は次のとおりです。

オペレーション完了までに必要な時間の短縮
5 TB を超えるデータベースをインポート可能

ストライプインポートを使用する場合のデメリットとしては、ストライプセット内のすべてのファイルを（1 つのファイルではなく）Cloud Storage バケット内の同じフォルダにアップロードしてからインポートを行うことが挙げられます。

運用の計画

ほとんどのユースケースでは、ストライプインポートによりパフォーマンスが向上し、デメリットはありません。ただし、特定のインスタンスからストライプセットにバックアップできない場合や、データベースが 5 TB 未満の場合で、高速なパフォーマンスが重要でない場合は、ストライプ化されていないインポートを使用することをおすすめします。

ストライプインポートの使用方法

gcloud

インポート用の Cloud Storage バケットを作成します。
```
gcloud storage buckets create gs://BUCKET_NAME --location=LOCATION_NAME --project=PROJECT_NAME
```
このステップは必須ではありませんが、他のデータへ一切アクセスできないようにするために、実行することを強く推奨します。
必要な IAM ロールと権限を構成済みであることを確認してください。
バケット内に新しいフォルダを作成します。
データベースをインポートするには、（データベースの）ストライプセットのファイルを新しいフォルダにアップロードします。すべてのファイルがフォルダにアップロードされており、フォルダに余分なファイルが含まれていないことを確認します。
エクスポート元のインスタンスを記述します。
```
gcloud sql instances describe INSTANCE_NAME
```
serviceAccountEmailAddress フィールドをコピーします。
gcloud storage buckets add-iam-policy-binding を使用して、バケットのサービスアカウントに storage.objectViewer IAM ロールを付与します。IAM 権限の設定の詳細については、IAM 権限の使用をご覧ください。
フォルダからデータをインポートします。ストライプ化されていないインポートとの違いは次のとおりです。URI は単一ファイルではなく、ストライプセットがアップロードされたフォルダの名前にリンクし、ユーザーは --striped パラメータを指定します。
```
gcloud beta sql import bak INSTANCE_NAME gs://BUCKET_NAME/FOLDER_NAME \
--database=DATABASE_NAME --striped
```
以前に設定した IAM 権限を保持する必要がない場合は、gcloud storage buckets remove-iam-policy-binding を使用して削除します。

REST v1

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

ファイルをバケットにアップロードする方法については、オブジェクトのアップロードをご覧ください。
インスタンスにバケットに対する storage.objectAdmin IAM のロールを付与します。IAM 権限の設定の詳細については、IAM 権限の使用をご覧ください。
ファイルからデータをインポートします。
データをリクエストする前に、次のように置き換えます。
- project-id: プロジェクト ID
- instance-id: インスタンス ID
- bucket_name: Cloud Storage バケット名
- path_to_folder: ストライプセットが配置されているフォルダ（Cloud Storage バケット内）のパス
- database_name: Cloud SQL インスタンス内に作成するデータベースの名前
- true | false: ストライプインポートを使用するには true に設定します。
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/import
```
リクエストの本文（JSON）:
```
{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://bucket_name/path_to_folder",
      "database": "database_name",
      "bakImportOptions": {
        "striped": 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/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-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": "2022-09-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"
}
```
別のユーザーがインポートするには、importContext.importUser プロパティを指定します。
リクエストのパラメータの一覧については、instances:import ページをご覧ください。
以前に設定した IAM 権限を保持する必要がない場合は、権限を削除します。

REST v1beta4

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

ファイルをバケットにアップロードする方法については、オブジェクトのアップロードをご覧ください。
インスタンスにバケットに対する storage.objectAdmin IAM のロールを付与します。IAM 権限の設定の詳細については、IAM 権限の使用をご覧ください。
ファイルからデータをインポートします。
データをリクエストする前に、次のように置き換えます。
- project-id: プロジェクト ID
- instance-id: インスタンス ID
- bucket_name: Cloud Storage バケット名
- path_to_folder: ストライプセットが配置されているフォルダ（Cloud Storage バケット内）のパス
- database_name: Cloud SQL インスタンス内に作成するデータベースの名前
- true | false: ストライプインポートを使用するには true に設定します。
HTTP メソッドと URL:
```
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/import
```
リクエストの本文（JSON）:
```
{
 "importContext":
   {
      "fileType": "BAK",
      "uri": "gs://bucket_name/path_to_folder",
      "database": "database_name",
      "bakImportOptions": {
        "striped": 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/sql/v1beta4/projects/project-id/instances/instance-id/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-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": "2022-09-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"
}
```
別のユーザーがインポートするには、importContext.importUser プロパティを指定します。
このリクエストのパラメータの一覧については、instances:import ページをご覧ください。
以前に設定した IAM 権限を保持する必要がない場合は、権限を削除します。

ERROR_RDBMS などのエラーが発生した場合は、テーブルが存在することを確認してください。存在している場合は、バケットに対して正しい権限があることを確認します。Cloud Storage のアクセス制御の構成について詳しくは、アクセス制御リストの作成と管理をご覧ください。

次のステップ

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

BAK ファイルとトランザクション ログファイルを使用したエクスポートとインポート

始める前に

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

Cloud SQL for SQL Server からのエクスポートに必要なロールと権限

Cloud SQL for SQL Server から BAK ファイルにデータをエクスポートする

コンソール

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

差分データベース バックアップをエクスポートする

gcloud

REST v1

curl

PowerShell

レスポンス

curl

PowerShell

レスポンス

REST v1beta4

curl

PowerShell

レスポンス

curl

PowerShell

レスポンス

トランザクション ログをエクスポートする

gcloud

REST

curl

PowerShell

レスポンス

ストライプ エクスポートを使用する

運用の計画

ストライプ エクスポートの使用方法

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

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

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

BAK ファイルから Cloud SQL for SQL Server にデータをインポートする

コンソール

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

差分データベース バックアップをインポートする

gcloud

REST v1

curl

PowerShell

レスポンス

curl

PowerShell

レスポンス

curl

PowerShell

レスポンス

REST v1beta4

curl

PowerShell

レスポンス

curl

PowerShell

BAK ファイルとトランザクションログファイルを使用したエクスポートとインポート

差分データベースバックアップをエクスポートする

トランザクションログをエクスポートする

ストライプエクスポートを使用する

ストライプエクスポートの使用方法

差分データベースバックアップをインポートする

トランザクションログのバックアップをインポートする

ストライプインポートを使用する

ストライプインポートの使用方法