Visualização de ATRIBUIÇÕES

A visualização INFORMATION_SCHEMA.ASSIGNMENTS contém uma lista quase em tempo real de todas as atribuições atuais no projeto de administração. Cada linha representa uma única atribuição atual. Uma atribuição atual está pendente ou ativa e não foi excluída. Para mais informações sobre reservas, consulte Introdução às reservas.

Permissão necessária

Para consultar a visualização INFORMATION_SCHEMA.ASSIGNMENTS, é preciso ter a permissão bigquery.reservationAssignments.list Identity and Access Management (IAM) para o projeto. Cada um dos seguintes papéis predefinidos do IAM inclui a permissão necessária:

roles/bigquery.resourceAdmin
roles/bigquery.resourceEditor
roles/bigquery.resourceViewer
roles/bigquery.user
roles/bigquery.admin

Para mais informações sobre as permissões do BigQuery, consulte Controle de acesso com o IAM.

Schema

A visualização INFORMATION_SCHEMA.ASSIGNMENTS tem o seguinte esquema:

Nome da coluna	Tipo de dados	Valor
`ddl`	`STRING`	A instrução DDL usada para criar esta atribuição.
`project_id`	`STRING`	ID do projeto de administração.
`project_number`	`INTEGER`	Número do projeto de administração.
`assignment_id`	`STRING`	Código que identifica exclusivamente a atribuição.
`reservation_name`	`STRING`	Nome da reserva que a atribuição usa.
`job_type`	`STRING`	O tipo de job que pode usar a reserva. Pode ser `PIPELINE`, `QUERY`, `ML_EXTERNAL`, or `BACKGROUND`.
`assignee_id`	`STRING`	Código que identifica exclusivamente o recurso do usuário.
`assignee_number`	`INTEGER`	Número que identifica exclusivamente o recurso atribuído.
`assignee_type`	`STRING`	Tipo de recurso atribuído. Pode ser `organization`, `folder` ou `project`.

Escopo e sintaxe

As consultas nessa visualização precisam incluir um qualificador de região. Se você não especificar um qualificador regional, os metadados serão recuperados de todas as regiões. A tabela a seguir explica o escopo da região dessa visualização:

Nome da visualização	Escopo do recurso	Escopo da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ASSIGNMENTS[_BY_PROJECT]	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 especificar o local para consultar as visualizações INFORMATION_SCHEMA, e 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 seu projeto padrão, adicione o ID do projeto no seguinte formato:

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.ASSIGNMENTS

Substitua:

PROJECT_ID: o ID do projeto ao qual você atribuiu reservas.
REGION_NAME: o nome da região.

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

O exemplo a seguir recebe a reserva atualmente atribuída e a respectiva capacidade de slot. Essas informações são úteis para depurar o desempenho do job comparando o uso do slot do projeto com a capacidade do slot da reserva atribuída a ele.

SELECT
  reservation.reservation_name,
  reservation.slot_capacity
FROM
  `RESERVATION_ADMIN_PROJECT.region-REGION_NAME`.
  INFORMATION_SCHEMA.ASSIGNMENTS_BY_PROJECT assignment
INNER JOIN
  `RESERVATION_ADMIN_PROJECT.region-REGION_NAME`.
  INFORMATION_SCHEMA.RESERVATIONS_BY_PROJECT AS reservation
ON
  (assignment.reservation_name = reservation.reservation_name)
WHERE
   assignment.assignee_id = "PROJECT_ID"
  AND job_type = "QUERY";