התצוגה EFFECTIVE_PROJECT_OPTIONS

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

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

כדי לקבל מטא-נתונים של אפשרויות פרויקט יעילות, צריך את ההרשאה bigquery.config.get בממשק של ניהול הזהויות והרשאות הגישה (IAM).

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

  • roles/bigquery.jobUser

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

סכימה

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

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

שם עמודה סוג נתונים ערך
project_id STRING מזהה הפרויקט.
project_number INTEGER מספר הפרויקט.
option_name STRING מזהה האפשרות להגדרה שצוינה.
option_description STRING תיאור האפשרות.
option_type STRING סוג הנתונים של OPTION_VALUE.
option_set_level STRING הרמה בהיררכיה שבה ההגדרה מוגדרת, עם הערכים האפשריים DEFAULT,‏ ORGANIZATION או PROJECTS.
option_set_on_id STRING הגדרת ערך על סמך הערך של option_set_level:
  • אם DEFAULT, מגדירים את הערך null.
  • אם ORGANIZATION, צריך להגדיר את הערך "".
  • אם PROJECT, מגדירים את הערך ID.
option_value STRING הערך הנוכחי של האפשרות.
טבלת אפשרויות
option_name option_type option_value
default_time_zone STRING אזור הזמן שמוגדר כברירת מחדל בפרויקט.
default_kms_key_name STRING שם מפתח ברירת המחדל בפועל של הפרויקט הזה.
default_query_job_timeout_ms INT64 הזמן הקצוב לתפוגה של שאילתות שמוגדר כברירת מחדל בפועל באלפיות השנייה בפרויקט הזה.
default_interactive_query_queue_timeout_ms STRING הזמן הקצוב לתפוגה שמוגדר כברירת מחדל בשביל שאילתות אינטראקטיביות בתור בפרויקט הזה, באלפיות השנייה.
default_batch_query_queue_timeout_ms STRING הזמן הקצוב לתפוגה שמוגדר כברירת מחדל באלפיות השנייה לשאילתות באצווה בתור בפרויקט הזה.
enable_reservation_based_fairness BOOL שימוש בהוגנות מבוססת-הזמנות במקום בהוגנות מבוססת-פרויקטים.
reusable_column_aliases_mode STRING האם כינויי עמודות לשימוש חוזר מופעלים בפרויקט הזה.

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

שמירת נתונים

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

היקף ותחביר

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

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

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

דוגמאות

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

SELECT
  option_name, option_type, option_value, option_set_level, option_set_on_id
FROM
  `region-REGION`.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;

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

  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | option_name                                | option_type | option_value        | option_set_level | option_set_on_id   |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_time_zone                          | STRING      | America/Los_Angeles | organizations    | my_organization_id |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_kms_key_name                       | STRING      | test/testkey1       | projects         | my_project_id      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_query_job_timeout_ms               | INT64       | 18000000            | projects         | my_project_id      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_interactive_query_queue_timeout_ms | INT64       | 600000              | organization     | my_organization_id |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+
  | default_batch_query_queue_timeout_ms       | INT64       | 1200000             | projects         | my_project_id      |
  +--------------------------------------------+-------------+---------------------+------------------+--------------------+