Vue TABLE_CONSTRAINTS

La vue TABLE_CONSTRAINTS contient les relations de clé primaire et de clé étrangère dans un ensemble de données BigQuery.

Dans les bases de données relationnelles classiques, les clés primaires et les clés étrangères permettent d'assurer l'intégrité des données. La valeur d'une clé primaire est unique pour chaque ligne et n'est pas NULL. Chaque valeur de clé étrangère d'une ligne doit s'afficher dans la colonne de clé primaire de la table référencée ou NULL. Les relations de clé primaire et de clé étrangère sont créées et gérées à l'aide d'instructions DDL.

Limites

  • Les contraintes de valeur pour les clés primaires et étrangères ne sont pas appliquées. Les utilisateurs doivent s'assurer que les valeurs correspondent à leurs contraintes respectives, sinon ils risquent d'obtenir des résultats incorrects. Plus précisément :
    • Les clés primaires doivent avoir des valeurs uniques.
    • Les clés primaires ne peuvent pas dépasser 16 colonnes.
    • Les clés étrangères doivent comporter des valeurs présentes dans la colonne de la table référencée. Ces valeurs peuvent être NULL.
    • Les clés primaires et étrangères doivent être de l'un des types suivants : BIGNUMERIC, BOOLEAN, DATE, DATETIME, INT64, NUMERIC, STRING ou TIMESTAMP.
  • Les clés primaires et étrangères ne peuvent être définies que sur des colonnes de premier niveau.
  • Les clés primaires ne peuvent pas être nommées.
  • Les tables avec des contraintes de clé primaire ne peuvent pas être renommées.
  • Une table peut contenir jusqu'à 64 clés étrangères définies dans la table.
  • Une clé étrangère ne peut pas faire référence à une colonne de la même table.
  • Les champs qui font partie de contraintes de clé primaire ou de clé étrangère ne peuvent pas être renommés, ou subir de modifications de type.
  • Si vous effectuez des opérations de copie, de clonage, de restauration ou de création d'instantané sur une table sans utiliser l'option -a ou --append_table, les contraintes de la table source sont copiées et écrasées dans la table de destination. Si vous utilisez l'option -a ou --append_table, seuls les enregistrements de la table source sont ajoutés à la table de destination, sans les contraintes de la table.

Autorisations requises

Vous avez besoin des autorisations IAM (Identity and Access Management) suivantes :

  • bigquery.tables.get pour afficher les définitions de clé primaire et étrangère.
  • bigquery.tables.list pour afficher les schémas d'informations des tables.

Chacun des rôles prédéfinis suivants dispose des autorisations nécessaires pour effectuer les workflows détaillés dans ce document :

  • roles/bigquery.dataEditor
  • roles/bigquery.dataOwner
  • roles/bigquery.admin

Pour en savoir plus sur les rôles et les autorisations IAM dans BigQuery, consultez la page Rôles prédéfinis et autorisations.

Schéma

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

Nom de la colonne Type Signification

CONSTRAINT_CATALOG

STRING

Nom de projet de la contrainte.

CONSTRAINT_SCHEMA

STRING

Nom de l'ensemble de données de la contrainte.

CONSTRAINT_NAME

STRING

Nom de la contrainte.

TABLE_CATALOG

STRING

Nom du projet de la table avec des contraintes.

TABLE_SCHEMA

STRING

Nom de l'ensemble de données de la table avec des contraintes.

TABLE_NAME

STRING

Nom de la table avec des contraintes.

CONSTRAINT_TYPE

STRING

PRIMARY KEY ou FOREIGN KEY.

IS_DEFERRABLE

STRING

YES ou NO selon qu'une contrainte est différable ou non. Seule l'option NO est acceptée.

INITIALLY_DEFERRED

STRING

Seule l'option NO est acceptée.

ENFORCED

STRING

YES ou NO selon que la contrainte est appliquée ou non.
Seule la fonctionnalité NO est prise en charge.

Champ d'application et syntaxe

Les requêtes exécutées sur cette vue doivent inclure un qualificatif d'ensemble de données. Pour les requêtes avec un qualificatif d'ensemble de données, vous devez disposer d'autorisations pour l'ensemble de données. Pour en savoir plus, consultez la section Syntaxe. Le tableau suivant explique le champ d'application des régions et des ressources pour cette vue :

Nom de la vue Champ d'application de la ressource Champ d'application de la région
[PROJECT_ID.]DATASET.INFORMATION_SCHEMA.TABLE_CONSTRAINTS; Niveau de l'ensemble de données Emplacement d'un ensemble de données
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é.

    Exemples

    La requête suivante montre les contraintes pour une seule table d'un ensemble de données :

    SELECT *
FROM PROJECT_ID.DATASET.INFORMATION_SCHEMA.TABLE_CONSTRAINTS
WHERE table_name = TABLE;

    Remplacez les éléments suivants :

    • PROJECT_ID : facultatif. Nom de votre projet Cloud. Si aucune valeur n'est spécifiée, cette commande utilise le projet par défaut.
    • DATASET : nom de votre ensemble de données.
    • TABLE : nom de la table.

    À l'inverse, la requête suivante affiche les contraintes pour toutes les tables d'un même ensemble de données.

    SELECT *
FROM PROJECT_ID.DATASET.INFORMATION_SCHEMA.TABLE_CONSTRAINTS;

    Avec des contraintes existantes, les résultats de la requête ressemblent à ce qui suit :

    +-----+---------------------+-------------------+-----------------------+---------------------+--------------+------------+-----------------+---------------+--------------------+----------+
| Row | constraint_catalog  | constraint_schema |    constraint_name    |    table_catalog    | table_schema | table_name | constraint_type | is_deferrable | initially_deferred | enforced |
+-----+---------------------+-------------------+-----------------------+---------------------+--------------+------------+-----------------+---------------+--------------------+----------+
|   1 | myConstraintCatalog | myDataset         | orders.pk$            | myConstraintCatalog | myDataset    | orders     | PRIMARY KEY     | NO            | NO                 | NO       |
|   2 | myConstraintCatalog | myDataset         | orders.order_customer | myConstraintCatalog | myDataset    | orders     | FOREIGN KEY     | NO            | NO                 | NO       |
+-----+---------------------+-------------------+-----------------------+---------------------+--------------+------------+-----------------+---------------+--------------------+----------+

    Si la table ou l'ensemble de données ne présente aucune contrainte, les résultats de la requête se présentent comme suit :

    +-----------------------------+
| There is no data to display |
+-----------------------------+