Memecahkan masalah

Dokumen ini mencantumkan error yang terlihat yang diambil dan ditampilkan oleh ekstensi Data Agent Kit untuk Antigravity. Error ini biasanya ditampilkan sebagai Notifikasi (pop-up) atau sebagai Peringatan Status Bar di IDE. Gunakan panduan ini untuk mengidentifikasi dan menyelesaikan masalah.

Jika Anda tidak dapat mengidentifikasi sumber masalah setelah meninjau kemungkinan error yang tercantum di sini, coba logout dan login kembali.

Error autentikasi dan gcloud CLI

Error ini memengaruhi konektivitas dasar ekstensi.

Pesan error

Kemungkinan penyebab

Perbaikan

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

Biner gcloud tidak ada di jalur sistem.

Instal Google Cloud CLI dan mulai ulang Antigravity.

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

gcloud auth login atau gcloud auth application-default login belum dijalankan.

Klik status bar atau notifikasi untuk memicu alur login di terminal.

Status bar menampilkan ikon $(warning) di samping nama akun Anda.

Akun ekstensi yang login berbeda dengan akun gcloud CLI yang aktif.

Jalankan gcloud auth login dan gcloud auth application-default login dengan akun yang sama yang digunakan untuk login ke Google Cloud.

Status bar menampilkan ikon $(warning).

Setelan ekstensi seperti project ID, region, atau project ID penagihan tidak cocok dengan setelan gcloud CLI.

Klik ikon peringatan di status bar project untuk menyinkronkan setelan antara ekstensi dan gcloud CLI. Atau, perbarui konfigurasi secara manual di salah satu alat untuk memastikan konfigurasi tersebut cocok.

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

Mencoba menyinkronkan setelan saat akun tidak konsisten.

Menyamakan akun antara gcloud CLI dan ekstensi. Pastikan mereka menggunakan akun pengguna, project, region, dan project penagihan yang sama.

Cannot sync settings: Google Cloud CLI is not installed.

Mencoba menyinkronkan setelan saat gcloud CLI tidak diinstal.

Instal gcloud CLI.

Error pengambilan API dan Explorer

Berikut adalah error umum yang terjadi saat menjelajahi resource cloud di struktur menu Google Cloud Data Agent Kit.

Pesan error

Kemungkinan penyebab

Perbaikan

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

Server tidak dapat mengotorisasi permintaan Anda (kode status HTTP 403 Forbidden), server tidak dapat menemukan resource (kode status HTTP 404 Not Found), atau API tidak diaktifkan.

Verifikasi izin Identity and Access Management (IAM); pastikan API yang relevan, seperti BigQuery, diaktifkan di setelan.

No Google Cloud project selected.

Fitur dipicu tanpa project yang aktif.

Gunakan pemilih project di status bar untuk memilih project.

Invalid table name format: ${tableName}

Konvensi penamaan salah (ID project atau ID set data tidak ada).

Gunakan nama yang sepenuhnya memenuhi syarat: project.dataset.table.

Error BigQuery dan Dataform

Error berikut khusus untuk transformasi SQL dan pengelolaan project Dataform.

Pesan error

Kemungkinan penyebab

Perbaikan

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

Paket npm Dataform tidak diinstal secara global.

Klik Instal Dataform CLI dalam dialog untuk mengotomatiskan penginstalan.

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

Error sintaksis dalam file .sqlx atau workflow_settings.yaml tidak valid.

Periksa tampilan Dataform Compiled Query untuk menemukan error sintaksis tertentu.

Failed to run Dataform project: ${message}

Kegagalan eksekusi tugas BigQuery.

Tinjau histori tugas BigQuery untuk mengetahui log eksekusi mendetail.

No content found for saved query: ${label}

Entri Knowledge Catalog atau BigQuery ada, tetapi memiliki konten NoSQL.

Verifikasi konten kueri dengan menjalankannya di konsol Google Cloud .

Managed Service untuk Apache Spark dan error Spark

Error berikut terkait dengan pengelolaan cluster dan eksekusi Spark.

Pesan error

Kemungkinan penyebab

Perbaikan

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

Izin IAM tidak memadai atau cluster dalam transisi.

Pastikan Anda memiliki peran roles/dataproc.editor; periksa apakah status cluster sudah UPDATING.

Error: No cluster name found.

Error referensi internal di tampilan hierarki.

Muat ulang tampilan Spark Resource Explorer.

Failed to redirect to Spark UI: ${message}

Cluster dihentikan atau Gateway Komponen dinonaktifkan.

Mulai cluster dan pastikan Gateway Komponen diaktifkan dalam konfigurasi cluster.

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

Error API

Muat ulang tampilan Spark Resource Explorer.

Failed to start Jupyter process / Pip install failed.

Startup server Jupyter lokal gagal atau penginstalan paket yang diperlukan gagal.

Buka Notebook Spark baru dengan kernel jarak jauh.

No sample notebooks found for the selected kernel type.

Contoh notebook untuk jenis kernel yang dipilih (lokal atau jarak jauh) tidak tersedia.

Tidak berlaku

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

Hal ini khusus untuk pengguna Windows saat jalur panjang tidak diaktifkan di komputer Anda.

Aktifkan jalur panjang dengan membuka link di notifikasi.

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

Dialog ini muncul saat pengguna mencoba menggunakan kernel jarak jauh untuk pertama kalinya.

Instal dependensi dengan mengklik notifikasi dan memilih Ya dalam dialog konfirmasi.

Requires package installation

Ditampilkan dalam deskripsi pemilih kernel di samping Kernel Jarak Jauh jika dependensi Jupyter tidak ada.

Instal dependensi dengan mengklik notifikasi dan memilih Ya dalam dialog konfirmasi.

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

Ditampilkan dalam deskripsi pemilih kernel saat pengguna menjalankan notebook yang ada di Kernel Jarak Jauh

Instal dependensi dengan mengklik notifikasi dan memilih Ya dalam dialog konfirmasi.

Error Cloud Storage

Error berikut muncul saat mengelola bucket dan objek.

Pesan error

Kemungkinan penyebab

Perbaikan

A folder with the name... already exists.

Konflik penamaan di bucket.

Pilih nama folder yang unik.

Upload/Download failed: ${message}

Izin ditolak atau waktu tunggu jaringan habis.

Verifikasi peran Storage Object Admin atau Creator.

Failed to create bucket: ${message}

Nama sudah digunakan secara global atau karakter tidak valid.

Ikuti aturan penamaan bucket Cloud Storage.

Error antarmuka umum

Error ini menunjukkan kegagalan tingkat UI.

Pesan error

Kemungkinan penyebab

Perbaikan

No workspace folder open.

Pengguna berada dalam mode Tanpa Folder di Antigravity.

Buka folder menggunakan File > Open Folder.

No active notebook editor found.

Anda menjalankan perintah Spark atau SQL tanpa membuka notebook.

Buka file .ipynb atau .sql.

Cannot insert item: unsupported resource type.

Mencoba menarik lalu melepas resource yang memiliki representasi string NoSQL.

Hanya tabel, tampilan, dan kolom yang dapat disisipkan ke dalam editor.

Error database

Error berikut ditampilkan saat membuat kueri database Google Cloud .

AlloyDB

Pesan error

Kemungkinan penyebab

Perbaikan

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

Pengguna yang login ke ekstensi belum ditambahkan sebagai pengguna IAM ke instance.

Lihat Mengelola autentikasi IAM untuk menambahkan pengguna sebagai pengguna IAM.

postgresql error: permission denied for table [TABLE_NAME]

Pengguna IAM tidak memiliki izin untuk objek.

Lihat Memberikan izin database yang sesuai kepada pengguna IAM untuk memberikan izin kepada pengguna IAM untuk objek.

Cloud SQL untuk MySQL

Pesan error Kemungkinan penyebab Perbaikan
Invalid request: Some of your SQL statements failed to execute. Details: Error 1045 (28000): Access denied for user '[USER]'@'localhost' (using password: YES). Pengguna yang login ke ekstensi belum ditambahkan sebagai pengguna IAM ke instance. Lihat Autentikasi IAM untuk menambahkan pengguna sebagai pengguna IAM untuk instance.
Invalid request: Some of your SQL statements failed to execute. Details: Error 1044 (42000): Access denied for user '[USER]'@'%' to database '[DB_NAME]'. Pengguna IAM tidak memiliki izin untuk mengakses database. Lihat Memberikan hak istimewa database kepada setiap akun layanan atau pengguna IAM untuk memberikan hak istimewa kepada pengguna IAM untuk database.
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" }}. Akses Data API tidak diaktifkan. Aktifkan akses Data API dari setelan kueri atau lihat Menjalankan pernyataan SQL menggunakan Cloud SQL Data API untuk mengaktifkannya dari konsol Google Cloud atau gcloud CLI.
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME]. Flag autentikasi IAM tidak diaktifkan. Aktifkan tanda autentikasi IAM dari setelan kueri atau lihat Autentikasi IAM untuk mengaktifkannya dari konsol Google Cloud atau gcloud CLI.

Cloud SQL untuk PostgreSQL

Pesan error Kemungkinan penyebab Perbaikan
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" }}. Akses Data API tidak diaktifkan. Aktifkan akses Data API dari setelan kueri atau lihat Menjalankan pernyataan SQL menggunakan Cloud SQL Data API untuk mengaktifkannya dari konsol Google Cloud atau gcloud CLI.
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME]. Flag autentikasi IAM tidak diaktifkan. Aktifkan flag autentikasi IAM dari setelan kueri atau lihat Autentikasi IAM untuk mengaktifkannya dari konsol Google Cloud atau gcloud CLI.
Invalid request: Some of your SQL statements failed to execute. Details: pq: password authentication failed for user "[USER_EMAIL]". Pengguna yang login ke ekstensi belum ditambahkan sebagai pengguna IAM ke instance. Lihat Autentikasi IAM untuk menambahkan pengguna sebagai pengguna IAM untuk instance.
Execution failed. All statements are aborted. Details: pq: permission denied for table [TABLE_NAME] Pengguna IAM tidak memiliki izin untuk mengakses objek. Lihat Mengelola pengguna dengan autentikasi database IAM untuk memberikan hak istimewa kepada pengguna IAM untuk database.

Spanner

Pesan error

Kemungkinan penyebab

Perbaikan

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

Ukuran hasil yang lebih besar dari 10,00 MiB tidak didukung.

Lihat executeSql.

Langkah berikutnya