תצוגת PROPERTY_GRAPHS

התצוגה INFORMATION_SCHEMA.PROPERTY_GRAPHS מכילה שורה אחת לכל תרשים בקבוצת הנתונים או באזור שציינתם.

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

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

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

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

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

כדי לשלוח שאילתות לתצוגה INFORMATION_SCHEMA.PROPERTY_GRAPHS, נדרשות ההרשאות הבאות:

  • bigquery.propertyGraphs.get
  • bigquery.propertyGraphs.list

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

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

סכימה

כששולחים שאילתה לתצוגה INFORMATION_SCHEMA.PROPERTY_GRAPHS, תוצאות השאילתה מכילות שורה אחת לכל תרשים בהיקף המשאבים שציינתם.

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

שם עמודה סוג נתונים ערך
property_graph_catalog STRING שם הפרויקט שמכיל את קבוצת הנתונים שבה מוגדר התרשים.
property_graph_schema STRING שם קבוצת הנתונים שמכילה את התרשים.
property_graph_name STRING שם התרשים.
property_graph_metadata_json STRING ייצוג ה-JSON של הגדרת התרשים. הייצוג הזה מכיל מידע על התרשים, כמו הצמתים, הקצוות, התוויות, המאפיינים, חותמת הזמן של היצירה וחותמות הזמן של השינויים.
ddl STRING הצהרת DDL שאפשר להשתמש בה כדי ליצור את התרשים.

היקף ותחביר

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

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

דוגמה

בדוגמה הבאה מאחזרים את העמודות property_graph_name,‏ property_graph_metadata_json ו-ddl מהתצוגה INFORMATION_SCHEMA.PROPERTY_GRAPHS:

SELECT
  property_graph_name, property_graph_metadata_json, ddl
FROM
  `region-REGION`.INFORMATION_SCHEMA.PROPERTY_GRAPHS;

התוצאה אמורה להיראות כך:

+---------------------+------------------------------------------------+------------------------------------------------------+
| property_graph_name | property_graph_metadata_json                   | ddl                                                  |
+---------------------+------------------------------------------------+------------------------------------------------------+
| FinGraph            | {"creationTime":"2026-01-05T22:22:22.365394Z", | CREATE PROPERTY GRAPH `my_project.graph_db.FinGraph` |
|                     | "edgeTables":[{"dataSourceTable":{"datasetId": | NODE TABLES (`my_project.graph_db.Account` AS        |
|                     | "graph_db","projectId":"my_project","tableId   | Account KEY (id)                                     |
|                     | ...                                            | ...                                                  |
+---------------------+------------------------------------------------+------------------------------------------------------+