תצוגת 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	שימוש בהוגנות מבוססת-הזמנות במקום הוגנות מבוססת-פרויקטים.

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

שמירת נתונים

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

היקף ותחביר

שאילתות שמופעלות על התצוגה הזו צריכות לכלול מסנן אזור.

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

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

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

דוגמאות

בדוגמה הבאה מאחזרים את העמודות 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;

הערה: שמות התצוגות המפורטות הם תלויי אותיות רישיות.

INFORMATION_SCHEMA

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

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