מבוא לשאילתות שמורות

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

מידע על שאילתות שמורות

שאילתות שמורות משפרות את שיתוף הפעולה ואת ניהול השאילתות באמצעות האפשרויות הבאות:

  • לשתף שאילתות שמורות עם משתמשים וקבוצות ספציפיים באמצעות ניהול זהויות והרשאות גישה (IAM).
  • בודקים את היסטוריית הגרסאות של השאילתה.
  • לחזור לגרסאות קודמות של השאילתה או ליצור מהן ענף.

שאילתות שמורות הן נכסי קוד של BigQuery Studio שמופעלים על ידי Dataform. גם Notebooks הם נכסי קוד. כל נכסי הקוד מאוחסנים באזור שמוגדר כברירת מחדל. עדכון אזור ברירת המחדל משנה את האזור של כל נכסי הקוד שנוצרו אחרי העדכון.

אבטחה של שאילתות שמורות

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

אזורים נתמכים

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

תיאור האזור שם האזור פרטים
אפריקה
יוהנסבורג africa-south1
אמריקה
קולומבוס us-east5
דאלאס us-south1 ‫סמל של עלה רמה נמוכה של CO2‎
אייווה us-central1 ‫סמל של עלה רמה נמוכה של CO2‎
לוס אנג'לס us-west2
לאס וגאס us-west4
מונטריאול northamerica-northeast1 ‫סמל של עלה רמה נמוכה של CO2‎
N. וירג'יניה us-east4
אורגון us-west1 ‫סמל של עלה רמה נמוכה של CO2‎
סאו פאולו southamerica-east1 ‫סמל של עלה רמה נמוכה של CO2‎
דרום קרוליינה us-east1
אסיה ואזור האוקיינוס השקט
הונג קונג asia-east2
ג'קארטה asia-southeast2
מומבאי asia-south1
סיאול asia-northeast3
סינגפור asia-southeast1
סידני australia-southeast1
טייוואן asia-east1
טוקיו asia-northeast1
אירופה
בלגיה europe-west1 ‫סמל של עלה רמה נמוכה של CO2‎
פינלנד europe-north1 ‫סמל של עלה רמה נמוכה של CO2‎
פרנקפורט europe-west3
לונדון europe-west2 ‫סמל של עלה רמה נמוכה של CO2‎
מדריד europe-southwest1 ‫סמל של עלה רמה נמוכה של CO2‎
מילאנו europe-west8 ‫סמל של עלה רמה נמוכה של CO2‎
הולנד europe-west4 ‫סמל של עלה רמה נמוכה של CO2‎
טורינו europe-west12 ‫סמל של עלה רמה נמוכה של CO2‎
ורשה europe-central2 ‫סמל של עלה רמה נמוכה של CO2‎
ציריך europe-west6 ‫סמל של עלה רמה נמוכה של CO2‎
המזרח התיכון
דמאם me-central2
דוחה me-central1
תל אביב me-west1

מכסות ומגבלות

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

מגבלות

לשאילתות שמורות יש את המגבלות הבאות:

שאילתות שמורות בגרסה הקלאסית (הוצאה משימוש)

כדי לערוך שאילתות שמורות קלאסיות קיימות אחרי שהן יוצאו משימוש באופן מלא, צריך להעביר אותן ל-BigQuery Studio.

שאילתות שמורות קלאסיות הן שיטה ישנה יותר לשמירה ולשיתוף של SQL. בניגוד לשאילתות שנשמרו ב-BigQuery Studio, הן שומרות רק את טקסט השאילתה ואת גרסת ה-SQL (‏SQL מדור קודם או GoogleSQL).

במסוף Google Cloud , הן מופיעות בתיקייה (Classic) Queries בחלונית Explorer. (אם לא הפעלתם את BigQuery Studio, הן מופיעות בתיקייה שאילתות שמורות (NUMBER) בחלונית Classic Explorer).

יש שלושה סוגים של שאילתות שמורות קלאסיות:

  • אישי (): גלוי רק למשתמש שיצר אותם.

    • הערה: אם שאילתה אישית מכילה מידע רגיש, צריך למחוק את השאילתה או להסיר את המידע הרגיש לפני ההעברה.

  • ברמת הפרויקט (): גלוי לכל חשבון ראשי עם ההרשאות הנדרשות.

  • גלוי לכולם (): כל מי שיש לו את הקישור לשאילתה יכול לראות אותה.

תפקידי IAM להעברה ולגישה

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

  • אדמין ב-BigQuery (roles/bigquery.admin) כולל הרשאות של roles/dataform.admin.
  • BigQuery Job User (roles/bigquery.jobUser) ו-BigQuery User (roles/bigquery.user) כוללים את:
    • dataform.locations.get
    • dataform.locations.list
    • dataform.repositories.create
    • dataform.repositories.list

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

המאמרים הבאים