疑難排解

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

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

驗證和 gcloud CLI 錯誤

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

錯誤訊息

可能原因

修復

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

gcloud 二進位檔不在系統路徑中。

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

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」，自動安裝 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}

知識目錄或 BigQuery 項目存在，但含有 NoSQL 內容。

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

Managed Service for Apache Spark 和 Spark 錯誤

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

錯誤訊息

可能原因

修復

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

身分與存取權管理權限不足，或叢集處於轉換狀態。

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

Error: No cluster name found.

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

重新整理「Spark 資源總管」檢視畫面。

Failed to redirect to Spark UI: ${message}

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

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

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

API 錯誤

重新整理「Spark 資源總管」檢視畫面。

Failed to start Jupyter process / Pip install failed.

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

使用遠端核心開啟新的 Spark 筆記本。

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 VS Code 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 依附元件，系統會在「Remote Kernel」(遠端核心) 旁邊的「kernel picker」(核心挑選器) 說明中顯示。

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

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 命名規則。

一般介面錯誤

這些錯誤表示 UI 層級發生故障。

錯誤訊息

可能原因

修復

No workspace folder open.

使用者在 VS Code 中處於「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。

後續步驟