התקנת התוסף

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

כדי להתקין את הפלאגין Data Agent Kit במקום התוסף IDE או בנוסף אליו, אפשר לעיין במאמר התקנת הפלאגין של סוכן התכנות.

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

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

התקנה של סביבת פיתוח משולבת (IDE) ו-Python

במחשב המקומי, מתקינים את סביבת הפיתוח המשולבת (IDE) ואת Python.

  1. מתקינים ומגדירים את סביבת הפיתוח המשולבת (IDE). אם האפליקציה כבר מותקנת, צריך לעדכן אותה לגרסה העדכנית.
  2. מתקינים את Python.

הגדרה של Google Cloud

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

התקנת ה-CLI של gcloud

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

  1. פותחים את הטרמינל במחשב המקומי או בסביבת הפיתוח המשולבת (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, צריך לבקש מהאדמין להקצות לכם את תפקידי ניהול הזהויות והרשאות הגישה (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)

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

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

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

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

  • 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. ב-IDE, לוחצים על Extensions (תוספים) או לוחצים על Ctrl/Cmd+Shift+X.
  2. חיפוש של Google Cloud Data Agent Kit.
  3. לוחצים על התקנה.
  4. אם מתבקשים, מפעילים מחדש את סביבת הפיתוח המשולבת. אחרי שהתוסף מותקן בהצלחה, הסמל של 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 ואז להיכנס שוב. כדי למצוא שיטות נוספות לאבחון ולפתרון של שגיאות בהתקנה, אפשר לעיין במאמר פתרון בעיות.

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