トラブルシューティング

このドキュメントでは、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 をインストールする

エクスプローラと 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）権限を確認します。BigQuery などの関連する API が設定で有効になっていることを確認します。

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 リソース エクスプローラ ビューを更新します。

Failed to redirect to Spark UI: ${message}

クラスタが停止しているか、コンポーネント ゲートウェイが無効になっています。

クラスタを起動し、クラスタ構成でコンポーネント ゲートウェイが有効になっていることを確認します。

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 の依存関係が不足している場合、[リモート カーネル] の横にあるカーネル選択ツールの説明に表示されます。

通知をクリックし、確認ダイアログで [はい] を選択して、依存関係をインストールします。

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

ユーザーが Remote Kernel で既存のノートブックを実行したときに、カーネル ピッカーの説明に表示されます

通知をクリックし、確認ダイアログで [はい] を選択して、依存関係をインストールします。

Cloud Storage のエラー

バケットとオブジェクトの管理中に次のエラーが発生します。

エラー メッセージ

考えられる原因

修復

A folder with the name... already exists.

バケット内の名前の競合。

一意のフォルダ名を選択します。

Upload/Download failed: ${message}

権限が拒否されたか、ネットワークがタイムアウトしました。

Storage Object Admin または Creator のロールを確認します。

Failed to create bucket: ${message}

名前がグローバルにすでに使用されているか、無効な文字が含まれています。

Cloud Storage バケットの命名規則に従います。

一般的なインターフェース エラー

これらのエラーは、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 ユーザーに適切なデータベース権限を付与するをご覧ください。

Cloud SQL for MySQL

エラー メッセージ 考えられる原因 修復
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 から有効にします。

Cloud SQL for PostgreSQL

エラー メッセージ 考えられる原因 修復
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 をご覧ください。

次のステップ