Schéma d'informations pour les bases de données utilisant le 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 section À 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
  • 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:

Filtrage des lignes dans les tables "information_schema"

Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et les comptes principaux 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 d'autres comptes principaux, pour certaines tables, les lignes sont filtrées en fonction du rôle de base de données actuel. Les descriptions de tables et de vues des sections suivantes indiquent comment le filtrage des lignes est appliqué pour chaque table et vue.

Tables dans INFORMATION_Schéma

Les sections suivantes décrivent les tables de la table INFORMATION_SCHEMA pour les bases de données utilisant le dialecte GoogleSQL.

SCHEMATA

La table INFORMATION_SCHEMA.SCHEMATA répertorie les schémas de la base de données. Cela inclut le schéma d'informations et un schéma non nommé (nommé ci-après "schéma par défaut"), qui contient les tables que vous définissez.

Nom de la colonne Type Description
CATALOG_NAME STRING Nom du catalogue. Cette colonne existe pour assurer la compatibilité avec les tables de schéma d'informations standards SQL. Cette colonne correspond toujours à une chaîne vide.
SCHEMA_NAME STRING Nom du schéma. Cette valeur est vide pour le schéma par défaut et non vide pour les schémas nommés.

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 lignes 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, ainsi que les comptes principaux 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 tables répondant à l'une des exigences suivantes:

  • Les droits de contrôle ultraprécis des accès SELECT, INSERT, UPDATE ou DELETE sont accordés sur la table au rôle de base de données actuel, aux rôles dont il est membre ou à public.
  • Les droits SELECT, INSERT ou UPDATE sont accordés sur n'importe quelle colonne de table au rôle de base de données actuel, aux rôles dont le rôle de base de données actuel est membre, 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. Pour en savoir plus, consultez les instructions TABLE.
SPANNER_STATE STRING Une table peut passer par plusieurs états lors de sa création, si des opérations groupées sont impliquées. C'est le cas, par exemple, lorsque la table est créée avec une clé étrangère nécessitant le 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 du schéma pour 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 de l'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 dans cette table peut exister sans tenir compte de la ligne de la table parente.
  • IN PARENT: la table a une relation parent-enfant. Une ligne dans cette table nécessite la présence de la ligne de la table parente.
  • Une chaîne vide indique que cette table n'a pas de relations d'entrelacement.
ROW_DELETION_POLICY_EXPRESSION STRING L'expression textuelle qui définit les règles de suppression de lignes de la table. Exemples : OLDER_THAN(CreatedAt, INTERVAL 1 DAY) ou OLDER_THAN(ExpiredDate, INTERVAL 0 DAY).

COLUMNS

Ce tableau filtré par lignes répertorie les colonnes d'un tableau. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données, ainsi que les comptes principaux 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 colonnes répondant à l'une des exigences suivantes:

  • Tous les droits de contrôle des accès ultraprécis SELECT, INSERT ou UPDATE sont directement accordés dans la colonne au rôle de base de données actuel, aux rôles dont ce rôle est membre, ou à public.
  • Tous les droits SELECT, INSERT ou UPDATE pour le contrôle ultraprécis des accès sont accordés sur la table contenant la colonne au rôle de base de données actuel, aux rôles dont ce rôle est membre 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 de l'expression SQL sous forme de chaîne pour la valeur par défaut de la colonne. NULL si la colonne ne contient 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 soit YES, soit 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

Cette table filtrée sur les lignes répertorie tous les droits accordés au niveau des colonnes pour tout 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 les comptes principaux 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 les droits 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 directement accordés dans la colonne au rôle de base de données actuel, aux rôles dont ce rôle est membre, ou à public.
  • Tous les droits SELECT, INSERT ou UPDATE pour le contrôle ultraprécis des accès sont accordés sur la table contenant la colonne au rôle de base de données actuel, aux rôles dont ce rôle est membre 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

Cette table filtrée sur les lignes répertorie tous les droits accordés au niveau de la table pour les 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 les comptes principaux 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 les droits que pour les tables sur lesquelles l'un des droits de contrôle ultraprécis des accès SELECT, INSERT, UPDATE ou DELETE est accordé au rôle de base de données actuel, aux rôles auxquels ce rôle 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 des droits de contrôle des accès précis sont accordés.
PRIVILEGE_TYPE STRING Peut prendre l'une des valeurs suivantes : 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 du catalogue de la contrainte PRIMARY KEY ou UNIQUE figurant dans la référence FOREIGN KEY. Toujours une chaîne vide.
UNIQUE_CONSTRAINT_SCHEMA STRING Nom de schéma de la contrainte PRIMARY KEY ou UNIQUE figurant dans la référence FOREIGN KEY. Chaîne vide si elle n'est pas nommée.
UNIQUE_CONSTRAINT_NAME STRING Nom de la contrainte PRIMARY KEY ou UNIQUE figurant dans la référence 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 que lorsque les index de sauvegarde de la clé étrangère sont créés et remplis. Une fois que les index sont prêts, Spanner commence à appliquer la contrainte pour les nouvelles transactions pendant la validation des 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 bien été effectuées, ou aucune n'était nécessaire, 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

Cette table filtrée par ligne contient une ligne pour chaque colonne des tables de TABLE_CONSTRAINTS limitées par une contrainte PRIMARY KEY, FOREIGN KEY ou UNIQUE en tant que clés. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et les comptes principaux 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 colonnes qui répondent aux critères suivants:

  • Tous les droits de contrôle des accès ultraprécis SELECT, INSERT ou UPDATE sont directement accordés dans la colonne au rôle de base de données actuel, aux rôles dont ce rôle est membre, ou à public.
  • Tous les droits SELECT, INSERT ou UPDATE pour le contrôle ultraprécis des accès sont accordés sur la table contenant la colonne au rôle de base de données actuel, aux rôles dont ce rôle est membre 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 elle n'a pas de nom.
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 elle n'a pas de nom.
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 fournit des informations sur les 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 du synonyme.
SYNONYM_SCHEMA STRING Nom du schéma du synonyme.
SYNONYM_TABLE_NAME STRING Nom de la table correspondant au synonyme.

INDEXES

Cette table filtrée sur les lignes 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, ainsi que les comptes principaux 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 index répondant à l'une des exigences suivantes:

  • Tous les droits de contrôle des accès ultraprécis SELECT, INSERT ou UPDATE sont accordés au niveau des colonnes sur toutes les colonnes de l'index au rôle de base de données actuel, aux rôles dont il est membre ou à public.
  • Tous les droits SELECT, INSERT, UPDATE ou DELETE pour le contrôle ultraprécis des accès sont accordés sur la table possédant l'index du rôle de base de données actuel, aux rôles dont le 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 dotées de la spécification PRIMARY KEY comportent une entrée de pseudo-index générée sous 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 cette 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 suivants :
  • 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érification de 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 ; dans le cas contraire, FALSE. Les index de sauvegarde secondaires pour les clés étrangères sont gérés par Spanner.

INDEX_COLUMNS

Ce tableau filtré par lignes répertorie les colonnes d'un index. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données, ainsi que les comptes principaux 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 index répondant à l'une des exigences suivantes:

  • Tous les droits de contrôle des accès ultraprécis SELECT, INSERT ou UPDATE sont accordés au niveau des colonnes sur toutes les colonnes de l'index au rôle de base de données actuel, aux rôles dont il est membre ou à public.
  • Tous les droits de contrôle des accès ultraprécis SELECT, INSERT ou UPDATE sont attribués sur la table ayant l'index vers le rôle de base de données actuel, aux rôles dont ce rôle est membre, 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 clés (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 soit YES, soit NO, et non une valeur booléenne.
SPANNER_TYPE STRING Type de données de la colonne.

COLUMN_OPTIONS

Ce tableau filtré par lignes énumère les options de colonne d'un tableau. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données, ainsi que les comptes principaux 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 les options que pour les colonnes répondant à l'une des exigences suivantes:

  • Tous les droits de contrôle des accès ultraprécis SELECT, INSERT ou UPDATE sont directement accordés dans la colonne au rôle de base de données actuel, aux rôles dont ce rôle est membre, ou à public.
  • Tous les droits SELECT, INSERT ou UPDATE pour le contrôle ultraprécis des accès sont accordés sur la table contenant la colonne au rôle de base de données actuel, aux rôles dont ce rôle est membre 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é en fonction de droits d'accès précis, si un utilisateur disposant de droits d'accès précis interroge le champ.

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 des 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 de droits d'accès précis, lorsqu'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 permettre la conversion vers 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 une suggestion ou via une API cliente.

VIEWS

Ce tableau filtré par lignes 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, ainsi que les comptes principaux 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 vues pour lesquelles le droit SELECT de contrôle ultraprécis des accès est accordé au rôle de base de données actuel, aux rôles dont le 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 la section À propos des vues.

ROLES

Ce tableau filtré par lignes répertorie les rôles de base de données définis pour un contrôle précis des accès, y compris les rôles système. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et les comptes principaux disposant d'un accès au rôle système spanner_info_reader ou aux 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, soit directement, soit 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 sur les lignes répertorie toutes les appartenances à des 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 les comptes principaux 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 attribuées au rôle de base de données actuel ou à un rôle dont le rôle de base de données actuel appartient.

Étant donné que tous les rôles de base de données ont le rôle public, les résultats omettent les enregistrements d'appartenance implicite au rôle public.

nom de la colonne Type Description
ROLE_NAME STRING Nom du rôle de base de données dans lequel cette appartenance est accordée.
GRANTEE STRING Nom du rôle de base de données auquel cette appartenance est attribuée.

CHANGE_STREAMS

Ce tableau filtré par lignes répertorie tous les flux de modifications d'une base de données, et indique ceux qui permettent de suivre l'intégralité de la base de données par rapport à des tables ou des colonnes spécifiques. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données, ainsi que les comptes principaux 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 flux de modifications pour lesquels le droit SELECT de contrôle des accès ultraprécis est accordé au rôle de base de données actuel, aux rôles dont le rôle actuel de base de données est membre 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, ainsi que les comptes principaux 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 dont le rôle de base de données actuel appartient ou à public.

Les données de 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 du tableau 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 les comptes principaux 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 dont 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.
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 lignes 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 les comptes principaux 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 dont 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

Cette table filtrée sur les lignes répertorie tous les droits de contrôle des accès détaillés accordés sur l'ensemble des flux de modifications à tout 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, ainsi que les comptes principaux 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 flux de modifications au rôle de base de données actuel, aux rôles dont 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 contenant le flux de modifications (chaîne vide).
CHANGE_STREAM_SCHEMA STRING Nom du schéma contenant le flux de modifications (chaîne vide).
CHANGE_STREAM_NAME STRING Nom du flux de modifications.
PRIVILEGE_TYPE STRING SELECT (le 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 lignes répertorie toutes les fonctions de lecture de 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 les comptes principaux 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 des 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 dont ce rôle est membre, 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. (Il risque d'être en double 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 et pour chaque fonction de lecture de flux de modifications définie.

Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et les comptes principaux 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 des flux de modifications pour lesquelles le droit de contrôle ultraprécis des accès EXECUTE est accordé au rôle de base de données actuel, aux rôles dont le 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 du nom.
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 être analysable dans le cadre d'une requête.

PARAMETERS

Cette table filtrée 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 de flux de modifications.

Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et les comptes principaux 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 lesquelles le droit de contrôle ultraprécis des accès EXECUTE est accordé au rôle de base de données actuel, aux rôles dont le 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 du nom.
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

Cette table filtrée sur les lignes répertorie tous les droits de contrôle des accès précis accordés à l'ensemble des fonctions de lecture de flux de modifications pour 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 les comptes principaux 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 dont le 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 du nom.
PRIVILEGE_TYPE STRING Toujours EXECUTE.
GRANTEE STRING Nom du rôle de base de données auquel ce droit est accordé.

ROLE_TABLE_GRANTS

Cette table filtrée sur les lignes répertorie tous les droits de contrôle des accès précis accordés à l'ensemble des tables et des vues pour tout 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, ainsi que les comptes principaux 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 tables et les vues au rôle de base de données actuel et aux rôles dont ce rôle est membre, à l'exception 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

Cette table filtrée sur les lignes répertorie tous les droits de contrôle des accès détaillés accordés sur l'ensemble des colonnes à tout 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, ainsi que les comptes principaux 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 colonnes au rôle de base de données actuel et sur les rôles dont ce rôle est membre, à l'exception 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 de droit (SELECT, INSERT ou UPDATE).
IS_GRANTABLE STRING Non utilisé. Toujours NO.

ROLE_CHANGE_STREAM_GRANTS

Ce tableau filtré par lignes présente les droits SELECT accordés sur tous les flux de modifications de tout 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, ainsi que les comptes principaux 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 flux de modifications au rôle de base de données actuel et aux rôles dont le rôle de base de données actuel appartient, à l'exception 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

Cette table filtrée sur les lignes répertorie tous les droits de contrôle des accès précis accordés sur l'ensemble des modèles à tout 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, ainsi que les comptes principaux 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 tables et les vues au rôle de base de données actuel et aux rôles dont ce rôle est membre, à l'exception 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

Cette table filtrée sur les lignes présente les droits EXECUTE accordés sur toutes les fonctions de lecture de flux de modifications de 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 les comptes principaux 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 pour le rôle de base de données actuel et pour les rôles auxquels ce rôle de base de données appartient, à l'exception 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 du nom.
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 présente 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, 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 du modèle.
OPTION_TYPE STRING Type de données de l'option de colonne de modèle.
OPTION_VALUE STRING Valeur de l'option de colonne de modèle.

MODEL_PRIVILEGES

Cette table filtrée sur les lignes 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 les comptes principaux 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 les droits que pour les modèles sur 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 dont le rôle actuel de base de données appartient, 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 sur lequel des droits de contrôle précis des accès 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

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

Renvoyez toutes les séquences:

SELECT
  *
FROM
  information_schema.sequences;

Afficher 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 à examiner les problèmes de base de données.