פתרון בעיות

במאמר הזה מפורטות השגיאות הגלויות שמתועדות ומוצגות על ידי התוסף Data Agent Kit ל-Antigravity IDE. השגיאות האלה מוצגות בדרך כלל כהתראות (חלונות קופצים) או כאזהרות בשורת הסטטוס בסביבת הפיתוח המשולבת (IDE). המדריך הזה יעזור לכם לזהות בעיות ולפתור אותן.

אם לא הצלחתם לזהות את מקור הבעיה אחרי שבדקתם את השגיאות האפשריות שמופיעות כאן, נסו לצאת מהחשבון ואז להיכנס אליו שוב.

שגיאות באימות וב-CLI של gcloud

השגיאות האלה משפיעות על הקישוריות הבסיסית של התוסף.

הודעת השגיאה

סיבה אפשרית

תיקון

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

הקובץ הבינארי gcloud לא נמצא בנתיב של המערכת.

מתקינים את Google Cloud CLI ומפעילים מחדש את Antigravity IDE.

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

הפעולה gcloud auth login או gcloud auth application-default login לא הופעלה.

לוחצים על סרגל הסטטוס או על ההתראה כדי להפעיל את תהליך הכניסה במסוף.

בסרגל הסטטוס מופיע הסמל $(warning) לצד שם החשבון.

החשבון של התוסף שאליו מחוברים שונה מהחשבון הפעיל ב-CLI של gcloud.

מריצים את gcloud auth login ואת gcloud auth application-default login עם אותו חשבון שמשמש לכניסה ל- Google Cloud.

בשורת הסטטוס מוצג הסמל $(warning).

הגדרות התוסף, כמו מזהה הפרויקט, האזור או מזהה הפרויקט לחיוב, לא תואמות להגדרות של ה-CLI של gcloud.

לוחצים על סמל האזהרה בסרגל הסטטוס של הפרויקט כדי לסנכרן את ההגדרות בין התוסף לבין ה-CLI של gcloud. אפשר גם לעדכן ידנית את ההגדרות באחד מהכלים כדי לוודא שהן זהות.

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

ניסיון לסנכרן את ההגדרות בזמן שהחשבונות לא עקביים.

התאמה בין החשבונות ב-CLI של gcloud ובתוסף. מוודאים שהם משתמשים באותו חשבון משתמש, פרויקט, אזור ופרויקט לחיוב.

Cannot sync settings: Google Cloud CLI is not installed.

מנסים לסנכרן את ההגדרות כש-ה-CLI של gcloud לא מותקן.

מתקינים את ה-CLI של gcloud.

שגיאות בשליפה של נתונים מ-API Explorer

בהמשך מפורטות שגיאות כלליות שנתקלים בהן כשמעיינים במשאבי הענן בעץ התפריט של Google Cloud Data Agent Kit.

הודעת השגיאה

סיבה אפשרית

תיקון

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

השרת לא יכול לאשר את הבקשה (קוד סטטוס HTTP 403 Forbidden), השרת לא יכול למצוא את המשאבים (קוד סטטוס HTTP 404 Not Found) או שה-API לא מופעל.

בודקים את ההרשאות לניהול הזהויות והרשאות הגישה (IAM) ומוודאים שממשק ה-API הרלוונטי, כמו BigQuery, מופעל בהגדרות.

No Google Cloud project selected.

הופעלה תכונה בלי פרויקט פעיל.

משתמשים בכלי לבחירת פרויקטים בסרגל המצב כדי לבחור פרויקט.

Invalid table name format: ${tableName}

מוסכמת מתן שמות שגויה (מזהה הפרויקט או מזהה קבוצת הנתונים חסרים).

משתמשים בשם המלא: project.dataset.table.

שגיאות ב-BigQuery וב-Dataform

השגיאות הבאות ספציפיות לטרנספורמציות של SQL ולניהול פרויקטים ב-Dataform.

הודעת השגיאה

סיבה אפשרית

תיקון

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

חבילת ה-npm‏ Dataform לא מותקנת באופן גלובלי.

בתיבת הדו-שיח, לוחצים על Install Dataform CLI (התקנת 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 .

שירות מנוהל ל-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}

האשכול הופסק או ש-Component Gateway מושבת.

מפעילים את האשכול ומוודאים ש-Component Gateway מופעל בהגדרת האשכול.

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

שגיאת API

מרעננים את התצוגה של Spark Resource Explorer.

Failed to start Jupyter process / Pip install failed.

ההפעלה של שרת Jupyter מקומי נכשלה או שההתקנה של חבילות נדרשות נכשלה.

פותחים מחברת Spark חדשה עם ליבת ה-kernel המרוחקת.

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

מוצג בתיאור של הכלי לבחירת ליבה לצד Remote Kernel אם חסרים יחסי תלות של 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.

שגיאות כלליות בממשק

השגיאות האלה מעידות על כשלים ברמת ממשק המשתמש.

הודעת השגיאה

סיבה אפשרית

תיקון

No workspace folder open.

המשתמש נמצא במצב No Folder ב-Antigravity IDE.

פותחים תיקייה באמצעות 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 ל-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 דרך הגדרות השאילתה, אפשר לעיין במאמר הרצת הצהרות SQL באמצעות Cloud SQL Data API כדי להפעיל אותו דרך Google Cloud המסוף או דרך ה-CLI של gcloud.
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME]. הדגל של אימות IAM לא מופעל. מפעילים את דגל האימות של IAM בהגדרות השאילתה או מעיינים במאמר בנושא אימות IAM כדי להפעיל אותו במסוף Google Cloud או ב-CLI של gcloud.

Cloud SQL ל-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 דרך מסוף Google Cloud או gcloud CLI, אפשר לעיין במאמר הרצת הצהרות SQL באמצעות Cloud SQL Data API או להפעיל אותה דרך הגדרות השאילתה.
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME]. הדגל של אימות IAM לא מופעל. מפעילים את דגל האימות של IAM בהגדרות השאילתה או מעיינים במאמר בנושא אימות IAM כדי להפעיל אותו במסוף Google Cloud או ב-CLI של gcloud.
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.00MiB.

מידע נוסף זמין במאמר בנושא executeSql.

המאמרים הבאים