ניהול משאבי AlloyDB באמצעות Knowledge Catalog

תצוגה מקדימה

השימוש בתכונה הזו כפוף לתנאי השימוש במוצרים בגרסת טרום-GA, שמפורטים בחלק "תנאי שירות הכלליים" בתנאים הספציפיים של השירות. השימוש בתכונות בגרסת טרום-GA הוא "כפי שהן" (As is), ויכול להיות שהתמיכה בהן תהיה מוגבלת. מידע נוסף זמין בקטע תיאור שלבי ההשקה.

הערה: השילוב של Knowledge Catalog עם AlloyDB מופעל עכשיו כברירת מחדל בכל אשכולות AlloyDB חדשים.

השילוב של Knowledge Catalog מופעל כברירת מחדל בכל האשכולות החדשים של AlloyDB, ומאפשר לכם לחפש ולנהל את המשאבים שלכם ב-AlloyDB ל-PostgreSQL באמצעות Knowledge Catalog, פלטפורמה שמאפשרת לכם לאחסן, לנהל ולגשת למטא-נתונים. השילוב הזה עוזר לכם לגלות את המטא-נתונים של AlloyDB ולהבין אותם, והוא תומך בתרחישי השימוש הבאים:

• ניתוח: הבנת התלות והערכת ההתאמה לתרחישי שימוש שונים.
• ניהול שינויים: מעקב אחרי שינויים במטא-נתונים וניהול שלהם בצורה יעילה.
• התפתחות הסכימה: מעקב אחרי שינויים בסכימה ותכנון שלהם.

‫Knowledge Catalog מאחזר באופן אוטומטי את המטא-נתונים הבאים מאשכולות, מופעים, מסדי נתונים, טבלאות, עמודות ותצוגות של AlloyDB:

• שם
• מיקום (אזור)
• תוויות (לאשכולות ולמופעים)
• השילוב עם Dataplex הופעל (עבור אשכולות)
• גרסת מסד הנתונים
• מספר ליבות ה-CPU במכונה (למופעים)
• סוג הזמינות (למופעים)
• ערכת תווים (למסדי נתונים)
• סדר השוואה (למסדי נתונים)
• בעלים
• תיאור (של טבלה, תצוגות, עמודות ומפתחות זרים)
• סוג (לאשכולות, למופעים ולמכונות)
• עמודות
  • סוג הנתונים
  • מצב
• מפתח ראשי
• מפתחות זרים
  • טבלה שאליה יש הפניה
  • מיפוי עמודות
• שעת יצירה
• מועד השינוי האחרון

הערה: ב-Knowledge Catalog, משאבים ב-AlloyDB ובשירותים אחרים של Google Cloud מוגדרים כנכסים. במסמך הזה, משאבי AlloyDB – אשכולות, מכונות, מסדי נתונים, טבלאות, סכימות ותצוגות – נקראים נכסי AlloyDB. המונח 'נכסים' מתייחס גם למשאבים ולמטא-נתונים שלהם ב-Knowledge Catalog.

סוגים של גילוי מטא-נתונים

גילוי מטא-נתונים ב-Knowledge Catalog הוא תהליך אוטומטי שסורק מקורות נתונים מקושרים – כמו AlloyDB – כדי לזהות נכסי נתונים כמו טבלאות, תצוגות ומסדי נתונים. לאחר מכן, Knowledge Catalog מחלץ מטא-נתונים טכניים מהנכסים, כמו סכימות, תיאורים ומיקומים, אל Knowledge Catalog.

התהליך הזה מסנכרן את המטא-נתונים כמעט בזמן אמת, וכך הקטלוג נשאר מסונכרן עם מערכות המקור. ב-AlloyDB, מטא-נתונים של אשכולות ומכונות מתגלים כברירת מחדל. גילוי מטא-נתונים של מסד נתונים, סכימה, טבלה ותצוגה מופעל כברירת מחדל באשכולות חדשים. במקרים של אשכולות שנוצרו לפני שהוגדר ברירת המחדל הזו (26 בפברואר 2026), צריך להפעיל את השילוב באופן ידני.

חיפוש מילות מפתח וחיפוש בשפה טבעית

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

• חיפוש מילות מפתח עוזר לכם למצוא משאבים באמצעות מילות מפתח ספציפיות, מסננים ותחביר מוגדר. לדוגמה, כדי להציג את כל מסדי הנתונים של AlloyDB, מזינים system=AlloyDB AND type=Database.
• חיפוש בשפה טבעית (גרסת Preview) משתמש ב-AI כדי להבין שאילתות סמנטיות. הוא עוזר לכם למצוא משאבים באמצעות שפה יומיומית, בלי שתצטרכו להשתמש בתחביר מורכב. לדוגמה, מזינים שאילתה כמו List all AlloyDB tables related to sales.

מידע נוסף זמין במאמר תחביר החיפוש ב-Knowledge Catalog.

דוגמה: גילוי סכימת מסד נתונים של AlloyDB

כדי להבין את תהליך גילוי המטא-נתונים, נתייחס לדוגמה של אשכול AlloyDB בשם user-data-cluster עם שילוב של Knowledge Catalog מופעל. במופע הראשי של האשכול הזה, יש מסד נתונים בשם profiles, שמכיל טבלה customers (id, email, signup_date) ותצוגה active_users (id, email).

מכיוון ש-AlloyDB מסתנכרן עם Knowledge Catalog כמעט בזמן אמת, המשאבים הבאים זמינים:

• אשכולות
• Columns
• מסדי נתונים
• מכונות
• Tables
• תצוגות

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

העשרת מטא-נתונים באמצעות היבטים

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

אחרי שיוצרים סוגים של היבטים בהתאמה אישית, מצרפים היבטים לנכסי AlloyDB. צירוף היבטים לנכסי AlloyDB מאפשר לכם:

• מוסיפים מטא-נתונים של העסק לנכסים.
• חיפוש נכסים לפי מטא-נתונים של העסק ומטא-נתונים מותאמים אישית אחרים.

מידע נוסף על יצירת סוגי היבטים וצירוף היבטים ל-AlloyDB זמין במאמר ניהול היבטים והעשרת מטא-נתונים.

תהליך העבודה של גילוי מטא-נתונים

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

1. מפעילים את השילוב של Knowledge Catalog עבור קלאסטר AlloyDB באמצעות AlloyDB API, אם הוא עדיין לא מופעל. הדרישה הזו חלה על אשכולות שנוצרו לפני 26 בפברואר 2026.

2. כדי לחפש נכסי AlloyDB, משתמשים בדף החיפוש של קטלוג הידע במסוף Google Cloud . מידע נוסף זמין במאמר חיפוש משאבים בקטלוג הידע.

3. כדי להוסיף עוד הקשר לנכסי AlloyDB, צריך לצרף היבטים לנכסים. היבטים הם רשומות מטא-נתונים בהתאמה אישית שעוזרות בניהול ובמשילות מידע. לדוגמה, אפשר להשתמש בהיבט כדי להוסיף תווית לעמודה שמכילה פרטים אישיים מזהים (PII). מידע נוסף מופיע במאמר בנושא ניהול היבטים והעשרת מטא-נתונים.

4. אפשר לנווט בין משאבי AlloyDB לפי ההיררכיה הבאה: אשכול > מסד נתונים > סכימה > טבלה או תצוגה > עמודה. ההיררכיה הזו מספקת תצוגה מפורטת של נתוני המערכת. מידע נוסף זמין במאמר חיפוש משאבים ב-Knowledge Catalog.

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

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

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

1. מפעילים את Dataplex API בפרויקט.

   הפעלת Dataplex API

2. בודקים את ההרשאות.

   כדי לחפש רשומות ולצרף אותן לנכסי AlloyDB, צריכות להיות לכם הרשאות ותפקידים ספציפיים ב-IAM. למידע נוסף, אפשר לעיין במאמר ההרשאות והתפקידים הנדרשים ב-IAM ל-Knowledge Catalog.

התפקידים שצריך ב-IAM

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

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

כדי לחפש ולהציג מטא-נתונים של AlloyDB ב-Knowledge Catalog, לגורמים נדרשות הרשאות להצגת משאבי AlloyDB, כולל ההרשאה dataplex.projects.search.

כדי להעניק את ההרשאות האלה לגורמים כמו משתמשים, קבוצות או חשבונות שירות, צריך להקצות להם את תפקיד ה-IAM‏ AlloyDB Viewer (roles/alloydb.viewer) בפרויקט שמכיל את משאבי AlloyDB.

פעולה ב-Knowledge Catalog	משאב AlloyDB	תפקידים או הרשאות נדרשים
חיפוש משאבים של AlloyDB	אשכול	alloydb.clusters.get
	Columns	alloydb.databases.get
	Instance	alloydb.instances.get
	מסד נתונים	alloydb.databases.get
	Tables	alloydb.databases.get
	תצוגות	alloydb.databases.get

חשוב לדעת: אם מקצים את התפקיד roles/alloydb.viewer ברמת הפרויקט, גורמים ראשיים עם התפקיד הזה יכולים לראות את המטא-נתונים של כל מופעי AlloyDB בפרויקט.

אם אתם לא רוצים להשתמש בתפקיד המוגדר מראש צפייה ב-AlloyDB, אתם יכולים להקצות תפקיד בהתאמה אישית שכולל את ההרשאות alloydb.clusters.get, alloydb.instances.get ו-alloydb.databases.get.

מידע נוסף על מתן תפקידים מופיע במאמר ניהול הגישה. במאמר תפקידים והרשאות ב-IAM ל-AlloyDB יש מידע נוסף על תפקידים ב-IAM ל-AlloyDB.

התפקידים שנדרשים כדי לחפש רשומות

צריכה להיות לכם לפחות אחת מהרשאות ה-IAM הבאות בפרויקט שמשמש לחיפוש:

• אדמין של Dataplex Catalog‏ (roles/dataplex.catalogAdmin)
• עריכה ב-Dataplex Catalog‏ (roles/dataplex.catalogEditor)
• בעל הרשאת צפייה ב-Dataplex Catalog‏ (roles/dataplex.catalogViewer)

ההרשאות בתוצאות החיפוש נבדקות בנפרד מהפרויקט שנבחר. מידע נוסף זמין במאמר בנושא חיפוש נכסי נתונים באמצעות Knowledge Catalog.

עדכניות הנתונים בשילוב עם Knowledge Catalog

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

השילוב של Knowledge Catalog למשאבי מסד נתונים, סכימה, טבלה ותצוגה מופעל כברירת מחדל כשיוצרים אשכול חדש של AlloyDB. כדי למנוע את סנכרון המטא-נתונים האלה, משביתים את השילוב.

הפעלת השילוב מפעילה את הייצוא של מטא-נתונים של AlloyDB – כמו מסדי נתונים, סכימות וטבלאות – לקטגוריות של Cloud Storage לצורך סנכרון תקופתי, או לנושאים של Pub/Sub לצורך סנכרון כמעט בזמן אמת, וכך הנתונים זמינים ב-Knowledge Catalog. התכונה הזו רלוונטית רק לאשכולות ראשיים. אשכולות משניים שמשמשים לשכפול חוצה אזורים לא תומכים בשילוב עם Knowledge Catalog של מטא-נתונים של מסדי נתונים, סכימות, טבלאות ותצוגות.

הערה: מטא-נתונים ברמת המשאב, כמו מטא-נתונים של אשכול ושל מופע, תמיד מופעלים ואי אפשר להשבית אותם.

עדכניות המטא-נתונים של המשאבים האלה תלויה במועד שבו האשכול נוצר או שוחזר:

• כמעט בזמן אמת: אשכולות שנוצרו או ששוחזרו ב-3 באפריל 2026 או אחריו מסנכרנים את המטא-נתונים עם Knowledge Catalog כמעט בזמן אמת. העדכונים זמינים ב-Knowledge Catalog תוך 5 דקות. תהליך החילוץ נמשך בדרך כלל כמה שניות.

• מדי כמה שעות: אשכולות שנוצרו או ששוחזרו בין 26 בפברואר 2026 ל-3 באפריל 2026 מרעננים את המטא-נתונים ב-Knowledge Catalog מדי כמה שעות. העדכונים יופיעו ב-Knowledge Catalog תוך 48 שעות. תהליך החילוץ נמשך בדרך כלל כמה דקות, אבל משך הזמן עד לסיום תלוי בגודל המעבד ובמספר הטבלאות.

הערה: כדי לשדרג את האוספים מסנכרון כל כמה שעות לסנכרון כמעט בזמן אמת, פנו Google Cloud לתמיכה.

יצירת AlloyDB כשהשילוב עם Knowledge Catalog מושבת

אתם יכולים לשלוט בשילוב הזה כשאתם יוצרים או מעדכנים אשכול באמצעות Google Cloud CLI או AlloyDB API:

gcloud

משתמשים בפקודה gcloud alloydb clusters create כדי ליצור אשכול AlloyDB. אם לא מציינים את הדגל --enable-dataplex-integration, שילוב Knowledge Catalog מופעל כברירת מחדל עבור מטא-נתונים של מסד נתונים, סכימה, טבלה ותצוגה. רשימה מלאה של הפרמטרים של השיחה הזו מופיעה במאמר gcloud alloydb clusters create. מידע על הגדרות האשכול זמין במאמר צפייה בהגדרות של אשכול ומופע.

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

כדי להשבית את השילוב של Knowledge Catalog למשאבים של מסד נתונים, סכימה, טבלה ותצוגה, צריך לכלול את הדגל --no-enable-dataplex-integration:

gcloud alloydb clusters create CLUSTER_ID \
    --password=PASSWORD \
    --region=REGION \
    --no-enable-dataplex-integration

מחליפים את הפרטים הבאים:

• ‫CLUSTER_ID: המזהה של האשכול שיוצרים. מזהה האשכול חייב להתחיל באות קטנה באנגלית, ויכול לכלול אותיות קטנות, מספרים ומקפים.
• ‫PASSWORD: הסיסמה שבה משתמשים עבור משתמש ברירת המחדל postgres.
• ‫REGION: המזהה של האזור של האשכול.

REST

משתמשים בשיטה POST כדי ליצור אשכול AlloyDB. אם לא מציינים את dataplexConfig בבקשה, השילוב עם Knowledge Catalog מופעל כברירת מחדל עבור מטא-נתונים של מסד נתונים, סכימה, טבלה ותצוגה. רשימה מלאה של הפרמטרים של הקריאה הזו זמינה במאמר Method: projects.locations.clusters.create. מידע על הגדרות האשכול זמין במאמר View cluster and instance settings.

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

כדי להשבית את השילוב של Knowledge Catalog למשאבי מסד נתונים, סכימה, טבלה ותצוגה, צריך לכלול את "dataplexConfig": { "enabled": false } בגוף הבקשה:

{
  "databaseVersion": "DATABASE_VERSION",
  "initialUser": {
    "user": "INITIAL_USERNAME",
    "password": "INITIAL_USER_PASSWORD"
  },
  "labels": {
    "test": "alloydb-cluster-full"
  },
  "dataplexConfig" : {
    "enabled" : false
  }
}

מחליפים את הפרטים הבאים:

• ‫DATABASE_VERSION: מחרוזת enum של גרסת מסד הנתונים, לדוגמה POSTGRES_16.
• ‫INITIAL_USERNAME: שם המשתמש שבו אתם משתמשים עבור משתמש ברירת המחדל של postgres.
• ‫INITIAL_USER_PASSWORD: הסיסמה שבה משתמשים עבור משתמש ברירת המחדל של postgres.

משתמשים ב-method הבא ב-HTTP ובכתובת ה-URL:

POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID

מחליפים את הפרטים הבאים:

• ‫PROJECT_ID: המזהה או מספר הפרויקט של Google Cloud הפרויקט שמכיל את האשכול.
• ‫LOCATION_ID: המזהה של האזור של האשכול.
• ‫CLUSTER_ID: המזהה של האשכול שיוצרים. מזהה האשכול חייב להתחיל באות קטנה באנגלית, ויכול לכלול אותיות קטנות, מספרים ומקפים.

כדי לשלוח את הבקשה, אפשר לבחור באחת מהאפשרויות הבאות:

‏Curl (Linux,‏ macOS או Cloud Shell)

הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של Google Cloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, מריצים את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

    curl -X POST \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
        "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID"
      

‎PowerShell (Windows)

הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של Google Cloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, מריצים את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID"| Select-Object -Expand Content

מקבלים תגובת JSON שדומה לזו:

תשובה

{
  "kind": "alloydb#operation",
  "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2024-09-25T22:19:33.735Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "CLUSTER_ID",
  "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

הפעלת השילוב של Knowledge Catalog באשכול AlloyDB

כדי להפעיל את השילוב של Knowledge Catalog באשכול קיים, משתמשים באחד מהתהליכים הבאים:

gcloud

כדי להפעיל את השילוב של Knowledge Catalog באשכול קיים, משתמשים בפקודה gcloud alloydb clusters update עם הדגל --enable-dataplex-integration.

gcloud alloydb clusters update CLUSTER_ID \
    --region=REGION \
    --enable-dataplex-integration

מחליפים את הפרטים הבאים:

• ‫CLUSTER_ID: שם האשכול.
• ‫REGION: המזהה של האזור של האשכול.

REST

כדי לעדכן שדות ספציפיים של אשכול קיים, משתמשים בשיטה PATCH ב-projects.locations.clusters resource.

משתמשים ב-method הבא ב-HTTP ובכתובת ה-URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled

מחליפים את הפרטים הבאים:

• ‫PROJECT_ID: המזהה או מספר הפרויקט של Google Cloud הפרויקט שמכיל את האשכול.
• ‫LOCATION_ID: המזהה של האזור של האשכול.
• ‫CLUSTER_ID: שם האשכול.

תוכן בקשת JSON:

{
  "dataplexConfig": {
    "enabled": true
  }
}

כדי לשלוח את הבקשה, אפשר לבחור באחת מהאפשרויות הבאות:

‏Curl (Linux,‏ macOS או Cloud Shell)

הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של Google Cloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, מריצים את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

    curl -X PATCH \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
        "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"
      

‎PowerShell (Windows)

הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של Google Cloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, מריצים את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"| Select-Object -Expand Content

מקבלים תגובת JSON שדומה לזו:

תשובה

{
  "kind": "alloydb#operation",
  "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2024-09-25T22:19:33.735Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "CLUSTER_ID",
  "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

אימות השילוב של Knowledge Catalog באשכול AlloyDB

כדי לוודא שהשילוב של Knowledge Catalog מופעל באשכול קיים, משתמשים באחת מהשיטות הבאות:

gcloud

כדי לוודא שהשילוב עם Knowledge Catalog מופעל באשכול קיים, משתמשים בפקודה gcloud alloydb clusters describe.

gcloud alloydb clusters describe CLUSTER_ID --region=REGION

מחליפים את הפרטים הבאים:

• ‫CLUSTER_ID: מזהה האשכול.
• ‫REGION: המזהה של האזור של האשכול.

הפלט כולל את הקטע dataplexConfig בפורמט YAML. אם הערך של enabled הוא true, השילוב עם Knowledge Catalog מופעל:

dataplexConfig:
  enabled: true

REST

כדי לוודא שהשילוב של Knowledge Catalog מופעל באשכול קיים, משתמשים בשיטה GET.

משתמשים ב-method הבא ב-HTTP ובכתובת ה-URL:

GET https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID

מחליפים את הפרטים הבאים:

• ‫PROJECT_ID: המזהה או מספר הפרויקט של הפרויקט שמכיל את האשכול. Google Cloud
• ‫LOCATION_ID: המזהה של האזור של האשכול.
• ‫CLUSTER_ID: מזהה האשכול.

כדי לשלוח את הבקשה, אפשר לבחור באחת מהאפשרויות הבאות:

‏Curl (Linux,‏ macOS או Cloud Shell)

הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של Google Cloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, מריצים את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID"
      

‎PowerShell (Windows)

הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של Google Cloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, מריצים את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content

מקבלים תגובת JSON לכל פרוטוקול Cluster, כולל ההודעה dataplexConfig:

{
  "dataplexConfig": {
    "enabled": true
  }
}

השבתת השילוב של Knowledge Catalog באשכול AlloyDB

כשמשביתים את השילוב של Knowledge Catalog באשכול AlloyDB, זמינים רק המטא-נתונים של האשכול והמכונה.

gcloud

משתמשים בפקודה gcloud alloydb clusters update עם הדגל --no-enable-dataplex-integration כדי להשבית את השילוב.

gcloud alloydb clusters update CLUSTER_ID \
    --region=REGION \
    --no-enable-dataplex-integration

מחליפים את הפרטים הבאים:

• ‫CLUSTER_ID: מזהה האשכול.
• ‫REGION: המזהה של האזור של האשכול.

REST

בדוגמה הבאה מוסבר איך להשבית את השילוב.

משתמשים ב-method הבא ב-HTTP ובכתובת ה-URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled

מחליפים את הפרטים הבאים:

• ‫PROJECT_ID: המזהה או מספר הפרויקט של Google Cloud הפרויקט שמכיל את האשכול.
• ‫LOCATION_ID: המזהה של האזור של האשכול.
• ‫CLUSTER_ID: מזהה האשכול.

תוכן בקשת JSON:

{
  "dataplexConfig": {
    "enabled": false
  }
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‏Curl (Linux,‏ macOS או Cloud Shell)

הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של Google Cloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, מריצים את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"
      

‎PowerShell (Windows)

הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של Google Cloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, מריצים את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"| Select-Object -Expand Content

מקבלים תגובת JSON שדומה לזו:

תשובה

{
  "kind": "alloydb#operation",
  "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2024-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "CLUSTER_ID",
  "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

העשרת נכסי AlloyDB באמצעות היבטים

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

אחרי שיוצרים סוגים של היבטים בהתאמה אישית, צריך לצרף היבטים לנכסי AlloyDB. צירוף היבטים לנכסי AlloyDB מספק את היכולות הבאות:

• הוספת מטא-נתונים של העסק לנכסים
• חיפוש נכסים לפי מטא-נתונים עסקיים ומטא-נתונים מותאמים אישית אחרים

מידע נוסף על יצירת סוגי היבטים וצירוף היבטים ל-AlloyDB זמין במאמר ניהול היבטים והעשרת מטא-נתונים.

חיפוש נכסי AlloyDB

משתמשים בדף החיפוש של Knowledge Catalog ב Google Cloud מסוף כדי לחפש נכסי AlloyDB.

1. עוברים לדף חיפוש ב-Knowledge Catalog.

   לחיפוש Google

2. בקטע Choose search platform (בחירת פלטפורמת חיפוש), בוחרים באפשרות Knowledge Catalog (קטלוג הידע).

3. בחלונית Filters, לוחצים על Systems ובוחרים באפשרות AlloyDB.

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

   • מסד נתונים
   • סכימת מסד נתונים
   • אשכול
   • Instance
   • שירות
   • טבלה
   • הצגה
   הערה: Service הוא כינוי לסוג של מופע AlloyDB.

שימוש בשאילתות לביצוע חיפוש מילות מפתח

משתמשים בשדה החיפוש ב-Knowledge Catalog כדי לבצע שאילתות לחיפוש מילות מפתח. לדוגמה, מזינים system=AlloyDB AND type=Database כדי לראות את כל מסדי הנתונים של AlloyDB.

מידע נוסף זמין במאמר תחביר החיפוש ב-Knowledge Catalog.

כדי לראות את כל נכסי AlloyDB, מזינים system=AlloyDB.

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

system=AlloyDB AND type=Database

כדי לראות את כל הטבלאות ב-AlloyDB, מזינים את השאילתה הבאה:

system=AlloyDB AND type=Table

אפשר להשתמש גם בסוגריים ובאופרטורים הלוגיים AND ו-OR לביטויים מורכבים. מידע נוסף על הביטויים שאפשר להשתמש בהם בשדה החיפוש זמין במאמר תחביר החיפוש ב-Knowledge Catalog.

אפשר להזין ישירות שאילתות חיפוש של נכסי AlloyDB ספציפיים בשדה החיפוש. הפורמט של מחרוזת השאילתה הוא:

type="projects/dataplex-types/locations/global/entryTypes/QUERY_STRING"

מחליפים את מה שכתוב בשדות הבאים:

• ‫QUERY_STRING: משתמשים ברשימה הבאה כדי לזהות מחרוזת שאילתה על סמך סוג נכס AlloyDB שרוצים לשלוח לגביו שאילתה:

  • alloydb-database
  • alloydb-cluster
  • alloydb-instance
  • alloydb-table
  • alloydb-schema
  • alloydb-view

דוגמה לשאילתה:

type="projects/1234567890/locations/global/entryTypes/alloydb-cluster"

חיפוש לפי סוג ההיבט

ב-Knowledge Catalog יש כמה סוגים מובנים של היבטים שעוזרים לכם לבצע חיפושים.

כדי לחפש לפי סוג היבט:

1. בחלונית מאפיינים, לוחצים על התפריט הוספת סוגי מאפיינים נוספים.
2. זה שינוי אופציונלי. בוחרים באפשרות AlloyDB Access כדי לסנן את התוצאות לפי ניב AlloyDB.
3. בוחרים אחד או יותר מסוגי ההיבטים הבאים כדי להגביל את תוצאות החיפוש לסוג הזה.
   • מסד נתונים של AlloyDB
   • אשכול AlloyDB
   • מופע AlloyDB
   • תצוגת AlloyDB
   • סכימת AlloyDB
   • טבלת AlloyDB
4. לוחצים על OK.
5. בטבלת התוצאות, לוחצים על שם הנכס כדי לראות את המטא-נתונים של הנכס.
6. אופציונלי: משפרים את הנכסים או צופים בהם. אפשר לשפר את הנכסים או לצפות בהם בדרכים הבאות:
   • כדי להוסיף תיאור בפורמט טקסט עשיר לנכס, לוחצים על הוספה בסקירה כללית.
   • כדי לצרף היבט לנכס, לוחצים על הוספה בהיבטים.
   • כדי לראות את מסדי הנתונים של החברים במופע, לוחצים על הכרטיסייה רשימת רשומות ואז על הצגת כל רשומות הצאצא בחיפוש. אם הכרטיסייה רשימת רשומות לא מופיעה, סימן שלקלאסטר אין מסדי נתונים.
   • כדי לראות את הפרטים המלאים של הנכס, לוחצים על פרטי הפריט. כדי לראות פריטים נוספים, לוחצים על שם הפריט.

חיפוש בשפה טבעית ב-AlloyDB

חיפוש בשפה טבעית (תצוגה מקדימה) משתמש ב-AI כדי להבין שאילתות סמנטיות. הוא עוזר לכם למצוא משאבים באמצעות שפה יומיומית, בלי שתצטרכו להשתמש בתחביר מורכב. לדוגמה, אפשר להזין שאילתות כמו List all AlloyDB tables related to sales.

מידע נוסף זמין במאמר תחביר החיפוש ב-Knowledge Catalog.

חיפוש תחביר ב-AlloyDB

חיפוש מילות מפתח עוזר לכם למצוא משאבים באמצעות מילות מפתח ספציפיות, מסננים ותחביר מוגדר. לדוגמה, מזינים system=AlloyDB AND type=Database כדי לראות את כל מסדי הנתונים של AlloyDB.

מידע נוסף זמין במאמר תחביר החיפוש ב-Knowledge Catalog.

דוגמה לתהליך עבודה – פירוט מתוך אשכול לעמודות

כדי לבצע פירוט יתר מאשכול לעמודות, פועלים לפי השלבים הבאים:

1. עוברים לדף חיפוש ב-Knowledge Catalog.

   לחיפוש Google

2. באפשרות Choose search platform (בחירת פלטפורמת חיפוש), בוחרים באפשרות Knowledge Catalog (קטלוג הידע).

3. בחלונית המסננים, בוחרים באפשרות מערכות ואז באפשרות AlloyDB. לחלופין, מקלידים system=AlloyDB בשדה החיפוש.

4. בוחרים שם לאשכול.

5. בדף AlloyDB details, לוחצים על הכרטיסייה Entry list ואז על Show all children entries in search. ב-Knowledge Catalog מוצגים מסדי הנתונים באשכול.

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

6. בדף AlloyDB database details, לוחצים על הכרטיסייה Entry list ואז על View child entries in search. ב-Knowledge Catalog מוצגות הטבלאות באשכול.

7. בוחרים שם של טבלה, ואז בדף AlloyDB table details (פרטי הטבלה ב-AlloyDB) לוחצים על Schema (סכימה) כדי לראות את העמודות בטבלה.

8. אופציונלי: כדי להוסיף סוג היבט לעמודה, לוחצים על הלחצן הוספת היבט.

תמחור

אין תשלום על אחסון מטא-נתונים טכניים של AlloyDB ב-Knowledge Catalog. חלים תעריפים רגילים של Knowledge Catalog על קריאות ל-API ועל העשרה של מטא-נתונים עסקיים נוספים. למידע נוסף, אפשר לעיין בדף התמחור של Knowledge Catalog.

שימוש במשאבים

מערכת Knowledge Catalog מחלצת מעת לעת מטא-נתונים מאשכולות AlloyDB. תהליך החילוץ הזה צורך משאבי CPU באשכול. השימוש במעבד בדרך כלל מינימלי. לדוגמה, באשכולות עם סוגי מכונות קטנים יותר (כמו n2-highmem-2-icelake) שמנהלים סכימות גדולות (כמו אלה עם 100,000 טבלאות או יותר), יכול להיות שיהיה גידול של עד 5% בשימוש במעבד במהלך החילוץ.

מגבלות

• השילוב תומך במקסימום של מיליון טבלאות לכל מסד נתונים, ובממוצע של 150 עמודות לכל טבלה. אם חורגים מאחת מהמגבלות האלה, לא מתבצעת חילוץ של מטא-נתונים למשאבים כמו מסדי נתונים, סכימות, טבלאות ותצוגות. רק מטא-נתונים של אשכולות ומופעים זמינים ב-Knowledge Catalog.
• כשיוצרים אשכול, הסנכרון הראשוני של כל המטא-נתונים עם Knowledge Catalog יכול להימשך עד 48 שעות. אחרי הסנכרון הראשוני, העדכונים הבאים זמינים כמעט בזמן אמת.
• אם יש קצב גבוה של שינויים במטא-נתונים (מעל 100 שינויים ב-DDL בשנייה) במסד הנתונים, יכול להיות שהסנכרון של המטא-נתונים כמעט בזמן אמת עם Knowledge Catalog יושהה למשך עד 30 דקות לפני שיחודש.
• אם פספסנו עדכון בגלל קצב גבוה של שינויים במטא-נתונים, בעיות ברשת או הפרעה לתהליך הסנכרון, העדכון יופיע בסופו של דבר ב-Knowledge Catalog תוך 48 שעות.
• אם מופעלת מחיקה של מטא-נתונים של מופע שלא קיים או שלא פועל, יכול להיות שיחלפו 7 ימים עד שהמטא-נתונים יימחקו.
• כשמשנים את השם של מסד נתונים, רק העדכון של מסד הנתונים זמין ב-Knowledge Catalog כמעט בזמן אמת. המיפוי הבסיסי של מסד הנתונים וכל הטבלאות הרלוונטיות יעודכן ב-Knowledge Catalog תוך 48 שעות.

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

• מידע על ניהול מטא-נתונים ב-Knowledge Catalog
• תפקידים בניהול זהויות והרשאות גישה (IAM) ב-Knowledge Catalog