Vista INFORMATION_SCHEMA.INSIGHTS

Para solicitar comentarios o asistencia para esta función, envía un correo electrónico a bq-recommendations+feedback@google.com.

La vista INFORMATION_SCHEMA.INSIGHTS contiene estadísticas sobre todas las recomendaciones de BigQuery del proyecto actual. BigQuery recupera estadísticas para todos los tipos de estadísticas de BigQuery del Centro de recomendaciones y las presenta en esta vista. Las estadísticas de BigQuery siempre están asociadas con una recomendación.

La vista INFORMATION_SCHEMA.INSIGHTS admite las siguientes recomendaciones:

Permiso necesario

Para ver las estadísticas con la vista INFORMATION_SCHEMA.INSIGHTS, debes tener los permisos necesarios para el recomendador correspondiente. La vista INFORMATION_SCHEMA.INSIGHTS solo muestra estadísticas de las recomendaciones que tienes permiso para ver.

Solicita al administrador que te otorgue acceso para ver las estadísticas. Para ver los permisos necesarios para cada recomendador, consulta los siguientes vínculos:

Esquema

La vista INFORMATION_SCHEMA.INSIGHTS tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
insight_id STRING ID codificado en base64 que contiene el tipo de estadística y el ID de estadística
insight_type STRING El tipo de estadística. Por ejemplo, google.bigquery.materializedview.Insight.
subtype STRING Es el subtipo de la estadística.
project_id STRING El ID del proyecto.
project_number STRING El número del proyecto.
description STRING La descripción de la recomendación.
last_updated_time TIMESTAMP Este campo representa la hora en la que se actualizó la estadística por última vez.
category STRING La categoría de optimización del impacto.
target_resources STRING Son los nombres de recursos completamente calificados a los que se segmenta esta estadística.
state STRING Es el estado de la estadística. Para obtener una lista de los valores posibles, consulta Valor.
severity STRING La gravedad de la estadística. Para obtener una lista de valores posibles, consulta Gravedad.
associated_recommendation_ids STRING Son los nombres completos de las recomendaciones con las que está asociada esta estadística. El nombre de la recomendación es la representación codificada en Base64 del tipo de recomendador y el ID de las recomendaciones.
additional_details RECORD Son los detalles adicionales sobre la estadística.
  • content: Contenido de estadísticas en formato JSON.
  • state_metadata: Son metadatos sobre el estado de la estadística. Contiene pares clave-valor.
  • observation_period_seconds: Período de observación para generar la estadística.

Permiso y sintaxis

Las consultas realizadas a esta vista deben incluir un calificador de región. El uso de un ID del proyecto es opcional. Si no se especifica un ID del proyecto, se usa el proyecto en el que se ejecuta la consulta.

Nombre de la vista Permiso del recurso Permiso de la región
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.INSIGHTS[_BY_PROJECT] Nivel de proyecto REGION
Reemplaza lo siguiente:

  • Opcional: PROJECT_ID: el ID del proyecto de Google Cloud. Si no se especifica, se usa el proyecto predeterminado.

  • REGION: Cualquier nombre de región del conjunto de datos. Por ejemplo, `region-us`.

  • Ejemplo

    Para ejecutar la consulta en un proyecto que no sea el predeterminado, agrega el ID del proyecto con el siguiente formato:

    `PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.INSIGHTS
    Reemplaza lo siguiente:

    • PROJECT_ID: el ID del proyecto.
    • REGION_NAME: la región del proyecto.

    Por ejemplo, `myproject`.`region-us`.INFORMATION_SCHEMA.INSIGHTS.

    Visualiza las estadísticas activas con el ahorro de costos

    En el siguiente ejemplo, se une la vista de estadísticas con la vista de recomendaciones para mostrar 3 recomendaciones para las estadísticas que son ACTIVE en la categoría COST:

    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;
    
    

    El resultado es similar al siguiente:

    +---------------------------------------------------+---------------------+--------------------+--------------------------+-------------------------+---------------------+
    |                    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 |
    +---------------------------------------------------+---------------------+--------------------+--------------------------+-------------------------+---------------------+