התצוגה 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: מזהה הפרויקט ב- Cloud de Confiance . אם לא מציינים פרויקט, המערכת משתמשת בפרויקט שמוגדר כברירת מחדל.
  • ‫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 |
+---------------------------------------------------+---------------------+--------------------+--------------------------+-------------------------+---------------------+