トラブルシューティング

このドキュメントでは、Antigravity 用 Data Agent Kit 拡張機能によってキャプチャされ、表示されるエラーの一覧を示します。通常、これらのエラーは IDE で通知 （ポップアップ）またはステータスバーの警告 として表示されます。 このガイドを使用して、問題を特定して解決してください。

ここに記載されている考えられるエラーを確認しても問題の原因を特定できない場合は、一旦ログアウトしてからもう一度ログインしてみてください。

認証と gcloud CLI のエラー

これらのエラーは、拡張機能の基本的な接続に影響します。

エラー メッセージ

考えられる原因

修復

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

gcloud バイナリがシステムのパスにありません。

Google Cloud CLI をインストールして、Antigravity を再起動します。

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[view] で特定の構文エラーを確認します。

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 Antigravity 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] の横に表示されます。

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

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.

ユーザーが Antigravity の [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 ユーザーにオブジェクトに対する権 101}限がありません。

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 認証を参照して、コンソールまたは gcloud CLI から有効にします。 Google Cloud

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 ステートメントを実行する を参照して、コンソールまたは gcloud CLI から有効にします。 Google Cloud
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME]. IAM 認証フラグが有効になっていません。 クエリ設定から IAM 認証フラグを有効にするか、IAM 認証を参照して、コンソールまたは gcloud CLI から有効にします。 Google Cloud
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。

次のステップ