התצוגה INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION

כדי לשלוח משוב או לבקש תמיכה בנוגע לתכונה הזו, אפשר לשלוח אימייל לכתובת bq-recommendations+feedback@google.com.

התצוגה INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION מכילה נתונים על כל ההמלצות של BigQuery לכל הפרויקטים בארגון הנוכחי.

בתצוגה INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION יש תמיכה בהמלצות הבאות:

תצוגת הסכימה הזו זמינה רק למשתמשים עם ארגונים מוגדרים ב-Google Cloud .

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

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

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

סכימה

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

שם העמודה סוג נתונים ערך
recommendation_id STRING מזהה בקידוד Base64 שמכיל את RecommendationID ואת הממליץ.
recommender STRING סוג ההמלצה. לדוגמה, google.bigquery.table.PartitionClusterRecommender להמלצות על חלוקה למחיצות וקיבוץ לאשכולות.
subtype STRING סוג המשנה של ההמלצה.
project_id STRING מזהה הפרויקט.
project_number STRING מספר הפרויקט.
description STRING תיאור ההמלצה.
last_updated_time TIMESTAMP השדה הזה מייצג את הזמן שבו ההמלצה נוצרה לאחרונה.
target_resources STRING שמות מלאים של משאבים שההמלצה הזו מיועדת להם.
state STRING המצב של ההמלצה. רשימה של הערכים האפשריים מופיעה בקטע מצב.
primary_impact RECORD ההשפעה של ההמלצה הזו על האופטימיזציה של הקטגוריה הראשית. מכיל את השדות הבאים:
  • ‫category: הקטגוריה שההמלצה הזו מנסה לבצע בה אופטימיזציה. רשימה של הערכים האפשריים מופיעה בקטע קטגוריה.
  • ‫cost_projection: הערך הזה יכול להיות מאוכלס אם ההמלצה יכולה לחזות את החיסכון בעלויות כתוצאה מיישום ההמלצה. האפשרות הזו מוצגת רק כשהקטגוריה היא COST.
  • ‫security_projection: יכול להיות שיופיע כשהקטגוריה היא SECURITY.
priority STRING העדיפות של ההמלצה. רשימה של הערכים האפשריים מופיעה בקטע עדיפות.
associated_insight_ids STRING השמות המלאים של התובנות שמשויכות להמלצה.שם התובנה הוא ייצוג בקידוד Base64 של שם סוג התובנה ומזהה התובנה. אפשר להשתמש בפרמטר הזה כדי לשלוח שאילתה לתצוגת התובנות.
additional_details RECORD פרטים נוספים על ההמלצה.
  • ‫overview: סקירה כללית של ההמלצה בפורמט JSON. התוכן של השדה הזה עשוי להשתנות בהתאם למערכת ההמלצות.
  • state_metadata: מטא-נתונים על מצב ההמלצה בזוגות של מפתח/ערך.
  • ‫operations: רשימת הפעולות שהמשתמש יכול לבצע במשאבי היעד. השדה הזה מכיל את השדות הבאים:
    • ‫action: סוג הפעולה שהמשתמש צריך לבצע. יכול להיות שהמערכת תגדיר את הערך הזה כטקסט חופשי בזמן יצירת ההמלצה. תמיד יאוכלס.
    • ‫resource_type: סוג משאב הענן.
    • ‫resource: שם המשאב המוגדר במלואו.
    • ‫path: הנתיב של שדה היעד ביחס למשאב.
    • ‫value: הערך של שדה הנתיב.

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

היקף ותחביר

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

שם התצוגה היקף המשאבים היקף האזור
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.RECOMMENDATIONS[_BY_ORGANIZATION] ברמת הפרויקט REGION
מחליפים את מה שכתוב בשדות הבאים:
  • אופציונלי: PROJECT_ID: מזהה הפרויקט ב- Google Cloud . אם לא מציינים פרויקט, המערכת משתמשת בפרויקט שמוגדר כברירת מחדל.
  • ‫REGION: כל שם של אזור במערך נתונים. לדוגמה, `region-us`.

דוגמה

כדי להריץ את השאילתה בפרויקט שאינו פרויקט ברירת המחדל, מוסיפים את מזהה הפרויקט בפורמט הבא: 

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION
 מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט
  • ‫REGION_NAME: האזור של הפרויקט.

לדוגמה, `myproject`.`region-us`.INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION.

הצגת המלצות לתצוגות חומריות בארגון

בדוגמה הבאה מוחזרות המלצות לתצוגות חומריות בארגון:

SELECT
  project_id,
  LAX_INT64(additional_details.overview.bytesSavedMonthly) / POW(1024, 3) as est_gb_saved_monthly,
  LAX_INT64(additional_details.overview.slotMsSavedMonthly) / (1000 * 3600) as slot_hours_saved_monthly,
  last_updated_time
FROM
 `region-us`.INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION
WHERE
  recommender = 'google.bigquery.materializedview.Recommender'
LIMIT 3;
INFORMATION_SCHEMA

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

+-------------------------------+----------------------------------------------------------------------+
|          project_id           | est_gb_saved_monthly| slot_hours_saved_monthly |  last_updated_time  |
+-------------------------------+----------------------------------------------------------------------+
| project1                      |   4689.071544663957 |       2682.1816833333337 | 2024-07-01 13:00:31 |
| project2                      |   137.5052567309467 |        9613.139166666666 | 2024-07-01 13:00:31 |
| project3                      |  146.83722260318973 |        7093.014316666667 | 2024-07-01 13:00:31 |
+-------------------------------+----------------------------------------------------------------------+