התצוגה PROJECT_OPTIONS_CHANGES

אפשר להריץ שאילתה בתצוגה INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES כדי לאחזר מטא-נתונים בזמן אמת לגבי שינויים בהגדרות של פרויקט ב-BigQuery. בתצוגה הזו מוצגים שינויים בהגדרות ברמת הפרויקט שבוצעו אחרי 31 בינואר 2024.

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

כדי לקבל את ההגדרה, צריך הרשאה לניהול זהויות והרשאות גישה (IAM) ברמת הפרויקט bigquery.config.update. תפקיד ה-IAM המוגדר מראש roles/bigquery.admin כולל את ההרשאות שנדרשות ליצירת הגדרה.

במאמר תפקידים והרשאות יש מידע נוסף על הרשאות מפורטות ב-BigQuery.

סכימה

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

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

שם העמודה סוג נתונים ערך
update_time TIMESTAMP השעה שבה בוצע שינוי ההגדרה.
username STRING למשתמשים מאינטראקציה ישירה (first-party), זו כתובת האימייל שלהם. למשתמשים של צד שלישי, זה השם שהמשתמשים מגדירים בספק הזהויות של צד שלישי.
updated_options JSON אובייקט JSON של אפשרויות ההגדרה שהמשתמשים עדכנו בשינוי, שמכיל את הערכים הקודמים והחדשים של השדות המעודכנים.
project_id STRING מזהה הפרויקט. השדה הזה ריק כשמדובר בשינויים בהגדרות ברמת הארגון.
project_number INTEGER מספר הפרויקט. השדה הזה ריק כשמדובר בשינויים בהגדרות ברמת הארגון.

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

שמירת נתונים

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

היקף ותחביר

שאילתות שמופעלות על התצוגה הזו צריכות לכלול מסנן אזור.

שם התצוגה היקף המשאבים היקף האזור
`region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES שינויים בהגדרות של הפרויקט שצוין. REGION

מחליפים את מה שכתוב בשדות הבאים:

דוגמאות

בדוגמה הבאה מאחזרים את כל העמודות מהתצוגה INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES.

SELECT
  *
FROM
  `region-REGION`.INFORMATION_SCHEMA.PROJECT_OPTIONS_CHANGES;
INFORMATION_SCHEMA

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

+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+
| project_number | project_id | update_time             | username        | updated_options                                                                                                  |
|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|
| 4471534625     | myproject1 | 2023-08-22 06:57:49 UTC | user1@gmail.com | {"default_query_job_timeout_ms":{"new":0,"old":1860369},"default_time_zone":{"new":"America/New_York","old":""}} |
|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|
| 5027725474     | myproject2 | 2022-08-01 00:00:00 UTC | user2@gmail.com | {"default_interactive_query_queue_timeout_ms":{"new":1860369,"old":1860008}}                                     |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+