トラブルシューティング

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

探索ユーザーと 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 Resource Explorer ビューを更新します。

Failed to redirect to Spark UI: ${message}

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

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

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

API エラー

Spark Resource Explorer ビューを更新します。

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 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.

バケット内の名前の衝突。

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

Upload/Download failed: ${message}

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

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

Failed to create bucket: ${message}

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

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

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

これらのエラーは、UI レベルの障害を示します。

エラー メッセージ

考えられる原因

修復

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

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 ユーザーとして追加されていません。
  • 組み込みデータベース認証の場合: Secret Manager で選択したリージョン シークレットまたはシークレット バージョンが、データベース ユーザーのパスワードと一致しません。
Invalid request: Some of your SQL statements failed to execute. Details: Error 1044 (42000): Access denied for user '[USER]'@'%' to database '[DB_NAME]'. データベース ユーザーにデータベースへのアクセス権限がありません。 データベースの権限を付与するには、個々の IAM ユーザーまたはサービス アカウントにデータベース権限を付与するか、データベース ユーザーを構成するをご覧ください。
Invalid request: Failed to access secret '[SECRET_VERSION]': generic::PERMISSION_DENIED: Permission 'secretmanager.versions.access' denied for resource '[SECRET_VERSION]' (or it may not exist). 拡張機能にログインしているアカウントに、Secret Manager のリージョン シークレット バージョンにアクセスする権限がないか、シークレット バージョンが存在しません。 クエリ設定で選択したリージョン シークレットとシークレット バージョンが存在することを確認します。次に、アカウントに Secret Manager Secret Accessor（roles/secretmanager.secretAccessor）ロールを付与します。Cloud SQL Data API のドキュメントの必要なロールまたは権限をご覧ください。
Invalid request: Secret fetched from Secret Manager is empty 選択したリージョン シークレット バージョンにパスワードが含まれていません。 データベース ユーザーのパスワードを含む新しいシークレット バージョンを追加し、クエリ設定で選択します。
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 アクセスが有効になっていません。 クエリ設定から 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]".
  • IAM データベース認証の場合: 拡張機能にログインしたユーザーが、インスタンスの IAM ユーザーとして追加されていません。
  • 組み込みデータベース認証の場合: Secret Manager で選択したリージョン シークレットまたはシークレット バージョンが、データベース ユーザーのパスワードと一致しません。
Invalid request: Failed to access secret '[SECRET_VERSION]': generic::PERMISSION_DENIED: Permission 'secretmanager.versions.access' denied for resource '[SECRET_VERSION]' (or it may not exist). 拡張機能にログインしているアカウントに、Secret Manager のリージョン シークレット バージョンにアクセスする権限がないか、シークレット バージョンが存在しません。 クエリ設定で選択したリージョン シークレットとシークレット バージョンが存在することを確認します。次に、アカウントに Secret Manager Secret Accessor（roles/secretmanager.secretAccessor）ロールを付与します。Cloud SQL Data API のドキュメントの必要なロールまたは権限をご覧ください。
Invalid request: Secret fetched from Secret Manager is empty 選択したリージョン シークレット バージョンにパスワードが含まれていません。 データベース ユーザーのパスワードを含む新しいシークレット バージョンを追加し、クエリ設定で選択します。
Execution failed. All statements are aborted. Details: pq: permission denied for table [TABLE_NAME] データベース ユーザーにオブジェクトへのアクセス権がない。 データベースの権限を付与するには、IAM データベース認証でユーザーを管理するまたはデータベース ユーザーを構成するをご覧ください。

Spanner

エラー メッセージ

考えられる原因

修復

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

10.00 MiB を超える結果サイズはサポートされていません。

executeSql をご覧ください。

次のステップ