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

בדף הזה מוסבר איך אפשר לחפש ולנהל את משאבי Cloud SQL באמצעות Knowledge 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 ל-MySQL בגרסה 8.0 ואילך
  3. ארכיטקטורת רשת: ארכיטקטורת רשת חדשה

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

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

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

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

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

פעם ביום

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

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

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

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

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

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

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

יצירת מופע עם שילוב של Knowledge Catalog

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

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

  2. גרסה: Cloud SQL ל-MySQL גרסה 8.0 ואילך
  3. thought ארכיטקטורת הרשת: ארכיטקטורת רשת חדשה

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

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

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

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

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

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

כדי להפעיל או להפעיל מחדש את השילוב של 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

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

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

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

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

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

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

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

    לחיפוש Google

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

מנוע 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, מבצעים את הפעולות הבאות:

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

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

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

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

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

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

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

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

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

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

    • Cloud SQL Database
    • מכונה של Cloud SQL
    • תצוגת Cloud SQL
    • <!--Cloud SQL Schema-->
    • טבלת Cloud SQL

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

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

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

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

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

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

  1. עוברים לדף חיפוש של 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. אופציונלי: כדי להוסיף סוג היבט לעמודה, לוחצים על הכפתור הוספת היבט.

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

תמחור

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

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

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

מגבלות

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

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

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

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

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

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