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

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

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

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

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

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

מידע נוסף זמין במאמר מידע על ניהול מטא-נתונים ב-Knowledge Catalog.

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

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

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

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

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

ב-Knowledge Catalog אפשר לחפש לפי מילות מפתח ובשפה טבעית.

• חיפוש לפי מילות מפתח עוזר למצוא משאבים באמצעות מילות מפתח ספציפיות, מסננים ותחביר מוגדר. לדוגמה, כדי לראות את כל מסדי הנתונים של AlloyDB, מזינים system=AlloyDB AND type=Database.
• חיפוש בשפה טבעית משתמש ב-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. אחר כך אפשר לראות את הסכימות שלהם ולהעשיר אותן במטא-נתונים עסקיים או תפעוליים נוספים.

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

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

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

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

במאמר ניהול היבטים והעשרת מטא-נתונים מוסבר איך יוצרים סוגי היבטים ומצרפים היבטים ל-AlloyDB.

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

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

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

2. מחפשים את נכסי AlloyDB באמצעות דף החיפוש של Knowledge Catalog במסוף Google Cloud . מידע נוסף זמין במאמר חיפוש משאבים ב-Knowledge Catalog.

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

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

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

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

2. Verify that billing is enabled for your Google Cloud project.

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

   הפעלת Dataplex API

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

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

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

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

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

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

כדי לתת לחשבונות משתמשים, קבוצות או חשבונות שירות את ההרשאות האלה, מקצים להם את התפקיד AlloyDB Viewer (roles/alloydb.viewer) ב-IAM בפרויקט שמכיל את המשאבים של 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‏ (roles/dataplex.catalogAdmin)
• עריכה ב-Dataplex Catalog‏ (roles/dataplex.catalogEditor)
• צפייה בקטלוג Dataplex‏ (roles/dataplex.catalogViewer)

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

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

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

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

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

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

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

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

• כל כמה שעות: אשכולות שנוצרו או שוחזרו בין 26 בפברואר 2026 ל-3 באפריל 2026 מרעננים את המטא-נתונים ב-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

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

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

כדי להשבית את השילוב של 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)

הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-Google Cloud CLI באמצעות חשבון המשתמש שלכם, על ידי הרצת 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)

הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-Google Cloud CLI באמצעות חשבון המשתמש שלכם, על ידי הרצת 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 אמורה להיראות כך:

תשובה

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
    "createTime": "2024-09-25T22:19:33.735Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

הפעלת השילוב של 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

כדי לעדכן שדות ספציפיים של אשכול קיים, משתמשים ב-method‏ 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)

הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-Google Cloud CLI באמצעות חשבון המשתמש שלכם, על ידי הרצת 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)

הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-Google Cloud CLI באמצעות חשבון המשתמש שלכם, על ידי הרצת 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 אמורה להיראות כך:

תשובה

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
    "createTime": "2024-09-25T22:19:33.735Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

אימות השילוב של 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 מופעל באשכול קיים, משתמשים ב-method‏ 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)

הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-Google Cloud CLI באמצעות חשבון המשתמש שלכם, על ידי הרצת 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)

הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-Google Cloud CLI באמצעות חשבון המשתמש שלכם, על ידי הרצת 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 לכל ה-proto של האשכול, שכוללת את ההודעה dataplexConfig:

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

הערה: אם השילוב של Knowledge Catalog מושבת באשכול, ה-API מחזיר את הערך "dataplexConfig": {} כי proto3 משמיט שדות עם ערכי ברירת מחדל.

השבתת השילוב של 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)

הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-Google Cloud CLI באמצעות חשבון המשתמש שלכם, על ידי הרצת 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)

הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-Google Cloud CLI באמצעות חשבון המשתמש שלכם, על ידי הרצת 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 אמורה להיראות כך:

תשובה

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
    "createTime": "2024-01-16T02:32:12.281Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

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

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

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

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

במאמר ניהול היבטים והעשרת מטא-נתונים מוסבר איך יוצרים סוגי היבטים ומצרפים היבטים ל-AlloyDB.

חיפוש נכסים ב-AlloyDB

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

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

   מעבר לחיפוש

2. בקטע בחירת פלטפורמת חיפוש, בוחרים באפשרות 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/dataplex-types/locations/global/entryTypes/alloydb-cluster"

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

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

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

1. בחלונית Aspects, לוחצים על התפריט Add more aspect types.
2. זה שינוי אופציונלי. בוחרים באפשרות AlloyDB Access כדי לסנן את התוצאות לפי הניב של AlloyDB.
3. כדי להגביל את תוצאות החיפוש לסוג מסוים, בוחרים אחד או יותר מסוגי ההיבטים הבאים.
   • מסד נתונים ב-AlloyDB
   • אשכול AlloyDB
   • מכונה של AlloyDB
   • תצוגת AlloyDB
   • סכימת AlloyDB
   • טבלת AlloyDB
4. לוחצים על OK.
5. בטבלת התוצאות, לוחצים על שם הנכס כדי לראות את המטא-נתונים שלו.
6. אופציונלי: משפרים את הנכסים או צופים בהם. אתם יכולים לשפר או לראות את הנכסים בדרכים הבאות:
   • כדי להוסיף תיאור בטקסט עשיר של הנכס, לוחצים על Add בקטע Overview.
   • כדי לצרף היבט לנכס, לוחצים על הוספה בקטע היבטים.
   • כדי לראות את מסדי הנתונים של המכונה, לוחצים על הכרטיסייה Entry List ואז על Show all children entries in search. אם הכרטיסייה Entry List לא מופיעה, לאשכול אין מסדי נתונים.
   • בקטע פרטי הרשומה אפשר לראות את הפרטים המלאים של הנכס. לוחצים על שם הרשומה כדי להציג רשומות נוספות.

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

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

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

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

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

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

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

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

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

   מעבר לחיפוש

2. באפשרות Choose search platform, בוחרים באפשרות Knowledge Catalog.

3. ב-Filters panel, בוחרים באפשרות Systems ואז ב-AlloyDB. אפשר גם להזין system=AlloyDB בשדה החיפוש.

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

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

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

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

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

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

תמחור

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

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

‫Knowledge Catalog מחלץ מדי פעם מטא-נתונים מאשכולות AlloyDB. תהליך החילוץ הזה צורך משאבי מעבד (CPU) באשכול. השימוש במעבד (CPU) הוא בדרך כלל מינימלי. לדוגמה, באשכולות עם סוגי מכונות קטנים יותר (כמו n2-highmem-2-icelake) שמנהלים סכימות גדולות (כמו כאלה עם 100,000 טבלאות או יותר), יכול להיות שהשימוש ב-CPU יגדל בשיעור של עד 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