Esta página foi traduzida pela API Cloud Translation.

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