Vista INFORMATION_SCHEMA.INSIGHTS

Vista previa

Este producto o función está sujeto a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones específicas del Servicio. Los productos y las funciones que se encuentran en la fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Para solicitar comentarios o asistencia para esta función, envía un correo electrónico a [e-mail].

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:

• Recomendaciones de particiones y clústeres
• Recomendaciones de vistas materializadas
• Recomendaciones de roles para conjuntos de datos de BigQuery

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:

• Permisos del recomendador de particiones y clústeres
• Permisos de recomendaciones de vista materializadas
• Recomendaciones de roles para los permisos de conjuntos de datos

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. Un ejemplo es region-us.

Nota: Debes usar un calificador de región para consultar las vistas INFORMATION_SCHEMA. La ubicación de la ejecución de la consulta debe coincidir con la región de la vista INFORMATION_SCHEMA.

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;

Nota: En los nombres de las vistas INFORMATION_SCHEMA, se distingue entre mayúsculas y minúsculas.

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