התצוגה SCHEMATA_LINKS

התצוגה INFORMATION_SCHEMA.SCHEMATA_LINKS מכילה שורה אחת לכל מערך נתונים מקושר שמשותף באמצעות BigQuery sharing. התצוגה הזו מכילה גם משאבים ספציפיים, כמו טבלאות או תצוגות, בפרויקט שמשותף באמצעות מרחבים מוגנים לניקוי נתונים. בתצוגה הזו מוצגת שורה אחת לכל משאב בודד במערך הנתונים המקושר.

ההרשאה הנדרשת

כדי לשלוח שאילתה לתצוגה INFORMATION_SCHEMA.SCHEMATA_LINKS, צריך הרשאה לניהול זהויות והרשאות גישה (IAM) bigquery.datasets.get ברמת הפרויקט.

כל אחד מהתפקידים הבאים שמוגדרים מראש ב-IAM כולל את ההרשאות שנדרשות כדי להריץ שאילתות בתצוגה INFORMATION_SCHEMA.SCHEMATA_LINKS:

  • roles/bigquery.admin
  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.dataViewer

מידע נוסף על הרשאות ב-BigQuery זמין במאמר בקרת גישה באמצעות IAM.

סכימה

לתצוגה INFORMATION_SCHEMA.SCHEMATA_LINKS יש את הסכימה הבאה:

שם העמודה סוג נתונים ערך
catalog_name STRING שם הפרויקט שמכיל את מערך הנתונים של המקור.
schema_name STRING השם של קבוצת נתוני המקור. שם קבוצת הנתונים נקרא גם datasetId.
linked_schema_catalog_number STRING מספר הפרויקט שמכיל את מערך הנתונים המקושר.
linked_schema_catalog_name STRING שם הפרויקט שמכיל את מערך הנתונים המקושר.
linked_schema_name STRING השם של קבוצת הנתונים המקושרת. שם קבוצת הנתונים נקרא גם datasetId.
linked_schema_creation_time TIMESTAMP השעה שבה נוצר מערך הנתונים המקושר.
linked_schema_org_display_name STRING השם המוצג של הארגון שבו נוצר מערך הנתונים המקושר.
shared_asset_id STRING המזהה של הנכס שמשותף באמצעות חדרים נקיים לנתונים. הערך הזה הוא null אם link_type הוא REGULAR.
link_type STRING סוג מערך הנתונים המקושר. הערכים האפשריים הם REGULAR או DCR (חדרים נקיים לנתונים).

כדי לשמור על יציבות, מומלץ לציין במפורש את העמודות בשאילתות של סכימת המידע, במקום להשתמש בתו כל כללי (SELECT *). ציון מפורש של העמודות מונע את השבירה של השאילתות אם הסכימה הבסיסית משתנה.

היקף ותחביר

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

שם התצוגה המפורטת היקף המשאבים היקף האזור
[PROJECT_ID.]INFORMATION_SCHEMA.SCHEMATA_LINKS ברמת הפרויקט אזור בארה"ב
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA_LINKS ברמת הפרויקט REGION
מחליפים את מה שכתוב בשדות הבאים:
  • אופציונלי: PROJECT_ID: מזהה הפרויקט ב- Google Cloud . אם לא מציינים פרויקט, המערכת משתמשת בפרויקט שמוגדר כברירת מחדל.
  • ‫REGION: כל שם של אזור במערך נתונים. לדוגמה, `region-us`.

דוגמאות

בקטע הזה מופיעות דוגמאות לשאילתות של התצוגה INFORMATION_SCHEMA.SCHEMATA_LINKS.

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

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

SELECT * FROM `otherproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

הפלט אמור להיראות כך: כדי לפשט את הפלט, חלק מהעמודות מושמטות.

+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|    catalog_name    |  schema_name    | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name | linked_schema_creation_time | shared_asset_id | link_type |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|  otherproject      | source_dataset  | subscriptioproject1        |                974999999291  | linked_dataset     |  subscriptionorg1              |         2025-08-07 05:02:27 | NULL            | REGULAR   |
|  otherproject      | source_dataset1 | subscriptionproject2       |                974999999292  | test_dcr           |  subscriptionorg2              |         2025-08-07 10:08:50 | test_table      | DCR       |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+

דוגמה: הצגת רשימה של כל מערכי הנתונים המקושרים לפי מערך נתונים משותף

בדוגמה הבאה מפורטים כל מערכי הנתונים המקושרים לפי מערך נתונים משותף בשם sharedataset באזור US:

SELECT * FROM INFORMATION_SCHEMA.SCHEMATA_LINKS WHERE schema_name = 'sharedataset';

הפלט אמור להיראות כך: כדי לפשט את הפלט, חלק מהעמודות מושמטות.


+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|    catalog_name     |  schema_name   | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name | linked_schema_creation_time | shared_asset_id | link_type |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|  myproject          | sharedataset   | subscriptionproject1       |                974999999291  | linked_dataset     |  subscriptionorg1              |         2025-08-07 05:02:27 | NULL            | REGULAR   |
|  myproject          | sharedataset   | subscriptionproject2       |                974999999292  | test_dcr           |  subscriptionorg2              |         2025-08-07 10:08:50 | test_table      | DCR       |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+

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

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

SELECT * FROM `otherproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS where link_type='DCR';

הפלט אמור להיראות כך: כדי לפשט את הפלט, חלק מהעמודות מושמטות.

+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|    catalog_name     |  schema_name   | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name | linked_schema_creation_time | shared_asset_id | link_type |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+
|  otherproject       | sharedataset1  | subscriptionproject1       |                 974999999291 | test_dcr1          |  subscriptionorg1              |         2025-08-07 05:02:27 | test_view       | DCR       |
|  otherproject       | sharedataset2  | subscriptionproject2       |                 974999999292 | test_dcr2          |  subscriptionorg2              |         2025-08-07 10:08:50 | test_table      | DCR       |
+---------------------+----------------+----------------------------+------------------------------+--------------------+--------------------------------+-----------------------------+-----------------+-----------+