תצוגת 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 |
למשתמשים מאינטראקציה ישירה (first-party), זו כתובת האימייל שלהם. למשתמשים של צד שלישי, זה השם שהמשתמשים מגדירים בספק הזהויות של צד שלישי. |
updated_options |
JSON |
אובייקט JSON של אפשרויות ההגדרה שהמשתמשים עדכנו בשינוי, שמכיל את הערכים הקודמים והחדשים של השדות המעודכנים. |
project_id |
STRING |
מזהה הפרויקט. השדה הזה ריק כשמדובר בשינויים בהגדרות ברמת הארגון. |
project_number |
INTEGER |
מספר הפרויקט. השדה הזה ריק כשמדובר בשינויים בהגדרות ברמת הארגון. |
כדי לשמור על יציבות, מומלץ לציין במפורש את העמודות בשאילתות של סכימת המידע, במקום להשתמש בתו כל כללי (SELECT *). ציון מפורש של העמודות מונע את השבירה של השאילתות אם הסכימה הבסיסית משתנה.
שמירת נתונים
בתצוגה הזו מופיעים סשנים שפועלים והיסטוריית הסשנים שהושלמו ב-180 הימים האחרונים.
היקף ותחביר
שאילתות שמופעלות על התצוגה הזו צריכות לכלול מסנן אזור.
| שם התצוגה | היקף המשאבים | היקף האזור |
|---|---|---|
`region-REGION`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES |
שינויים בתצורה בתוך הארגון שצוין. | REGION |
מחליפים את מה שכתוב בשדות הבאים:
-
REGION: כל שם של אזור במערך נתונים. לדוגמה,USאוus-west2.
דוגמאות
בדוגמה הבאה מאחזרים את כל השינויים באפשרות 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}} |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+