ניהול משאבי 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 ל-PostgreSQL בגרסה 14.0 ואילך
  3. thought ארכיטקטורת הרשת: ארכיטקטורת רשת חדשה

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

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

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

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

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

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

  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.

    Go to project selector

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

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

    הפעלת Dataplex API

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

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

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

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

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

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

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

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

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

  2. ‫גרסה: Cloud SQL ל-PostgreSQL בגרסה 14.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: גרסת מסד הנתונים של המכונה (לדוגמה, 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 של סוג המכונה (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 באמצעות היבטים

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

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

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

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

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

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

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

מנוע 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, בוחרים באפשרות 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 Database
    • מכונה של Cloud SQL
    • תצוגת Cloud SQL
    • <!--Cloud SQL Schema-->
    • טבלת Cloud SQL

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

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

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

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

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

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

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

    לחיפוש Google

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

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