Vista INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION

Para pedir feedback ou apoio técnico para esta funcionalidade, envie um email para bq-recommendations+feedback@google.com.

A vista INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION contém dados sobre todas as recomendações do BigQuery para todos os projetos na organização atual.

A vista INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION suporta as seguintes recomendações:

Esta vista de esquema só está disponível para utilizadores com Google Cloud organizações definidas.

Autorizações necessárias

Para ver recomendações com a vista INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION, tem de ter as autorizações necessárias para o recomendador correspondente. A visualização INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATIONsó devolve recomendações que tem autorização para ver. Quando tem as autorizações necessárias na organização, pode ver recomendações para todos os projetos nessa organização, independentemente das suas autorizações no próprio projeto.

Peça ao administrador para conceder acesso à visualização das recomendações. Para ver as autorizações necessárias para cada motor de recomendações, consulte o seguinte:

Esquema

A vista INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION tem o seguinte esquema:

Nome da coluna Tipo de dados Valor
recommendation_id STRING ID codificado em Base64 que contém o RecommendationID e o recomendador.
recommender STRING O tipo de recomendação. Por exemplo, google.bigquery.table.PartitionClusterRecommender para recomendações de particionamento e agrupamento.
subtype STRING O subtipo da recomendação.
project_id STRING O ID do projeto.
project_number STRING O número do projeto.
description STRING A descrição sobre a recomendação.
last_updated_time TIMESTAMP Este campo representa a hora em que a recomendação foi criada pela última vez.
target_resources STRING Nomes de recursos totalmente qualificados que esta recomendação está a segmentar.
state STRING O estado da recomendação. Para ver uma lista de valores possíveis, consulte State.
primary_impact RECORD O impacto que esta recomendação pode ter ao tentar otimizar a categoria principal. Contém os seguintes campos:
  • category: a categoria que esta recomendação está a tentar otimizar. Para ver uma lista de valores possíveis, consulte Categoria.
  • cost_projection: este valor pode ser preenchido se a recomendação conseguir projetar a poupança de custos desta recomendação. Só está presente quando a categoria é COST.
  • security_projection: pode estar presente quando a categoria é SECURITY.
priority STRING A prioridade da recomendação. Para ver uma lista de valores possíveis, consulte Prioridade.
associated_insight_ids STRING Nomes completos das estatísticas associadas à recomendação.O nome das estatísticas é a representação com codificação Base64 do nome do tipo de estatísticas e do ID das estatísticas. Pode usar esta opção para consultar a vista Estatísticas.
additional_details RECORD Detalhes adicionais sobre a recomendação.
  • overview: vista geral da recomendação no formato JSON. O conteúdo deste campo pode mudar com base no autor da recomendação.
  • state_metadata: metadados sobre o estado da recomendação em pares de chave-valor.
  • operations: lista de operações que o utilizador pode realizar nos recursos de destino. Contém os seguintes campos:
    • action: o tipo de ação que o utilizador tem de realizar. Este pode ser um texto livre definido pelo sistema durante a geração da recomendação. Vai estar sempre preenchido.
    • resource_type: o tipo de recurso na nuvem.
    • resource: nome do recurso totalmente qualificado.
    • path: caminho do campo de destino relativo ao recurso.
    • value: valor do campo de caminho.

Âmbito e sintaxe

As consultas nesta vista têm de incluir um qualificador de região. Um ID do projeto é opcional. Se não for especificado um ID do projeto, é usado o projeto no qual a consulta é executada.

Nome da visualização de propriedade Âmbito do recurso Âmbito da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.RECOMMENDATIONS[_BY_ORGANIZATION] Nível do projeto REGION
Substitua o seguinte:
  • Opcional: PROJECT_ID: o ID do seu projeto do Google Cloud Google Cloud. Se não for especificado, é usado o projeto predefinido.
  • REGION: qualquer nome da região do conjunto de dados. Por exemplo, `region-us`.

Exemplo

Para executar a consulta num projeto que não seja o seu projeto predefinido, adicione o ID do projeto no seguinte formato: 

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION
 Substitua o seguinte:

  • PROJECT_ID: o ID do projeto.
  • REGION_NAME: a região do seu projeto.

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

Veja recomendações de vistas materializadas na organização

O exemplo seguinte devolve recomendações de vistas materializadas na organização:

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;

O resultado é semelhante ao seguinte:

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