Schéma d'informations pour les bases de données de dialecte GoogleSQL

Le schéma d'informations est un schéma intégré commun à toutes les bases de données Spanner. Vous pouvez exécuter des requêtes SQL sur des tables de INFORMATION_SCHEMA afin de récupérer les métadonnées de schéma d'une base de données.

Par exemple, la requête suivante récupère le nom de toutes les tables définies par l'utilisateur dans une base de données :

  SELECT
    table_name
  FROM
    information_schema.tables
  WHERE
    table_schema = ''

Les utilisateurs du contrôle des accès ultraprécis voient les résultats filtrés pour certaines tables INFORMATION_SCHEMA en fonction de leur rôle de base de données. Pour en savoir plus, consultez la page À propos du contrôle précis des accès.

Utilisation

Les tables INFORMATION_SCHEMA ne sont disponibles que via des interfaces SQL, par exemple:

  • L'API executeQuery
  • La commande gcloud spanner databases execute-sql
  • la page Spanner Studio d'une base de données dans la console Google Cloud) ;

Les autres méthodes de lecture unique ne sont pas compatibles avec INFORMATION_SCHEMA.

Autres remarques sur l'utilisation de INFORMATION_SCHEMA:

Filtrer les lignes dans les tables information_schema

Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant d'un accès au rôle système spanner_info_reader (ou aux membres de ce rôle) peuvent afficher toutes les lignes de toutes les tables information_schema. Pour les autres comptes principaux, pour certaines tables, les lignes sont filtrées en fonction du rôle de base de données actuel. Les descriptions des tables et des vues dans les sections suivantes indiquent comment le filtrage des lignes est appliqué pour chaque table et vue.

Tables de INFORMATION_SCHEMA

Les sections suivantes décrivent les tables du fichier INFORMATION_SCHEMA pour les bases de données de dialecte GoogleSQL.

SCHEMATA

La table INFORMATION_SCHEMA.SCHEMATA répertorie les schémas de la base de données. Ceux-ci incluent le schéma d'informations et les schémas nommés, qui contiennent les tables que vous définissez.

Nom de la colonne Type Description
CATALOG_NAME STRING Nom du catalogue. Cette colonne existe à des fins de compatibilité avec les tables de schéma d'informations standards SQL. Cette colonne est toujours une chaîne vide.
SCHEMA_NAME STRING Nom du schéma. Il s'agit d'un nom pour les schémas nommés ou "pour le schéma par défaut".
PROTO_BUNDLE STRING Si la base de données contient des instructions de bundle proto, cette colonne fournit des informations sur le groupe proto utilisé dans le schéma. Cette colonne affiche la valeur NULL si aucun groupe proto n'existe dans la base de données.

DATABASE_OPTIONS

Ce tableau répertorie les options définies sur la base de données.

Nom de la colonne Type Description
CATALOG_NAME STRING Nom du catalogue. Toujours une chaîne vide.
SCHEMA_NAME STRING Nom du schéma. Chaîne vide si elle n'est pas nommée.
OPTION_NAME STRING Nom de l'option de base de données.
OPTION_TYPE STRING Type de données de l'option de base de données.
OPTION_VALUE STRING Valeur de l'option de base de données.

TABLES

Ce tableau filtré par ligne répertorie les tables et les vues de la base de données. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant du rôle système spanner_info_reader ou des membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les tables qui répondent à l'une des exigences suivantes:

  • Les droits de contrôle des accès précis SELECT, INSERT, UPDATE ou DELETE sont accordés sur la table au rôle de base de données actuel, aux rôles dont ce rôle fait actuellement partie, ou à public.
  • Les droits SELECT, INSERT ou UPDATE sont accordés sur n'importe quelle colonne de la table au rôle de base de données actuel, aux rôles auxquels appartient ce rôle de base de données ou à public.
Nom de la colonne Type Description
TABLE_CATALOG STRING Non utilisé. Toujours une chaîne vide.
TABLE_SCHEMA STRING Non utilisé. Toujours une chaîne vide.
TABLE_NAME STRING Nom de la table, de la vue ou du synonyme.
TABLE_TYPE STRING Type de la table. Pour les tables, elle a la valeur BASE TABLE ; pour les vues, elle a la valeur VIEW. Pour les synonymes, elle a la valeur SYNONYM.
PARENT_TABLE_NAME STRING Nom de la table parente si cette table est entrelacée et NULL dans le cas contraire.
ON_DELETE_ACTION STRING Ce paramètre est défini sur CASCADE ou NO ACTION pour les tables entrelacées, et sur NULL dans le cas contraire. Consultez les instructions TABLE pour en savoir plus.
SPANNER_STATE STRING Une table peut passer par plusieurs états lors de sa création si des opérations groupées sont impliquées. Par exemple, lorsque la table est créée avec une clé étrangère qui nécessite un remplissage de ses index. Les états possibles sont les suivants :
  • ADDING_FOREIGN_KEY : ajout des clés étrangères de la table.
  • WAITING_FOR_COMMIT : finalisation de la modification du schéma.
  • COMMITTED: la modification de schéma permettant de créer la table a été validée. Vous ne pouvez pas écrire dans la table tant que la modification n'a pas été validée.
INTERLEAVE_TYPE STRING Texte d'expression qui indique s'il existe une relation parent-enfant entre cette table et la table dans laquelle elle est entrelacée. Les valeurs possibles sont les suivantes :
  • IN: la table n'a pas de relation parent-enfant. Une ligne de cette table peut exister quelle que soit l'existence de la ligne de la table parente.
  • IN PARENT: la table a une relation parent-enfant. Une ligne de cette table nécessite l'existence de la ligne de sa table parente.
  • Une chaîne vide indique que cette table ne comporte aucune relation d'entrelacement.
ROW_DELETION_POLICY_EXPRESSION STRING Texte d'expression qui définit la règle de suppression des lignes de la table. Par exemple, OLDER_THAN(CreatedAt, INTERVAL 1 DAY) ou OLDER_THAN(ExpiredDate, INTERVAL 0 DAY).

COLUMNS

Ce tableau filtré par ligne répertorie les colonnes d'un tableau. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant du rôle système spanner_info_reader ou des membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les colonnes qui répondent à l'une des exigences suivantes:

  • Tous les droits de contrôle des accès ultraprécis SELECT, INSERT ou UPDATE sont attribués directement sur la colonne au rôle de base de données actuel, aux rôles auxquels appartient le rôle de base de données actuel ou à public.
  • Tous les droits de contrôle des accès ultraprécis SELECT, INSERT ou UPDATE sont accordés dans la table contenant la colonne au niveau du rôle de base de données actuel, aux rôles auxquels appartient ce rôle ou à public.
Nom de la colonne Type Description
TABLE_CATALOG STRING Non utilisé. Toujours une chaîne vide.
TABLE_SCHEMA STRING Non utilisé. Toujours une chaîne vide.
TABLE_NAME STRING Nom de la table.
COLUMN_NAME STRING Nom de la colonne.
ORDINAL_POSITION INT64 Position ordinale de la colonne dans la table, commençant par la valeur 1.
COLUMN_DEFAULT STRING

Représentation sous forme de chaîne de l'expression SQL pour la valeur par défaut de la colonne. NULL si la colonne n'a pas de valeur par défaut.

Remarque:Avant mars 2022, COLUMN_DEFAULT utilisait le type BYTES.

DATA_TYPE STRING Inclus pour respecter la norme SQL. Toujours NULL. Voir la colonne SPANNER_TYPE
IS_NULLABLE STRING Chaîne qui indique si la colonne peut être vide. Conformément à la norme SQL, la chaîne est YES ou NO, et non une valeur booléenne.
SPANNER_TYPE STRING Type de données de la colonne.
IS_GENERATED STRING Chaîne qui indique si la colonne est générée. La chaîne peut être soit ALWAYS pour une colonne générée, soit NEVER pour une colonne non générée.
GENERATION_EXPRESSION STRING Chaîne représentant l'expression SQL d'une colonne générée. NULL si la colonne n'est pas une colonne générée.
IS_STORED STRING Chaîne qui indique si la colonne générée est stockée. La chaîne est toujours YES pour les colonnes générées et NULL pour les colonnes non générées.
SPANNER_STATE STRING État actuel de la colonne. Une nouvelle colonne générée stockée dans une table existante peut passer par plusieurs états observables par l'utilisateur avant d'être entièrement utilisable. Les valeurs possibles du champ sont les suivantes :
  • WRITE_ONLY : la colonne est en cours de remplissage. Aucune lecture n'est autorisée.
  • COMMITTED : la colonne est entièrement utilisable.

COLUMN_PRIVILEGES

Ce tableau filtré par ligne répertorie tous les droits accordés au niveau des colonnes à n'importe quel rôle de base de données, y compris public. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant d'un accès au rôle système spanner_info_reader ou aux membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les droits des colonnes répondant à l'une des exigences suivantes:

  • Tous les droits de contrôle des accès ultraprécis SELECT, INSERT ou UPDATE sont attribués directement sur la colonne au rôle de base de données actuel, aux rôles auxquels appartient le rôle de base de données actuel ou à public.
  • Tous les droits de contrôle des accès ultraprécis SELECT, INSERT ou UPDATE sont accordés dans la table contenant la colonne au niveau du rôle de base de données actuel, aux rôles auxquels appartient ce rôle ou à public.
Nom de la colonne Type Description
TABLE_CATALOG STRING Non utilisé. Toujours une chaîne vide.
TABLE_SCHEMA STRING Non utilisé. Toujours une chaîne vide.
TABLE_NAME STRING Nom de la table qui contient la colonne privilégiée.
COLUMN_NAME STRING Nom de la colonne privilégiée.
PRIVILEGE_TYPE STRING SELECT, INSERT et UPDATE
GRANTEE STRING Nom du rôle de base de données auquel ce droit est accordé.

TABLE_PRIVILEGES

Ce tableau filtré par ligne répertorie tous les droits accordés au niveau de la table aux rôles de base de données, y compris public. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant d'un accès au rôle système spanner_info_reader ou aux membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les droits des tables sur lesquelles des droits de contrôle des accès ultraprécis SELECT, INSERT, UPDATE ou DELETE ont été accordés au rôle de base de données actuel, aux rôles auxquels ce rôle de base de données actuel appartient ou à public.

Nom de la colonne Type Description
TABLE_CATALOG STRING Non utilisé. Toujours une chaîne vide.
TABLE_SCHEMA STRING Non utilisé. Toujours une chaîne vide.
TABLE_NAME STRING Nom de la table sur laquelle les droits de contrôle des accès ultraprécis sont accordés.
PRIVILEGE_TYPE STRING Au choix : SELECT, INSERT, UPDATE ou DELETE
GRANTEE STRING Nom du rôle de base de données auquel ce droit est accordé.

TABLE_CONSTRAINTS

Ce tableau contient une ligne pour chaque contrainte définie pour les tables de la base de données.

Nom de la colonne Type Description
CONSTRAINT_CATALOG STRING Toujours une chaîne vide.
CONSTRAINT_SCHEMA STRING Nom du schéma de la contrainte. Chaîne vide si elle n'est pas nommée.
CONSTRAINT_NAME STRING Nom de la contrainte.
TABLE_CATALOG STRING Nom du catalogue de la table avec des contraintes. Toujours une chaîne vide.
TABLE_SCHEMA STRING Nom du schéma de la table avec des contraintes. Chaîne vide si elle n'est pas nommée.
TABLE_NAME STRING Nom de la table avec des contraintes.
CONSTRAINT_TYPE STRING Type de la contrainte. Les valeurs possibles du champ sont les suivantes :
  • PRIMARY KEY
  • FOREIGN KEY
  • CHECK
  • UNIQUE
IS_DEFERRABLE STRING Toujours NO.
INITIALLY_DEFERRED STRING Toujours NO.
ENFORCED STRING Toujours YES.

CONSTRAINT_TABLE_USAGE

Ce tableau répertorie les tables qui définissent des contraintes ou sont utilisées par celles-ci. Inclut les tables qui définissent les contraintes PRIMARY KEY et UNIQUE. Inclut également les tables référencées des définitions FOREIGN KEY.

Nom de la colonne Type Description
TABLE_CATALOG STRING Nom du catalogue de la table avec des contraintes. Toujours une chaîne vide.
TABLE_SCHEMA STRING Nom du schéma de la table avec des contraintes. Chaîne vide si elle n'est pas nommée.
TABLE_NAME STRING Nom de la table avec des contraintes.
CONSTRAINT_CATALOG STRING Nom du catalogue de la contrainte. Toujours une chaîne vide.
CONSTRAINT_SCHEMA STRING Nom du schéma de la contrainte. Chaîne vide si elle n'est pas nommée.
CONSTRAINT_NAME STRING Nom de la contrainte.

REFERENTIAL_CONSTRAINTS

Ce tableau contient une ligne pour chaque contrainte FOREIGN KEY.

Nom de la colonne Type Description
CONSTRAINT_CATALOG STRING Nom du catalogue de la clé étrangère. Toujours une chaîne vide.
CONSTRAINT_SCHEMA STRING Nom du schéma de la clé étrangère. Chaîne vide si elle n'est pas nommée.
CONSTRAINT_NAME STRING Nom de la clé étrangère.
UNIQUE_CONSTRAINT_CATALOG STRING Nom de catalogue de la contrainte PRIMARY KEY ou UNIQUE à la clé FOREIGN KEY. Toujours une chaîne vide.
UNIQUE_CONSTRAINT_SCHEMA STRING Nom de schéma de la contrainte PRIMARY KEY ou UNIQUE à la clé FOREIGN KEY. Chaîne vide si elle n'est pas nommée.
UNIQUE_CONSTRAINT_NAME STRING Nom de la contrainte PRIMARY KEY ou UNIQUE à la clé FOREIGN KEY.
MATCH_OPTION STRING Toujours SIMPLE.
UPDATE_RULE STRING Toujours NO ACTION.
DELETE_RULE STRING CASCADE ou NO ACTION.
SPANNER_STATE STRING État actuel de la clé étrangère. Spanner ne commence à appliquer la contrainte qu'une fois que les index de sauvegarde de la clé étrangère sont créés et remplis. Une fois les index prêts, Spanner commence à appliquer la contrainte pour les nouvelles transactions pendant qu'il valide les données existantes. Voici les valeurs possibles et les états qu'elles représentent :
  • BACKFILLING_INDEXES : les index sont en cours de remplissage.
  • VALIDATING_DATA: les données existantes et les nouvelles écritures sont en cours de validation.
  • WAITING_FOR_COMMIT: les opérations groupées de clé étrangère ont abouti ou n'étaient pas nécessaires, mais la clé étrangère est toujours en attente.
  • COMMITTED : la modification du schéma a été validée.

CHECK_CONSTRAINTS

La table information_schema.CHECK_CONSTRAINTS contient une ligne pour chaque contrainte CHECK définie par le mot clé CHECK ou NOT NULL.

Nom de la colonne Type Description
CONSTRAINT_CATALOG STRING Nom du catalogue de la contrainte. Cette colonne n'est jamais nulle, mais correspond toujours à une chaîne vide.
CONSTRAINT_SCHEMA STRING Nom du schéma de la contrainte. Chaîne vide si elle n'est pas nommée.
CONSTRAINT_NAME STRING Nom de la contrainte. Cette colonne n'est jamais nulle. S'il n'est pas explicitement spécifié dans la définition du schéma, un nom défini par le système est attribué.
CHECK_CLAUSE STRING Expressions de la contrainte CHECK. Cette colonne n'est jamais nulle.
SPANNER_STATE STRING État actuel de la contrainte CHECK. Cette colonne n'est jamais nulle. Les états possibles sont les suivants :
  • VALIDATING: Spanner valide les données existantes.
  • COMMITTED : il n'existe aucune modification de schéma active pour cette contrainte.

KEY_COLUMN_USAGE

Ce tableau filtré par ligne contient une ligne pour chaque colonne des tables de TABLE_CONSTRAINTS qui sont limitées en tant que clés par une contrainte PRIMARY KEY, FOREIGN KEY ou UNIQUE. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant d'un accès au rôle système spanner_info_reader ou aux membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent afficher que les colonnes correspondant aux critères suivants:

  • Tous les droits de contrôle des accès ultraprécis SELECT, INSERT ou UPDATE sont attribués directement sur la colonne au rôle de base de données actuel, aux rôles auxquels appartient le rôle de base de données actuel ou à public.
  • Tous les droits de contrôle des accès ultraprécis SELECT, INSERT ou UPDATE sont accordés dans la table contenant la colonne au niveau du rôle de base de données actuel, aux rôles auxquels appartient ce rôle ou à public.
Nom de la colonne Type Description
CONSTRAINT_CATALOG STRING Nom du catalogue de la contrainte. Toujours une chaîne vide.
CONSTRAINT_SCHEMA STRING Nom du schéma de la contrainte. Cette colonne n'est jamais nulle. Chaîne vide si aucun nom n'est spécifié.
CONSTRAINT_NAME STRING Nom de la contrainte.
TABLE_CATALOG STRING Nom du catalogue de la colonne avec des contraintes. Toujours une chaîne vide.
TABLE_SCHEMA STRING Nom du schéma de la colonne avec des contraintes. Cette colonne n'est jamais nulle. Chaîne vide si elle n'est pas nommée.
TABLE_NAME STRING Nom de la table de la colonne avec des contraintes.
COLUMN_NAME STRING Nom de la colonne.
ORDINAL_POSITION INT64 Position ordinale de la colonne dans la clé de la contrainte, commençant par la valeur 1.
POSITION_IN_UNIQUE_CONSTRAINT INT64 Pour les valeurs FOREIGN KEY, il s'agit de la position ordinale de la colonne dans la contrainte unique, commençant par la valeur 1. Cette colonne est nulle pour les autres types de contraintes.

CONSTRAINT_COLUMN_USAGE

Ce tableau contient une ligne pour chaque colonne utilisée par une contrainte. Inclut les colonnes PRIMARY KEY et UNIQUE, ainsi que les colonnes référencées de contraintes FOREIGN KEY.

Nom de la colonne Type Description
TABLE_CATALOG STRING Nom du catalogue de la table de la colonne. Toujours une chaîne vide.
TABLE_SCHEMA STRING Nom du schéma de la table de la colonne. Cette colonne n'est jamais nulle. Chaîne vide si aucun nom n'est spécifié.
TABLE_NAME STRING Nom de la table de la colonne.
COLUMN_NAME STRING Nom de la colonne utilisée par la contrainte.
CONSTRAINT_CATALOG STRING Nom du catalogue de la contrainte. Toujours une chaîne vide.
CONSTRAINT_SCHEMA STRING Nom du schéma de la contrainte. Chaîne vide si elle n'est pas nommée.
CONSTRAINT_NAME STRING Nom de la contrainte.

TABLE_SYNONYMS

Ce tableau répertorie les informations relatives aux synonymes du tableau.

Nom de la colonne Type Description
TABLE_CATALOG STRING Non utilisé. Toujours une chaîne vide.
TABLE_SCHEMA STRING Non utilisé. Toujours une chaîne vide.
TABLE_NAME STRING Nom de la table.
SYNONYM_CATALOG STRING Nom du catalogue pour le synonyme.
SYNONYM_SCHEMA STRING Nom du schéma pour le synonyme.
SYNONYM_TABLE_NAME STRING Nom de la table pour le synonyme.

INDEXES

Ce tableau filtré par ligne répertorie les index de la base de données. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant du rôle système spanner_info_reader ou des membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent afficher que les index qui répondent à l'une des exigences suivantes:

  • Tous les droits de contrôle des accès précis SELECT, INSERT ou UPDATE sont accordés au niveau des colonnes sur toutes les colonnes de l'index, avec le rôle de base de données actuel, les rôles auxquels le rôle de base de données actuel appartient ou à public.
  • Tous les droits SELECT, INSERT, UPDATE ou DELETE pour le contrôle des accès précis sont accordés sur la table qui possède l'index du rôle de base de données actuel, aux rôles auxquels ce rôle de base de données actuel appartient, ou à public.
Nom de la colonne Type Description
TABLE_CATALOG STRING Nom du catalogue. Toujours une chaîne vide.
TABLE_SCHEMA STRING Nom du schéma. Chaîne vide si elle n'est pas nommée.
TABLE_NAME STRING Nom de la table.
INDEX_NAME STRING Nom de l'index. Les tables avec une spécification PRIMARY KEY comportent une entrée de pseudo-index générée avec le nom PRIMARY_KEY, ce qui permet de déterminer les champs de la clé primaire.
INDEX_TYPE STRING Type d'index. Le type est INDEX ou PRIMARY_KEY.
PARENT_TABLE_NAME STRING Les index secondaires peuvent être entrelacés dans une table parente, comme indiqué dans la section Créer un index secondaire. Cette colonne contient le nom de la table parente ou une chaîne vide si l'index n'est pas entrelacé.
IS_UNIQUE BOOL Si les clés d'index doivent être uniques.
IS_NULL_FILTERED BOOL Si l'index inclut des entrées dotées de valeurs NULL.
INDEX_STATE STRING État actuel de l'index. Les valeurs possibles et les états qu'elles représentent sont les suivantes :
  • PREPARE : créer des tables vides pour un nouvel index.
  • WRITE_ONLY : remplir des données pour un nouvel index.
  • WRITE_ONLY_CLEANUP : nettoyer un nouvel index.
  • WRITE_ONLY_VALIDATE_UNIQUE: vérifier l'unicité des données dans un nouvel index.
  • READ_WRITE : opération d'index normale.
SPANNER_IS_MANAGED BOOL TRUE si l'index est géré par Spanner ; sinon, FALSE. Les index de sauvegarde secondaires pour les clés étrangères sont gérés par Spanner.

INDEX_COLUMNS

Ce tableau filtré par ligne répertorie les colonnes d'un index. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant du rôle système spanner_info_reader ou des membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent afficher que les index qui répondent à l'une des exigences suivantes:

  • Tous les droits de contrôle des accès précis SELECT, INSERT ou UPDATE sont accordés au niveau des colonnes sur toutes les colonnes de l'index, avec le rôle de base de données actuel, les rôles auxquels le rôle de base de données actuel appartient ou à public.
  • Tous les droits SELECT, INSERT ou UPDATE pour le contrôle des accès ultraprécis sont accordés sur la table indexant le rôle de base de données actuel, aux rôles auxquels appartient le rôle de base de données actuel, ou à public.
Nom de la colonne Type Description
TABLE_CATALOG STRING Nom du catalogue. Toujours une chaîne vide.
TABLE_SCHEMA STRING Nom du schéma. Chaîne vide si elle n'est pas nommée.
TABLE_NAME STRING Nom de la table.
INDEX_NAME STRING Nom de l'index.
COLUMN_NAME STRING Nom de la colonne.
ORDINAL_POSITION INT64 Position ordinale de la colonne dans l'index (ou clé primaire), commençant par la valeur 1. Cette valeur est NULL pour les colonnes non clés (par exemple, les colonnes spécifiées dans la clause STORING d'un index).
COLUMN_ORDERING STRING Ordre de la colonne. La valeur est ASC ou DESC pour les colonnes de clé, et NULL pour les colonnes non de clé (par exemple, les colonnes spécifiées dans la clause STORING d'un index).
IS_NULLABLE STRING Chaîne qui indique si la colonne peut être vide. Conformément à la norme SQL, la chaîne est YES ou NO, et non une valeur booléenne.
SPANNER_TYPE STRING Type de données de la colonne.

COLUMN_OPTIONS

Ce tableau filtré par ligne répertorie les options de colonnes dans un tableau. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant du rôle système spanner_info_reader ou des membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir les options que pour les colonnes qui répondent à l'une des exigences suivantes:

  • Tous les droits de contrôle des accès ultraprécis SELECT, INSERT ou UPDATE sont attribués directement sur la colonne au rôle de base de données actuel, aux rôles auxquels appartient le rôle de base de données actuel ou à public.
  • Tous les droits de contrôle des accès ultraprécis SELECT, INSERT ou UPDATE sont accordés dans la table contenant la colonne au niveau du rôle de base de données actuel, aux rôles auxquels appartient ce rôle ou à public.
Nom de la colonne Type Description
TABLE_CATALOG STRING Nom du catalogue. Toujours une chaîne vide.
TABLE_SCHEMA STRING Nom du schéma. Le nom est vide pour le schéma par défaut et non vide pour les autres schémas (par exemple, INFORMATION_SCHEMA). Cette colonne n'est jamais nulle.
TABLE_NAME STRING Nom de la table.
COLUMN_NAME STRING Nom de la colonne.
OPTION_NAME STRING Identifiant SQL qui identifie l'option de manière unique. Il est la clé de la clause OPTIONS en DDL.
OPTION_TYPE STRING Nom de type de données qui correspond au type de cette valeur d'option.
OPTION_VALUE STRING Littéral SQL décrivant la valeur de cette option. La valeur de cette colonne doit être analysable dans le cadre d'une requête. L'expression obtenue à partir de l'analyse de la valeur doit pouvoir être convertie en OPTION_TYPE. Cette colonne n'est jamais nulle.

SEQUENCES

Ce tableau liste les métadonnées des séquences. SEQUENCES est filtré par ligne en fonction des droits d'accès précis si un utilisateur disposant de droits d'accès précis l'interroge.

Nom de la colonne Type Description
CATALOG STRING Nom du catalogue contenant la séquence.
SCHEMA STRING Nom du schéma contenant la séquence.
NAME STRING Nom de la séquence.
DATA_TYPE STRING Type de valeurs séquentielles. Elle utilise le type de données INT64.

SEQUENCE_OPTIONS

Ce tableau contient les options de configuration des séquences. SEQUENCE_OPTIONS est filtré par ligne en fonction des privilèges d'accès précis si un utilisateur disposant de droits d'accès précis l'interroge.

Nom de la colonne Type Description
CATALOG STRING Nom du catalogue contenant la séquence.
SCHEMA STRING Nom du schéma contenant la séquence.
NAME STRING Nom de la séquence.
OPTION_NAME STRING Nom de l'option de séquence.
OPTION_TYPE STRING Nom de type de données qui correspond au type de cette valeur d'option.
OPTION_VALUE STRING Valeur de l'option de séquence. L'expression résultant de l'analyse de la valeur doit autoriser la conversion en OPTION_TYPE.

SPANNER_STATISTICS

Ce tableau répertorie les packages de statistiques disponibles pour l'optimiseur de requêtes.

Nom de la colonne Type Description
CATALOG_NAME STRING Nom du catalogue. Toujours une chaîne vide.
SCHEMA_NAME STRING Nom du schéma. Le nom est vide pour le schéma par défaut et non vide pour les autres schémas (par exemple, INFORMATION_SCHEMA). Cette colonne n'est jamais nulle.
PACKAGE_NAME STRING Nom du package de statistiques.
ALLOW_GC BOOL FALSE si le package de statistiques est exempté de la récupération de mémoire ; sinon, TRUE.
Cet attribut doit être défini sur FALSE afin de référencer le package de statistiques dans un indice ou via l'API cliente.

VIEWS

Ce tableau filtré par ligne répertorie les vues de la base de données. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant du rôle système spanner_info_reader ou des membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent afficher que les vues pour lesquelles le droit de contrôle des accès ultraprécis SELECT est accordé au rôle de base de données actuel, aux rôles auxquels ce rôle de base de données actuel appartient ou à public.

Nom de la colonne Type Description
TABLE_CATALOG STRING Nom du catalogue. Toujours une chaîne vide.
TABLE_SCHEMA STRING Nom du schéma. Chaîne vide si elle n'est pas nommée.
TABLE_NAME STRING Nom de la vue.
VIEW_DEFINITION STRING Texte SQL de la requête qui définit la vue.
SECURITY_TYPE STRING Type de sécurité de la vue. INVOKER ou DEFINER.

Pour en savoir plus, consultez À propos des vues.

ROLES

Ce tableau filtré par ligne répertorie les rôles de base de données définis pour un contrôle des accès précis, y compris les rôles système. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant du rôle système spanner_info_reader ou des membres de ce rôle peuvent afficher tous les rôles de base de données. Tous les autres comptes principaux ne peuvent voir que les rôles de base de données auxquels ils ont accès, directement ou par héritage.

Nom de la colonne Type Description
ROLE_NAME STRING Nom du rôle de base de données.
IS_SYSTEM BOOL TRUE si le rôle de base de données est un rôle système ; FALSE dans le cas contraire.

ROLE_GRANTEES

Cette table filtrée par lignes répertorie toutes les appartenances aux rôles explicitement accordées à tous les rôles de base de données. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant d'un accès au rôle système spanner_info_reader ou aux membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les appartenances aux rôles attribués au rôle de base de données actuel ou à un rôle auquel appartient ce rôle de base de données.

Étant donné que tous les rôles de base de données sont membres du rôle public, les résultats omettent les enregistrements pour l'appartenance implicite au rôle public.

Nom de la colonne Type Description
ROLE_NAME STRING Nom du rôle de base de données auquel cet membre est accordé.
GRANTEE STRING Nom du rôle de base de données auquel cet membre est accordé.

CHANGE_STREAMS

Ce tableau filtré par ligne répertorie tous les flux de modifications d'une base de données et indique ceux qui permettent d'effectuer le suivi de l'intégralité de la base de données par rapport à des tables ou colonnes spécifiques. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant du rôle système spanner_info_reader ou des membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les flux de modifications pour lesquels le droit de contrôle des accès ultraprécis SELECT est accordé au rôle de base de données actuel, aux rôles auxquels le rôle de base de données actuel appartient ou à public.

Nom de la colonne Type Description
CHANGE_STREAM_CATALOG STRING Nom du catalogue du flux de modifications. Toujours une chaîne vide.
CHANGE_STREAM_SCHEMA STRING Nom du schéma de ce flux de modifications. Toujours une chaîne vide.
CHANGE_STREAM_NAME STRING Nom du flux de modifications.
ALL BOOL TRUE si ce flux de modifications suit l'intégralité de la base de données. FALSE si ce flux de modifications suit des tables ou des colonnes spécifiques.

CHANGE_STREAM_TABLES

Cette table filtrée par ligne contient des informations sur les tables et les flux de modifications qui les surveillent. Chaque ligne décrit une table et un flux de modifications. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant du rôle système spanner_info_reader ou des membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les lignes des flux de modifications sur lesquels le droit SELECT est accordé au rôle de base de données actuel, aux rôles auxquels le rôle de base de données actuel appartient ou à public.

Les données dans CHANGE_STREAM_TABLES n'incluent pas les relations implicites entre les tables et les flux de modifications qui suivent l'intégralité de la base de données.

Nom de la colonne Type Description
CHANGE_STREAM_CATALOG STRING Nom du catalogue du flux de modifications. Toujours une chaîne vide.
CHANGE_STREAM_SCHEMA STRING Nom du schéma du flux de modifications. Toujours une chaîne vide.
CHANGE_STREAM_NAME STRING Nom du flux de modifications auquel cette ligne fait référence.
TABLE_CATALOG STRING Nom du catalogue de la table. Toujours une chaîne vide.
TABLE_SCHEMA STRING Nom du schéma de la table. Toujours une chaîne vide.
TABLE_NAME STRING Nom de la table à laquelle cette ligne fait référence.
ALL_COLUMNS BOOL TRUE si le flux de modifications de cette ligne suit l'intégralité de la table à laquelle cette ligne fait référence. Dans le cas contraire, FALSE.

CHANGE_STREAM_COLUMNS

Cette table filtrée par ligne contient des informations sur les colonnes de la table et les flux de modifications qui les surveillent. Chaque ligne décrit un flux de modifications et une colonne. Si un flux de modifications suit une table entière, les colonnes de cette table ne s'affichent pas dans cette vue.

Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant d'un accès au rôle système spanner_info_reader ou aux membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les lignes des flux de modifications pour lesquels le droit SELECT est accordé au rôle de base de données actuel, aux rôles auxquels appartient le rôle de base de données actuel ou à public.

Nom de la colonne Type Description
CHANGE_STREAM_CATALOG STRING Nom du catalogue du flux de modifications. Toujours une chaîne vide.
CHANGE_STREAM_SCHEMA STRING Nom du schéma du flux de modifications. Toujours une chaîne vide.
CHANGE_STREAM_NAME STRING Nom du flux de modifications.
TABLE_CATALOG STRING Nom du catalogue de la table. Toujours une chaîne vide.
TABLE_SCHEMA STRING Nom du schéma de la table. Toujours une chaîne vide.
TABLE_NAME STRING Nom de la table à laquelle cette ligne fait référence.
COLUMN_NAME STRING Nom de la colonne à laquelle cette ligne fait référence.

CHANGE_STREAM_OPTIONS

Ce tableau filtré par ligne contient les options de configuration pour les flux de modifications. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant d'un accès au rôle système spanner_info_reader ou aux membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les options des flux de modifications pour lesquels le droit SELECT est accordé au rôle de base de données actuel, aux rôles auxquels le rôle de base de données actuel appartient ou à public.

Nom de la colonne Type Description
CHANGE_STREAM_CATALOG STRING Nom du catalogue du flux de modifications. Toujours une chaîne vide.
CHANGE_STREAM_SCHEMA STRING Nom du schéma du flux de modifications. Toujours une chaîne vide.
CHANGE_STREAM_NAME STRING Nom du flux de modifications.
OPTION_NAME STRING Nom de l'option de flux de modifications.
OPTION_TYPE STRING Type de données de l'option de flux de modifications.
OPTION_VALUE STRING Valeur de l'option de flux de modifications.

CHANGE_STREAM_PRIVILEGES

Ce tableau filtré par ligne répertorie tous les droits de contrôle des accès précis accordés sur tous les flux de modifications dans n'importe quel rôle de base de données, y compris public. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant du rôle système spanner_info_reader ou des membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les droits accordés sur les flux de modifications au rôle de base de données actuel, aux rôles auxquels appartient le rôle de base de données actuel, ou à public.

Nom de la colonne Type Description
CHANGE_STREAM_CATALOG STRING Nom du catalogue contenant le flux de modifications (chaîne vide).
CHANGE_STREAM_SCHEMA STRING Nom du schéma contenant le flux de modifications (une chaîne vide).
CHANGE_STREAM_NAME STRING Nom du flux de modifications.
PRIVILEGE_TYPE STRING SELECT (seul droit autorisé pour les flux de modifications).
GRANTEE STRING Nom du rôle de base de données auquel ce droit est accordé.

ROUTINES

Ce tableau filtré par ligne répertorie toutes les fonctions de lecture du flux de modifications d'une base de données. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant d'un accès au rôle système spanner_info_reader ou aux membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les fonctions de lecture du flux de modifications pour lesquelles le droit précis de contrôle des accès EXECUTE est accordé au rôle de base de données actuel, aux rôles dont il fait partie, ou à public.

Nom de la colonne Type Description
SPECIFIC_CATALOG STRING Nom du catalogue de la routine. Toujours une chaîne vide.
SPECIFIC_SCHEMA STRING Nom du schéma de la routine. Toujours une chaîne vide.
SPECIFIC_NAME STRING Nom de la routine. Identifie la routine de manière unique, même si son nom est surchargé.
ROUTINE_CATALOG STRING Nom du catalogue de la routine. Toujours une chaîne vide.
ROUTINE_SCHEMA STRING Nom du schéma de la routine. Toujours une chaîne vide.
ROUTINE_NAME STRING Nom de la routine. (Peut être dupliqué en cas de surcharge.)
ROUTINE_TYPE STRING Type de la routine (FUNCTION ou PROCEDURE). Toujours FUNCTION
DATA_TYPE STRING Type de données renvoyé par la routine
ROUTINE_BODY STRING Type du corps de la routine (SQL ou EXTERNAL).
ROUTINE_DEFINITION STRING Définition de ROUTINE_BODY.
SECURITY_TYPE STRING Type de sécurité de la routine. Toujours INVOKER.

ROUTINE_OPTIONS

Cette table filtrée par ligne contient une ligne pour chaque option, pour chaque fonction de lecture du flux de modifications définie.

Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant d'un accès au rôle système spanner_info_reader ou aux membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les options des fonctions de lecture de flux de modifications pour lesquelles le droit de contrôle des accès ultraprécis EXECUTE est accordé au rôle de base de données actuel, aux rôles auxquels ce rôle de base de données actuel appartient, ou à public.

Nom de la colonne Type Description
SPECIFIC_CATALOG STRING Nom du catalogue de la routine. Toujours une chaîne vide.
SPECIFIC_SCHEMA STRING Nom du schéma de la routine. Toujours une chaîne vide.
SPECIFIC_NAME STRING Nom de la routine. Identifie la routine de manière unique en cas de surcharge de noms.
OPTION_NAME STRING Identifiant SQL qui identifie l'option de manière unique.
OPTION_TYPE STRING Type de données de OPTION_VALUE.
OPTION_VALUE STRING Littéral SQL décrivant la valeur de cette option. La valeur de cette colonne doit pouvoir être analysée dans le cadre d'une requête.

PARAMETERS

Ce tableau filtré par ligne définit les arguments de chaque fonction de lecture du flux de modifications. Chaque ligne décrit un argument pour une fonction de lecture du flux de modifications.

Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant d'un accès au rôle système spanner_info_reader ou aux membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les paramètres des fonctions de lecture de flux de modifications pour lesquels le droit de contrôle des accès ultraprécis EXECUTE est accordé au rôle de base de données actuel, aux rôles auxquels ce rôle de base de données actuel appartient, ou à public.

Nom de la colonne Type Description
SPECIFIC_CATALOG STRING Nom du catalogue de la routine. Toujours une chaîne vide.
SPECIFIC_SCHEMA STRING Nom du schéma de la routine. Toujours une chaîne vide.
SPECIFIC_NAME STRING Nom de la routine. Identifie la routine de manière unique en cas de surcharge de noms.
ORDINAL_POSITION INT64 Position ordinale du paramètre dans la routine, commençant par la valeur 1.
PARAMETER_NAME STRING Nom du paramètre.
DATA_TYPE STRING Type de données du paramètre.

ROUTINE_PRIVILEGES

Ce tableau filtré par ligne répertorie tous les droits de contrôle des accès précis accordés pour toutes les fonctions de lecture du flux de modifications dans n'importe quel rôle de base de données, y compris public. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant d'un accès au rôle système spanner_info_reader ou aux membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les droits accordés sur les fonctions de lecture de flux de modifications au rôle de base de données actuel, aux rôles auxquels appartient le rôle de base de données actuel, ou à public.

Nom de la colonne Type Description
SPECIFIC_CATALOG STRING Nom du catalogue de la routine. Toujours une chaîne vide.
SPECIFIC_SCHEMA STRING Nom du schéma de la routine. Toujours une chaîne vide.
SPECIFIC_NAME STRING Nom de la routine. Identifie la routine de manière unique en cas de surcharge de noms.
PRIVILEGE_TYPE STRING Toujours EXECUTE.
GRANTEE STRING Nom du rôle de base de données auquel ce droit est accordé.

ROLE_TABLE_GRANTS

Ce tableau filtré par ligne répertorie tous les droits de contrôle des accès précis accordés sur toutes les tables et vues à n'importe quel rôle de base de données, y compris public. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant du rôle système spanner_info_reader ou des membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les droits accordés sur les tables et les vues au rôle de base de données actuel et aux rôles auxquels ce rôle de base de données actuel appartient, à l'exclusion de public.

Nom de colonne Type Description
GRANTOR STRING Non utilisé. Toujours NULL.
GRANTEE STRING Nom du rôle de base de données auquel ce droit est accordé.
TABLE_CATALOG STRING Non utilisé. Toujours une chaîne vide.
TABLE_SCHEMA STRING Non utilisé. Toujours une chaîne vide.
TABLE_NAME STRING Nom de la table ou de la vue.
PRIVILEGE_TYPE STRING Type du droit (SELECT, INSERT, UPDATE ou DELETE).
IS_GRANTABLE STRING Non utilisé. Toujours NO.

ROLE_COLUMN_GRANTS

Ce tableau filtré par ligne répertorie tous les droits de contrôle des accès précis accordés sur toutes les colonnes à n'importe quel rôle de base de données, y compris public. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant du rôle système spanner_info_reader ou des membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les droits accordés sur les colonnes au rôle de base de données actuel et aux rôles dont ce rôle fait partie, à l'exclusion de public.

La vue inclut les droits SELECT, INSERT et UPDATE dont la colonne hérite de la table ou de la vue contenant la colonne.

Nom de colonne Type Description
GRANTOR STRING Non utilisé. Toujours NULL.
GRANTEE STRING Nom du rôle de base de données auquel ce droit est accordé.
TABLE_CATALOG STRING Non utilisé. Toujours une chaîne vide.
TABLE_SCHEMA STRING Non utilisé. Toujours une chaîne vide.
TABLE_NAME STRING Nom de la table ou de la vue contenant la colonne.
COLUMN_NAME STRING Nom de la colonne pour laquelle le droit est accordé.
PRIVILEGE_TYPE STRING Type du droit (SELECT, INSERT ou UPDATE).
IS_GRANTABLE STRING Non utilisé. Toujours NO.

ROLE_CHANGE_STREAM_GRANTS

Ce tableau filtré par ligne répertorie les droits SELECT accordés sur tous les flux de modifications dans n'importe quel rôle de base de données, y compris public. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant du rôle système spanner_info_reader ou des membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les droits accordés sur les flux de modifications au rôle de base de données actuel et aux rôles auxquels appartient le rôle de base de données actuel, à l'exclusion de public.

Nom de colonne Type Description
CHANGE_STREAM_CATALOG STRING Non utilisé. Toujours une chaîne vide.
CHANGE_STREAM_SCHEMA STRING Nom du schéma contenant le flux de modifications.
CHANGE_STREAM_NAME STRING Nom du flux de modifications.
PRIVILEGE_TYPE STRING Type de droit (SELECT uniquement).
GRANTEE STRING Nom du rôle de base de données auquel ce droit est accordé.

ROLE_MODEL_GRANTS

Ce tableau filtré par ligne répertorie tous les droits de contrôle des accès précis accordés sur tous les modèles à n'importe quel rôle de base de données, y compris public. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant du rôle système spanner_info_reader ou des membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les droits accordés sur les tables et les vues au rôle de base de données actuel et aux rôles auxquels ce rôle de base de données actuel appartient, à l'exclusion de public.

Nom de colonne Type Description
GRANTOR STRING Non utilisé. Toujours NULL.
GRANTEE STRING Nom du rôle de base de données auquel ce droit est accordé.
MODEL_CATALOG STRING Non utilisé. Toujours une chaîne vide.
MODEL_SCHEMA STRING Non utilisé. Toujours une chaîne vide.
MODEL_NAME STRING Nom du modèle.
PRIVILEGE_TYPE STRING Type de droit (EXECUTE).
IS_GRANTABLE STRING Non utilisé. Toujours NO.

ROLE_ROUTINE_GRANTS

Ce tableau filtré par ligne répertorie les droits EXECUTE accordés pour toutes les fonctions de lecture du flux de modifications dans n'importe quel rôle de base de données, y compris public. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant d'un accès au rôle système spanner_info_reader ou aux membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les droits accordés sur les fonctions de lecture de flux de modifications au rôle de base de données actuel et aux rôles auxquels ce rôle de base de données actuel appartient, à l'exclusion de public.

Nom de la colonne Type Description
GRANTOR STRING Non utilisé. Toujours NULL.
GRANTEE STRING Nom du rôle auquel le droit est accordé.
SPECIFIC_CATALOG STRING Nom du catalogue de routines.
SPECIFIC_SCHEMA STRING Nom du schéma de routine.
SPECIFIC_NAME STRING Nom de la routine. Identifie la routine de manière unique en cas de surcharge de noms.
PRIVILEGE_TYPE STRING Type de droit accordé. Toujours EXECUTE.
IS_GRANTABLE STRING Non utilisé. Toujours NO.

MODELS

Ce tableau répertorie tous les modèles d'une base de données.

Nom de la colonne Type Description
MODEL_CATALOG STRING Nom du catalogue. Toujours une chaîne vide.
MODEL_SCHEMA STRING Nom du schéma de ce modèle. Toujours une chaîne vide.
MODEL_NAME STRING Nom du modèle.
IS_REMOTE BOOL TRUE s'il s'agit d'un modèle distant. FALSE s'il s'agit d'un modèle géré.

MODEL_OPTIONS

Ce tableau contient les options de configuration des modèles.

Nom de la colonne Type Description
MODEL_CATALOG STRING Nom du catalogue. Toujours une chaîne vide.
MODEL_SCHEMA STRING Nom du schéma de ce modèle. Toujours une chaîne vide.
MODEL_NAME STRING Nom du modèle.
OPTION_NAME STRING Nom de l'option de modèle.
OPTION_TYPE STRING Type de données de l'option de modèle.
OPTION_VALUE STRING Valeur de l'option du modèle.

MODEL_COLUMNS

Ce tableau répertorie les colonnes d'un modèle.

Nom de la colonne Type Description
MODEL_CATALOG STRING Nom du catalogue. Toujours une chaîne vide.
MODEL_SCHEMA STRING Nom du schéma de ce modèle. Toujours une chaîne vide.
MODEL_NAME STRING Nom du modèle.
COLUMN_KIND STRING Genre de la colonne du modèle. Choix possible: "INPUT" ou "OUTPUT".
COLUMN_NAME STRING Nom de la colonne.
DATA_TYPE STRING Type de données SQL standard de la colonne.
ORDINAL_POSITION INT64 Position ordinale de la colonne, commençant par la valeur 1, pour conserver l'ordre des colonnes déclarées.
IS_EXPLICIT BOOL TRUE si la colonne a été spécifiée explicitement dans le LDD et FALSE si la colonne a été découverte à partir du point de terminaison.

MODEL_COLUMN_OPTIONS

Ce tableau contient les options de configuration des colonnes de modèle.

Nom de la colonne Type Description
MODEL_CATALOG STRING Nom du catalogue. Toujours une chaîne vide.
MODEL_SCHEMA STRING Nom du schéma de ce modèle. Toujours une chaîne vide.
MODEL_NAME STRING Nom du modèle.
COLUMN_KIND STRING Genre de la colonne du modèle. Choix possible: "INPUT" ou "OUTPUT".
COLUMN_NAME STRING Nom de la colonne.
OPTION_NAME STRING Nom de l'option de colonne de modèle.
OPTION_TYPE STRING Type de données de l'option de colonne de modèle.
OPTION_VALUE STRING Valeur d'option de la colonne de modèle.

MODEL_PRIVILEGES

Ce tableau filtré par ligne répertorie tous les droits accordés au niveau du modèle aux rôles de base de données, y compris public. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux disposant d'un accès au rôle système spanner_info_reader ou aux membres de ce rôle peuvent afficher toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les droits des modèles pour lesquels le droit de contrôle des accès ultraprécis EXECUTE est accordé au rôle de base de données actuel, aux rôles auxquels appartient le rôle de base de données actuel, ou à public.

Nom de la colonne Type Description
MODEL_CATALOG STRING Non utilisé. Toujours une chaîne vide.
MODEL_SCHEMA STRING Non utilisé. Toujours une chaîne vide.
MODEL_NAME STRING Nom du modèle pour lequel les droits de contrôle des accès ultraprécis sont accordés.
PRIVILEGE_TYPE STRING EXECUTE>
GRANTEE STRING Nom du rôle de base de données auquel ce droit est accordé.

Examples

Renvoie des informations sur chaque table dans le schéma de l'utilisateur :

SELECT
  t.table_name,
  t.parent_table_name
FROM
  information_schema.tables AS t
WHERE
  t.table_catalog = ''
  AND
  t.table_schema = ''
ORDER BY
  t.table_catalog,
  t.table_schema,
  t.table_name

Renvoyez le nom de toutes les tables de INFORMATION_SCHEMA:

SELECT
  t.table_name
FROM
  information_schema.tables AS t
WHERE
  t.table_schema = "SPANNER_SYS"

Renvoie des informations sur les colonnes de la table utilisateur MyTable :

SELECT
  t.column_name,
  t.spanner_type,
  t.is_nullable
FROM
  information_schema.columns AS t
WHERE
  t.table_catalog = ''
  AND
  t.table_schema = ''
  AND
  t.table_name = 'MyTable'
ORDER BY
  t.table_catalog,
  t.table_schema,
  t.table_name,
  t.ordinal_position

Renvoie des informations sur la région principale par défaut de la base de données. La fonction renvoie une valeur vide si la région principale par défaut n'est pas définie :

SELECT
  s.option_name,
  s.option_value
FROM
  information_schema.database_options s
WHERE
  s.option_name = 'default_leader'

Renvoie des informations sur chaque index du schéma de l'utilisateur :

SELECT
  t.table_name,
  t.index_name,
  t.parent_table_name
FROM
  information_schema.indexes AS t
WHERE
  t.table_catalog = ''
  AND
  t.table_schema = ''
  AND
  t.index_type != 'PRIMARY_KEY'
ORDER BY
  t.table_catalog,
  t.table_schema,
  t.table_name,
  t.index_name

Renvoie toutes les colonnes qui utilisent des options autres que celles par défaut :

SELECT
  t.table_name,
  t.column_name,
  t.option_type,
  t.option_value,
  t.option_name
FROM
  information_schema.column_options AS t
WHERE
  t.table_catalog = ''
AND
  t.table_schema = ''

Renvoie les options de base de données actuelles associées à l'optimiseur :

SELECT
  s.option_name,
  s.option_value
FROM
  information_schema.database_options s
WHERE
  s.schema_name=''
  AND s.option_name IN ('optimizer_version',
    'optimizer_statistics_package')

Renvoie tous les packages de statistiques disponibles :

SELECT
  *
FROM
  information_schema.spanner_statistics;

Renvoyer toutes les séquences:

SELECT
  *
FROM
  information_schema.sequences;

Renvoyer toutes les options de séquence pour la séquence nommée "MySequence"

SELECT
  *
FROM
  information_schema.sequence_options WHERE name="MySequence";

Étapes suivantes

  • Découvrez les outils d'introspection disponibles pour vous aider à analyser les problèmes de base de données.