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

בדף הזה מוסבר איך לחפש ולנהל את המשאבים של Cloud SQL באמצעות Knowledge Catalog (לשעבר Dataplex Universal Catalog).

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

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

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

אתם יכולים להשתמש ב-Knowledge Catalog כדי לגלות ולהבין את המטא-נתונים של Cloud SQL. אתם יכולים להשתמש ב-Knowledge Catalog כדי לבצע את הפעולות הבאות:

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

ב-Knowledge Catalog, אתם יכולים לאסוף מטא-נתונים על ידי צירוף היבטים לרשומות של מטא-נתונים ב-Cloud SQL. לכל היבט יכולים להיות כמה שדות מטא-נתונים, והוא יכול להתבסס על סוג היבט מוגדר מראש או מותאם אישית.

לדוגמה, אתם יכולים לצרף את ההיבט הבא לעמודה שמכילה מספר תעודת זהות, שהוא פרט אישי מזהה (PII):

  pii:true
  pii_type:SSN

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

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

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

כמעט בזמן אמת

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

1. מועד היצירה: ב-18 באפריל 2026 או אחרי התאריך הזה

2. ‫גרסה: Cloud SQL ל-PostgreSQL בגרסה 14.0 ואילך
3. ארכיטקטורת הרשת: ארכיטקטורת רשת חדשה

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

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

מופעים שמשולבים כמעט בזמן אמת מכילים טבלת חותמות זמן כדי לעקוב אחרי זמני היצירה והעדכון של הנכסים. טבלת חותמות הזמן היא הטבלה resource_timestamps במסד הנתונים cloudsqladmin. אפשר לשלוח שאילתות לטבלת חותמות הזמן מ-Cloud SQL במסוף Cloud de Confiance . כשיש שינוי ב-DDL או בסכימה של המכונה, השילוב שולח שאילתה לטבלת חותמות הזמן כדי לזהות נכסים שהשתנו לאחרונה, ואז טוען את העדכונים האחרונים בסכימה ל-Knowledge Catalog כמעט בזמן אמת. במקרים נדירים, למשל כשיש חוסר יציבות ברשת, יכול להיות ש-Knowledge Catalog יפספס עדכון. זה קורה לעיתים נדירות, אבל כל השינויים שלא נכללו יהיו עקביים בסופו של דבר, בדרך כלל תוך 24 שעות. מידע נוסף על תרחישים שעלולים לגרום לפספוס של שינויים מופיע בקטע מגבלות בדף הזה.

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

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

פעם ביום

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

1. זמן היצירה: לפני 18 באפריל 2026
2. ‫גרסה: Cloud SQL ל-PostgreSQL בגרסה שקודמת ל-14.0
3. ארכיטקטורת הרשת: ארכיטקטורת הרשת הישנה

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

אם המכונה נוצרה אחרי 18 באפריל 2026, השילוב עם Knowledge Catalog מופעל כברירת מחדל. במכונות שנוצרו לפני 18 באפריל 2026, אפשר להפעיל את השילוב של Knowledge Catalog במכונה קיימת של Cloud SQL.

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

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

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

1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance 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.

   Go to project selector

2. Verify that billing is enabled for your Cloud de Confiance project.

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

   הפעלת Dataplex API

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

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

התפקידים וההרשאות הנדרשים ב-IAM בשביל Knowledge Catalog

‫Cloud SQL משתמש בהרשאה cloudsql.schemas.view כדי לספק גישה למטא-נתונים ב-Knowledge Catalog.

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

מידע נוסף זמין במאמר תפקידי IAM מוגדרים מראש ב-Cloud SQL.

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

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

1. מועד היצירה: ב-18 באפריל 2026 או אחרי התאריך הזה

2. ‫גרסה: Cloud SQL ל-PostgreSQL בגרסה 14.0 ואילך
3. ארכיטקטורת הרשת: ארכיטקטורת רשת חדשה

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

gcloud sql instances create INSTANCE_NAME \
  --database-version=DATABASE_VERSION \
  --tier=MACHINE_TYPE \
  --region=REGION_NAME

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

{
  "name": "INSTANCE_NAME",
  "region": "REGION_NAME",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "enableDataplexIntegration": true
  }
}

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

$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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-09-25T22:19:33.735Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances

{
  "name": "INSTANCE_NAME",
  "region": "REGION_NAME",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "enableDataplexIntegration": true
  }
}

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances"

$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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-09-25T22:19:33.735Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

הפעלת השילוב של Knowledge Catalog במכונה קיימת של Cloud SQL

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

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

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

  • ‫גרסה: Cloud SQL ל-PostgreSQL בגרסה שקודמת ל-14.0
  • ארכיטקטורת הרשת: ארכיטקטורת הרשת הישנה

• במקרים שעומדים בכל הקריטריונים הבאים, הפעלת השילוב של Knowledge Catalog מאפשרת עדכונים כמעט בזמן אמת:

  • ‫גרסה: Cloud SQL ל-PostgreSQL בגרסה 14.0 ואילך
  • ארכיטקטורת הרשת: ארכיטקטורת רשת חדשה

  אחרי שמפעילים את השילוב כמעט בזמן אמת, שינויים חדשים ב-DDL ובסכימה מופיעים תוך 10 דקות, ומשאבים קיימים במכונה מאוכלסים תוך 24 שעות.

כדי להפעיל או להפעיל מחדש את השילוב של Knowledge Catalog במכונה קיימת של Cloud SQL, משתמשים באחד מהתהליכים הבאים.

gcloud sql instances patch INSTANCE_NAME \
  --enable-dataplex-integration

gcloud sql instances list --format="(NAME)" \
| tail -n +2 | xargs -t -I %
gcloud sql instances patch % --enable-dataplex-integration

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

{
  "settings":
  {
    "enableDataplexIntegration": true
  }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

$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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

{
  "settings":
  {
    "enableDataplexIntegration": true
  }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

$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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

אימות השילוב של Knowledge Catalog במכונה של Cloud SQL

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

gcloud sql instances describe INSTANCE_NAME

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

{
"settings":
  {
  "enableDataplexIntegration": true
  }
}

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

{
"settings":
  {
  "enableDataplexIntegration": true
  }
}

השבתת השילוב של Knowledge Catalog במכונה של Cloud SQL

כדי להשבית את השילוב של Knowledge Catalog במכונה של Cloud SQL, אתם יכולים להשתמש באחד מהתהליכים הבאים.

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

gcloud sql instances patch INSTANCE_NAME \
  --no-enable-dataplex-integration

gcloud sql instances list --format="(NAME)" \
| tail -n +2 | xargs -t -I %
gcloud sql instances patch % --no-enable-dataplex-integration

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

{
  "settings":
  {
    "enableDataplexIntegration": false
  }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

$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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

{
  "settings":
  {
    "enableDataplexIntegration": false
  }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

$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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

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

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

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

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

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

חיפוש נכסים של Cloud SQL

אתם יכולים לחפש נכסים של Cloud SQL בדף החיפוש של Knowledge Catalog במסוף Cloud de Confiance .

1. עוברים לדף Search ב-Knowledge Catalog.

   מעבר לחיפוש

2. בקטע בחירת פלטפורמת חיפוש, בוחרים באפשרות Knowledge Catalog.

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

4. זה שינוי אופציונלי. ב-Type aliases, אתם יכולים לסנן את תוצאות החיפוש לפי סוג ספציפי של נכס Cloud SQL, על ידי בחירה של אחד או יותר מהכינויים הבאים:

   • מסד נתונים
   • סכימה של מסד נתונים
   • Service
   • טבלה
   • תצוגה

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

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

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

system=Cloud_SQL AND type=Database

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

system=Cloud_SQL AND type=Table

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

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

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

מחליפים את QUERY_STRING במחרוזת שאילתה שמבוססת על מנוע Cloud SQL וסוג הנכס שרוצים לשלוח אליו שאילתה. בטבלה הבאה מפורטות מחרוזות השאילתה המתאימות.

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

type="projects/dataplex-types/locations/global/entryTypes/cloudsql-postgresql-instance"

סינון נכסי Cloud SQL לפי ניב Cloud SQL

כברירת מחדל, ב-Knowledge Catalog מוצגים כל הנכסים של Cloud SQL. כדי לסנן את הנכסים רק ל-Cloud SQL ל-MySQL, ל-Cloud SQL ל-PostgreSQL או לשרת SQL, מבצעים את הפעולות הבאות:

1. בחלונית Aspects, לוחצים על התפריט Add more aspect types.

2. לוחצים על גישה ל-SQL.

3. לוחצים על OK.

4. לוחצים על כפתור העריכה playlist_add . בדף SQL Access, מבצעים את הפעולות הבאות:

   • בשדה Dialect, בוחרים באפשרות PostgreSQL כדי לסנן את הנכסים של Cloud SQL ל-PostgreSQL.
5. זה שינוי אופציונלי. בשדה Version, מזינים גרסה ספציפית של Cloud SQL ל-PostgreSQL.

6. לוחצים על אישור. ב-Knowledge Catalog מוצגים רק נכסים של Cloud SQL ל-PostgreSQL.

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

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

1. בחלונית Aspects, לוחצים על התפריט Add more aspect types.

2. זה שינוי אופציונלי. בוחרים באפשרות SQL Access כדי לסנן את התוצאות לפי הניב של Cloud SQL. מידע נוסף מופיע בתהליך הקודם, סינון נכסי Cloud SQL לפי ניב של Cloud SQL.

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

   • מסד נתונים של Cloud SQL
   • מכונה של Cloud SQL
   • תצוגת Cloud SQL
   • סכימת Cloud SQL
   • טבלת Cloud SQL

4. לוחצים על OK.

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

6. אופציונלי: משפרים את הנכסים או צופים בהם. אלה הפעולות שאפשר לעשות:

   • בקטע Overview, לוחצים על Add כדי להוסיף תיאור של הנכס בטקסט עשיר.
   • בקטע Aspects (היבטים), לוחצים על Add (הוספה) כדי לצרף היבט לנכס.
   • לדוגמה, כדי להציג מסדי נתונים של חברים, לוחצים על הכרטיסייה Entry List ואז על Show all children entries in search. אם הכרטיסייה Entry List לא מופיעה, סימן שאין למכונה מסדי נתונים.
   • בקטע פרטי הרשומה, אפשר לראות את הפרטים המלאים של הנכס. לוחצים על שם הרשומה כדי להציג רשומות נוספות.

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

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

1. עוברים לדף Search ב-Knowledge Catalog.

   מעבר לחיפוש

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

3. בחלונית המסננים, בוחרים באפשרות Systems ואז באפשרות Cloud SQL. אפשר גם להזין system=Cloud_SQL בשדה החיפוש.

4. בוחרים שם למכונה.

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

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

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

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

תהליך העבודה הזה מדגים פירוט ממופע לטבלה. כדי לעבור ישירות לרשימת הטבלאות, אפשר להזין system=Cloud_SQL AND type=Table בשדה החיפוש.

תמחור

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

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

כשהשילוב של Knowledge Catalog מופעל, Knowledge Catalog מחלץ נתונים מהמכונות שלכם מדי פעם. תהליך החילוץ דורש שימוש מסוים ב-CPU.

בדרך כלל, למכונות שמשולבות ב-Knowledge Catalog כמעט בזמן אמת יש השפעה מינימלית על השימוש במעבד (CPU). במכונות שמשולבות עם Knowledge Catalog פעם ביום, השימוש במעבד יכול להיות גבוה יותר. ההשפעה הזו בולטת במיוחד במכונות עם סוגי מכונות קטנים יותר, למשל מכונות עם ליבות מעבד משותפות וסכימות גדולות יותר (10,000 טבלאות או יותר), שיכולות להשתמש בעד 40% מהמעבד שלהן במהלך תהליך החילוץ. במכונות מסוגים קטנים יותר, כמו מכונות עם ליבות מעבד משותפות וסכימות גדולות יותר (10,000 טבלאות או יותר), תהליך החילוץ יכול להשתמש בעד 40% מהמעבד.

מגבלות

בקטע הזה מפורטות המגבלות בשימוש ב-Cloud SQL וב-Knowledge Catalog.

• במכונות שנוצרו לפני 18 באפריל 2026, השילוב של Knowledge Catalog עם Cloud SQL מושבת בכל מכונה שמגבילה את הגישה למשאבים בגלל רישום המשאבים ב-Assured Workloads.

• אחרי שמפעילים את Knowledge Catalog במכונה, יכול להיות שיעברו בין שעתיים ל-48 שעות עד שמשאבי Cloud SQL יופיעו ב-Knowledge Catalog כנכסים, בהתאם לגודל המכונה, לגרסה ולסוג של מנוע Cloud SQL שבו אתם משתמשים.

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

המגבלות הבאות חלות רק כשהמכונה מתעדכנת כמעט בזמן אמת, כמו שמתואר בקטע כמעט בזמן אמת:

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

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

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