Vista INFORMATION_SCHEMA.RECOMMENDATIONS

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.RECOMMENDATIONS contiene datos sobre todas las recomendaciones de BigQuery del proyecto actual. BigQuery recupera recomendaciones para todos los recomendadores de BigQuery desde Recommendation Hub y las presenta en esta vista.

La vista INFORMATION_SCHEMA.RECOMMENDATIONS admite las siguientes recomendaciones:

En la vista INFORMATION_SCHEMA.RECOMMENDATIONS, solo se muestran recomendaciones relacionadas con BigQuery. Puedes ver las recomendaciones de Google Cloud en el Centro de recomendaciones.

Permiso necesario

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

Pídele al administrador que te otorgue acceso para ver las recomendaciones. Para ver los permisos necesarios para cada recomendador, consulta los siguientes vínculos:

Esquema

La vista INFORMATION_SCHEMA.RECOMMENDATIONS tiene el siguiente esquema:

Nombre de la columna Tipo de datos Valor
recommendation_id STRING ID codificado en Base64 que contiene el RecommendationID y el recomendador.
recommender STRING Es el tipo de recomendación. Por ejemplo, google.bigquery.table.PartitionClusterRecommender para las recomendaciones de particiones y agrupamiento en clústeres.
subtype STRING Es el subtipo de la recomendación.
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 creó la recomendación por última vez.
target_resources STRING Son los nombres de recursos completamente calificados a los que se segmenta esta recomendación.
state STRING Es el estado de la recomendación. Para obtener una lista de valores posibles, consulta Estado.
primary_impact RECORD El impacto que puede tener esta recomendación cuando se intenta optimizar la categoría principal. Contiene los siguientes campos:
  • category: Es la categoría que esta recomendación intenta optimizar. Para obtener una lista de valores posibles, consulta Categoría.
  • cost_projection: Este valor se puede propagar si la recomendación puede proyectar los ahorros de costos de esta recomendación. Solo está presente cuando la categoría es COST.
  • security_projection: Puede estar presente cuando la categoría es SECURITY.
priority STRING Es la prioridad de la recomendación. Para obtener una lista de valores posibles, consulta Prioridad.
associated_insight_ids STRING Son los nombres completos de las estadísticas asociadas con la recomendación. El nombre de la estadística es la representación codificada en base64 del nombre del tipo de estadística y el ID de la estadística. Se puede usar para consultar la vista de estadísticas.
additional_details RECORD Detalles adicionales sobre la recomendación.
  • overview: Descripción general de la recomendación en formato JSON. El contenido de este campo puede cambiar según el recomendador.
  • state_metadata: Son metadatos sobre el estado de la recomendación en pares clave-valor.
  • operations: Es la lista de operaciones que el usuario puede realizar en los recursos de destino. Esto contiene los campos siguientes:
    • action: Es el tipo de acción que debe realizar el usuario. Puede ser un texto libre establecido por el sistema mientras se genera la recomendación. Siempre se propagará.
    • resource_type: Es el tipo de recurso de Cloud.
    • resource: Nombre de recurso completamente calificado.
    • path: Es la ruta del campo de destino en relación con el recurso.
    • value: Es el valor del campo de ruta.

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.RECOMMENDATIONS[_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.RECOMMENDATIONS
 Reemplaza lo siguiente:

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

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

Visualiza las recomendaciones de ahorro de costos principales

En el siguiente ejemplo, se muestran las 3 recomendaciones de categoría COST principales en función del slot_hours_saved_monthly proyectado:

SELECT 
   recommender,
   target_resources,
   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_PROJECT
WHERE 
   primary_impact.category = 'COST'
AND
   state = 'ACTIVE'
ORDER by 
   slot_hours_saved_monthly DESC 
LIMIT 3;

El resultado es similar al siguiente:

+---------------------------------------------------+--------------------------------------------------------------------------------------------------+
|                    recommender                    |   target_resources      | est_gb_saved_monthly | slot_hours_saved_monthly |  last_updated_time
+---------------------------------------------------+--------------------------------------------------------------------------------------------------+
| google.bigquery.materializedview.Recommender      | ["project_resource"]    | 140805.38289248943   |        9613.139166666666 |  2024-07-01 13:00:00
| google.bigquery.table.PartitionClusterRecommender | ["table_resource_1"]    | 4393.7416711859405   |        56.61476777777777 |  2024-07-01 13:00:00
| google.bigquery.table.PartitionClusterRecommender | ["table_resource_2"]    |   3934.07264107652   |       10.499466666666667 |  2024-07-01 13:00:00
+---------------------------------------------------+--------------------------------------------------------------------------------------------------+