התקנת התוסף

התוסף Google Cloud Data Agent Kit ל-Antigravity IDE מאפשר לכם לעבוד עם משאבי הנתונים שלכם ב-IDE המועדף עליכם. Google Cloud

לפני שמתחילים

לפני שמתקינים את התוסף Data Agent Kit ל-Antigravity IDE, צריך לבצע את הפעולות הבאות.

התקנה של Antigravity IDE ו-Python

במחשב המקומי, מתקינים את Antigravity IDE ואת Python.

  1. מתקינים ומגדירים את Antigravity במחשב, או מעדכנים לגרסה 1.21.5 ואילך.
  2. מתקינים את Python.

הגדרה של Google Cloud

  1. אם עדיין אין לכם פרויקט, יוצרים פרויקט. Google Cloud
  2. מפעילים את החיוב.

התקנת ה-CLI של gcloud

צריך להתקין את Google Cloud CLI ולהיכנס אליו. התוסף משתמש בפרטי כניסה מ-ה-CLI של gcloud ומפרטי כניסה שמוגדרים כברירת מחדל באפליקציה (ADC).

  1. פותחים את הטרמינל במחשב המקומי או ב-Antigravity IDE.
  2. אם לא התקנתם בעבר את ה-CLI של gcloud, אתם צריכים להוריד ולהתקין אותו לפי השלבים במאמר התקנת ה-CLI של gcloud.

  3. בטרמינל, מריצים את הפקודה gcloud init כדי לאתחל את ה-CLI של gcloud:

    gcloud init

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

    gcloud auth login && gcloud auth application-default login

  5. מעדכנים את ה-CLI של gcloud לגרסה העדכנית:

    gcloud components update

התפקידים הנדרשים

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

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

  • צפייה בנתוני BigQuery ‏ (roles/bigquery.dataViewer)
  • BigQuery Job User (roles/bigquery.jobUser)
  • BigQuery Metadata Viewer (צפייה במטא-נתונים של BigQuery) (roles/bigquery.metadataViewer)
  • BigQuery Read Session User (roles/bigquery.readSessionUser)
  • עריכה ב-Dataproc (roles/dataproc.editor)

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

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

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

ההרשאות הנדרשות

  • bigquery.config.get
  • bigquery.datasets.get
  • bigquery.datasets.getIamPolicy
  • bigquery.jobs.create
  • bigquery.readsessions.create
  • bigquery.readsessions.getData
  • bigquery.readsessions.update
  • bigquery.tables.createSnapshot
  • bigquery.tables.export
  • bigquery.tables.get
  • bigquery.tables.getIamPolicy
  • bigquery.tables.list
  • bigquery.tables.replicateData
  • dataform.locations.get
  • dataform.locations.list
  • dataform.repositories.create
  • dataform.repositories.list
  • dataplex.projects.search
  • dataproc.clusters.use
  • dataproc.operations.get
  • dataproc.sessions.create
  • dataproc.sessions.delete
  • dataproc.sessions.get
  • dataproc.sessions.list
  • dataproc.sessions.terminate
  • dataproc.sessionTemplates.create
  • dataproc.sessionTemplates.delete
  • dataproc.sessionTemplates.get
  • dataproc.sessionTemplates.list
  • dataproc.sessionTemplates.update
  • resourcemanager.projects.get

התקנת התוסף

  1. ב-Antigravity IDE, לוחצים על Extensions (תוספים) או לוחצים על Ctrl/Cmd+Shift+X.
  2. חיפוש של Google Cloud Data Agent Kit.
  3. לוחצים על התקנה.
  4. אם מוצגת בקשה, מפעילים מחדש את Antigravity IDE. אחרי שהתוסף מותקן בהצלחה, הסמל של Google Cloud Data Agent Kit מתווסף לסרגל הפעילות.

כניסה ל-Google Cloud Data Agent Kit

בשלב הבא, צריך לבצע אימות ב-Google Cloud Data Agent Kit באמצעות אותו חשבון שבו השתמשתם כדי להיכנס ל-CLI של gcloud.

  1. אם תיבת הדו-שיח של הכניסה לא נפתחת באופן אוטומטי, מחפשים את הקישור לכניסה ל-Google Cloud Data Agent Kit בסרגל הסטטוס בחלק התחתון של חלון ה-IDE ולוחצים עליו.

    אפשר גם להקיש על Ctrl/Cmd+Shift+P כדי לפתוח את לוח הפקודות, לחפש את האפשרות Google Cloud Data Agent Kit: Sign in ולבחור אותה.

  2. פועלים לפי ההנחיות ומסיימים את תהליך הכניסה.

    מוצג דף אינטרנט שמאשר שהאימות הושלם.

  3. סוגרים את הדף וחוזרים לסביבת הפיתוח המשולבת (IDE).

הפעלת ממשקי ה-API

אחרי שנכנסים לחשבון Google, צריך להפעיל את ממשקי ה-API בGoogle Cloud פרויקט לכל השירותים שבהם משתמשים בתהליכי העבודה של מדעי הנתונים או הנדסת הנתונים.

כדי לראות את רשימת ממשקי ה-API ולבדוק אילו מהם כבר מופעלים:

  1. בסרגל הפעילות, לוחצים על הסמל של Google Cloud Data Agent Kit.
  2. מרחיבים את הגדרות ולוחצים על הגדרות.
  3. לוחצים על נפוצים.
  4. לוחצים על Required APIs (ממשקי API נדרשים).

ממשקי API להפעלה

  • ‫AlloyDB API
  • BigLake API
  • BigQuery API
  • Cloud Composer API
  • Cloud Dataplex API
  • Cloud Resource Manager API
  • Cloud Spanner API
  • Cloud SQL
  • Cloud SQL Admin API
  • Cloud Storage API
  • Dataproc API
  • Dataproc Release Manager API
  • Vertex AI API

פתרון בעיות

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

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