תצוגת ORGANIZATION_OPTIONS
אפשר להריץ שאילתה בתצוגה INFORMATION_SCHEMA.ORGANIZATION_OPTIONS כדי לאחזר מטא-נתונים בזמן אמת על אפשרויות הארגון ב-BigQuery. בתצוגה הזו יש אפשרויות הגדרה שמוגדרות ברמת הארגון.
כדי לראות את ערכי ברירת המחדל של אפשרות הגדרה, אפשר לעיין בהגדרות.
ההרשאות הנדרשות
כדי לקבל מטא-נתונים של אפשרויות ארגוניות, אתם צריכים את ההרשאות הבאות לניהול זהויות והרשאות גישה (IAM):
bigquery.config.get
תפקיד ה-IAM המוגדר מראש הבא כולל את ההרשאות שדרושות כדי לקבל מטא-נתונים של אפשרויות הארגון:
roles/bigquery.jobUser
במאמר תפקידים והרשאות יש מידע נוסף על הרשאות מפורטות ב-BigQuery.
סכימה
כשמבצעים שאילתה בתצוגה INFORMATION_SCHEMA.ORGANIZATION_OPTIONS, תוצאות השאילתה מכילות שורה אחת לכל אפשרות הגדרה בפרויקט, אם האפשרות הזו שונה מערך ברירת המחדל ברמת הארגון.
לתצוגה INFORMATION_SCHEMA.ORGANIZATION_OPTIONS יש את הסכימה הבאה:
| שם העמודה | סוג נתונים | ערך |
|---|---|---|
option_name |
STRING |
אחד מערכי השם בטבלת האפשרויות. |
option_description |
STRING |
תיאור האפשרות. |
option_type |
STRING |
סוג הנתונים של option_value. |
option_value |
STRING |
הערך הנוכחי של האופציה. |
טבלת אפשרויות
option_name |
option_type |
option_value |
|---|---|---|
default_time_zone |
STRING |
אזור הזמן שמוגדר כברירת מחדל בארגון. |
default_kms_key_name |
STRING |
שם מפתח ברירת המחדל לארגון הזה. |
default_query_job_timeout_ms |
STRING |
הזמן הקצוב לתפוגה של השאילתה שמוגדר כברירת מחדל בארגון הזה, באלפיות השנייה. |
default_interactive_query_queue_timeout_ms |
STRING |
הזמן הקצוב לתפוגה שמוגדר כברירת מחדל באלפיות השנייה לשאילתות אינטראקטיביות שנמצאות בתור בארגון הזה. |
default_batch_query_queue_timeout_ms |
STRING |
הזמן הקצוב לתפוגה שמוגדר כברירת מחדל באלפיות השנייה לשאילתות אצווה בתור בארגון הזה. |
כדי לשמור על יציבות, מומלץ לציין במפורש את העמודות בשאילתות של סכימת המידע, במקום להשתמש בתו כל כללי (SELECT *). ציון מפורש של העמודות מונע את השבירה של השאילתות אם הסכימה הבסיסית משתנה.
שמירת נתונים
בתצוגה הזו מופיעים סשנים שפועלים כרגע והיסטוריה של סשנים שהושלמו ב-180 הימים האחרונים.
היקף ותחביר
שאילתות שמופעלות על התצוגה הזו צריכות לכלול מסנן אזור.
| שם התצוגה | היקף המשאבים | היקף האזור |
|---|---|---|
`region-REGION`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS |
אפשרויות ההגדרה בארגון שצוין. | REGION |
מחליפים את מה שכתוב בשדות הבאים:
-
REGION: כל שם של אזור במערך נתונים. לדוגמה,region-us.
דוגמאות
בדוגמה הבאה מאחזרים את העמודות OPTION_NAME, OPTION_TYPE ו-OPTION_VALUE מהטבלה INFORMATION_SCHEMA.ORGANIZATION_OPTIONS.
SELECT option_name, option_type, option_value FROM `region-us`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;
INFORMATION_SCHEMA
התוצאה אמורה להיראות כך:
+--------------------------------------------+-------------+---------------------+ | option_name | option_type | option_value | +--------------------------------------------+-------------+---------------------+ | default_time_zone | STRING | America/Los_Angeles | +--------------------------------------------+-------------+---------------------+ | default_kms_key_name | STRING | test/testkey1 | +--------------------------------------------+-------------+---------------------+ | default_query_job_timeout_ms | INT64 | 18000000 | +--------------------------------------------+-------------+---------------------+ | default_interactive_query_queue_timeout_ms | INT64 | 600000 | +--------------------------------------------+-------------+---------------------+ | default_batch_query_queue_timeout_ms | INT64 | 1200000 | +--------------------------------------------+-------------+---------------------+