התצוגה 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

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

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

סכימה

כשמריצים שאילתה בתצוגה 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;
 INFORMATION_SCHEMA

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

+---------------------+------------------------------------------------+------------------------------------------------------+
| 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)                                     |
|                     | ...                                            | ...                                                  |
+---------------------+------------------------------------------------+------------------------------------------------------+