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

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

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

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

מאגר הידע מאחזר מטא-נתונים רק ממופעים ראשיים של 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. ארכיטקטורת רשת: ארכיטקטורת רשת חדשה

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

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

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

אפשר להשבית את השילוב ולהפעיל אותו מחדש מאוחר יותר באמצעות ההוראות שבמאמר עדכון המופע.

פעם ביום

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

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

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

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

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

  1. נכנסים לחשבון Google Cloud . אם אתם משתמשים חדשים ב- Google Cloud, צרו חשבון כדי שתוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.
  2. 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.

    Go to project selector

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

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

    Go to project selector

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

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

    הפעלת Dataplex API

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

    כדי לחפש רשומות ולצרף אותן לנכסי 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

יצירת המופע

כדי ליצור מכונה של Cloud SQL, משתמשים בפקודה gcloud sql instances create.

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

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

  • INSTANCE_NAME: השם של המכונה
  • DATABASE_VERSION: גרסת מסד הנתונים של המופע (לדוגמה, POSTGRES_14 ). לרשימה מלאה של המחרוזות הזמינות, אפשר לעיין ב-SqlDatabaseVersion.
  • MACHINE_TYPE: סוג המכונה של המכונה
  • REGION_NAME: שם האזור של המכונה

הדוגמה הזו מבוססת על Linux.

REST v1

יצירת המופע

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

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • PROJECT_ID: המזהה או מספר הפרויקט של פרויקט Google Cloud שמכיל את המופע
  • INSTANCE_NAME: השם של המכונה
  • REGION_NAME: שם האזור של המכונה
  • DATABASE_VERSION: מחרוזת enum של גרסת מסד הנתונים (לדוגמה, POSTGRES_13). רשימה מלאה של המחרוזות הזמינות מופיעה במאמר בנושא SqlDatabaseVersion.
  • PASSWORD: הסיסמה של המשתמש root
  • MACHINE_TYPE: מחרוזת enum של סוג המכונה (רמת השירות), באופן הבא: db-custom-[CPUS]-[MEMORY_MBS]
  • EDITION_TYPE: מהדורת Cloud SQL שלכם

ה-method של ה-HTTP וכתובת ה-URL:

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

תוכן בקשת JSON:

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

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

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

{
  "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"
}

REST v1beta4

יצירת המופע

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

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • PROJECT_ID: המזהה או מספר הפרויקט של פרויקט Google Cloud שמכיל את המופע
  • INSTANCE_NAME: השם של המכונה
  • REGION_NAME: שם האזור של המכונה
  • DATABASE_VERSION: מחרוזת enum של גרסת מסד הנתונים (לדוגמה, POSTGRES_13). רשימה מלאה של המחרוזות הזמינות מופיעה במאמר בנושא SqlDatabaseVersion.
  • PASSWORD: הסיסמה של המשתמש root
  • MACHINE_TYPE: מחרוזת enum של סוג המכונה (רמת השירות), באופן הבא: db-custom-[CPUS]-[MEMORY_MBS]
  • EDITION_TYPE: מהדורת Cloud SQL שלכם

ה-method של ה-HTTP וכתובת ה-URL:

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

תוכן בקשת JSON:

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

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

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

{
  "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

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

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

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

gcloud

עדכון המכונה

כדי להפעיל את השילוב במכונה קיימת, משתמשים בפקודה gcloud sql instances patch.

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

אם אתם צריכים להפעיל ולעדכן את כל המכונות של Cloud SQL בפרויקט, תוכלו להריץ סקריפט שדומה לזה:

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

הדוגמה הזו מבוססת על Linux.

REST v1

עדכון המכונה

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

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • PROJECT_ID: המזהה או מספר הפרויקט של פרויקט Google Cloud שמכיל את המופע
  • INSTANCE_NAME: השם של המכונה

ה-method של ה-HTTP וכתובת ה-URL:

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

תוכן בקשת JSON:

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

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

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

{
  "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"
}

REST v1beta4

עדכון המכונה

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

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

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • PROJECT_ID: המזהה או מספר הפרויקט של פרויקט Google Cloud שמכיל את המופע
  • INSTANCE_NAME: השם של המכונה

ה-method של ה-HTTP וכתובת ה-URL:

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

תוכן בקשת JSON:

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

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

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

{
  "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

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

gcloud sql instances describe INSTANCE_NAME

מחליפים את INSTANCE_NAME בשם המכונה. בפלט, מחפשים את הגדרת התצורה enableDataplexIntegration שמוגדרת לערך true.

REST v1

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • PROJECT_ID: מזהה הפרויקט
  • INSTANCE_ID: מזהה המכונה

ה-method של ה-HTTP וכתובת ה-URL:

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

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

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

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

REST v1beta4

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • PROJECT_ID: מזהה הפרויקט
  • INSTANCE_ID: מזהה המכונה

ה-method של ה-HTTP וכתובת ה-URL:

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

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

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

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

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

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

המסוף

  1. נכנסים לדף Cloud SQL Instances במסוף Google Cloud .

    כניסה לדף Cloud SQL Instances

  2. כדי לפתוח את הדף סקירה כללית של מכונה, לוחצים על שם המכונה.
  3. לוחצים על Edit.
  4. בקטע Customize your instance, מרחיבים את התפריט Show configuration options.
  5. בקטע Flags and parameters (דגלים ופרמטרים), מבטלים את הסימון בתיבה Enable Knowledge Catalog integration (הפעלת שילוב של קטלוג הידע).

  6. לוחצים על Save.

gcloud

כדי להשבית את השילוב במכונה קיימת, משתמשים בפקודה gcloud sql instances patch.

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

אם אתם צריכים להשבית את השילוב ולעדכן את כל המכונות של Cloud SQL בפרויקט, אתם יכולים להריץ סקריפט שדומה לזה:

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

הדוגמה הזו מבוססת על Linux.

REST v1

אפשר להשתמש בדוגמה הזו כדי להשבית את השילוב.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • PROJECT_ID: המזהה או מספר הפרויקט של פרויקט Google Cloud שמכיל את המופע
  • INSTANCE_NAME: השם של המכונה

ה-method של ה-HTTP וכתובת ה-URL:

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

תוכן בקשת JSON:

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

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

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

{
  "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"
}

REST v1beta4

אפשר להשתמש בדוגמה הזו כדי להשבית את השילוב.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

  • PROJECT_ID: המזהה או מספר הפרויקט של פרויקט Google Cloud שמכיל את המופע
  • INSTANCE_NAME: השם של המכונה

ה-method של ה-HTTP וכתובת ה-URL:

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

תוכן בקשת JSON:

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

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

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

{
  "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

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

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

    מעבר אל חיפוש

  2. בקטע Choose search platform (בחירת פלטפורמת חיפוש), בוחרים באפשרות 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 ועל סוג הנכס שרוצים לשלוח לו שאילתה. בטבלה הבאה מפורטים מחרוזות השאילתה המתאימות.

מנוע Cloud SQL מחרוזות שאילתה
Cloud SQL ל-MySQL
  • cloudsql-mysql-database
  • cloudsql-mysql-instance
  • cloudsql-mysql-table
  • cloudsql-mysql-view
Cloud SQL ל-PostgreSQL
  • cloudsql-postgresql-database
  • cloudsql-postgresql-instance
  • cloudsql-postgresql-table
  • cloudsql-postgresql-schema
  • cloudsql-postgresql-view
Cloud SQL ל-SQL Server
  • cloudsql-sqlserver-database
  • cloudsql-sqlserver-instance
  • cloudsql-sqlserver-table
  • cloudsql-sqlserver-schema
  • cloudsql-sqlserver-view

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

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 Server בלבד, פועלים לפי השלבים הבאים.

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

  2. בוחרים באפשרות SQL Access (גישת SQL).

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

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

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

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

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

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

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

    • מסד נתונים של Cloud SQL
    • Cloud SQL Instance
    • תצוגת Cloud SQL
    • סכימה של Cloud SQL
    • טבלה של Cloud SQL
  4. לוחצים על OK.

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

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

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

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

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

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

    מעבר אל חיפוש

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

  3. בחלונית המסננים, בוחרים באפשרות מערכות ואז באפשרות 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 (פרטי הטבלה ב-Cloud SQL) לוחצים על Schema (סכימה) כדי לראות את העמודות של הטבלה.

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

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

תמחור

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

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

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

מגבלות

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

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

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

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

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

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

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