התצוגה 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 הזמן הקצוב לתפוגה שמוגדר כברירת מחדל באלפיות השנייה לשאילתות באצווה בתור בארגון הזה.
reusable_column_aliases_mode STRING האם מופעלות בארגון הזה כתובות אימייל חלופיות של עמודות שאפשר לעשות בהן שימוש חוזר.

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

שמירת נתונים

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

היקף ותחביר

שאילתות בתצוגה הזו חייבות לכלול מזהה אזור.

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

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

דוגמאות

בדוגמה הבאה, השאילתה מאחזרת את העמודות OPTION_NAME, ‏ OPTION_TYPE ו-OPTION_VALUE מהטבלה INFORMATION_SCHEMA.ORGANIZATION_OPTIONS.

SELECT
  option_name, option_type, option_value
FROM
  `region-us`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;

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

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