תצוגת PROJECT_OPTIONS

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

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

כדי לקבל מטא-נתונים של אפשרויות ההגדרה, אתם צריכים את ההרשאות הבאות לניהול זהויות והרשאות גישה (IAM):

• bigquery.config.get

תפקיד ה-IAM המוגדר מראש הבא כולל את ההרשאות שנדרשות כדי לקבל מטא-נתונים של אפשרויות הפרויקט:

• roles/bigquery.jobUser

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

סכימה

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

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

שם העמודה	סוג נתונים	ערך
option_name	STRING	מזהה האפשרות להגדרה שצוינה.
project_id	STRING	מזהה הפרויקט.
project_number	INTEGER	מספר הפרויקט.
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.PROJECT_OPTIONS	אפשרויות ההגדרה בפרויקט שצוין.	REGION

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

• ‫REGION: כל שם של אזור במערך נתונים. לדוגמה, region-us.

דוגמאות

בדוגמה הבאה מאחזרים את העמודות OPTION_NAME, OPTION_TYPE ו-OPTION_VALUE מהתצוגה INFORMATION_SCHEMA.PROJECT_OPTIONS.

SELECT
  option_name, option_type, option_value
FROM
  `region-REGION`.INFORMATION_SCHEMA.PROJECT_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             |
  +--------------------------------------------+-------------+---------------------+