Vista INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION

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.RECOMMENDATIONS_BY_ORGANIZATION contiene datos sobre todas las recomendaciones de BigQuery para todos los proyectos de la organización actual.

La vista INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION admite las siguientes recomendaciones:

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

Esta vista de esquema solo está disponible para los usuarios con organizaciones de Google Cloud definidas.

Permisos necesarios

Para ver las recomendaciones con la vista INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION, debes tener los permisos necesarios para el recomendador correspondiente. La vista INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION solo muestra las recomendaciones que tienes permiso para ver. Cuando tengas los permisos necesarios en la organización, podrás ver las recomendaciones de todos los proyectos dentro de esa organización, independientemente de tus permisos en el proyecto.

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:

• 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.RECOMMENDATIONS_BY_ORGANIZATION 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_ORGANIZATION]	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.RECOMMENDATIONS_BY_ORGANIZATION

Reemplaza lo siguiente:

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

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

Cómo ver recomendaciones de vistas materializadas en la organización

En el siguiente ejemplo, se muestran recomendaciones de vistas materializadas de la organización:

SELECT
  project_id,
  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_ORGANIZATION
WHERE
  recommender = 'google.bigquery.materializedview.Recommender'
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:

+-------------------------------+----------------------------------------------------------------------+
|          project_id           | est_gb_saved_monthly| slot_hours_saved_monthly |  last_updated_time  |
+-------------------------------+----------------------------------------------------------------------+
| project1                      |   4689.071544663957 |       2682.1816833333337 | 2024-07-01 13:00:31 |
| project2                      |   137.5052567309467 |        9613.139166666666 | 2024-07-01 13:00:31 |
| project3                      |  146.83722260318973 |        7093.014316666667 | 2024-07-01 13:00:31 |
+-------------------------------+----------------------------------------------------------------------+