Visualização de INFORMATION_SCHEMA.RECOMMENDATIONS_BY_ORGANIZATION

Visualização

Este produto ou recurso está sujeito aos "Termos das ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos do serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Para solicitar feedback ou suporte para esse recurso, envie um e-mail para [e-mail].

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:

• Recomendações de partição e cluster
• Recomendações de visualização materializada
• Recomendações de função para conjuntos de dados do BigQuery

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:

• Permissões do recomendador de partição e cluster
• Permissões de recomendações de visualização materializada
• Recomendações de função para permissões de conjuntos de dados

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.

Observação: é necessário usar um qualificador de região para consultar visualizações INFORMATION_SCHEMA. O local de execução da consulta precisa corresponder à região da visualização INFORMATION_SCHEMA.

Exemplo

Para executar a consulta em um projeto diferente do padrão, adicione o ID do projeto neste 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 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;

Observação: os nomes da visualização INFORMATION_SCHEMA diferenciam maiúsculas e minúsculas.

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