データのインポートとエクスポートをキャンセルする

MySQL | PostgreSQL | SQL Server

このページでは、Cloud SQL インスタンスへのデータのインポートとエクスポートをキャンセルする方法について説明します。このデータは SQL ダンプファイルまたは CSV ファイルに含まれています。

始める前に

データのインポートとエクスポートをキャンセルするには、インポートまたはエクスポートオペレーションの ID が必要です。キャンセルするオペレーションを Cloud SQL が認識できるように、この ID を gcloud または REST API コマンドに指定する必要があります。

オペレーション ID はレスポンスの name フィールドで返されます。この ID を取得するには、SQL ダンプファイルを使用してエクスポートとインポートを行うをご覧ください。

オペレーション ID は、Cloud SQL インスタンスに対して operations.list 呼び出しを行って確認することもできます。

インポートオペレーションをキャンセルしても、MySQL は必ずしもデータを完全にロールバックするとは限りません。データベースに部分的にインポートされたデータが表示される可能性があります。

インポートまたはエクスポートのオペレーションをキャンセルする

インポートやエクスポートのオペレーションをキャンセルするには、gcloud または REST API コマンドを使用します。

gcloud

gcloud sql operations cancel コマンドを使用してオペレーションをキャンセルします。

gcloud sql operations cancel operation-ID

operation-ID 変数は、オペレーションの ID に置き換えます。詳細については、始める前にをご覧ください。

REST v1

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

project-ID: プロジェクト ID。
operation-ID: インポートまたはエクスポートのオペレーションの ID。詳細については、始める前にをご覧ください。

HTTP メソッドと URL:

POST https://sqladmin.googleapis.com/v1/projects/project-ID/operations/operation-ID/cancel

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

curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

次のコマンドを実行します。

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d "" \
    "https://sqladmin.googleapis.com/v1/projects/project-ID/operations/operation-ID/cancel"

PowerShell（Windows）

次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-ID/operations/operation-ID/cancel" | Select-Object -Expand Content

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

レスポンス

{}

この REST API 呼び出しはレスポンスを返しません。インポートオペレーションやエクスポートオペレーションのキャンセルステータスを確認する方法については、キャンセルステータスを確認するをご覧ください。

REST v1beta4

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

project-ID: プロジェクト ID。
operation-ID: インポートまたはエクスポートのオペレーションの ID。詳細については、始める前にをご覧ください。

HTTP メソッドと URL:

POST https://sqladmin.googleapis.com/v1beta4/projects/project-ID/operations/operation-ID/cancel

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

curl（Linux、macOS、Cloud Shell）

次のコマンドを実行します。

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -d "" \
    "https://sqladmin.googleapis.com/v1beta4/projects/project-ID/operations/operation-ID/cancel"

PowerShell（Windows）

次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/project-ID/operations/operation-ID/cancel" | Select-Object -Expand Content

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

レスポンス

{}

キャンセルステータスを確認する

キャンセルされたインポートまたはエクスポートのオペレーションのステータスを確認するには、gcloud または REST API コマンドを使用できます。

gcloud


gcloud sql operations describe

コマンドを使用してキャンセルされたオペレーションのステータスを確認します。

gcloud sql operations describe operation-ID

operation-ID 変数は、キャンセルされたオペレーションの ID に置き換えます。詳細については、始める前にをご覧ください。

REST v1

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

project-ID: プロジェクト ID。
operation-ID: インポートまたはエクスポートのオペレーションの ID。詳細については、始める前にをご覧ください。

HTTP メソッドと URL:

GET https://sqladmin.googleapis.com/v1/projects/project-ID/operations/operation-ID

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

curl（Linux、macOS、Cloud Shell）

次のコマンドを実行します。

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://sqladmin.googleapis.com/v1/projects/project-ID/operations/operation-ID"

PowerShell（Windows）

次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-ID/operations/operation-ID" | Select-Object -Expand Content

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

レスポンス

{
  "kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/project-ID",
  "status": "DONE",
  "user": "user@example.com",
  "insertTime": "2022-11-08T22:12:58.199Z",
  "startTime": "2022-11-08T22:13:04.798Z",
  "endTime": "2022-11-08T22:13:45.862Z",
  "error": {
    "kind": "sql#operationErrors",
    "errors": [
      {
        "kind": "sql#operationError",
        "code": "CANCEL_SUCCESSFUL",
        "message": "Operation successfully cancelled"
      }
    ]
  },
  "operationType": "EXPORT",
  "exportContext": {
    "uri": "gs://replica-bucket/source-database.sql",
    "kind": "sql#exportContext",
    "sqlExportOptions": {
      "schemaOnly": false,
      "mysqlExportOptions": {
        "masterData": 0
      }
    },
    "fileType": "SQL"
  },
  "name": "operation-ID",
  "targetId": "cloud-sql-instance-display-name",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-ID/operations/operation-ID",
  "targetProject": "project-ID",
  "instanceUid": "cloud-sql-instance-ID"
}

REST v1beta4

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

project-ID: プロジェクト ID。
operation-ID: インポートまたはエクスポートのオペレーションの ID。詳細については、始める前にをご覧ください。

HTTP メソッドと URL:

GET https://sqladmin.googleapis.com/v1beta4/projects/project-ID/operations/operation-ID

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

curl（Linux、macOS、Cloud Shell）

次のコマンドを実行します。

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://sqladmin.googleapis.com/v1beta4/projects/project-ID/operations/operation-ID"

PowerShell（Windows）

次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/project-ID/operations/operation-ID" | Select-Object -Expand Content

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

レスポンス

{
  "kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/project-ID",
  "status": "DONE",
  "user": "user@example.com",
  "insertTime": "2022-11-08T22:12:58.199Z",
  "startTime": "2022-11-08T22:13:04.798Z",
  "endTime": "2022-11-08T22:13:45.862Z",
  "error": {
    "kind": "sql#operationErrors",
    "errors": [
      {
        "kind": "sql#operationError",
        "code": "CANCEL_SUCCESSFUL",
        "message": "Operation successfully cancelled"
      }
    ]
  },
  "operationType": "EXPORT",
  "exportContext": {
    "uri": "gs://replica-bucket/source-database.sql",
    "kind": "sql#exportContext",
    "sqlExportOptions": {
      "schemaOnly": false,
      "mysqlExportOptions": {
        "masterData": 0
      }
    },
    "fileType": "SQL"
  },
  "name": "operation-ID",
  "targetId": "cloud-sql-instance-display-name",
  "selfLink": "https://sqladmin.googleapis.com/v1beta4/projects/project-ID/operations/operation-ID",
  "targetProject": "project-ID",
  "instanceUid": "cloud-sql-instance-ID"
}

トラブルシューティング

問題	トラブルシューティング
エラーメッセージ: `You can't cancel operation [operation-ID] because this operation isn't in progress.`	完了した、失敗した、またはキャンセルされたインポートまたはエクスポートのオペレーションをキャンセルしようとしています。実行中のオペレーションはキャンセルできます。
エラーメッセージ: `You can't cancel operation [operation-ID] because Cloud SQL doesn't support the cancellation of an [operation-type] operation.`	Cloud SQL には、`IMPORT` または `EXPORT` 以外のオペレーションタイプがあるため、オペレーションのキャンセルをサポートしていません。
エラーメッセージ: `The [operation-type] operation isn't cancelled. Wait and retry in a few seconds.`	現時点では、Cloud SQL はインポートオペレーションとエクスポートオペレーションをキャンセルできません。しばらくしてから、もう一度お試しください。問題が解決しない場合は、Google Cloud サポートまでご連絡ください。

次のステップ

データのインポートとエクスポートのベストプラクティスについて確認する
SQL ダンプファイルを使用して Cloud SQL インスタンスにデータをエクスポートおよびインポートを行う方法を確認する
インポートとエクスポートの各オペレーションのステータスのチェック方法について学習する
インポートとエクスポートの既知の問題

データのインポートとエクスポートをキャンセルする

始める前に

インポートまたはエクスポートのオペレーションをキャンセルする

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

キャンセル ステータスを確認する

gcloud

REST v1

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

REST v1beta4

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

トラブルシューティング

次のステップ

キャンセルステータスを確認する