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

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

שמירת נתונים

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

היקף ותחביר

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

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

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

דוגמאות

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

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