Vista INFORMATION_SCHEMA.RECOMMENDATIONS

Pré-visualização

Este produto ou funcionalidade está sujeito aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. Os produtos e as funcionalidades pré-GA estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Para pedir feedback ou apoio técnico para esta funcionalidade, envie um email para [e-mail].

A vista INFORMATION_SCHEMA.RECOMMENDATIONS contém dados sobre todas as recomendações do BigQuery no projeto atual. O BigQuery obtém recomendações para todos os recomendadores do BigQuery a partir do Centro de recomendações e apresenta-as nesta vista.

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

• Recomendações de partições e agrupamentos
• Recomendações de vistas materializadas
• Recomendações de funções para conjuntos de dados do BigQuery

A visualização INFORMATION_SCHEMA.RECOMMENDATIONS mostra apenas recomendações relacionadas com o BigQuery. Pode ver Google Cloud recomendações no Centro de Recomendações.

Autorização necessária

Para ver recomendações com a vista INFORMATION_SCHEMA.RECOMMENDATIONS, tem de ter as autorizações necessárias para o recomendador correspondente. A visualização INFORMATION_SCHEMA.RECOMMENDATIONS só devolve recomendações que tem autorização para ver.

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:

• Particione e agrupe autorizações do recomendador
• Autorizações de recomendações de vistas materializadas
• Recomendações de funções para autorizações de conjuntos de dados

Esquema

A vista INFORMATION_SCHEMA.RECOMMENDATIONS 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_PROJECT]	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`.
  Nota: tem de usar um qualificador de região para consultar as visualizações INFORMATION_SCHEMA. A localização da execução da consulta tem de corresponder à região da vista INFORMATION_SCHEMA.

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

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.

Veja as principais recomendações de poupança de custos

O exemplo seguinte devolve as 3 principais recomendações de categorias com base na COSTprojeçãoslot_hours_saved_monthly:

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;

Nota: os nomes das INFORMATION_SCHEMAvistas são sensíveis a maiúsculas e minúsculas.

O resultado é semelhante ao seguinte:

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