Vue ASSIGNMENTS

La vue INFORMATION_SCHEMA.ASSIGNMENTS contient la liste de toutes les attributions en cours dans le projet d'administration. Chaque ligne représente une seule attribution en cours. Une attribution en cours est en attente ou active, et n'a pas été supprimée. Pour en savoir plus sur la réservation, consultez la section Présentation de Reservations.

Autorisation requise

Pour interroger la vue INFORMATION_SCHEMA.ASSIGNMENTS, vous devez disposer de l'autorisation IAM (Identity and Access Management) bigquery.reservationAssignments.list pour le projet. Chacun des rôles IAM prédéfinis suivants inclut l'autorisation requise :

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

Pour plus d'informations sur les autorisations BigQuery, consultez la page Contrôle des accès avec IAM.

Schéma

La vue INFORMATION_SCHEMA.ASSIGNMENTS présente le schéma suivant :

Nom de la colonne	Type de données	Valeur
`ddl`	`STRING`	Instruction LDD utilisée pour créer l'attribution.
`project_id`	`STRING`	ID du projet d'administration.
`project_number`	`INTEGER`	Numéro du projet d'administration.
`assignment_id`	`STRING`	ID qui identifie de manière unique l'attribution.
`reservation_name`	`STRING`	Nom de la réservation utilisée par l'attribution.
`job_type`	`STRING`	Type de tâche pouvant utiliser la réservation. Il peut s'agir de `PIPELINE`, `QUERY`, `ML_EXTERNAL` ou `BACKGROUND`.
`assignee_id`	`STRING`	ID qui identifie de manière unique la ressource affectée.
`assignee_number`	`INTEGER`	Numéro qui identifie de manière unique la ressource affectée.
`assignee_type`	`STRING`	Type de ressource affectée. Il peut s'agir de `organization`, `folder` ou `project`.

Champ d'application et syntaxe

Les requêtes exécutées sur cette vue doivent inclure un qualificatif de région. Si vous ne spécifiez pas de qualificatif de région, les métadonnées sont extraites de toutes les régions. Le tableau suivant explique le champ d'application de la région pour cette vue :

Nom de la vue	Champ d'application de la ressource	Champ d'application de la région
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ASSIGNMENTS[_BY_PROJECT]	Niveau Projet	`REGION`

Remplacez les éléments suivants :

Facultatif : PROJECT_ID : ID de votre projet Google Cloud. Si non spécifié, le projet par défaut est utilisé.
REGION : tout nom de région d'ensemble de données. Exemple : region-us.

Remarque : Vous devez spécifier l'emplacement pour interroger les vues INFORMATION_SCHEMA. L'emplacement d'exécution de la requête doit correspondre à la région de la vue INFORMATION_SCHEMA.

Exemple

Pour exécuter la requête sur un projet autre que celui par défaut, ajoutez l'ID du projet en respectant le format suivant :

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

Remplacez les éléments suivants :

PROJECT_ID : l'ID du projet auquel vous avez attribué des réservations.
REGION_NAME : nom de la région.

Par exemple, `myproject`.`region-us`.INFORMATION_SCHEMA.ASSIGNMENTS.

L'exemple suivant récupère la réservation actuellement attribuée à un projet et sa capacité d'emplacements. Ces informations peuvent vous aider à déboguer les performances des tâches en comparant l'utilisation de l'emplacement du projet avec la capacité d'emplacements attribuée à ce même projet.

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