Visualização de INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION

Para solicitar feedback ou suporte para esse recurso, envie um e-mail para bq-recommendations+feedback@google.com.

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

A visualização INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION é compatível com estas recomendações:

Essa visualização de esquema está disponível apenas para usuários com organizações definidas do Google Cloud.

Permissões necessárias

Para conferir as recomendações com a visualização INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION, é necessário ter as permissões necessárias para o recomendador correspondente. A visualização INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION retorna apenas recomendações que você tem permissão para visualizar. Quando você tiver as permissões necessárias na organização, poderá visualizar recomendações para todos os projetos dentro dessa organização, independentemente de suas permissões no projeto em si.

Peça para o administrador conceder acesso para conferir as recomendações. Para conferir as permissões necessárias para cada recomendador, consulte estes tópicos:

Esquema

A visualização 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 clustering.
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 da recomendação.
last_updated_time TIMESTAMP Esse campo representa a hora em que a recomendação foi criada pela última vez.
target_resources STRING Nomes de recursos totalmente qualificados que a recomendação está segmentando.
state STRING O estado da recomendação. Para conferir uma lista de valores possíveis, consulte Estado.
primary_impact RECORD O impacto que essa recomendação pode ter ao tentar otimizar a categoria principal. Contém os seguintes campos:
  • category: a categoria que a recomendação está tentando otimizar. Para conferir uma lista de valores possíveis, consulte Categoria.
  • cost_projection: esse valor poderá ser preenchido se a recomendação puder projetar a economia de custos dela. Presente somente quando a categoria é COST.
  • security_projection: pode estar presente quando a categoria é SECURITY.
priority STRING A prioridade da recomendação. Para uma lista de valores possíveis, consulte Prioridade.
associated_insight_ids STRING Nomes completos dos insights associados à recomendação. O nome do insight é a representação codificada em Base64 do nome do tipo de insight e do ID do insight. Isso pode ser usado para consultar a visualização de insights.
additional_details RECORD Detalhes adicionais sobre a recomendação.
  • overview: visão geral da recomendação no formato JSON. O conteúdo desse campo pode mudar com base no recomendador.
  • state_metadata: metadados sobre o estado da recomendação em pares de chave-valor.
  • operations: lista de operações que o usuário pode realizar nos recursos de destino. Ela contém os seguintes campos:
    • action: o tipo de ação que o usuário precisa realizar. Pode ser um texto livre definido pelo sistema ao gerar a recomendação. Sempre será preenchido.
    • resource_type: o tipo de recurso da nuvem.
    • resource: nome do recurso totalmente qualificado
    • path: caminho do campo de destino em relação ao recurso.
    • value: valor do campo de caminho.

Escopo e sintaxe

As consultas nessa visualização precisam incluir um qualificador de região. Um ID do projeto é opcional. Se nenhum ID de projeto for especificado, o projeto em que a consulta será executada será usado.

Nome da visualização Escopo do recurso Escopo da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.RECOMMENDATIONS[_BY_ORGANIZATION] Nível do projeto REGION
Substitua:

  • Opcional: PROJECT_ID: o ID do seu projeto do Google Cloud. Se não for especificado, o projeto padrão será usado.

  • REGION: qualquer nome da região do conjunto de dados. Por exemplo, `region-us`.

  • Exemplo

    Para executar a consulta em um projeto diferente do projeto padrão, adicione o ID do projeto no seguinte formato:

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

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

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

    Consultar recomendações de visualização materializada na organização

    O exemplo a seguir retorna recomendações de visualização materializada 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 será 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 |
    +-------------------------------+----------------------------------------------------------------------+