התצוגה ORGANIZATION_OPTIONS_CHANGES

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

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

כדי לקבל את ההרשאה שנדרשת כדי לקבל את השינויים בהגדרות, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM‏ BigQuery Admin (roles/bigquery.admin) בארגון. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקיד המוגדר מראש הזה כולל את ההרשאה bigquery.config.update, שנדרשת כדי לקבל את שינויי ההגדרות.

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

סכימה

כשמריצים שאילתה בתצוגה INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES, תוצאות השאילתה מכילות שורה אחת לכל שינוי בהגדרה בארגון.

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

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

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

שמירת נתונים

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

היקף ותחביר

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

שם התצוגה היקף המשאבים היקף האזור
`region-REGION`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES שינויים בתצורה בארגון שצוין. REGION

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

דוגמאות

בדוגמה הבאה מוצגים כל השינויים באפשרות default_query_job_timeout_ms option:

SELECT
  *
FROM
  `region-REGION`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES
WHERE
  updated_options.default_query_job_timeout_ms is not null;
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_query_job_timeout_ms":{"new":1860369,"old":1860008}}                                                   |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+