錯誤訊息

本文說明您在使用 BigQuery 時可能會遇到的錯誤訊息，包括 HTTP 錯誤代碼和建議的疑難排解步驟。

如要進一步瞭解查詢錯誤，請參閱「排解查詢錯誤」一文。

如要進一步瞭解串流資料插入錯誤，請參閱「排解串流資料插入疑難」。

錯誤表格

BigQuery API 的回應會在回應主體中加入 HTTP 錯誤代碼和錯誤物件。錯誤物件通常為下列其中一種：

• errors 物件，其中包含 ErrorProto 物件的陣列。
• errorResults 物件，其中包含單一 ErrorProto 物件。

下表中的「錯誤訊息」欄會對應至 ErrorProto 物件中的 reason 屬性。

這份表格並未列出所有可能的 HTTP 錯誤或其他網路錯誤。因此，請勿假設 BigQuery 的每個錯誤回應都會包含錯誤物件。此外，如果您使用 BigQuery API 的 Cloud 用戶端程式庫，可能會收到不同的錯誤或錯誤物件。詳情請參閱「BigQuery API 用戶端程式庫」。

如果您收到的 HTTP 回應代碼沒有出現在下表中，代表 HTTP 要求發生問題，或是產生符合預期的結果。5xx 範圍內的回應代碼表示伺服器端錯誤。如果您收到 5xx 回應代碼，請稍後再重試要求。在某些情況下，中繼伺服器 (例如 Proxy) 可能會傳回 5xx 回應碼。請檢查回應主體和回應標頭，瞭解錯誤的詳細資訊。如需完整的 HTTP 回應代碼清單，請參閱「HTTP 回應代碼」。

當您使用 bq 指令列工具查看工作狀態時，系統預設不會傳回錯誤物件。如要查看錯誤物件，以及與下表對應的 reason 屬性，請使用 --format=prettyjson 標記。例如：bq --format=prettyjson show -j <job id>。如要查看 bq 工具的詳細記錄，請使用 --apilog=stdout。如要進一步瞭解如何排解 bq 工具的問題，請參閱「偵錯」一文。

錯誤回應範例

GET https://bigquery.googleapis.com/bigquery/v2/projects/12345/datasets/foo
Response:
[404]
{
  "error": {
  "errors": [
  {
    "domain": "global",
    "reason": "notFound",
    "message": "Not Found: Dataset myproject:foo"
  }],
  "code": 404,
  "message": "Not Found: Dataset myproject:foo"
  }
}

計算失敗要求的頻率和正常運作時間

大多數的 500 和 503 錯誤都可以透過以指數輪詢方式重試來解決。如果 500 和 503 錯誤仍持續發生，您可以計算失敗要求的整體比率和對應的上線時間，然後與 BigQuery 服務水準協議 (SLA) 進行比較，判斷服務是否正常運作。

如要計算過去 30 天內失敗要求的整體比率，請將特定 API 呼叫或方法在過去 30 天內的失敗要求數量，除以該 API 呼叫或方法在過去 30 天內的要求總數。將這個值乘以 100，即可算出 30 天內失敗要求的平均百分比。

舉例來說，您可以查詢 Cloud Logging 資料，取得 jobs.insert 要求的總數和失敗的 jobs.insert 要求數，然後執行計算。您也可以從 API 資訊主頁或 Cloud Monitoring 中的 Metrics Explorer 取得錯誤率值。這些選項不會納入用戶端和 BigQuery 之間的網路或路由問題資料，因此我們也建議使用用戶端記錄和報表系統，以便更精確地計算失敗率。

首先，請將 100% 減去失敗要求的整體比率。如果這個值大於或等於 BigQuery SLA 中所述的值，則運作時間也符合 BigQuery SLA。不過，如果這個值低於服務水準協議中所述的值，請手動計算正常運作時間。

如要計算正常運作時間，您必須知道系統中斷服務的時間長度。「服務停機時間」是指根據服務水準協議定義，錯誤率超過 10% 的一段時間。如要計算正常運作時間，請將過去 30 天的總分鐘數減去服務停機的總分鐘數。將剩餘時間除以過去 30 天的總分鐘數，然後將這個值乘以 100，即可算出 30 天內的正常運作時間百分比。如要進一步瞭解 SLA 的定義和計算方式，請參閱 BigQuery 服務水準協議 (SLA)

如果每月正常運作百分比大於或等於 BigQuery 服務水準協議中所述的值，則錯誤很可能是由暫時性問題造成，因此您可以繼續使用指數型退避，重新嘗試執行作業。

如果正常運作時間低於《服務水準協議》中顯示的值，請與支援團隊聯絡尋求協助，並提供觀察到的整體錯誤率和正常運作時間計算結果。

驗證錯誤

根據 OAuth2 規格的定義，OAuth 憑證產生系統所擲回的錯誤，會傳回以下 JSON 物件。

{"error" : "description_string"}

這個錯誤會與 HTTP 400「不正確的要求」錯誤或 HTTP 401「未授權」錯誤一起出現。description_string 是 OAuth2 規格所定義的其中一個錯誤代碼。例如：

{"error":"invalid_client"}

查看錯誤

您可以使用記錄瀏覽器查看特定工作、使用者或其他範圍的驗證錯誤。以下列舉幾個可用於查看驗證錯誤的記錄探索器篩選器範例。

在「政策遭拒」稽核記錄中搜尋權限問題導致失敗的工作：

    resource.type="bigquery_resource"
    protoPayload.status.message=~"Access Denied"
    logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access"
  

搜尋用於驗證的特定使用者或服務帳戶：

    resource.type="bigquery_resource"
    protoPayload.authenticationInfo.principalEmail="EMAIL"
  

將 EMAIL 替換為使用者或服務帳戶的電子郵件地址。

在管理員活動稽核記錄中搜尋 IAM 政策變更：

    protoPayload.methodName=~"SetIamPolicy"
    logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity"
  

在「資料存取」稽核記錄中搜尋特定 BigQuery 資料集的變更：

    resource.type="bigquery_resource"
    protoPayload.resourceName="projects/PROJECT_ID/datasets/DATASET_ID"
    logName=projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fdata_access
  

取代下列內容：

• PROJECT_ID：包含資源的專案 ID
• DATASET_ID：包含資源的資料集 ID

連線錯誤訊息

下表列出使用用戶端程式庫或從程式碼呼叫 BigQuery API 時，可能因連線中斷而出現的錯誤訊息：

Google Cloud 控制台錯誤訊息

下表列出您在Google Cloud 主控台中工作時可能會看到的錯誤訊息。