Schéma d'informations pour les bases de données utilisant le dialecte PostgreSQL

Le schéma d'informations est un schéma intégré commun à toutes les bases de données PostgreSQL. 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 = 'public'

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 Requête 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.

Différences par rapport à information_schema pour PostgreSQL

Les tables des bases de données information_schema pour PostgreSQL incluent des colonnes issues des tables du groupe information_schema pour PostgreSQL Open Source et, dans certains cas, incluent également des colonnes Spanner. Dans ces tableaux, les colonnes PostgreSQL Open Source apparaissent en premier et dans le même ordre que pour une base de données PostgreSQL Open Source. Toutes les colonnes distinctes pour Spanner sont ensuite ajoutées. Les requêtes écrites pour la version Open Source de PostgreSQL information_schema devraient fonctionner sans modification lorsque vous utilisez des bases de données de dialecte PostgreSQL dans la Google Cloud CLI.

Voici d'autres différences notables dans le fichier information_schema pour les bases de données basées sur le dialecte PostgreSQL:

  • Certaines colonnes de la table pour PostgreSQL Open Source sont disponibles, mais ne sont pas renseignées dans les bases de données utilisant le dialecte PostgreSQL.
  • Les bases de données de dialecte PostgreSQL utilisent public comme nom de schéma par défaut.
  • Les noms de contrainte générés automatiquement utilisent un format différent de celui des bases de données PostgreSQL Open Source.
  • Les tables liées aux fonctionnalités PostgreSQL Open Source non compatibles avec les bases de données utilisant le dialecte PostgreSQL ne sont pas disponibles.
  • Certaines tables disponibles avec Spanner, mais pas PostgreSQL Open Source, telles que database_options, index_columns, indexes et spanner_statistics.

Filtrage des lignes dans information_schema tables et vues

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 et vues information_schema. Pour les autres comptes principaux, Spanner filtre les lignes en fonction du rôle de base de données actuel. Les descriptions de table et de vue figurant dans les sections suivantes indiquent comment Spanner filtre les lignes pour chaque table et vue.

Tables dans information_schema pour les bases de données utilisant le dialecte PostgreSQL

Les tables et les vues du information_schema sont compatibles avec les tables et les vues du information_schema de la version Open Source de PostgreSQL.

Les sections suivantes décrivent les tables et les vues dans information_schema pour les bases de données basées sur le dialecte PostgreSQL.

applicable_roles

Cette vue filtrée par ligne répertorie toutes les appartenances aux rôles qui sont 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 aux rôles attribuées au rôle de base de données actuel ou à un rôle auquel ce rôle 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 colonne Type Description
grantee character varying Nom du rôle de base de données auquel l'appartenance est accordée.
role_name character varying Nom du rôle de base de données parent dans lequel cette appartenance est accordée.
is_grantable character varying Non utilisé. Toujours NO.

change_stream_columns

Cette vue 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 est membre, ou à public.

nom de la colonne Type Description
change_stream_catalog character varying Nom de la base de données.
change_stream_schema character varying Nom du schéma du flux de modifications. Pour les bases de données basées sur le dialecte PostgreSQL, la valeur par défaut est public.
change_stream_name character varying Nom du flux de modifications.
table_catalog character varying Nom de la base de données.
table_schema character varying Nom du schéma de la table. Pour les bases de données basées sur le dialecte PostgreSQL, la valeur par défaut est public.
table_name character varying Nom de la table à laquelle cette ligne fait référence.
column_name character varying Nom de la colonne à laquelle cette ligne fait référence.

change_stream_options

Cette vue filtrée par ligne contient les options de configuration des 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 character varying Nom de la base de données.
change_stream_schema character varying Nom du schéma du flux de modifications. Pour les bases de données basées sur le dialecte PostgreSQL, la valeur par défaut est public.
change_stream_name character varying Nom du flux de modifications.
option_name character varying Nom de l'option de flux de modifications.
option_type character varying Type de données de l'option de flux de modifications.
option_value character varying Valeur de l'option de flux de modifications.

change_stream_privileges

Cette vue filtrée par ligne 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 et les comptes principaux qui ont reçu l'autorisation d'accéder 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 colonne Type Description
grantor character varying Non utilisé. Toujours NULL.
grantee character varying Nom du rôle de base de données auquel ce droit est accordé.
change_stream_catalog character varying Nom de la base de données.
change_stream_schema character varying Nom du schéma contenant le flux de modifications. La valeur par défaut est public pour les bases de données utilisant le dialecte PostgreSQL.
change_stream_name character varying Nom du flux de modifications.
privilege_type character varying Type de droit (SELECT uniquement).
is_grantable character varying Non utilisé. Toujours NO.

change_stream_tables

Cette vue 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 les comptes principaux qui ont reçu l'autorisation d'accéder 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 character varying Nom de la base de données.
change_stream_schema character varying Nom du schéma du flux de modifications. Pour les bases de données basées sur le dialecte PostgreSQL, la valeur par défaut est public.
change_stream_name character varying Nom du flux de modifications auquel cette ligne fait référence.
table_catalog character varying Nom de la base de données.
table_schema character varying Nom du schéma de la table. Pour les bases de données basées sur le dialecte PostgreSQL, la valeur par défaut est public.
table_name character varying Nom de la table à laquelle cette ligne fait référence.
all_columns character varying YES 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, NO. Conformément à la norme SQL, la chaîne est soit YES, soit NO, et non une valeur booléenne.

change_streams

Cette vue filtrée par ligne 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, et les comptes principaux qui ont reçu l'autorisation d'accéder 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 character varying Nom de la base de données.
change_stream_schema character varying Nom du schéma de ce flux de modifications. Pour les bases de données basées sur le dialecte PostgreSQL, la valeur par défaut est public.
change_stream_name character varying Nom du flux de modifications.
all character varying YES si ce flux de modifications suit l'intégralité de la base de données. NO si ce flux de modifications suit des tables ou des colonnes spécifiques. Conformément à la norme SQL, la chaîne est soit YES, soit NO, et non une valeur booléenne.

check_constraints

La vue check_constraints contient une ligne pour chaque contrainte de vérification définie par le mot clé CHECK ou NOT NULL.

nom de la colonne Type Description
constraint_catalog character varying Nom de la base de données.
constraint_schema character varying Nom du schéma de la contrainte. La valeur par défaut est public pour les bases de données utilisant le dialecte PostgreSQL.
constraint_name character varying Nom de la contrainte. Si le nom de la contrainte n'est pas spécifié explicitement dans le schéma, le nom généré automatiquement est utilisé.
check_clause character varying Expression de la contrainte de contrôle.
spanner_state character varying État actuel de la contrainte de vérification. Les états possibles sont les suivants :
  • VALIDATING: la base de données du dialecte PostgreSQL valide les données existantes pour une commande ALTER CONSTRAINT ou ADD CONSTRAINT.
  • COMMITTED : il n'existe aucune modification de schéma active pour cette contrainte.

column_column_usage

Cette vue répertorie toutes les colonnes générées qui dépendent d'une autre colonne de base dans la même table.

nom de la colonne Type Description
table_catalog character varying Nom de la base de données.
table_schema character varying Nom du schéma contenant la table. Le nom est public pour le schéma par défaut et non vide pour les autres schémas (par exemple, information_schema lui-même). Cette colonne n'est jamais nulle.
table_name character varying Nom de la table contenant les colonnes générées.
column_name character varying Nom de la colonne de base dont dépend la colonne générée.
dependent_column character varying Nom de la colonne générée.

column_options

Cette vue liste toutes les options définies pour les colonnes de table référencées d'une contrainte de clé étrangère. La vue ne contient que les colonnes de la table de référence à laquelle l'utilisateur actuel a accès (en tant que propriétaire ou droits accordés).

nom de la colonne Type Description
table_catalog character varying Nom de la base de données.
table_schema character varying Nom du schéma contenant la table étrangère. Le nom est public pour le schéma par défaut et non vide pour les autres schémas (par exemple, information_schema lui-même). Cette colonne n'est jamais nulle.
table_name character varying Nom de la table étrangère.
column_name character varying Nom de la colonne.
option_name character varying Identifiant SQL qui identifie l'option de manière unique. Il est la clé de la clause OPTIONS en DDL.
option_value character varying Littéral SQL décrivant la valeur de cette option. La valeur de cette colonne peut être analysée dans le cadre d'une requête.
option_type character varying Nom de type de données qui correspond au type de cette valeur d'option.

column_privileges

Cette vue filtrée par ligne 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 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 colonnes au rôle de base de données actuel, pour les rôles dont le rôle de base de données actuel est membre, ou pour 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 character varying Non utilisé. Toujours NULL.
grantee character varying Nom du rôle de base de données auquel ce droit est accordé.
table_catalog character varying Nom de la base de données.
table_schema character varying Nom du schéma contenant la table ou la vue. La valeur par défaut est public pour les bases de données utilisant le dialecte PostgreSQL.
table_name character varying Nom de la table ou de la vue contenant la colonne.
column_name character varying Nom de la colonne.
privilege_type character varying Type de droit (SELECT, INSERT ou UPDATE).
is_grantable character varying Non utilisé. Toujours NO.

columns

Cette vue filtrée par ligne fournit des informations sur toutes les colonnes de la table et des colonnes de la 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 colonnes sur lesquelles des droits de contrôle des accès ultraprécis ont été accordés (ou les droits SELECT, INSERT ou UPDATE accordés sur les tables qui les contiennent) au rôle de base de données actuel, aux rôles dont il fait partie ou à public.

nom de la colonne Type Description
table_catalog character varying Nom de la base de données.
table_schema character varying Nom du schéma contenant la table. Le nom est public pour le schéma par défaut et non vide pour les autres schémas (par exemple, information_schema lui-même). Cette colonne n'est jamais nulle.
table_name character varying Nom de la table
column_name character varying Nom de la colonne
ordinal_position BIGINT Position ordinale de la colonne dans la table, commençant par la valeur 1
column_default character varying Représentation, sous forme de chaîne, de l'expression PostgreSQL Open Source de la valeur par défaut de la colonne (par exemple, '9'::bigint).
is_nullable character varying 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.
data_type character varying Type de données de la colonne. La valeur est l'une des suivantes :
  • Pour les types intégrés, il s'agit du nom du type de données.
  • Pour les tableaux, la valeur ARRAY.
character_maximum_length BIGINT Longueur maximale déclarée pour les types de données de chaîne de caractères et de bits. Si aucune longueur maximale n'a été spécifiée, la valeur est NULL. Si le type de données de la colonne n'est pas une chaîne de caractères ou de bits, la valeur est NULL.
character_octet_length BIGINT Non utilisé. La valeur est toujours NULL.
numeric_precision BIGINT Précision du type de données numériques de la colonne active. Pour double precision, la valeur est 53. Pour bigint, la valeur est de 64. Pour tous les autres types de données, la valeur est NULL.
numeric_precision_radix BIGINT Base (unité) de la précision pour les types numériques. Actuellement, seules deux valeurs sont acceptées :
  • 2 pour double precision float8 et bigint
  • 10 correspond à numeric
Pour tous les autres types de données, la valeur est NULL.
numeric_scale BIGINT Contient l'échelle du type de colonne numérique, qui correspond au nombre d'unités de base de précision après le point de base. Pour bigint, la valeur est 0. Pour tous les autres types de données, la valeur est NULL.
datetime_precision BIGINT Non utilisé. La valeur est toujours NULL.
interval_type character varying Non utilisé. La valeur est toujours NULL.
interval_precision BIGINT Non utilisé. La valeur est toujours NULL.
character_set_catalog character varying Non utilisé. La valeur est toujours NULL.
character_set_schema character varying Non utilisé. La valeur est toujours NULL.
character_set_name character varying Non utilisé. La valeur est toujours NULL.
collation_catalog character varying Non utilisé. La valeur est toujours NULL.
collation_schema character varying Non utilisé. La valeur est toujours NULL.
collation_name character varying Non utilisé. La valeur est toujours NULL.
domain_catalog character varying Non utilisé. La valeur est toujours NULL.
domain_schema character varying Non utilisé. La valeur est toujours NULL.
domain_name character varying Non utilisé. La valeur est toujours NULL.
udt_catalog character varying Non utilisé. La valeur est toujours NULL.
udt_schema character varying Non utilisé. La valeur est toujours NULL.
udt_name character varying Non utilisé. La valeur est toujours NULL.
scope_catalog character varying Non utilisé. La valeur est toujours NULL.
scope_schema character varying Non utilisé. La valeur est toujours NULL.
scope_name character varying Non utilisé. La valeur est toujours NULL.
maximum_cardinality BIGINT Non utilisé. La valeur est toujours NULL.
dtd_identifier character varying Non utilisé. La valeur est toujours NULL.
is_self_referencing character varying Non utilisé. La valeur est toujours NULL.
is_identity character varying Non utilisé. La valeur est toujours NULL.
identity_generation character varying Non utilisé. La valeur est toujours NULL.
identity_start character varying Non utilisé. La valeur est toujours NULL.
identity_increment character varying Non utilisé. La valeur est toujours NULL.
identity_maximum character varying Non utilisé. La valeur est toujours NULL.
identity_minimum character varying Non utilisé. La valeur est toujours NULL.
identity_cycle character varying Non utilisé. La valeur est toujours NULL.
is_generated character varying 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 character varying Chaîne représentant l'expression SQL d'une colonne générée, ou NULL si la colonne n'est pas une colonne générée.
is_updatable character varying Non utilisé. La valeur est toujours NULL.
spanner_type character varying Chaîne contenant le type de colonne compatible LDD.
is_stored character varying Chaîne qui indique si la colonne générée est stockée. La chaîne est toujours YES ou NO pour les colonnes générées, et NULL pour les colonnes non générées.
spanner_state character varying É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 :
  • NO_WRITE: aucune opération de lecture ni d'écriture n'est autorisée dans les colonnes. Une colonne générée stockée dans cet état n'a aucun effet sur le client.
  • WRITE_ONLY : la colonne est en cours de remplissage. Aucune lecture n'est autorisée.
  • COMMITTED : la colonne est entièrement utilisable.
  • NULL: utilisé pour les colonnes des schémas système.

constraint_column_usage

Cette vue contient une ligne pour chaque colonne utilisée par une contrainte.

  • Pour les contraintes PRIMARY KEY et CHECK définies par le mot clé NOT NULL, la vue contient ces colonnes.
  • Pour les contraintes CHECK créées avec le mot clé CHECK, la vue inclut les colonnes utilisées par l'expression de contrainte de vérification.
  • Pour les contraintes de clé étrangère, l'affichage contient les colonnes de la table référencée.
  • Pour les contraintes UNIQUE, la vue contient les colonnes de KEY_COLUMN_USAGE.

nom de la colonne Type Description
table_catalog character varying Nom de la base de données.
table_schema character varying Nom du schéma contenant la table contenant la colonne utilisée par la contrainte.
table_name character varying Nom de la table contenant la colonne utilisée par la contrainte.
column_name character varying Nom de la colonne utilisée par la contrainte.
constraint_catalog character varying Nom de la base de données.
constraint_schema character varying Nom du schéma de la contrainte.
constraint_name character varying Nom de la contrainte.

constraint_table_usage

Cette vue contient une ligne pour chaque table utilisée par une contrainte. Pour les contraintes FOREIGN KEY, les informations sur les tables concernent les tables de la clause REFERENCES. Pour une contrainte de clé unique ou primaire, cette vue identifie simplement la table à laquelle appartient la contrainte. Les contraintes de vérification et les contraintes non nulles ne sont pas incluses dans cette vue.

nom de la colonne Type Description
table_catalog character varying Nom de la base de données.
table_schema character varying Nom du schéma de la table avec des contraintes.
table_name character varying Nom de la table utilisée par une contrainte.
constraint_catalog character varying Nom de la base de données.
constraint_schema character varying Nom du schéma contenant la contrainte.
constraint_name character varying Nom de la contrainte.

database_options

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

Nom de la colonne Type Description
catalog_name character varying Nom de la base de données.
schema_name character varying Nom du schéma. La valeur par défaut est public pour les bases de données utilisant le dialecte PostgreSQL.
option_name character varying Nom de l'option de base de données. Il s'agit de la valeur de key dans la clause OPTIONS du langage LDD.
option_type character varying Type de données de l'option de base de données.
option_value character varying Valeur de l'option de base de données.

enabled_roles

Cette vue filtrée par ligne répertorie les rôles de base de données définis. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et les comptes principaux autorisés à accéder 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 reçu l'accès, directement ou par héritage. Tous les rôles système, à l'exception de public, s'affichent également dans cette vue.

Nom de colonne Type Description
role_name character varying Nom du rôle.
spanner_is_system character varying YES si le rôle est un rôle système. Sinon, NO.

index_columns

Cette vue répertorie les colonnes d'un index.

Nom de la colonne Type Description
table_catalog character varying Nom de la base de données.
table_schema character varying Nom du schéma contenant l'index. La valeur par défaut est public.
table_name character varying Nom de la table associée à l'index.
index_name character varying Nom de l'index. Les tables comportant une spécification PRIMARY KEY comportent une entrée de pseudo-index générée sous le nom PRIMARY_KEY.
index_type character varying Type d'index. Les valeurs possibles sont PRIMARY_KEY, LOCAL ou GLOBAL.
column_name character varying Nom de la colonne.
ordinal_position BIGINT La 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 INCLUDE d'un index).
column_ordering character varying Ordre de tri 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 character varying 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 character varying Chaîne contenant le type de colonne compatible LDD.

indexes

Cette vue répertorie les index d'un schéma.

Nom de la colonne Type Description
table_catalog character varying Nom de la base de données.
table_schema character varying Nom du schéma. La valeur par défaut est public.
table_name character varying Nom de la table.
index_name character varying Nom de l'index. Les tables créées avec une clause PRIMARY KEY comportent une entrée de pseudo-index générée avec le nom PRIMARY_KEY, ce qui permet d'identifier les champs de la clé primaire.
index_type character varying Type d'index. Les valeurs sont PRIMARY_KEY, LOCAL ou GLOBAL.
parent_table_name character varying 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 character varying Si les clés d'index doivent être uniques. Conformément à la norme SQL, la chaîne est soit YES, soit NO, et non une valeur booléenne.
is_null_filtered character varying Si l'index inclut des entrées dotées de valeurs NULL. Conformément à la norme SQL, la chaîne est soit YES, soit NO, et non une valeur booléenne.
index_state character varying État actuel de l'index. Les valeurs possibles et les états qu'elles représentent sont les suivants :
  • NULL: le type d'index est PRIMARY_KEY.
  • PREPARE: créer des tables vides pour un nouvel index
  • WRITE_ONLY: remplissage 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 character varying Indique si l'index est géré par Spanner. Par exemple, les index de sauvegarde secondaires pour les clés étrangères sont gérés par Spanner. Conformément à la norme SQL, la chaîne correspond à YES ou NO, et non à une valeur booléenne.

information_schema_catalog_name

Cette table contient une ligne et une colonne contenant le nom de la base de données.

nom de la colonne Type Description
catalog_name character varying Nom de la base de données.

key_column_usage

Cette vue identifie toutes les colonnes de la base de données actuelle référencées par une contrainte de clé primaire ou étrangère unique ou de clé étrangère. Pour en savoir plus sur les colonnes de contraintes CHECK, consultez la vue check_constraints.

nom de la colonne Type Description
constraint_catalog character varying Nom de la base de données.
constraint_schema character varying Nom du schéma de la contrainte. La valeur par défaut est public.
constraint_name character varying Nom de la contrainte.
table_catalog character varying Nom de la base de données.
table_schema character varying Nom du schéma contenant la table contenant la colonne avec contrainte. La valeur par défaut est public.
table_name character varying Nom de la table contenant la colonne limitée par cette contrainte.
column_name character varying Nom de la colonne soumise à une contrainte.
ordinal_position BIGINT Position ordinale de la colonne dans la clé de la contrainte, commençant par la valeur 1.
position_in_unique_constraint BIGINT 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 comporte une valeur NULL pour les autres types de contraintes.

parameters

Cette vue 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 character varying Nom de la base de données.
specific_schema character varying Nom du schéma de la routine. Pour les bases de données basées sur le dialecte PostgreSQL, la valeur par défaut est public.
specific_name character varying Nom de la routine. Identifie la routine de manière unique, même si son nom est surchargé.
ordinal_position bigint Position ordinale du paramètre dans la liste d'arguments de la routine, commençant par une valeur 1.
parameter_mode character varying Non utilisé. Toujours NULL.
is_result character varying Non utilisé. Toujours NULL.
as_locator character varying Non utilisé. Toujours NULL.
parameter_name character varying Nom du paramètre.
data_type character varying Type de données du paramètre. La valeur est l'une des suivantes:
  • Pour les types intégrés, il s'agit du nom du type de données.
  • Pour les tableaux, la valeur est ARRAY.
character_maximum_length bigint Non utilisé. Toujours NULL.
character_octet_length bigint Non utilisé. La valeur est toujours NULL.
character_set_catalog character varying Non utilisé. La valeur est toujours NULL.
character_set_schema character varying Non utilisé. La valeur est toujours NULL.
character_set_name character varying Non utilisé. La valeur est toujours NULL.
collation_catalog character varying Non utilisé. La valeur est toujours NULL.
collation_schema character varying Non utilisé. La valeur est toujours NULL.
collation_name character varying Non utilisé. La valeur est toujours NULL.
numeric_precision bigint Non utilisé. La valeur est toujours NULL.
numeric_precision_radix bigint Non utilisé. La valeur est toujours NULL.
numeric_scale bigint Non utilisé. La valeur est toujours NULL.
datetime_precision bigint Non utilisé. La valeur est toujours NULL.
interval_type character varying Non utilisé. La valeur est toujours NULL.
interval_precision bigint Non utilisé. La valeur est toujours NULL.
udt_catalog character varying Non utilisé. La valeur est toujours NULL.
udt_schema character varying Non utilisé. La valeur est toujours NULL.
udt_name character varying Non utilisé. La valeur est toujours NULL.
scope_catalog character varying Non utilisé. La valeur est toujours NULL.
scope_schema character varying Non utilisé. La valeur est toujours NULL.
scope_name character varying Non utilisé. La valeur est toujours NULL.
maximum_cardinality bigint Non utilisé. La valeur est toujours NULL.
dtd_identifier character varying Non utilisé. La valeur est toujours NULL.
parameter_default character varying Non utilisé. La valeur est toujours NULL.

referential_constraints

Cette vue contient une ligne pour chaque contrainte FOREIGN KEY. Vous ne pouvez afficher que les contraintes pour lesquelles vous disposez d'un accès en écriture à la table de référence. Cette vue identifie également les contraintes PRIMARY KEY et UNIQUE sur les tables référencées utilisées par les clés étrangères pour l'application des contraintes et les actions référentielles.

nom de la colonne Type Description
constraint_catalog character varying Nom de la base de données.
constraint_schema character varying Nom du schéma contenant la contrainte de clé étrangère. La valeur par défaut est public.
constraint_name character varying Nom de la contrainte de clé étrangère.
unique_constraint_catalog character varying Nom de la base de données.
unique_constraint_schema character varying Nom du schéma contenant la contrainte de clé unique ou primaire à laquelle la contrainte de clé étrangère fait référence.
unique_constraint_name character varying Nom de la contrainte de clé unique ou primaire référencée par la contrainte de clé étrangère.
match_option character varying Méthode de correspondance utilisée par la contrainte de clé étrangère. La valeur est toujours NONE.
update_rule character varying Règle de mise à jour de la contrainte de clé étrangère. Cette valeur est toujours NO ACTION.
delete_rule character varying Règle de suppression de la contrainte de clé étrangère. Cette valeur est CASCADE ou NO ACTION.
spanner_state character varying É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. Les valeurs possibles et les états qu'elles représentent sont les suivants :
  • 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.

role_change_stream_grants

Cette vue filtrée par ligne répertorie les droits SELECT accordés sur tous les flux de modifications de tous 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 qui ont reçu l'autorisation d'accéder 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
grantor character varying Non utilisé. Toujours NULL.
grantee character varying Nom du rôle de base de données auquel ce droit est accordé.
change_stream_catalog character varying Nom de la base de données.
change_stream_schema character varying Nom du schéma contenant le flux de modifications. La valeur par défaut est public pour les bases de données utilisant le dialecte PostgreSQL.
change_stream_name character varying Nom du flux de modifications.
privilege_type character varying Type de droit (SELECT uniquement).
is_grantable character varying Non utilisé. Toujours NO.

role_column_grants

Cette vue filtrée par ligne 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, 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 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 character varying Non utilisé. Toujours NULL.
grantee character varying Nom du rôle de base de données auquel ce droit est accordé.
table_catalog character varying Nom de la base de données.
table_schema character varying Nom du schéma contenant la table ou la vue. La valeur par défaut est public pour les bases de données utilisant le dialecte PostgreSQL.
table_name character varying Nom de la table ou de la vue contenant la colonne.
column_name character varying Nom de la colonne.
privilege_type character varying Type de droit (SELECT, INSERT ou UPDATE).
is_grantable character varying Non utilisé. Toujours NO.

role_routine_grants

Cette vue filtrée par ligne répertorie 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 character varying Non utilisé. Toujours NULL.
grantee character varying Nom du rôle auquel le droit a été accordé.
specific_catalog character varying Nom de la base de données.
specific_schema character varying Nom du schéma de la routine. Pour les bases de données basées sur le dialecte PostgreSQL, la valeur par défaut est public.
specific_name character varying Nom de la routine. Identifie la routine de manière unique, même si son nom est surchargé.
routine_catalog character varying Nom de la base de données.
routine_schema character varying Nom du schéma de la routine. La valeur par défaut est public pour les bases de données utilisant le dialecte PostgreSQL.
routine_name character varying Nom de la routine. (Il risque d'être en double en cas de surcharge.)
privilege_type character varying Type de droit accordé. Toujours EXECUTE.
is_grantable character varying Non utilisé. Toujours NO.

role_table_grants

Cette vue filtrée par ligne 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 et les comptes principaux qui ont reçu l'autorisation d'accéder 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 character varying Non utilisé. Toujours NULL.
grantee character varying Nom du rôle de base de données auquel ce droit est accordé.
table_catalog character varying Nom de la base de données.
table_schema character varying Nom du schéma contenant la table ou la vue. La valeur par défaut est public pour les bases de données utilisant le dialecte PostgreSQL.
table_name character varying Nom de la table ou de la vue.
privilege_type character varying Type du droit (SELECT, INSERT, UPDATE ou DELETE).
is_grantable character varying Non utilisé. Toujours NO.
with_hierarchy character varying Non utilisé. Toujours NULL.

routine_options

Cette vue 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 character varying Nom de la base de données.
specific_schema character varying Nom du schéma de la routine. La valeur par défaut est public pour les bases de données utilisant le dialecte PostgreSQL.
specific_name character varying Nom de la routine. Identifie la routine de manière unique, même si son nom est surchargé.
option_name character varying Nom de l'option.
option_type character varying Type de données de l'option. La valeur est l'une des suivantes:
  • Pour les types intégrés, il s'agit du nom du type de données.
  • Pour les tableaux, la valeur est ARRAY.
option_value character varying Valeur de l'option.

routine_privileges

Cette vue filtrée par ligne répertorie tous les droits de contrôle des accès détaillés accordés sur l'ensemble des fonctions de lecture de flux de modifications 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 qui ont été autorisés à accéder au 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 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 est membre, ou à public.

nom de la colonne Type Description
grantor character varying Non utilisé. Toujours NULL.
grantee character varying Nom du rôle auquel le droit a été accordé.
specific_catalog character varying Nom de la base de données.
specific_schema character varying Nom du schéma de la routine. Pour les bases de données basées sur le dialecte PostgreSQL, la valeur par défaut est public.
specific_name character varying Nom de la routine. Identifie la routine de manière unique, même si son nom est surchargé.
routine_catalog character varying Nom de la base de données.
routine_schema character varying Nom du schéma de la routine. La valeur par défaut est public.
routine_name character varying Nom de la routine. (Susceptible d'être dupliqué en cas de surcharge.)
privilege_type character varying Type de droit accordé.
is_grantable character varying Non utilisé. Toujours NO.

routines

Cette vue filtrée 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 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 character varying Nom de la base de données.
specific_schema character varying Nom du schéma de la routine. La valeur par défaut est public pour les bases de données utilisant le dialecte PostgreSQL.
specific_name character varying Nom de la routine. Identifie la routine de manière unique, même si son nom est surchargé.
routine_catalog character varying Nom de la base de données.
routine_schema character varying Nom du schéma de la routine.
routine_name character varying Nom de la routine. (Il risque d'être en double en cas de surcharge.)
routine_type character varying Type de la routine (FUNCTION ou PROCEDURE). Toujours FUNCTION
module_catalog character varying Non utilisé. La valeur est toujours NULL.
module_schema character varying Non utilisé. La valeur est toujours NULL.
module_name character varying Non utilisé. La valeur est toujours NULL.
udt_catalog character varying Non utilisé. La valeur est toujours NULL.
udt_schema character varying Non utilisé. La valeur est toujours NULL.
udt_name character varying Non utilisé. La valeur est toujours NULL.
data_type character varying Type renvoyé de la routine. La valeur est l'une des suivantes:
  • Pour les types intégrés, il s'agit du nom du type de données.
  • Pour les tableaux, la valeur est ARRAY.
character_maximum_length bigint Non utilisé. La valeur est toujours NULL.
character_octet_length bigint Non utilisé. La valeur est toujours NULL.
character_set_catalog character varying Non utilisé. La valeur est toujours NULL.
character_set_schema character varying Non utilisé. La valeur est toujours NULL.
character_set_name character varying Non utilisé. La valeur est toujours NULL.
collation_catalog character varying Non utilisé. La valeur est toujours NULL.
collation_schema character varying Non utilisé. La valeur est toujours NULL.
collation_name character varying Non utilisé. La valeur est toujours NULL.
numeric_precision/td> bigint Non utilisé. La valeur est toujours NULL.
numeric_precision_radix bigint Non utilisé. La valeur est toujours NULL.
numeric_scale bigint Non utilisé. La valeur est toujours NULL.
datetime_precision bigint Non utilisé. La valeur est toujours NULL.
interval_type character varying Non utilisé. La valeur est toujours NULL.
interval_precision bigint Non utilisé. La valeur est toujours NULL.
type_udt_catalog character varying Non utilisé. La valeur est toujours NULL.
type_udt_schema character varying Non utilisé. La valeur est toujours NULL.
type_udt_name character varying Non utilisé. La valeur est toujours NULL.
scope_catalog character varying Non utilisé. La valeur est toujours NULL.
scope_schema character varying Non utilisé. La valeur est toujours NULL.
scope_name character varying Non utilisé. La valeur est toujours NULL.
maximum_cardinality bigint Non utilisé. La valeur est toujours NULL.
dtd_identifier character varying Non utilisé. La valeur est toujours NULL.
routine_body character varying Type du corps de la routine (SQL ou EXTERNAL).
routine_definition character varying Définition du SQL routine_body. Sinon, elle est vide.
external_name character varying Non utilisé. La valeur est toujours NULL.
external_language character varying Non utilisé. La valeur est toujours NULL.
parameter_style character varying Non utilisé. La valeur est toujours NULL.
is_deterministic character varying Non utilisé. La valeur est toujours NULL.
sql_data_access character varying Non utilisé. La valeur est toujours NULL.
is_null_call character varying Non utilisé. La valeur est toujours NULL.
sql_path character varying Non utilisé. La valeur est toujours NULL.
schema_level_routine character varying Non utilisé. La valeur est toujours NULL.
max_dynamic_result_sets character varying Non utilisé. La valeur est toujours NULL.
is_user_defined_cast character varying Non utilisé. La valeur est toujours NULL.
is_implicitly_invocable character varying Non utilisé. La valeur est toujours NULL.
security_type character varying Type de sécurité de la routine. Actuellement, il n'y a que INVOKER.
to_sql_specific_catalog character varying Non utilisé. La valeur est toujours NULL.
to_sql_specific_schema character varying Non utilisé. La valeur est toujours NULL.
to_sql_specific_name character varying Non utilisé. La valeur est toujours NULL.
as_locator character varying Non utilisé. La valeur est toujours NULL.
created timestamp with time zone Non utilisé. La valeur est toujours NULL.
last_altered timestamp with time zone Non utilisé. La valeur est toujours NULL.
new_savepoint_level character varying Non utilisé. La valeur est toujours NULL.
is_udt_dependent character varying Non utilisé. La valeur est toujours NULL.
result_cast_from_data_type character varying Non utilisé. La valeur est toujours NULL.
result_cast_as_locator character varying Non utilisé. La valeur est toujours NULL.
result_cast_char_max_length bigint Non utilisé. La valeur est toujours NULL.
result_cast_char_octet_length bigint Non utilisé. La valeur est toujours NULL.
result_cast_char_set_catalog character varying Non utilisé. La valeur est toujours NULL.
result_cast_char_set_schema character varying Non utilisé. La valeur est toujours NULL.
result_cast_char_set_name character varying Non utilisé. La valeur est toujours NULL.
result_cast_collation_catalog character varying Non utilisé. La valeur est toujours NULL.
result_cast_collation_schema character varying Non utilisé. La valeur est toujours NULL.
result_cast_collation_name character varying Non utilisé. La valeur est toujours NULL.
result_cast_numeric_precision bigint Non utilisé. La valeur est toujours NULL.
result_cast_numeric_precision_radix bigint Non utilisé. La valeur est toujours NULL.
result_cast_numeric_scale bigint Non utilisé. La valeur est toujours NULL.
result_cast_datetime_precision bigint Non utilisé. La valeur est toujours NULL.
result_cast_interval_type character varying Non utilisé. La valeur est toujours NULL.
result_cast_interval_precision bigint Non utilisé. La valeur est toujours NULL.
result_cast_type_udt_catalog character varying Non utilisé. La valeur est toujours NULL.
result_cast_type_udt_schema character varying Non utilisé. La valeur est toujours NULL.
result_cast_type_udt_name character varying Non utilisé. La valeur est toujours NULL.
result_cast_scope_catalog character varying Non utilisé. La valeur est toujours NULL.
result_cast_scope_schema character varying Non utilisé. La valeur est toujours NULL.
result_cast_scope_name character varying Non utilisé. La valeur est toujours NULL.
result_cast_maximum_cardinality bigint Non utilisé. La valeur est toujours NULL.
result_cast_dtd_identifier character varying Non utilisé. La valeur est toujours NULL.

schemata

La vue information_schema.schemata contient une ligne pour chaque schéma de la base de données actuelle. Les schémas incluent le schéma d'informations et un schéma par défaut nommé public.

nom de la colonne Type Description
catalog_name character varying Nom de la base de données.
schema_name character varying Nom du schéma. Ce champ est défini sur public pour le schéma par défaut et n'est pas vide pour les schémas nommés.
schema_owner character varying Nom du propriétaire du schéma.
default_character_set_catalog character varying Non utilisé.
default_character_set_schema character varying Non utilisé.
default_character_set_name character varying Non utilisé.
sql_path character varying Non utilisé.
effective_timestamp timestamp with timezone Horodatage auquel toutes les données de ce schéma sont devenues effectives. Il n'est actuellement utilisé que pour le schéma par défaut.

sequences

La vue information_schema.sequences contient les métadonnées sequences.

nom de la colonne Type Description
sequence_catalog character varying Nom de la base de données.
sequence_schema character varying Nom du schéma de la séquence. La valeur par défaut est public pour une base de données de dialecte PostgreSQL.
sequence_name character varying Nom de la séquence.
data_type character varying La séquence n'est compatible qu'avec int8.
numeric_precision bigint Actuellement non utilisé. La valeur est toujours "NULL".
numeric_precision_radix bigint Actuellement non utilisé. La valeur est toujours "NULL".
numeric_scale bigint Actuellement non utilisé. La valeur est toujours "NULL".
start_value bigint Actuellement non utilisé. La valeur est toujours "NULL".
minimum_value bigint Actuellement non utilisé. La valeur est toujours "NULL".
maximum_value bigint Actuellement non utilisé. La valeur est toujours "NULL".
increment bigint Actuellement non utilisé. La valeur est toujours "NULL".
cycle_option character varying La seule option acceptée par sequence est no.
sequence_kind character varying Type de séquence. bit_reversed_positive est la seule valeur acceptable.
counter_start_value bigint Valeur de départ du compteur de séquence.
skip_range_min bigint Valeur minimale de la plage ignorée. Si elle n'est pas définie, cette valeur est NULL.
skip_range_max bigint Valeur maximale de la plage ignorée. Si elle n'est pas définie, cette valeur est NULL.

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 character varying Nom de la base de données.
schema_name character varying Nom du schéma. La valeur de schéma par défaut est public.
package_name character varying Nom du package de statistiques.
allow_gc character varying Indique si le package de statistiques est exempté de la récupération de mémoire. Conformément à la norme SQL, la chaîne est soit YES, soit NO, et non une valeur booléenne. Cet attribut doit être défini sur NO pour que vous puissiez référencer le package de statistiques dans une suggestion ou via l'API cliente.

table_constraints

Cette vue contient toutes les contraintes appartenant aux tables auxquelles l'utilisateur actuel a accès (autres que SELECT).

nom de la colonne Type Description
constraint_catalog character varying Nom de la base de données.
constraint_schema character varying Nom du schéma contenant la contrainte.
constraint_name character varying Nom de la contrainte.
table_catalog character varying Nom de la base de données.
table_schema character varying Nom du schéma contenant la table associée à la contrainte.
table_name character varying Nom de la table.
constraint_type character varying Type de la contrainte. Les valeurs possibles du champ sont les suivantes :
  • CHECK
  • FOREIGN KEY
  • PRIMARY KEY
  • UNIQUE
is_deferrable character varying La valeur est toujours NO.
initially_deferred character varying La valeur est toujours NO.
enforced character varying Indique si la contrainte est appliquée. Si une contrainte est appliquée (après avoir atteint un certain état), elle est validée à la fois au moment de l'écriture et par un vérificateur d'intégrité en arrière-plan. Conformément à la norme SQL, la chaîne est soit YES, soit NO, et non une valeur booléenne.

table_privileges

Cette vue filtrée par ligne 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 et les comptes principaux qui ont reçu l'autorisation d'accéder 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, aux rôles dont le rôle de base de données actuel est membre, ou à public.

Nom de colonne Type Description
grantor character varying Non utilisé. Toujours NULL.
grantee character varying Nom du rôle de base de données auquel ce droit est accordé.
table_catalog character varying Nom de la base de données.
table_schema character varying Nom du schéma contenant la table ou la vue. La valeur par défaut est public pour les bases de données utilisant le dialecte PostgreSQL.
table_name character varying Nom de la table ou de la vue.
privilege_type character varying Type du droit (SELECT, INSERT, UPDATE ou DELETE).
is_grantable character varying Non utilisé. Toujours NO.
that have_hierarchy character varying Non utilisé. Toujours NULL.

tables

Cette vue filtrée par ligne répertorie toutes les tables et toutes les vues qui se trouvent dans la base de données actuelle. 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 tables et les vues. 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 character varying Nom de la base de données.
table_schema character varying Nom du schéma contenant la table ou la vue.
table_name character varying Nom de la table, de la vue ou du synonyme.
table_type character varying Type de table. Les valeurs possibles sont "BASE TABLE", "VIEW" ou "SYNONYM".
self_referencing_column_name character varying Non utilisé.
reference_generation character varying Non utilisé.
user_defined_type_catalog character varying Non utilisé.
user_defined_type_schema character varying Non utilisé.
user_defined_type_name character varying Non utilisé.
is_insertable_into character varying Non utilisé.
is_typed character varying Non utilisé.
commit_action character varying Non utilisé.
parent_table_name character varying Nom de la table parente si cette table est entrelacée, ou NULL.
on_delete_action character varying 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 character varying État de création actuel de la table.
Une table peut passer par plusieurs états lors de sa création, si des opérations groupées sont impliquées, par exemple lorsqu'elle est créée avec une clé étrangère nécessitant le remplissage de son index référencé. Les états possibles sont les suivants :
  • ADDING_FOREIGN_KEY: ajouter les 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.
  • NULL: tables ou vues qui ne sont pas des tables de base.
interleave_type character varying Indique s'il existe une relation parent-enfant entre cette table et la table dans laquelle elle est entrelacée. Les valeurs possibles du champ sont les suivantes :
  • IN: table INTERLEAVE IN sans relation parent-enfant. Une ligne dans cette table peut exister sans tenir compte de la ligne de la table parente.
  • IN PARENT: table INTERLEAVE IN PARENT ayant une relation parent-enfant. Une ligne dans cette table nécessite la présence de la ligne de la table parente.
row_deletion_policy_expression character varying Chaîne contenant l'expression de texte qui définit ROW DELETION POLICY.

table_synonyms

Ce tableau fournit des informations sur les synonymes du tableau.

nom de la colonne Type Description
CATALOG STRING Nom du catalogue contenant la table.
SCHEMA STRING Nom du schéma contenant la table.
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.

views

Cette vue filtrée par ligne répertorie toutes les vues de la base de données actuelle. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données, et les comptes principaux qui ont été autorisés à accéder au rôle système spanner_info_reader ou aux membres de ce rôle peuvent afficher toutes les vues. Tous les autres comptes principaux ne peuvent afficher que les vues auxquelles 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 auxquels ce rôle appartient, ou à public.

nom de la colonne Type Description
table_catalog character varying Nom de la base de données.
table_schema character varying Nom du schéma. La valeur par défaut est public.
table_name character varying Nom de la vue.
view_definition character varying Texte SQL de la requête qui définit la vue.
check_option character varying Non utilisé.
is_updatable character varying Non utilisé.
is_insertable_into character varying Non utilisé.
is_trigger_updatable character varying Non utilisé.
is_trigger_deletable character varying Non utilisé.
is_trigger_insertable_into character varying Non utilisé.
security_type character varying Type de sécurité de la vue. INVOKER ou DEFINER.

Pour en savoir plus, consultez la section À propos des vues.

Examples

Renvoie des informations sur chaque table dans le schéma par défaut:

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

Renvoyez le nom de toutes les tables et vues dans le fichier information_schema pour les bases de données du dialecte PostgreSQL:

SELECT table_name
FROM information_schema.tables
WHERE table_schema = "information_schema"

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

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

Renvoie des informations sur chaque index du schéma par défaut dans la base de données actuelle:

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

Renvoyez toutes les colonnes qui utilisent d'autres options que la colonne 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_schema = 'public'
ORDER BY
  t.table_schema,
  t.table_name,
  t.column_name,
  t.option_name

Renvoyez les options de base de données actuelles liées à l'optimiseur: 

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

Renvoyez tous les packages de statistiques disponibles: 

SELECT *
FROM information_schema.spanner_statistics;

Étapes suivantes

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