‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

ניהול הגדרות ברירת המחדל

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

התפקידים הנדרשים

כדי לקבל את ההרשאות שדרושות לציון או לאחזור של הגדרות, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים:

מציינים את הגדרות האישיות: אדמין ב-BigQuery (roles/bigquery.admin) בארגון או בפרויקט
אחזור הגדרות אישיות: משתמש במשימות BigQuery (roles/bigquery.jobUser) בפרויקט שצוין

להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

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

כדי לציין או לאחזר הגדרות תצורה, נדרשות ההרשאות הבאות:

מציינים את הגדרות התצורה: bigquery.config.update בארגון או בפרויקט
אחזור הגדרות: bigquery.config.get בפרויקט שצוין

יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.

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

הגדרת הגדרות גלובליות

ההגדרות הגלובליות חלות על כל המיקומים ולא משתמשות בקידומת region-REGION.. לעומת זאת, הגדרות אזוריות חלות רק על מיקום ספציפי. אפשר לציין הגדרות גלובליות ברמת הארגון או ברמת הפרויקט. מיקום ברירת המחדל (default_location) הוא ההגדרה הגלובלית היחידה שאפשר להגדיר.

אם לא מציינים מיקום באופן מפורש, המיקום נקבע באחת מהדרכים הבאות:

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

אם המיקום לא צוין במפורש, ואי אפשר לקבוע אותו מהמשאבים בבקשה, המערכת משתמשת במיקום ברירת המחדל. אם לא מוגדר מיקום ברירת מחדל, המשימה תרוץ באזור US במספר אזורים.

מגבלות

ההגבלות הבאות חלות על הגדרות התצורה הגלובליות:

אין תמיכה בהגדרות גלובליות של ארגונים ופרויקטים במיקומים של BigQuery Omni. אי אפשר להגדיר את default_location למיקום BigQuery Omni, או להגדיר או להציג הגדרות גלובליות במיקום BigQuery Omni.
אי אפשר לשלב הגדרות גלובליות ואזוריות באותה הצהרת DDL של ALTER ORGANIZATION SET OPTIONS או ALTER PROJECT SET OPTIONS.
כשמשנים את ההגדרה הגלובלית default_location, יכול להיות שיעברו עד 10 דקות עד שהשינוי יתעדכן. עד שההגדרה תתעדכן, יכול להיות ש-BigQuery ינתב משימות שמסתמכות על מיקום ברירת המחדל למיקום ברירת המחדל הקודם.

קביעת הגדרות גלובליות לארגון

אפשר להגדיר הגדרות גלובליות ברמת הארגון באמצעות הצהרת ה-DDL‏ ALTER ORGANIZATION SET OPTIONS. מיקום ברירת המחדל (default_location) הוא ההגדרה הגלובלית היחידה שאפשר להגדיר ברמת הארגון. כל שאר ההגדרות ברמת הארגון הן הגדרות אזוריות.

הצהרת ה-DDL‏ ALTER ORGANIZATION SET OPTIONS חלה על הארגון שאליו משויך הפרויקט הנוכחי.

כדי לקבוע את ההגדרה default_location ברמת הארגון:

המסוף

נכנסים לדף BigQuery במסוף Google Cloud .

כניסה ל-BigQuery
כדי לפתוח את עורך השאילתות, לוחצים על search_insights Untitled query.
כדי להגדיר את ההגדרה default_location, מזינים את הצהרת ה-DDL הבאה בעורך השאילתות:
```
  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );
```
מחליפים את LOCATION באזור או במיקום במספר אזורים ב-BigQuery. הערך הזה הוא המיקום שבו BigQuery משתמש כדי להריץ משימות כשאי אפשר להסיק את מיקום המשימה מהבקשה – לדוגמה, כששאילתה לא מפנה למערכי נתונים או לחיבורים.
לחלופין, כדי להסיר את ההגדרה default_location ברמת הארגון, מזינים את הצהרת ה-DDL הבאה בעורך השאילתות:
```
  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = NULL
  );
```
לוחצים על Run.

BQ

כדי להגדיר את default_location ברמת הארגון, מזינים את הפקודה bq query עם הדגל --use_legacy_sql שמוגדר ל-false, ומספקים את הצהרת ה-DDL הבאה כפרמטר של השאילתה:

  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );

מחליפים את LOCATION במיקום אזורי או במיקום במספר אזורים ב-BigQuery. הערך הזה הוא המיקום שבו BigQuery משתמש כדי להריץ משימות כשאי אפשר להסיק את מיקום המשימה מהבקשה – לדוגמה, כששאילתה לא מפנה למערכי נתונים או לחיבורים.

לחלופין, כדי להסיר את ההגדרה default_location ברמת הארגון, מזינים את הפקודה bq query עם הדגל --use_legacy_sql שמוגדר לערך false, ומספקים את הצהרת ה-DDL הבאה כפרמטר של השאילתה:

  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = NULL
  );

API

מבצעים קריאה לשיטה jobs.query ומספקים את הצהרת ה-DDL במאפיין query של גוף הבקשה.

הגדרת הפרויקט הגלובלי

אפשר לקבוע הגדרות גלובליות ברמת הפרויקט באמצעות הצהרת ה-DDL‏ ALTER PROJECT SET OPTIONS. מיקום ברירת המחדל (default_location) הוא ההגדרה הכללית היחידה שאפשר להגדיר ברמת הפרויקט. כל שאר ההגדרות ברמת הפרויקט הן הגדרות אזוריות.

הצהרת ה-DDL‏ ALTER PROJECT SET OPTIONS מקבלת באופן אופציונלי את המשתנה PROJECT_ID. אם לא מציינים את PROJECT_ID, ההצהרה מוגדרת כברירת מחדל לפרויקט שבו מריצים את הצהרת ה-DDL של ALTER PROJECT.

הגדרות ברמת הפרויקט מבטלות הגדרות ברמת הארגון. הגדרות ברמת הסשן יכולות לשנות הגדרות ברמת הפרויקט, והגדרות ברמת המשימה יכולות לשנות הגדרות ברמת הסשן.

כדי להגדיר את default_location ברמת הפרויקט:

המסוף

נכנסים לדף BigQuery במסוף Google Cloud .

כניסה ל-BigQuery
כדי לפתוח את עורך השאילתות, לוחצים על search_insights Untitled query.
כדי להגדיר את ההגדרה default_location, מזינים את הצהרת ה-DDL הבאה בעורך השאילתות:
```
  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫PROJECT_ID: מזהה הפרויקט.
- ‫LOCATION: מיקום של אזור או של מספר אזורים ב-BigQuery. הערך הזה הוא המיקום שבו BigQuery מריץ משימות, אם אי אפשר להסיק את מיקום המשימה מהבקשה. לדוגמה, אם שאילתה לא מפנה למערכי נתונים או לחיבורים.
לחלופין, כדי להסיר את ההגדרה default_location ברמת הפרויקט, מזינים את הצהרת ה-DDL הבאה בעורך השאילתות:
```
  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = NULL
  );
```
אם מסירים את ההגדרה default_location ברמת הפרויקט, BigQuery משתמש בהגדרת ברירת המחדל ברמת הארגון, אם היא קיימת, או בהגדרת ברירת המחדל של המערכת.
לוחצים על Run.

BQ

כדי להגדיר את default_location ברמת הפרויקט, מזינים את הפקודה bq query עם הדגל --use_legacy_sql שמוגדר ל-false, ומספקים את הצהרת ה-DDL הבאה כפרמטר של השאילתה:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );

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

‫PROJECT_ID: מזהה הפרויקט.
‫LOCATION: מיקום אזורי או במספר אזורים ב-BigQuery. הערך הזה הוא המיקום שבו BigQuery משתמש כדי להריץ עבודות, אם אי אפשר להסיק את מיקום העבודה מהבקשה – למשל, אם שאילתה לא מפנה למערכי נתונים או לחיבורים.

לחלופין, כדי להסיר את ההגדרה default_location ברמת הפרויקט, מזינים את הפקודה bq query עם האפשרות --use_legacy_sql שמוגדרת לערך false, ומספקים את הצהרת ה-DDL הבאה כפרמטר של השאילתה:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = NULL
  );

אם מסירים את ההגדרה default_location ברמת הפרויקט, BigQuery משתמש בהגדרת ברירת המחדל ברמת הארגון, אם היא קיימת, או בהגדרת ברירת המחדל של המערכת.

API

מפעילים את השיטה jobs.query ומספקים את הצהרת ה-DDL במאפיין query של גוף הבקשה.

הגדרת הגדרות אזוריות

הגדרות אזוריות חלות על מיקום ספציפי וצריך להוסיף להן את הקידומת region-REGION.. אפשר להגדיר את האזור ברמת הארגון או ברמת הפרויקט.

אמצעי בקרה על הזמנות וחיוב

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

אמצעי הבקרה הנפוצים להזמנות ולחיוב כוללים את reservation_override_mode (גרסת טרום-השקה (Preview)) ואת disable_on_demand_billing (גרסת טרום-השקה (Preview)). כדי לקבוע את ההגדרות האלה, קראו את המאמר קביעת הגדרות אזוריות לפרויקטים. רשימת האפשרויות המלאה של הפרויקט מופיעה ברשימת האפשרויות של ALTER PROJECT SET OPTIONS.

קביעת הגדרות אזוריות לארגון

אפשר לקבוע הגדרות אזוריות ברמת הארגון באמצעות הצהרת ה-DDL‏ ALTER ORGANIZATION SET OPTIONS. צריך לציין את האזור שבו כל הגדרה של הארגון חלה. אפשר להשתמש רק באזור אחד בהצהרה.

בדוגמאות שבקטע הזה, אלה הגדרות ברירת המחדל של הארגון האזורי:

אזור זמן: America/Chicago
מפתח Cloud KMS: מפתח שמוגדר על ידי המשתמש
זמן קצוב לתפוגה של שאילתה: 30 דקות (1,800,000 אלפיות השנייה)
זמן קצוב לתפוגה של תור שאילתות אינטראקטיביות: 10 דקות (600,000 אלפיות השנייה)
הזמן הקצוב לתפוגה של תור שאילתות Batch: ‏ 20 דקות (1,200,000 אלפיות השנייה)
תצוגות של אחסון טבלאות ואינדקס חיפוש INFORMATION_SCHEMA (enable_info_schema_storage): מופעל

מידע נוסף על כל ההגדרות הארגוניות האזוריות זמין במאמר בנושא organization_set_options_list.

כדי לקבוע את הגדרות הארגון האזוריות, מבצעים את השלבים הבאים:

המסוף

נכנסים לדף BigQuery במסוף Google Cloud .

כניסה ל-BigQuery
כדי לפתוח את עורך השאילתות, לוחצים על search_insights Untitled query.
כדי להגדיר את הארגון האזורי, מזינים את הצהרת ה-DDL הבאה בעורך השאילתות:
```
  ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone`= 'America/Chicago',
  -- Ensure all service accounts under the organization have permission to KMS_KEY
  `region-REGION.default_kms_key_name` = KMS_KEY,
  `region-REGION.default_query_job_timeout_ms` = 1800000,
  `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
  `region-REGION.default_batch_query_queue_timeout_ms` = 1200000,
  `region-REGION.enable_info_schema_storage` = true);
```
מחליפים את מה שכתוב בשדות הבאים:
- ‫REGION: האזור ב-BigQuery שמשויך לפרויקט או לארגון שלכם – למשל, us או europe-west6. הערך של REGION צריך להיות זהה לכל אפשרות בפקודה.
- ‫KMS_KEY: מפתח Cloud KMS שהוגדר על ידי המשתמש. מידע נוסף מופיע במאמר בנושא מפתחות Cloud KMS בניהול הלקוח.

לחלופין, כדי להסיר את ההגדרות האזוריות של הארגון, מזינים את הצהרת ה-DDL הבאה בעורך השאילתות:

  ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL,
  `region-REGION.enable_info_schema_storage` = NULL);

לוחצים על Run.

BQ

כדי להגדיר את ההגדרות האזוריות של הארגון, מזינים את הפקודה bq query עם האפשרות --use_legacy_sql שמוגדרת ל-false, ומספקים את הצהרת ה-DDL הבאה כפרמטר של השאילתה:

  ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone`= 'America/Chicago',
  -- Ensure all service accounts under the organization have permission to KMS_KEY
  `region-REGION.default_kms_key_name` = KMS_KEY,
  `region-REGION.default_query_job_timeout_ms` = 1800000,
  `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
  `region-REGION.default_batch_query_queue_timeout_ms` = 1200000,
  `region-REGION.enable_info_schema_storage` = true);

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

‫REGION: האזור ב-BigQuery שמשויך לפרויקט או לארגון שלכם – למשל, us או europe-west6. הערך של REGION צריך להיות זהה לכל אפשרות בפקודה.
‫KMS_KEY: מפתח Cloud KMS שמוגדר על ידי המשתמש. מידע נוסף מופיע במאמר בנושא מפתחות Cloud KMS בניהול הלקוח.

לחלופין, כדי להסיר את ההגדרות האזוריות של הארגון, מזינים את הפקודה bq query עם הדגל --use_legacy_sql שמוגדר ל-false, ומספקים את הצהרת ה-DDL הבאה כפרמטר של השאילתה:

  ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL,
  `region-REGION.enable_info_schema_storage` = NULL);

API

מבצעים קריאה לשיטה jobs.query ומספקים את הצהרת ה-DDL במאפיין query של גוף הבקשה.

הגדרת הגדרות אזוריות לפרויקט

אפשר להגדיר הגדרות אזוריות ברמת הפרויקט באמצעות הצהרת ה-DDL ALTER PROJECT SET OPTIONS. צריך לציין את האזור שבו כל הגדרות הפרויקט חלות. אפשר להשתמש רק באזור אחד בהצהרה.

הגדרות ברמת הפרויקט מבטלות הגדרות ברמת הארגון. בתמורה, הגדרות ברמת הסשן יכולות לבטל הגדרות ברמת הפרויקט, והגדרות ברמת הג'וב יכולות לבטל הגדרות ברמת הסשן.

הצהרת ה-DDL‏ ALTER PROJECT SET OPTIONS מקבלת באופן אופציונלי את המשתנה PROJECT_ID. אם לא מציינים את PROJECT_ID, ברירת המחדל של ההצהרה היא הפרויקט שבו מריצים את הצהרת ה-DDL‏ ALTER PROJECT.

בדוגמאות שבקטע הזה, אלה הגדרות ברירת המחדל של הפרויקט ברמה האזורית:

אזור זמן: America/Los_Angeles
מפתח Cloud KMS: מפתח שמוגדר על ידי המשתמש
זמן קצוב לתפוגה של שאילתה: שעה (3,600,000 אלפיות השנייה)
זמן קצוב לתפוגה של תור שאילתות אינטראקטיביות: 10 דקות (600,000 אלפיות השנייה)
זמן קצוב לתפוגה של תור שאילתות באצווה: 20 דקות (1,200,000 אלפיות השנייה)
הוגנות מבוססת-הזמנה: מופעלת
שאילתות עם אחזור נתונים גלובלי: מופעלות להרצה ולגישה לנתונים
תצוגות של אחסון טבלאות ואינדקס חיפוש INFORMATION_SCHEMA (enable_info_schema_storage): מופעל

מידע נוסף על כל הגדרות הפרויקט האזוריות זמין במאמר project_set_options_list.

כדי להגדיר הגדרות אזוריות לפרויקט, פועלים לפי השלבים הבאים:

המסוף

נכנסים לדף BigQuery במסוף Google Cloud .

כניסה ל-BigQuery
כדי לפתוח את עורך השאילתות, לוחצים על search_insights Untitled query.

כדי להגדיר את הגדרות הפרויקט האזורי, מזינים את הצהרת ה-DDL הבאה בעורך השאילתות:

 ALTER PROJECT PROJECT_ID
 SET OPTIONS (
 `region-REGION.default_time_zone` = 'America/Los_Angeles',
 -- Ensure all service accounts under the project have permission to KMS_KEY
 `region-REGION.default_kms_key_name` = KMS_KEY,
 `region-REGION.default_query_job_timeout_ms` = 3600000,
 `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
 `region-REGION.default_batch_query_queue_timeout_ms` = 1200000,
 `region-REGION.enable_reservation_based_fairness` = true,
 `region-REGION.enable_global_queries_execution` = true,
 `region-REGION.enable_global_queries_data_access` = true,
 `region-REGION.enable_info_schema_storage` = true);

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

‫PROJECT_ID: מזהה הפרויקט.
‫REGION: האזור ב-BigQuery שמשויך לפרויקט או לארגון, למשל us או europe-west6. הערך של REGION צריך להיות זהה בכל אפשרות בפקודה.
‫KMS_KEY: מפתח Cloud KMS שמוגדר על ידי המשתמש. מידע נוסף מופיע במאמר בנושא מפתחות Cloud KMS בניהול הלקוח.

לחלופין, כדי להסיר את הגדרות הפרויקט האזוריות, מזינים את הצהרת ה-DDL הבאה בעורך השאילתות:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL,
  `region-REGION.enable_reservation_based_fairness` = false,
  `region-REGION.enable_global_queries_execution` = NULL,
  `region-REGION.enable_global_queries_data_access` = NULL,
  `region-REGION.enable_info_schema_storage` = NULL);

לוחצים על Run.

BQ

כדי להגדיר את הגדרות הפרויקט האזורי, מזינים את הפקודה bq query עם הדגל --use_legacy_sql שמוגדר ל-false, ומספקים את הצהרת ה-DDL הבאה כפרמטר של השאילתה:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `region-REGION.default_time_zone` = 'America/Los_Angeles',
  -- Ensure all service accounts under the project have permission to KMS_KEY
  `region-REGION.default_kms_key_name` = KMS_KEY,
  `region-REGION.default_query_job_timeout_ms` = 3600000,
  `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
  `region-REGION.default_batch_query_queue_timeout_ms` = 1200000,
  `region-REGION.enable_reservation_based_fairness` = true,
  `region-REGION.enable_global_queries_execution` = true,
  `region-REGION.enable_global_queries_data_access` = true,
  `region-REGION.enable_info_schema_storage` = true);

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

‫PROJECT_ID: מזהה הפרויקט.
‫REGION: האזור ב-BigQuery שמשויך לפרויקט או לארגון שלכם – למשל, us או europe-west6. הערך של REGION צריך להיות זהה לכל אפשרות בפקודה.
‫KMS_KEY: מפתח Cloud KMS שהוגדר על ידי המשתמש. מידע נוסף מופיע במאמר מפתחות Cloud KMS בניהול הלקוח.

לחלופין, כדי להסיר את הגדרות הפרויקט האזוריות, מזינים את הפקודה bq query כשהדגל --use_legacy_sql מוגדר ל-false, ומספקים את הצהרת ה-DDL הבאה כפרמטר של השאילתה:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL,
  `region-REGION.enable_reservation_based_fairness` = false,
  `region-REGION.enable_global_queries_execution` = NULL,
  `region-REGION.enable_global_queries_data_access` = NULL,
  `region-REGION.enable_info_schema_storage` = NULL);

API

מפעילים את השיטה jobs.query ומספקים את הצהרת ה-DDL במאפיין query של גוף הבקשה.

אחזור הגדרות

אתם יכולים לראות את הגדרות התצורה של ארגון או פרויקט באמצעות התצוגות הבאות של INFORMATION_SCHEMA:

‫INFORMATION_SCHEMA.PROJECT_OPTIONS: ההגדרות שחלות על פרויקט.
‫INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS: ההגדרות בפועל שחלות על פרויקט. ההגדרות בפועל כוללות את כל ההגדרות שנקבעו ברמת הפרויקט, וגם את כל ההגדרות שהפרויקט ירש מהארגון.
‫INFORMATION_SCHEMA.ORGANIZATION_OPTIONS: ההגדרות האישיות שחלות על ארגון.

יכול להיות שיעברו כמה דקות עד שההגדרות החדשות ייכנסו לתוקף ויופיעו בתצוגות של INFORMATION_SCHEMA.

דוגמאות לשאילתות לאחזור הגדרות

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

הצגת ההגדרות הגלובליות

כדי לראות את כל ההגדרות הגלובליות של הארגון, מריצים את השאילתה הבאה:

SELECT * FROM INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;

כדי להציג רק את הגדרת הארגון default_location, מריצים את השאילתה הבאה:

SELECT
    option_value
FROM INFORMATION_SCHEMA.ORGANIZATION_OPTIONS
WHERE option_name = 'default_location'

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

SELECT * FROM INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;

כדי להציג רק את ההגדרה בפועל של default_location בפרויקט ברירת המחדל, מריצים את השאילתה הבאה:

SELECT
    option_value
FROM INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS
WHERE option_name = 'default_location'

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

SELECT * FROM INFORMATION_SCHEMA.PROJECT_OPTIONS;

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

SELECT
    option_value
FROM INFORMATION_SCHEMA.PROJECT_OPTIONS
WHERE option_name = 'default_location'

הצגת ההגדרות האזוריות

כדי לראות את ההגדרות של ארגון באזור us, מריצים את השאילתה הבאה:

SELECT * FROM region-us.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;

כדי לראות את ההגדרות שבתוקף בפרויקט ברירת המחדל באזור us, מריצים את השאילתה הבאה:

SELECT * FROM region-us.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;

כדי לראות את ההגדרות בפרויקט ברירת המחדל באזור us, מריצים את השאילתה הבאה:

SELECT * FROM region-us.INFORMATION_SCHEMA.PROJECT_OPTIONS;

הגדרות ברירת המחדל

בקטעים הבאים מפורטות הגדרות התצורה שאפשר לציין.

הגדרות של שאילתות והרצת משימות

אפשר להשתמש בהגדרות הבאות כדי לשלוט באופן ההרצה, התזמון והתור של השאילתות.

default_batch_query_queue_timeout_ms: משך הזמן שמוגדר כברירת מחדל, באלפיות השנייה, שבו שאילתת אצווה ממתינה בתור שאילתות. אם המדיניות לא מוגדרת, ברירת המחדל היא 24 שעות. הערך המינימלי הוא אלפית השנייה. הערך המקסימלי הוא 48 שעות. כדי להשבית את התור של שאילתות אצווה, מגדירים את הערך כ--1.
‫default_interactive_query_queue_timeout_ms: משך הזמן שמוגדר כברירת מחדל באלפיות השנייה שבו שאילתה אינטראקטיבית ממתינה בתור שאילתות. אם המדיניות לא מוגדרת, ברירת המחדל היא 6 שעות. הערך המינימלי הוא אלפית השנייה, והערך המקסימלי הוא 48 שעות. כדי להשבית את התור של שאילתות אינטראקטיביות, מגדירים את הערך ל--1.
‫default_query_job_timeout_ms: הזמן שחלף עד שפג התוקף של שאילתת משימה, כולל הזמן שהמשימה ממתינה בתור והזמן שחלף במהלך ההרצה. תקופת ההמתנה צריכה להיות בין 5 דקות ל-48 שעות. הזמן הקצוב לתפוגה חל רק על משימות שאילתה ספציפיות ועל משימות צאצא של סקריפטים. כדי להגדיר זמן קצוב לתהליכים של סקריפטים, משתמשים בשיטת ה-API‏ jobs.insert ומגדירים את השדה jobTimeoutMs.

הערה: ההגדרה default_query_job_timeout_ms חלה גם על משימות של שאילתה מתמשכת. כדי לשנות את ההגדרה הזו ברמת הפרויקט בשביל שאילתה מתמשכת ספציפית, צריך להקצות זמן קצוב לתהליך לשאילתה המתמשכת הרלוונטית. שאילתות מתמשכות עדיין כפופות לזמני ריצה מקסימליים.
‫default_location: הגדרת התצורה default_location משמשת להרצת משימות כשהמיקום לא מוגדר או כשאי אפשר לקבוע אותו. אם לא מגדירים את default_location, המשימה תרוץ במספר אזורים US. מידע נוסף זמין במאמר ציון מיקומים.
‫enable_reservation_based_fairness: האפשרות שקובעת איך משתפים את המשבצות שלא בשימוש. בפרויקטים של ניהול שנוצרו אחרי 10 באוקטובר 2026, האפשרות הזו מופעלת (TRUE) כברירת מחדל. בפרויקטים שנוצרו לפני 10 באוקטובר 2026, ערך ברירת המחדל הוא FALSE, כלומר המשבצות הפנויות מופצות באופן שווה בין כל הפרויקטים של השאילתות. אם תפעילו את האפשרות הזו, המשבצות הפנויות יחולקו באופן שווה בין כל ההזמנות, ואז בין הפרויקטים בכל הזמנה. מידע נוסף זמין במאמר בנושא הוגנות מבוססת-הזמנה. האפשרות הזאת נתמכת רק ברמת הפרויקט. אי אפשר לציין את זה ברמת הארגון או ברמת המשרה.
‫default_time_zone: אזור הזמן שמוגדר כברירת מחדל לפונקציות GoogleSQL שתלויות באזור זמן, כשלא מציינים אזור זמן כארגומנט. ההגדרה הזו לא חלה על טבלאות שמחולקות למחיצות לפי עמודות של יחידות זמן (שמשתמשות ב-UTC כאזור הזמן), על העברות מתוזמנות של Storage Transfer Service או על טעינת נתונים באמצעות כלי שורת הפקודה של BigQuery. מידע נוסף זמין במאמר אזורי זמן.

הערה: אם רוצים להגדיר אזור זמן שיהיה ברירת המחדל, צריך לוודא שזה לא ישפיע על שאילתות קיימות שמשתמשות בערכים מילוליים של DATETIME. השאילתות שמושפעות כוללות שאילתות שמשתמשות במילת המפתח DATETIME המפורשת, מחרוזות מילוליות שהומרו באופן מרומז ומועברות לפונקציות זמן כמו DATETIME_DIFF('2022-10-01', ...), והפונקציה PARSE_DATETIME(). לכן, בטוח יותר להגדיר את default_time_zone רק בפרויקטים חדשים.
‫default_query_optimizer_options: האופטימיזציות של השאילתות שמבוססות על היסטוריה. האפשרות הזו יכולה להיות אחת מהבאות:
- ‫'adaptive=on': שימוש באופטימיזציות של שאילתות שמבוססות על היסטוריה.
- ‫'adaptive=off': לא להשתמש באופטימיזציות של שאילתות שמבוססות על היסטוריה.
- ‫NULL (ברירת המחדל): שימוש בהגדרת ברירת המחדל של אופטימיזציות של שאילתות על סמך היסטוריה, ששווה ל-'adaptive=on'.
‫default_sql_dialect_option: ניב ברירת המחדל של שאילתת SQL להרצת משימות של שאילתות באמצעות כלי שורת הפקודה של BigQuery או BigQuery API. שינוי ההגדרה הזו לא משפיע על הניב שמוגדר כברירת מחדל במסוף. האפשרות הזו יכולה להיות אחת מהאפשרויות הבאות:
- ‫'default_legacy_sql' (ברירת מחדל): המערכת משתמשת ב-SQL מדור קודם אם לא מציינים את ניב השאילתה ברמת העבודה.
- ‫'default_google_sql': שימוש ב-GoogleSQL אם שפת השאילתה לא צוינה ברמת המשימה.
- ‫'only_google_sql': שימוש ב-GoogleSQL אם לא צוין ניב השאילתה ברמת המשימה. דחיית משימות שבהן ניב השאילתה מוגדר ל-SQL מדור קודם.
- ‫NULL: שימוש בהגדרת ברירת המחדל של ניב השאילתה, ששווה ל-'default_legacy_sql'.
‫enable_global_queries_execution: האפשרות שקובעת אם אפשר להריץ שאילתות עם אחזור נתונים גלובלי. ערך ברירת המחדל הוא FALSE, כלומר השאילתות עם אחזור נתונים גלובלי מושבתות.
‫enable_global_queries_data_access: האפשרות שקובעת אם שאילתות עם אחזור נתונים גלובלי יכולות לגשת לנתונים שמאוחסנים באזור. ערך ברירת המחדל הוא FALSE, כלומר שאילתות עם אחזור נתונים גלובלי לא יכולות להעתיק נתונים מהאזור הזה, בלי קשר לפרויקט שבו הן פועלות.
‫reusable_column_aliases_mode: האפשרות שקובעת אם כתובות אימייל חלופיות של עמודות לשימוש חוזר מופעלות בשאילתות. ערך ברירת המחדל הוא off, כלומר שמות חלופיים לעמודות לשימוש חוזר לא מופעלים. למידע נוסף, קראו את המאמר כינויים לעמודות לשימוש חוזר.

הגדרות לניהול נתונים

משתמשים בהגדרות הבאות כדי להגדיר כללים ליצירת נתונים, לאבטחה ולמחזור החיים שלהם.

‫default_column_name_character_map: היקף ברירת המחדל והטיפול בתווים בשמות של עמודות. אם לא מגדירים את המאפיין, משימות טעינה שמשתמשות בתווים לא נתמכים בשמות של עמודות נכשלות ומוצגת הודעת שגיאה. יכול להיות שחלק מהטבלאות הישנות יותר מוגדרות להחלפת תווים לא נתמכים בשמות של עמודות. מידע נוסף זמין במאמר load_option_list.
‫default_data_policy_projects: רשימת ברירת המחדל של הפרויקטים שמדיניות הנתונים שלהם נבדקת כשניגשים לעמודות שמוגנות על ידי תגי משילות מידע. כברירת מחדל, רק מדיניות הנתונים של הפרויקט של הטבלה נבדקת. כשמגדירים פרויקט ברירת מחדל למדיניות נתונים ברמת הארגון, BigQuery בודק גם את מדיניות הנתונים של הפרויקט של הטבלה וגם את מדיניות הנתונים של פרויקט ברירת המחדל. אם יש מדיניות סותרת בשני הפרויקטים, מדיניות הנתונים בפרויקט של הטבלה מקבלת עדיפות. אפשר להגדיר את ההגדרה הזו רק ברמת הארגון באמצעות ההצהרה ALTER ORGANIZATION SET OPTIONS, לדוגמה, region-us.default_data_policy_projects = ["my_default_project"]. מידע נוסף זמין במאמר הגדרת פרויקט ברירת מחדל למדיניות נתונים.
‫default_kms_key_name: מפתח ברירת המחדל של Cloud Key Management Service להצפנת נתוני טבלה, כולל טבלאות זמניות או אנונימיות. מידע נוסף מופיע במאמר בנושא מפתחות Cloud KMS בניהול הלקוח.

הערה: כדי להגדיר מפתח ברירת מחדל של Cloud KMS, צריך להעניק את התפקיד Encrypter/Decrypter לכל חשבונות השירות של BigQuery שמשמשים בפרויקט או בארגון. אם לחשבון שירות בפרויקט או בארגון אין הרשאות מתאימות, כל השאילתות שמופעלות על ידי חשבון השירות ייכשלו. במאמר הקצאת התפקיד "מצפין/מפענח" מוסבר איך מקצים את התפקיד הזה. אם הגדרתם מפתח Cloud KMS שמשמש כברירת מחדל בלי להקצות קודם את התפקידים המתאימים, אתם יכולים להסיר את מפתח ברירת המחדל על ידי הגדרת הערך ל-NULL. דוגמאות מופיעות במאמרים הגדרת הגדרות ארגוניות אזוריות והגדרת הגדרות פרויקט אזוריות.
‫default_max_time_travel_hours: חלון הזמן שמוגדר כברירת מחדל למסע בזמן (בשעות) למערכי נתונים חדשים. משך הזמן הזה צריך להיות בטווח של 48 עד 168, כולל, וצריך להתחלק ב-24. שינוי ברירת המחדל של מספר השעות המקסימלי של מסע בזמן לא משפיע על מערכי נתונים קיימים. מידע נוסף זמין במאמר Time Travel ושמירת נתונים.
‫enable_info_schema_storage: האפשרות שנותנת גישה לתצוגות INFORMATION_SCHEMA.TABLE_STORAGE ו-SEARCH_INDEXES ולגרסאות שלהן. האפשרות הזו לא מופעלת כברירת מחדל. אם תשלחו שאילתה לתצוגות האלה בפעם הראשונה בלי להגדיר את האפשרות הזו לערך TRUE, השאילתה תיכשל ותקבלו הוראות להפעלת האפשרות. אחרי שמפעילים את האפשרות הזו, השאילתות מצליחות מיד ומחזירות נתונים שנוצרו מאותו רגע ואילך. יכול להיות שיעבור יום עד שמילוי החוסרים בנתונים ההיסטוריים יושלם ושהנתונים יהיו זמינים בתצוגות המפורטות. אם השתמשתם בתצוגות האלה לפני שההגדרה הזו הושקה, האפשרות הזו כבר מופעלת.

הגדרות עלות ומשאבים

משתמשים בהגדרות הבאות כדי לקבוע איך המשאבים יחויבו ואיך הם יקושרו.

‫default_storage_billing_model: מודל החיוב שמוגדר כברירת מחדל לאחסון של מערכי נתונים חדשים. מגדירים את הערך PHYSICAL כדי להשתמש בבייטים פיזיים בחישוב חיובי האחסון, או את הערך LOGICAL כדי להשתמש בבייטים לוגיים. שינוי מודל החיוב שמוגדר כברירת מחדל לא משפיע על מערכי נתונים קיימים. מידע נוסף זמין במאמר מודלים של חיוב על אחסון.
‫default_cloud_resource_connection_id: חיבור ברירת המחדל שבו משתמשים כשיוצרים טבלאות ומודלים. ציינו רק את המזהה או השם של החיבור, בלי מזהה הפרויקט המצורף והקידומות של האזור. כשמשתמשים בחיבורים שמוגדרים כברירת מחדל, יכול להיות ש-BigQuery יעדכן את ההרשאות שניתנו לחשבון השירות של החיבור, בהתאם לסוג הטבלה או המודל שאתם יוצרים. מידע נוסף זמין במאמר סקירה כללית על חיבור ברירת המחדל.
‫reservation_override_mode (תצוגה מקדימה): מציין איך אפשר לשנות את ההזמנות של השאילתות באזור (לדוגמה, 'ALLOW_ANY_OVERRIDE'). פרטים נוספים זמינים ברשימת האפשרויות של ALTER PROJECT SET OPTIONS.
‫disable_on_demand_billing (Preview): קובע אם החיוב על פי דרישה מושבת לשאילתות באזור. אם true, כל השאילתות חייבות להשתמש בהזמנה שהוקצתה, אחרת הן ייכשלו. לפרטים נוספים, ראו רשימת האפשרויות של ALTER PROJECT SET OPTIONS.
‫preflight_fluid_autoscaling_reservations: רשימת ההזמנות שבהן הופעלה התאמה גמישה לעומס לחיוב לפי שנייה, בלי משך זמן מינימלי. מידע נוסף זמין במאמר הסבר על הזמנות.

תמחור

אין עלות נוספת על השימוש בשירות ההגדרות האישיות של BigQuery. מידע נוסף על התמחור ב-BigQuery