התצוגה INFORMATION_SCHEMA.INSIGHTS

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

התצוגה INFORMATION_SCHEMA.INSIGHTS מכילה תובנות לגבי כל ההמלצות של BigQuery בפרויקט הנוכחי. ‫BigQuery מאחזר תובנות לגבי כל סוגי התובנות ב-BigQuery מ-Active Assist ומציג אותן בתצוגה הזו. התובנות ב-BigQuery תמיד משויכות להמלצה.

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

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

כדי לראות תובנות בתצוגה INFORMATION_SCHEMA.INSIGHTS, אתם צריכים את ההרשאות הנדרשות לשירות ההמלצות המתאים. בתצוגה INFORMATION_SCHEMA.INSIGHTS מוצגות רק תובנות מהמלצות שיש לכם הרשאה לראות.

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

סכימה

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

שם העמודה סוג נתונים ערך
insight_id STRING מזהה בקידוד Base64 שמכיל את סוג התובנה ואת מזהה התובנה
insight_type STRING סוג התובנה. לדוגמה, google.bigquery.materializedview.Insight.
subtype STRING סוג המשנה של התובנה.
project_id STRING מזהה הפרויקט.
project_number STRING מספר הפרויקט.
description STRING תיאור ההמלצה.
last_updated_time TIMESTAMP השדה הזה מייצג את השעה שבה התובנה עודכנה לאחרונה.
category STRING קטגוריית האופטימיזציה של ההשפעה.
target_resources STRING שמות מלאים של משאבים שהתובנה הזו מטרגטת.
state STRING המצב של התובנה. רשימה של הערכים האפשריים זמינה במאמר ערך.
severity STRING רמת החומרה של התובנה. רשימה של הערכים האפשריים זמינה במאמר בנושא חומרה.
associated_recommendation_ids STRING השמות המלאים של ההמלצות שהתובנה הזו משויכת אליהן. שם ההמלצה הוא ייצוג בקידוד Base64 של סוג שירות ההמלצות ומזהה ההמלצה.
additional_details RECORD פרטים נוספים על התובנה.
  • ‫content: תוכן התובנה בפורמט JSON.
  • ‫state_metadata: מטא-נתונים על מצב התובנה. מכיל צמדי מפתח/ערך.
  • ‫observation_period_seconds: תקופת התצפית ליצירת התובנה.

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

היקף ותחביר

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

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

דוגמה

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

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

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

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

צפייה בתובנות פעילות עם חיסכון בעלויות

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

WITH 
 insights as (SELECT * FROM `region-us`.INFORMATION_SCHEMA.INSIGHTS),
 recs as (SELECT recommender, recommendation_id, additional_details FROM `region-us`.INFORMATION_SCHEMA.RECOMMENDATIONS)

SELECT  
   recommender,
   target_resources,
   LAX_INT64(recs.additional_details.overview.bytesSavedMonthly) / POW(1024, 3) as est_gb_saved_monthly,
   LAX_INT64(recs.additional_details.overview.slotMsSavedMonthly) / (1000 * 3600) as slot_hours_saved_monthly,
   insights.additional_details.observation_period_seconds / 86400 as observation_period_days,
   last_updated_time
FROM 
  insights 
JOIN recs 
ON 
  recommendation_id in UNNEST(associated_recommendation_ids) 
WHERE 
  state = 'ACTIVE' 
AND
  category = 'COST'
LIMIT 3;
INFORMATION_SCHEMA

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

+---------------------------------------------------+---------------------+--------------------+--------------------------+-------------------------+---------------------+
|                    recommender                    |   target_resource   |  gb_saved_monthly  | slot_hours_saved_monthly | observation_period_days |  last_updated_time  |
+---------------------------------------------------+---------------------+--------------------+--------------------------+-------------------------+---------------------+
| google.bigquery.table.PartitionClusterRecommender | ["table_resource1"] |   3934.07264107652 |       10.499466666666667 |                    30.0 | 2024-07-01 16:41:25 |
| google.bigquery.table.PartitionClusterRecommender | ["table_resource2"] | 4393.7416711859405 |        56.61476777777777 |                    30.0 | 2024-07-01 16:41:25 |
| google.bigquery.materializedview.Recommender      | ["project_resource"]| 140805.38289248943 |        9613.139166666666 |                     2.0 | 2024-07-01 13:00:31 |
+---------------------------------------------------+---------------------+--------------------+--------------------------+-------------------------+---------------------+