取消資料匯入和匯出作業

MySQL   |  PostgreSQL   |  SQL Server

本頁說明如何取消將資料匯入 Cloud SQL 執行個體，以及從 Cloud SQL 執行個體匯出資料。這些資料會包含在 SQL 傾印檔案或 BAK 檔案中。

事前準備

如要取消匯入及匯出資料，您需要匯入或匯出作業的 ID。您需要在 gcloud 或 REST API 指令中指定這個 ID，Cloud SQL 才能知道要取消哪個作業。

作業 ID 會在回應的 name 欄位中傳回。如要取得這個 ID，請參閱「使用 SQL 傾印檔案匯出及匯入」一文。

您也可以對 Cloud SQL 執行個體發出 operations.list 呼叫，找出作業 ID。

取消匯入或匯出作業

您可以使用 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 方法和網址：

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)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

$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 方法和網址：

POST https://sqladmin.googleapis.com/v1beta4/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/v1beta4/projects/project-ID/operations/operation-ID/cancel"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

$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 回覆：

回應

{}

這項 REST API 呼叫不會傳回任何回應。如要進一步瞭解如何檢查匯入或匯出作業的取消狀態，請參閱「檢查取消狀態」。

查看取消狀態

您可以使用 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 方法和網址：

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

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

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

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

$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": "[e-mail]",
  "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 方法和網址：

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

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

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

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

$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": "[e-mail]",
  "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 執行個體。
• 瞭解如何檢查匯入與匯出作業的狀態。
• 匯入及匯出作業的已知問題。