疑難排解

這份文件列出 Data Agent Kit IDE 擴充功能擷取並顯示的錯誤。這些錯誤通常會以 IDE 中的通知 (彈出式視窗) 或狀態列警告形式顯示。請參閱本指南，找出並解決問題。

如果查看這裡列出的可能錯誤後，仍無法找出問題來源，請嘗試登出並重新登入。

驗證和 gcloud CLI 錯誤

這類錯誤會影響擴充功能的基礎連線。

錯誤訊息

可能原因

補救措施

Google Cloud CLI is required... but was not found.

系統路徑中沒有 gcloud 二進位檔。

安裝 Google Cloud CLI，然後重新啟動 IDE。

You must be logged in to both the Google Cloud CLI and ADC...

尚未執行 gcloud auth login 或 gcloud auth application-default login。

按一下狀態列或通知，即可在終端機中觸發登入流程。

狀態列會在帳戶名稱旁顯示 $(warning) 圖示。

登入擴充功能的帳戶與有效的 gcloud CLI 帳戶不同。

使用登入 Google Cloud的帳戶執行 gcloud auth login 和 gcloud auth application-default login。

狀態列顯示 $(warning) 圖示。

專案 ID、區域或帳單專案 ID 等擴充功能設定與 gcloud CLI 設定不符。

按一下專案狀態列中的警告圖示，即可在擴充功能和 gcloud CLI 之間同步設定。或者，手動更新任一工具中的設定，確保兩者一致。

Cannot sync settings: gcloud CLI or ADC account does not match extension account。

帳戶不一致時嘗試同步設定。

在 gcloud CLI 和擴充功能之間對齊帳戶。請確認他們使用的是相同的使用者帳戶、專案、區域和帳單專案。

Cannot sync settings: Google Cloud CLI is not installed.

嘗試在未安裝 gcloud CLI 時同步設定。

安裝 gcloud CLI。

Explorer 和 API 擷取錯誤

在 Google Cloud Data Agent Kit 選單樹狀結構中瀏覽雲端資源時，可能會遇到下列一般錯誤。

錯誤訊息

可能原因

補救措施

Failed to load ${itemKind}: ${error.message}

伺服器無法授權您的要求 (HTTP 403 Forbidden 狀態碼)、伺服器找不到資源 (HTTP 404 Not Found 狀態碼)，或是 API 未啟用。

驗證 Identity and Access Management (IAM) 權限，並確認已在設定中啟用相關 API，例如 BigQuery。

No Google Cloud project selected.

觸發功能時沒有啟用專案。

使用狀態列中的專案挑選器選取專案。

Invalid table name format: ${tableName}

命名慣例不正確 (缺少專案 ID 或資料集 ID)。

請使用完整名稱：project.dataset.table。

BigQuery 和 Dataform 錯誤

下列錯誤與 SQL 轉換和 Dataform 專案管理有關。

錯誤訊息

可能原因

補救措施

Dataform CLI is not installed. Dataform features will not work.

Dataform npm 套件未全域安裝。

在對話方塊中點選「Install Dataform CLI」，即可自動安裝。

Failed to compile project in folder...: ${stderr}

.sqlx 檔案中的語法錯誤或無效的 workflow_settings.yaml。

在 Dataform Compiled Query 檢視畫面中檢查特定語法錯誤。

Failed to run Dataform project: ${message}

BigQuery 工作執行失敗。

查看 BigQuery 工作記錄，瞭解詳細的執行記錄。

No content found for saved query: ${label}

Knowledge Catalog 或 BigQuery 項目存在，但含有 NoSQL 內容。

在 Google Cloud 控制台中執行查詢，驗證查詢內容。

Managed Service for Apache Spark 和 Spark 錯誤

下列錯誤與叢集管理和 Spark 執行作業有關。

錯誤訊息

可能原因

補救措施

Error starting/stopping/restarting cluster ${name}: ${message}

IAM 權限不足或叢集處於轉換狀態。

確認您具備 roles/dataproc.editor 角色，並檢查叢集狀態是否已為「UPDATING」。

Error: No cluster name found.

樹狀檢視畫面中的內部參照錯誤。

重新整理「Spark Resource Explorer」檢視畫面。

Failed to redirect to Spark UI: ${message}

叢集已停止或 Component Gateway 已停用。

啟動叢集，並確保叢集設定中已啟用元件閘道。

Failed to load [clusters/jobs/sessions/session templates]: [message]

API 錯誤

重新整理「Spark Resource Explorer」檢視畫面。

Failed to start Jupyter process / Pip install failed.

無法啟動本機 Jupyter 伺服器，或無法安裝必要套件。

使用遠端核心開啟新的 Spark Notebook。

No sample notebooks found for the selected kernel type.

所選核心類型 (本機或遠端) 沒有可用的範例筆記本。

不適用

This system does not have Windows Long Path support enabled. Please enable long paths and restart your IDE to work with Spark Notebooks on remote kernels. Learn More

如果電腦未啟用長路徑，這項功能特別適合 Windows 使用者。

請參閱通知中的連結，啟用長路徑。

google-cloud-jupyter-config and jupyter_server are required to connect to remote kernels on Managed Service for Apache Spark. Install them?

使用者首次嘗試使用遠端核心時，系統會顯示這項提示。

按一下通知，然後在確認對話方塊中選取「是」，即可安裝依附元件。

Requires package installation

如果缺少 Jupyter 依附元件，系統會在「遠端核心」旁的核心挑選器說明中顯示這項資訊。

按一下通知，然後在確認對話方塊中選取「是」，即可安裝依附元件。

Install dependencies for remote Spark kernels. Require google-cloud-jupyter-config and jupyter_server

使用者在遠端核心上執行現有筆記本時，會顯示在核心挑選器說明中

按一下通知，然後在確認對話方塊中選取「是」，即可安裝依附元件。

Cloud Storage 錯誤

管理值區和物件時，會顯示下列錯誤。

錯誤訊息

可能原因

補救措施

A folder with the name... already exists.

bucket 中的命名衝突。

選擇不重複的資料夾名稱。

Upload/Download failed: ${message}

權限遭拒或網路逾時。

驗證 Storage Object Admin 或 Creator 角色。

Failed to create bucket: ${message}

名稱已在全域使用或包含無效字元。

請遵守 Cloud Storage bucket 命名規則。

一般介面錯誤

這些錯誤表示使用者介面層級發生失敗。

錯誤訊息

可能原因

補救措施

No workspace folder open.

使用者在 IDE 中處於「No Folder」模式。

使用 File > Open Folder 開啟資料夾。

No active notebook editor found.

您正在執行 Spark 或 SQL 指令，但未開啟筆記本。

開啟 .ipynb 或 .sql 檔案。

Cannot insert item: unsupported resource type.

嘗試拖曳具有 NoSQL 字串表示法的資源。

只有表格、檢視畫面和資料欄可以插入編輯器。

資料庫錯誤

查詢資料庫時會傳回下列錯誤。 Google Cloud

AlloyDB

錯誤訊息

可能原因

補救措施

postgresql error: role "[USER_EMAIL]" does not exist

登入擴充功能的帳戶未新增為執行個體的 IAM 使用者。

如要將使用者新增為 IAM 使用者，請參閱「管理 IAM 驗證」。

postgresql error: permission denied for table [TABLE_NAME]

IAM 使用者沒有物件的權限。

如要授予 IAM 使用者物件權限，請參閱「授予 IAM 使用者適當的資料庫權限」。

MySQL 適用的 Cloud SQL

錯誤訊息 可能原因 補救措施
Invalid request: Some of your SQL statements failed to execute. Details: Error 1045 (28000): Access denied for user '[USER]'@'localhost' (using password: YES). 登入擴充功能的帳戶未新增為執行個體的 IAM 使用者。 請參閱「IAM 驗證」，將使用者新增為執行個體的 IAM 使用者。
Invalid request: Some of your SQL statements failed to execute. Details: Error 1044 (42000): Access denied for user '[USER]'@'%' to database '[DB_NAME]'. IAM 使用者沒有資料庫存取權。 如要將資料庫權限授予 IAM 使用者，請參閱「將資料庫權限授予個別 IAM 使用者或服務帳戶」。
Invalid request: The instance doesn't allow using ExecuteSql to access this instance. You can allow it by patching the instance with {settings: { dataApiAccess: "ALLOW_DATA_API" }}. 未啟用 Data API 存取權。 從查詢設定啟用 Data API 存取權，或參閱「使用 Cloud SQL Data API 執行 SQL 陳述式」，瞭解如何透過 Google Cloud 控制台或 gcloud CLI 啟用這項功能。
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME]. 未啟用 IAM 驗證旗標。 從查詢設定啟用 IAM 驗證旗標，或參閱「IAM 驗證」一文，瞭解如何從 Google Cloud 控制台或 gcloud CLI 啟用這項功能。

PostgreSQL 適用的 Cloud SQL

錯誤訊息 可能原因 補救措施
Invalid request: The instance doesn't allow using ExecuteSql to access this instance. You can allow it by patching the instance with {settings: { dataApiAccess: "ALLOW_DATA_API" }}. 未啟用 Data API Access。 從查詢設定啟用 Data API 存取權，或參閱「使用 Cloud SQL Data API 執行 SQL 陳述式」，瞭解如何從 Google Cloud 控制台或 gcloud CLI 啟用這項功能。
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME]. IAM 驗證旗標未啟用。 從查詢設定啟用 IAM 驗證旗標，或參閱「IAM 驗證」一文，瞭解如何從 Google Cloud 控制台或 gcloud CLI 啟用這項功能。
Invalid request: Some of your SQL statements failed to execute. Details: pq: password authentication failed for user "[USER_EMAIL]". 登入擴充功能的帳戶未新增為執行個體的 IAM 使用者。 如要將使用者新增為執行個體的 IAM 使用者，請參閱「IAM 驗證」。
Execution failed. All statements are aborted. Details: pq: permission denied for table [TABLE_NAME] IAM 使用者沒有存取物件的權限。 如要授予 IAM 使用者資料庫權限，請參閱「使用 IAM 資料庫驗證機制管理使用者」。

Spanner

錯誤訊息

可能原因

補救措施

Result set too large. Result sets larger than 10.00M can only be yielded through the streaming API.

系統不支援超過 10.00 MiB 的結果大小。

詳情請參閱 executeSql。

後續步驟