פתרון בעיות

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

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

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

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

הודעת שגיאה

סיבה אפשרית

Remediation

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

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

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

בשורת הסטטוס מופיע הסמל $(warning).

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

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

Cannot sync Google Cloud CLI to Extension Settings: CLI identity does not match extension account או Cannot sync Extension Settings to Google Cloud CLI: CLI identity does not match extension account

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

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

Cannot sync settings: Google Cloud CLI is not installed.

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

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

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

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

הודעת שגיאה

סיבה אפשרית

Remediation

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

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

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

No Google Cloud project selected.

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

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

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

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

הודעת שגיאה

סיבה אפשרית

Remediation

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

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

בתיבת הדו-שיח, לוחצים על 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 כדי לראות יומני ביצוע מפורטים.

שירות מנוהל ל-Apache Spark ושגיאות ב-Spark

השגיאות הבאות קשורות לניהול אשכולות ולהרצת Spark.

הודעת שגיאה

סיבה אפשרית

Remediation

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

השגיאות הבאות מוצגות במהלך ניהול של קטגוריות ואובייקטים.

הודעת שגיאה

סיבה אפשרית

Remediation

A folder with the name... already exists.

התנגשות בשמות בקטגוריה.

בוחרים שם ייחודי לתיקייה.

Upload/Download failed: ${message}

ההרשאה נדחתה או שחלף הזמן הקצוב לתפוגה של הרשת.

אימות תפקידים של Storage Object Admin או Creator.

Failed to create bucket: ${message}

השם כבר תפוס באופן גלובלי או שהוא מכיל תווים לא חוקיים.

פועלים לפי הכללים למתן שמות לקטגוריות של Cloud Storage.

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

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

הודעת שגיאה

סיבה אפשרית

Remediation

No workspace folder open.

המשתמש נמצא במצב No Folder בסביבת הפיתוח המשולבת (IDE).

פותחים תיקייה באמצעות File > Open Folder.

No active notebook editor found.

אתם מריצים פקודות Spark או SQL בלי לפתוח מחברת.

פותחים קובץ .ipynb או .sql.

Cannot insert item: unsupported resource type.

נעשה ניסיון לגרור ולשחרר מקור מידע שיש לו ייצוג מחרוזת NoSQL.

אפשר להוסיף לעורכים רק טבלאות, תצוגות ועמודות.

שגיאות במסד הנתונים

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

AlloyDB

הודעת שגיאה

סיבה אפשרית

Remediation

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

הודעת שגיאה סיבה אפשרית Remediation
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 דרך הגדרות השאילתה, אפשר לעיין במאמר הרצת הצהרות 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

הודעת שגיאה סיבה אפשרית Remediation
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.
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

הודעת שגיאה

סיבה אפשרית

Remediation

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

אין תמיכה בגדלים של תוצאות שגדולים מ-10.00MiB.

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

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