Vista ATRIBUIÇÕES

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

Autorização necessária

Para consultar a vista INFORMATION_SCHEMA.ASSIGNMENTS, precisa da autorização de gestão de identidade e de acesso (IAM) para o projeto.bigquery.reservationAssignments.list Cada uma das seguintes funções de IAM predefinidas inclui a autorização necessária:

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

Para mais informações sobre as autorizações do BigQuery, consulte o artigo Controlo de acesso com a IAM.

Esquema

A vista INFORMATION_SCHEMA.ASSIGNMENTS tem o seguinte esquema:

Nome da coluna Tipo de dados Valor
ddl STRING A declaraçã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 ID que identifica de forma exclusiva a atribuição.
reservation_name STRING Nome da reserva que a atribuição usa.
job_type STRING O tipo de trabalho que pode usar a reserva. Pode ser PIPELINE, QUERY, CONTINUOUS, ML_EXTERNAL ou BACKGROUND.
assignee_id STRING ID que identifica de forma exclusiva o recurso atribuído.
assignee_number INTEGER Número que identifica de forma exclusiva o recurso de cessionário.
assignee_type STRING Tipo de recurso do destinatário. Pode ser organization, folder ou project.

Âmbito e sintaxe

As consultas nesta vista têm de incluir um qualificador de região. Se não especificar um qualificador regional, os metadados são obtidos de todas as regiões. A tabela seguinte explica o âmbito da região para esta vista:

Nome da visualização de propriedade Âmbito do recurso Âmbito da região
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ASSIGNMENTS[_BY_PROJECT]
 Nível do projeto REGION
Substitua o seguinte:
  • Opcional: PROJECT_ID: o ID do seu projeto do Trusted 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.ASSIGNMENTS
.

Substitua o seguinte:

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

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

O exemplo seguinte obtém a reserva atualmente atribuída de um projeto e a respetiva capacidade de slots. Estas informações são úteis para depurar o desempenho das tarefas comparando a utilização de slots do projeto com a capacidade de slots da reserva atribuída a esse projeto.

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";