ניהול הקצאות של עומסי עבודה

המסוף

1. במסוף Cloud de Confiance , עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. בתפריט הניווט, לוחצים על Workload management.

3. לוחצים על הכרטיסייה הזמנות.

4. מוצאים את ההזמנה בטבלת ההזמנות.

5. מרחיבים את האפשרות more_vert Actions (פעולות).

6. לוחצים על יצירת מטלה.

7. בקטע יצירת מטלה, לוחצים על עיון.

8. מחפשים את הארגון או מנווטים אליו ובוחרים אותו.

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

   • QUERY
   • CONTINUOUS
   • PIPELINE
   • BACKGROUND
   • ML_EXTERNAL

   מידע נוסף על סוגי משימות זמין במאמר הקצאות של הזמנות. ערך ברירת המחדל הוא QUERY.

   מידע נוסף על מתן הרשאה למשתמשים להשתמש ב-Gemini ב-BigQuery באמצעות מטלות במהדורת Enterprise Plus זמין במאמר הגדרת Gemini ב-BigQuery.

10. אופציונלי: בשדה User, מזינים את כתובת האימייל של המשתמש, חשבון השירות או הזהות של הצד השלישי.

11. לוחצים על יצירה.

SQL

כדי להקצות ארגון להזמנה, משתמשים בהצהרת ה-DDL‏ CREATE ASSIGNMENT.

1. במסוף Cloud de Confiance , עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. מזינים את ההצהרה הבאה בעורך השאילתות:

   CREATE ASSIGNMENT
     `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME.ASSIGNMENT_ID`
   OPTIONS (
     assignee = 'organizations/ORGANIZATION_ID',
     job_type = 'JOB_TYPE',
     principal = 'PRINCIPAL');

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

   • ‫ADMIN_PROJECT_ID: מזהה הפרויקט של פרויקט הניהול שבבעלותו משאב ההזמנה
   • ‫LOCATION: המיקום של ההזמנה
   • ‫RESERVATION_NAME: השם של ההזמנה

   • ‫ASSIGNMENT_ID: מזהה ההקצאה

     המזהה צריך להיות ייחודי לפרויקט ולמיקום, להתחיל ולהסתיים באות קטנה או במספר, ולהכיל רק אותיות קטנות, מספרים ומקפים.

   • ‫ORGANIZATION_ID: מזהה הארגון
   • ‫JOB_TYPE: סוג העבודה שיוקצה להזמנה הזו, למשל QUERY,‏ CONTINUOUS,‏ PIPELINE,‏ BACKGROUND או ML_EXTERNAL
   • אופציונלי: PRINCIPAL: פורמט הזהות שמציין את המשתמש, חשבון השירות או הזהות של הצד השלישי

     השדה principal תומך רק בפורמטים הבאים של מזהה חשבון משתמש ב-IAM:

     • חשבון Google
     • חשבון שירות
     • זהות יחידה במאגר זהויות של כוח עבודה
     • זהות יחידה במאגר זהויות של עומסי עבודה

3. לוחצים על play_circle הפעלה.

מידע נוסף על הרצת שאילתות זמין במאמר הרצת שאילתה אינטראקטיבית.

BQ

כדי להקצות משרות בארגון להזמנה, משתמשים בפקודה bq mk עם הדגל --reservation_assignment:

bq mk \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_assignment \
    --reservation_id=RESERVATION_NAME \
    --assignee_type=ORGANIZATION \
    --assignee_id=ORGANIZATION_ID \
    --job_type=JOB_TYPE \
    --principal=PRINCIPAL

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

• ‫ADMIN_PROJECT_ID: מזהה הפרויקט של פרויקט הניהול שבבעלותו משאב המקום השמור
• ‫LOCATION: המיקום של ההזמנה
• ‫RESERVATION_NAME: השם של ההזמנה
• ‫ORGANIZATION_ID: מזהה הארגון
• ‫JOB_TYPE: סוג העבודה שיוקצה להזמנה הזו, למשל QUERY,‏ CONTINUOUS,‏ PIPELINE,‏ BACKGROUND או ML_EXTERNAL

• אופציונלי: PRINCIPAL: פורמט הזהות שמציין את המשתמש, חשבון השירות או הזהות של הצד השלישי.

  הדגל --principal תומך רק בפורמטים הבאים של מזהי חשבונות משתמשים ב-IAM:

  • חשבון Google
  • חשבון שירות
  • זהות יחידה במאגר זהויות של כוח עבודה
  • זהות יחידה במאגר זהויות של עומסי עבודה

המסוף

1. במסוף Cloud de Confiance , עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. בתפריט הניווט, עוברים אל Administration > Workload management (ניהול עומסי עבודה).

3. לוחצים על הכרטיסייה כללי הקצאה.

4. לוחצים על יצירת כלל הקצאה.

5. ברשימה סוג הכלל, בוחרים באפשרות מגבלת פרויקט.

6. ברשימה Select a project, בוחרים פרויקט ולוחצים על Continue.

7. ברשימה הזמנה, בוחרים הזמנה ולוחצים על המשך.

8. בקטע Project override (שינוי ברירת המחדל של הפרויקט), מזינים ערכים בשדות Max slots (מקסימום משבצות) ו-Max concurrency (מקסימום מקביליות).

9. לוחצים על יצירה.

SQL

כדי ליצור הקצאה של מדיניות תזמון פרויקטים, משתמשים בהצהרת DDL‏ CREATE ASSIGNMENT עם האפשרויות scheduling_policy_max_slots ו-scheduling_policy_concurrency.

CREATE ASSIGNMENT
  `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME.ASSIGNMENT_ID`
OPTIONS (
  assignee = 'projects/PROJECT_ID',
  scheduling_policy_max_slots = MAX_SLOTS,
  scheduling_policy_concurrency = MAX_CONCURRENCY);

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

• ‫ADMIN_PROJECT_ID: מזהה הפרויקט של פרויקט הניהול שבבעלותו משאב המקום השמור
• ‫LOCATION: המיקום של ההזמנה
• ‫RESERVATION_NAME: השם של ההזמנה
• ‫ASSIGNMENT_ID: מזהה ההקצאה
• ‫PROJECT_ID: מזהה הפרויקט שמוקצה Cloud de Confiance
• ‫MAX_SLOTS: המגבלה המקסימלית על צריכת משבצות של שאילתות שמופעלות בפרויקט
• ‫MAX_CONCURRENCY: הגבול העליון של מספר השאילתות בו-זמניות שאושרו לפרויקט

BQ

כדי ליצור הקצאה של מדיניות תזמון באמצעות כלי שורת הפקודה bq, משתמשים בפקודה bq mk עם הדגלים --scheduling_policy_max_slots ו---scheduling_policy_concurrency.

bq mk \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_assignment \
    --reservation_id=RESERVATION_NAME \
    --assignee_id=PROJECT_ID \
    --assignee_type=PROJECT \
    --scheduling_policy_max_slots=MAX_SLOTS \
    --scheduling_policy_concurrency=MAX_CONCURRENCY

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

• ‫ADMIN_PROJECT_ID: מזהה הפרויקט של פרויקט הניהול שבבעלותו משאב המקום השמור
• ‫LOCATION: המיקום של ההזמנה
• ‫RESERVATION_NAME: השם של ההזמנה
• ‫PROJECT_ID: מזהה הפרויקט שמוקצה Cloud de Confiance
• ‫MAX_SLOTS: המגבלה המקסימלית על צריכת משבצות של שאילתות שמופעלות בפרויקט
• ‫MAX_CONCURRENCY: הגבול העליון של מספר השאילתות בו-זמניות שאושרו לפרויקט

המסוף

1. במסוף Cloud de Confiance , עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. בתפריט הניווט, לוחצים על Workload management.

3. לוחצים על הכרטיסייה הזמנות.

4. מוצאים את ההזמנה בטבלת ההזמנות.

5. מרחיבים את האפשרות more_vert Actions (פעולות).

6. לוחצים על יצירת מטלה.

7. בקטע יצירת מטלה, לוחצים על עיון.

8. מדפדפים או מחפשים את הפרויקט או התיקייה ובוחרים אותם.

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

   • QUERY
   • CONTINUOUS
   • PIPELINE
   • BACKGROUND
   • ML_EXTERNAL

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

   מידע נוסף על סוגי משימות זמין במאמר בנושא הקצאות של הזמנות. ערך ברירת המחדל הוא QUERY.

10. אופציונלי: בשדה User, מזינים את כתובת האימייל של המשתמש, חשבון השירות או הזהות של הצד השלישי.

11. לוחצים על יצירה.

SQL

כדי להקצות פרויקט להזמנה, משתמשים בהצהרת DDL‏ CREATE ASSIGNMENT.

1. במסוף Cloud de Confiance , עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. מזינים את ההצהרה הבאה בעורך השאילתות:

   CREATE ASSIGNMENT
     `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME.ASSIGNMENT_ID`
   OPTIONS(
     assignee="projects/PROJECT_ID",
     job_type="JOB_TYPE",
     principal="PRINCIPAL");

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

   • ‫ADMIN_PROJECT_ID: מזהה הפרויקט של פרויקט הניהול שבבעלותו משאב ההזמנה
   • ‫LOCATION: המיקום של ההזמנה
   • ‫RESERVATION_NAME: השם של ההזמנה

   • ‫ASSIGNMENT_ID: מזהה ההקצאה

     המזהה צריך להיות ייחודי לפרויקט ולמיקום, להתחיל ולהסתיים באות קטנה או במספר, ולהכיל רק אותיות קטנות, מספרים ומקפים.

   • ‫PROJECT_ID: המזהה של הפרויקט שרוצים להקצות להזמנה
   • ‫JOB_TYPE: סוג העבודה שמוקצה להזמנה הזו, למשל QUERY,‏ CONTINUOUS,‏ PIPELINE,‏ BACKGROUND_CHANGE_DATA_CAPTURE,‏ BACKGROUND_COLUMN_METADATA_INDEX,‏ BACKGROUND_SEARCH_INDEX_REFRESH,‏ BACKGROUND או ML_EXTERNAL

   • אופציונלי: PRINCIPAL: פורמט הזהות שמציין את המשתמש, חשבון השירות או הזהות של הצד השלישי. השדה principal תומך רק בפורמטים הבאים של מזהה חשבון משתמש ב-IAM:

     • חשבון Google
     • חשבון שירות
     • זהות יחידה במאגר זהויות של כוח עבודה
     • זהות יחידה במאגר זהויות של עומסי עבודה

3. לוחצים על play_circle הפעלה.

מידע נוסף על הרצת שאילתות זמין במאמר הרצת שאילתה אינטראקטיבית.

BQ

כדי להקצות משימות להזמנה, משתמשים בפקודה bq mk עם הדגל --reservation_assignment:

bq mk \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_assignment \
    --reservation_id=RESERVATION_NAME \
    --assignee_type=PROJECT \
    --assignee_id=PROJECT_ID \
    --job_type=JOB_TYPE \
    --principal=PRINCIPAL

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

• ‫ADMIN_PROJECT_ID: מזהה הפרויקט של פרויקט הניהול שבבעלותו משאב המקום השמור
• ‫LOCATION: המיקום של ההזמנה
• ‫RESERVATION_NAME: השם של ההזמנה
• ‫PROJECT_ID: המזהה של הפרויקט להקצאה להזמנה הזו
• ‫JOB_TYPE: סוג העבודה שמוקצה להזמנה הזו, כמו QUERY,‏ CONTINUOUS,‏ PIPELINE,‏ BACKGROUND_CHANGE_DATA_CAPTURE,‏ BACKGROUND_COLUMN_METADATA_INDEX,‏ BACKGROUND_SEARCH_INDEX_REFRESH,‏ BACKGROUND או ML_EXTERNAL

• אופציונלי: PRINCIPAL: פורמט הזהות שמציין את המשתמש, חשבון השירות או הזהות של הצד השלישי.

  הדגל --principal תומך רק בפורמטים הבאים של מזהי חשבונות משתמשים ב-IAM:

  • חשבון Google
  • חשבון שירות
  • זהות יחידה במאגר זהויות של כוח עבודה
  • זהות יחידה במאגר זהויות של עומסי עבודה

Terraform

משתמשים במשאב google_bigquery_reservation_assignment.

כדי לבצע אימות ב-BigQuery, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.

בדוגמה הבאה, פרויקט מוקצה להזמנה בשם my-reservation:

resource "google_bigquery_reservation" "default" {
  name              = "my-reservation"
  location          = "us-central1"
  slot_capacity     = 100
  edition           = "ENTERPRISE"
  ignore_idle_slots = false # Use idle slots from other reservations
  concurrency       = 0     # Automatically adjust query concurrency based on available resources
  autoscale {
    max_slots = 200 # Allow the reservation to scale up to 300 slots (slot_capacity + max_slots) if needed
  }
}

data "google_project" "project" {}

resource "google_bigquery_reservation_assignment" "default" {
  assignee    = "projects/${data.google_project.project.project_id}"
  job_type    = "QUERY"
  reservation = google_bigquery_reservation.default.id
}

כדי להחיל את הגדרות Terraform בפרויקט ב- Cloud de Confiance , מבצעים את השלבים בקטעים הבאים.

הכנת Cloud Shell

1. מפעילים את Cloud Shell.

2. מגדירים את פרויקט ברירת המחדל שבו רוצים להחיל את ההגדרות של Terraform. Cloud de Confiance

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

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

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

הכנת הספרייה

לכל קובץ תצורה של Terraform צריכה להיות ספרייה משלו (שנקראת גם מודול ברמה הבסיסית).

1. יוצרים ספרייה חדשה ב-Cloud Shell ובה יוצרים קובץ חדש. שם הקובץ חייב לכלול את הסיומת .tf, למשל main.tf. במדריך הזה, הקובץ נקרא main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

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

   מעתיקים את הקוד לדוגמה בקובץ main.tf החדש שיצרתם.

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

3. בודקים את הפרמטרים לדוגמה ומשנים אותם בהתאם לסביבה שלכם.
4. שומרים את השינויים.
5. מפעילים את Terraform. צריך לעשות זאת רק פעם אחת לכל ספרייה.

   terraform init

   אופציונלי: תוכלו לכלול את האפשרות -upgrade, כדי להשתמש בגרסה העדכנית ביותר של הספק של Google:

   terraform init -upgrade

החלה של השינויים

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

   terraform plan

   מתקנים את ההגדרות לפי הצורך.

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

   terraform apply

   ממתינים עד שב-Terraform תוצג ההודעה "Apply complete!‎".

3. פותחים את Cloud de Confiance הפרויקט כדי לראות את התוצאות. במסוף Cloud de Confiance , נכנסים למשאבים בממשק המשתמש כדי לוודא שהם נוצרו או עודכנו ב-Terraform.

SQL

כדי ליצור הקצאה ספציפית למשתמש, משתמשים בהצהרת CREATE ASSIGNMENT DDL עם האפשרות principal.

CREATE ASSIGNMENT
  `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME.ASSIGNMENT_ID`
OPTIONS (
  assignee = 'projects/PROJECT_ID',
  principal = 'principal://goog/subject/EMAIL_ADDRESS',
  job_type = 'QUERY');

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

• ‫ADMIN_PROJECT_ID: מזהה הפרויקט של פרויקט הניהול שבבעלותו משאב המקום השמור
• ‫LOCATION: המיקום של ההזמנה
• ‫RESERVATION_NAME: השם של ההזמנה
• ‫ASSIGNMENT_ID: מזהה ההקצאה
• ‫PROJECT_ID: מזהה הפרויקט
• ‫`EMAIL_ADDRESS: כתובת האימייל של המשתמש
• ‫JOB_TYPE: סוג העבודה שיוקצה להזמנה הזו, למשל QUERY,‏ CONTINUOUS,‏ PIPELINE,‏ BACKGROUND או ML_EXTERNAL

BQ

כדי ליצור הקצאה ספציפית למשתמש, משתמשים בפקודה bq mk עם הדגל --principal:

bq mk \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_assignment \
    --reservation_id=RESERVATION_NAME \
    --assignee_id=PROJECT_ID \
    --assignee_type=PROJECT \
    --principal=PRINCIPAL \
    --job_type=JOB_TYPE

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

• ‫ADMIN_PROJECT_ID: מזהה הפרויקט של פרויקט הניהול שבבעלותו משאב המקום השמור
• ‫LOCATION: המיקום של ההזמנה
• ‫RESERVATION_NAME: השם של ההזמנה
• ‫ASSIGNMENT_ID: מזהה ההקצאה
• ‫PROJECT_ID: מזהה הפרויקט
• PRINCIPAL: the principal identifier, for example,principal://goog/subject/EMAIL_ADDRESS`
• ‫JOB_TYPE: סוג העבודה שיוקצה להזמנה הזו, למשל QUERY,‏ CONTINUOUS,‏ PIPELINE,‏ BACKGROUND או ML_EXTERNAL

SQL

כדי להקצות פרויקט ל-none, משתמשים בהצהרת ה-DDL‏ CREATE ASSIGNMENT.

1. במסוף Cloud de Confiance , עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. מזינים את ההצהרה הבאה בעורך השאילתות:

   CREATE ASSIGNMENT
     `ADMIN_PROJECT_ID.region-LOCATION.none.ASSIGNMENT_ID`
   OPTIONS(
     assignee="projects/PROJECT_ID",
     job_type="QUERY");

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

   • ‫LOCATION: המיקום של המשימות שצריך להשתמש בהן בתמחור לפי דרישה

   • ‫ASSIGNMENT_ID: מזהה ההקצאה

     המזהה צריך להיות ייחודי לפרויקט ולמיקום, להתחיל ולהסתיים באות קטנה או במספר, ולהכיל רק אותיות קטנות, מספרים ומקפים.

   • ‫PROJECT_ID: המזהה של הפרויקט שרוצים להקצות להזמנה

3. לוחצים על play_circle הפעלה.

מידע נוסף על הרצת שאילתות זמין במאמר הרצת שאילתה אינטראקטיבית.

BQ

כדי להקצות פרויקט ל-none, משתמשים בפקודה bq mk עם הדגל --reservation_assignment:

bq mk \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_assignment \
    --reservation_id=none \
    --job_type=QUERY \
    --assignee_id=PROJECT_ID \
    --assignee_type=PROJECT

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

• ‫ADMIN_PROJECT_ID: מזהה הפרויקט של פרויקט הניהול שבבעלותו משאב המקום השמור
• ‫LOCATION: המיקום של המשרות שצריך להחיל עליהן תמחור לפי דרישה
• ‫PROJECT_ID: מזהה הפרויקט להקצאה ל-none

Terraform

משתמשים במשאב google_bigquery_reservation_assignment.

כדי לבצע אימות ב-BigQuery, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לספריות לקוח.

בדוגמה הבאה מוקצה פרויקט ל-none:

data "google_project" "project" {}

resource "google_bigquery_reservation_assignment" "default" {
  assignee    = "projects/${data.google_project.project.project_id}"
  job_type    = "QUERY"
  reservation = "projects/${data.google_project.project.project_id}/locations/us/reservations/none"
}

כדי להחיל את הגדרות Terraform בפרויקט ב- Cloud de Confiance , מבצעים את השלבים בקטעים הבאים.

הכנת Cloud Shell

1. מפעילים את Cloud Shell.

2. מגדירים את פרויקט ברירת המחדל שבו רוצים להחיל את ההגדרות של Terraform. Cloud de Confiance

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

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

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

הכנת הספרייה

לכל קובץ תצורה של Terraform צריכה להיות ספרייה משלו (שנקראת גם מודול ברמה הבסיסית).

1. יוצרים ספרייה חדשה ב-Cloud Shell ובה יוצרים קובץ חדש. שם הקובץ חייב לכלול את הסיומת .tf, למשל main.tf. במדריך הזה, הקובץ נקרא main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

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

   מעתיקים את הקוד לדוגמה בקובץ main.tf החדש שיצרתם.

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

3. בודקים את הפרמטרים לדוגמה ומשנים אותם בהתאם לסביבה שלכם.
4. שומרים את השינויים.
5. מפעילים את Terraform. צריך לעשות זאת רק פעם אחת לכל ספרייה.

   terraform init

   אופציונלי: תוכלו לכלול את האפשרות -upgrade, כדי להשתמש בגרסה העדכנית ביותר של הספק של Google:

   terraform init -upgrade

החלה של השינויים

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

   terraform plan

   מתקנים את ההגדרות לפי הצורך.

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

   terraform apply

   ממתינים עד שב-Terraform תוצג ההודעה "Apply complete!‎".

3. פותחים את Cloud de Confiance הפרויקט כדי לראות את התוצאות. במסוף Cloud de Confiance , נכנסים למשאבים בממשק המשתמש כדי לוודא שהם נוצרו או עודכנו ב-Terraform.

המסוף

1. עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. לוחצים על add_box שאילתת SQL.

3. מזינים שאילתת GoogleSQL תקינה בעורך השאילתות.

4. לוחצים על עריכה > הגדרות שאילתה.

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

6. ברשימה Reservation, בוחרים את ההזמנה שרוצים שהשאילתה תפעל בה.

7. לוחצים על Save.

8. כותבים שאילתה בכרטיסיית העורך ומריצים אותה. השאילתה מופעלת בהזמנה שציינתם.

SQL

מגדירים את משתנה המערכת @@reservation בסשן כדי להקצות את ההזמנה שהשאילתה פועלת בה:

1. במסוף Cloud de Confiance , עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. מזינים את ההצהרה הבאה בעורך השאילתות:

   SET @@reservation='RESERVATION';
   SELECT QUERY;

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

   • ‫RESERVATION: ההזמנה שבה רוצים להריץ את השאילתה.

   • ‫QUERY: השאילתה שרוצים להריץ.

3. לוחצים על play_circle הפעלה.

מידע נוסף על הרצת שאילתות זמין במאמר הרצת שאילתה אינטראקטיבית.

לדוגמה, השאילתה הבאה משתמשת בהצהרה SET כדי להגדיר את המקום השמור ל-test-reservation באזור US שכולל מספר אזורים, ואז קוראת לשאילתה בסיסית:

SET @@reservation='projects/project1/locations/US/reservations/test-reservation';
SELECT 42;

BQ

1. במסוף Cloud de Confiance , מפעילים את Cloud Shell.

   הפעלת Cloud Shell

   בחלק התחתון של Cloud de Confiance המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

2. ב-Cloud Shell, מריצים את השאילתה באמצעות הפקודה bq query עם הדגל --reservation_id:

   bq query --use_legacy_sql=false --reservation_id=RESERVATION_ID
   'QUERY'

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

   • ‫RESERVATION_ID: ההזמנה שבה רוצים להריץ את השאילתה.

   • ‫QUERY: הצהרת ה-SQL של השאילתה.

   לדוגמה, השאילתה הבאה מופעלת בהזמנה test-reservation באזור מרובה US:

   bq query --reservation_id=project1.US:test-reservation 'SELECT 42;'

API

כדי לציין הזמנה באמצעות ה-API, מוסיפים משימה חדשה ומאכלסים את מאפיין הגדרת המשימה query. מציינים את ההזמנה בשדה reservation.

המסוף

1. במסוף Cloud de Confiance , עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. בתפריט הניווט, לוחצים על Workload management.

3. לוחצים על הכרטיסייה הזמנות.

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

SQL

כדי לגלות לאיזו הזמנה מוקצות משימות השאילתה של הפרויקט, צריך להריץ שאילתה על התצוגה INFORMATION_SCHEMA.ASSIGNMENTS_BY_PROJECT.

1. במסוף Cloud de Confiance , עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. מזינים את ההצהרה הבאה בעורך השאילתות:

     SELECT
       assignment_id
     FROM `region-LOCATION`.INFORMATION_SCHEMA.ASSIGNMENTS_BY_PROJECT
     WHERE
       assignee_id = 'PROJECT_ID'
       AND job_type = 'JOB_TYPE';

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

   • ‫LOCATION: המיקום של ההזמנות שרוצים לראות
   • ‫ADMIN_PROJECT_ID: מזהה הפרויקט של פרויקט הניהול שבבעלותו משאב ההזמנה
   • ‫PROJECT_ID: המזהה של הפרויקט שרוצים להקצות להזמנה
   • ‫JOB_TYPE: סוג העבודה שיוקצה להזמנה הזו, למשל QUERY,‏ CONTINUOUS,‏ PIPELINE,‏ BACKGROUND או ML_EXTERNAL

3. לוחצים על play_circle הפעלה.

מידע נוסף על הרצת שאילתות זמין במאמר הרצת שאילתה אינטראקטיבית.

BQ

כדי לגלות לאיזו הזמנה משויכות משימות השאילתות של הפרויקט, משתמשים בפקודה bq show עם הדגל --reservation_assignment:

bq show \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_assignment \
    --job_type=JOB_TYPE \
    --assignee_id=PROJECT_ID \
    --assignee_type=PROJECT

כדי למצוא הקצאה ספציפית למשתמש, מוסיפים את הדגל --principal:

bq show \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_assignment \
    --job_type=JOB_TYPE \
    --assignee_id=PROJECT_ID \
    --assignee_type=PROJECT \
    --principal=PRINCIPAL

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

• ‫ADMIN_PROJECT_ID: המזהה של הפרויקט שבבעלותו משאב ההזמנה
• ‫LOCATION: המיקום של ההזמנות שרוצים לראות
• ‫JOB_TYPE: סוג העבודה שיוקצה להזמנה הזו, למשל QUERY,‏ CONTINUOUS,‏ PIPELINE,‏ BACKGROUND או ML_EXTERNAL
• ‫PROJECT_ID: מזהה הפרויקט
• ‫PRINCIPAL: המזהה של החשבון הראשי, לדוגמה, principal://goog/subject/EMAIL_ADDRESS

כדי לראות את כללי ההקצאה הפעילים שספציפיים למשתמש, בודקים את העמודה principal בתצוגה INFORMATION_SCHEMA.ASSIGNMENTS או מריצים את הפקודה bq ls --reservation_assignment. בנוסף, אפשר לבדוק איזו הזמנה הפעילה עבודה ספציפית באמצעות שאילתה בתצוגה INFORMATION_SCHEMA.JOBS. כשמשתמשים בפקודה bq show --reservation_assignment, אפשר לכלול את הדגל האופציונלי --principal כדי לסנן הקצאה של משתמש ספציפי.

המסוף

1. במסוף Cloud de Confiance , עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. בתפריט הניווט, לוחצים על Workload management.

3. לוחצים על הכרטיסייה הזמנות.

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

5. מרחיבים את האפשרות more_vert Actions (פעולות).

6. לוחצים על Delete.

SQL

משתמשים בהצהרת DDL‏ DROP ASSIGNMENT.

1. במסוף Cloud de Confiance , עוברים לדף BigQuery.

   כניסה ל-BigQuery

2. מזינים את ההצהרה הבאה בעורך השאילתות:

   DROP ASSIGNMENT
     `ADMIN_PROJECT_ID.region-LOCATION.RESERVATION_NAME.ASSIGNMENT_ID`;

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

   • ‫ADMIN_PROJECT_ID: מזהה הפרויקט של פרויקט הניהול שבבעלותו משאב ההזמנה
   • ‫LOCATION: המיקום של ההזמנה
   • ‫RESERVATION_NAME: השם של ההזמנה

   • ‫ASSIGNMENT_ID: מזהה ההקצאה

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

3. לוחצים על play_circle הפעלה.

מידע נוסף על הרצת שאילתות זמין במאמר הרצת שאילתה אינטראקטיבית.

BQ

כדי להסיר פרויקט מהזמנה, משתמשים בפקודה bq rm עם הדגל --reservation_assignment:

bq rm \
    --project_id=ADMIN_PROJECT_ID \
    --location=LOCATION \
    --reservation_assignment RESERVATION_NAME.ASSIGNMENT_ID

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

• ‫ADMIN_PROJECT_ID: המזהה של הפרויקט שבבעלותו משאב ההזמנה
• ‫LOCATION: המיקום של ההזמנה
• ‫RESERVATION_NAME: השם של ההזמנה

• ‫ASSIGNMENT_ID: מזהה ההקצאה

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