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

Un 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 disposant d'un contrôle d'accès pré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 de un contrôle des accès précis.

Utilisation

Les tables INFORMATION_SCHEMA ne sont disponibles que via des interfaces SQL, pour 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

Comptes principaux disposant d'autorisations IAM au niveau de la base de données et de ceux qui se sont vu accorder l'accès spanner_info_reader rôle système (ou aux membres de ce peut voir toutes les lignes de toutes les tables "information_schema". Autre principaux, pour certaines tables, les lignes sont filtrées en fonction de la de base de données. Description des tables et des vues dans les sections suivantes indiquent comment le filtrage des lignes est appliqué pour chaque table et vue.

Tables de INFORMATION_SCHEMA

Les sections suivantes décrivent les tables de l'INFORMATION_SCHEMA pour les bases de données GoogleSQL-dialect.

SCHEMATA

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

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

DATABASE_OPTIONS

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

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

PLACEMENTS

Ce tableau répertorie les emplacements de la base de données.

Nom de la colonne Type Description
PLACEMENT_NAME STRING Nom de l'emplacement.
IS_DEFAULT BOOL Valeur booléenne indiquant si l'emplacement est l'emplacement par défaut.

PLACEMENT_OPTIONS

Pour chaque emplacement, ce tableau liste les options définies pour l'emplacement dans la clause OPTIONS de l'instruction CREATE PLACEMENT.

Les valeurs valides pour OPTION_NAME sont les suivantes :

  • instance_partition
  • default_leader
Nom de la colonne Type Description
PLACEMENT_NAME STRING Nom de l'emplacement.
OPTION_NAME STRING Nom de l'option d'emplacement.
OPTION_TYPE STRING Type de données de l'option d'emplacement. Pour les deux options, il s'agit de STRING(MAX).
OPTION_VALUE STRING Valeur de l'option d'emplacement. Pour instance_partition, il s'agit du nom de la partition de l'instance. Pour default_leader, il s'agit du nom de la région principale par défaut.

TABLES

Ce tableau filtré par ligne répertorie les tables et les vues de la base de données. Comptes principaux avec des autorisations IAM au niveau de la base de données et des comptes principaux a été autorisé à accéder au rôle système spanner_info_reader ou à des membres de ce peut voir toutes les lignes de cette vue. Tous les autres principaux ne peuvent voir que les tables qui répondent à l'une des exigences suivantes :

  • Les droits de contrôle des accès ultraprécis SELECT, INSERT, UPDATE ou DELETE sont accordés dans la 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.
  • Les autorisations SELECT, INSERT ou UPDATE sont accordées 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, il a la valeur BASE TABLE. Pour les vues, la valeur est VIEW. Pour les synonymes, la valeur est SYNONYM.
PARENT_TABLE_NAME STRING Nom de la table parente si cette table est entrelacée et NULL dans les autres cas.
ON_DELETE_ACTION STRING Ce paramètre est défini sur CASCADE ou NO ACTION pour les tables entrelacées, et sur NULL dans les autres cas. Voir TABLEAU pour en savoir plus.
SPANNER_STATE STRING Une table peut passer par plusieurs états lors de la création, si des opérations groupées sont impliquées. Par exemple, lorsque la table est créée avec une clé étrangère qui nécessite un remplissage de ses index. Les états possibles sont les suivants :
  • ADDING_FOREIGN_KEY : ajout des clés étrangères de la table.
  • WAITING_FOR_COMMIT : finalisation de la modification du schéma.
  • COMMITTED : la modification du schéma de création de 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: <ph type="x-smartling-placeholder">
    </ph>
  • IN: la table n'a pas de parent-enfant relation. Une ligne de ce tableau peut exister quel que soit le de la ligne de table parente.
  • IN PARENT: la table a une relation parent-enfant. Une ligne de cette table nécessite l'existence de la ligne de sa table parente.
  • Une chaîne vide indique que ce tableau n'a pas d'entrelacement des relations.
ROW_DELETION_POLICY_EXPRESSION STRING Le texte de l'expression qui définit le règle de suppression des lignes de la table. Par exemple, OLDER_THAN(CreatedAt, INTERVAL 1 DAY) ou OLDER_THAN(ExpiredDate, INTERVAL 0 DAY)

COLUMNS

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

  • SELECT, INSERT ou UPDATE des droits de contrôle des accès ultraprécis sont accordés directement au niveau de la colonne le rôle de base de données, rôle de base de données actuel est membre, ou à public.
  • N'importe lequel des SELECT, INSERT ou Contrôle précis des accès UPDATE droits accordés sur la table contenant la colonne rôle de base de données, aux rôles dont dépend le rôle actuel de base de données public
Nom de la colonne Type Description
TABLE_CATALOG STRING Non utilisé. Toujours une chaîne vide.
TABLE_SCHEMA STRING Non utilisé. Toujours une chaîne vide.
TABLE_NAME STRING Nom de la table.
COLUMN_NAME STRING Nom de la colonne.
ORDINAL_POSITION INT64 Position ordinale de la colonne dans la table, commençant par la valeur 1.
COLUMN_DEFAULT STRING

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

Remarque:Avant mars 2022, COLUMN_DEFAULT utilisé le type BYTES.

DATA_TYPE STRING Inclus pour respecter la norme SQL. Toujours NULL. Consultez le colonne SPANNER_TYPE
IS_NULLABLE STRING Chaîne qui indique si la colonne peut être vide. Conformément à la norme SQL, la chaîne comprend une valeur YES ou NO à la place d'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é.
  • COMMITTED : la colonne est entièrement utilisable.

COLUMN_PRIVILEGES

Ce tableau filtré par ligne liste tous les droits accordés au niveau des colonnes à tout rôle de base de données, y compris public. Les principaux disposant d'autorisations IAM au niveau de la base de données et les principaux auxquels l'accès au rôle système spanner_info_reader ou aux membres de ce rôle a été accordé peuvent voir toutes les lignes de cette vue. Tous les autres principaux ne peuvent voir les droits que pour les colonnes qui répondent à l'une des conditions suivantes :

  • Les droits de contrôle d'accès précis SELECT, INSERT ou UPDATE sont directement accordés sur la colonne 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.
  • Les autorisations de contrôle d'accès précis SELECT, INSERT ou UPDATE sont accordées sur la table contenant la colonne 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 contenant la colonne privilégiée.
COLUMN_NAME STRING Nom de la colonne privilégiée.
PRIVILEGE_TYPE STRING SELECT, INSERT, UPDATE
GRANTEE STRING Nom du rôle de base de données auquel ce privilège est accordé.

TABLE_PRIVILEGES

Ce tableau filtré par ligne liste tous les droits accordés au niveau du tableau pour rôles de base de données, y compris public. Comptes principaux avec IAM au niveau de la base de données comptes principaux et autorisations disposant d'un accès le rôle système spanner_info_reader ou aux membres de ce rôle peuvent voir toutes les lignes de cette vue. Tous les autres principaux ne peuvent voir les privilèges que pour les tables sur lesquelles l'un des privilèges de contrôle d'accès précis SELECT, INSERT, UPDATE ou DELETE 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
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 pour laquelle des droits de contrôle des accès précis sont accordés.
PRIVILEGE_TYPE STRING Au choix : SELECT, INSERT, UPDATE et 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
  • PLACEMENT 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 clé primaire ou de la contrainte unique référencé par la clé étrangère. Toujours une chaîne vide.
UNIQUE_CONSTRAINT_SCHEMA STRING Nom de schéma de la CLÉ PRINCIPALE ou de la contrainte UNIQUE de la CLÉ FOREIGN de référence. Chaîne vide si elle n'est pas nommée.
UNIQUE_CONSTRAINT_NAME STRING Nom de la CLÉ PRINCIPALE ou de la contrainte UNIQUE de la CLÉ FOREIGN de référence.
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 stockage de la clé étrangère sont créés et remplis. Une fois les index prêts, Spanner commence à appliquer la contrainte pour les nouvelles transactions tout en validant les données existantes. Voici les valeurs possibles et les états qu'elles représentent :
  • BACKFILLING_INDEXES : les index sont en cours de remplissage.
  • VALIDATING_DATA : les données existantes et les nouvelles écritures sont en cours de validation.
  • WAITING_FOR_COMMIT: les opérations groupées de clé étrangère ont s’est terminée avec succès, ou qu’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

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

  • SELECT, INSERT ou UPDATE des droits de contrôle des accès ultraprécis sont accordés directement au niveau de la colonne le rôle de base de données, rôle de base de données actuel est membre, ou à public.
  • N'importe lequel des SELECT, INSERT ou Contrôle précis des accès UPDATE droits accordés sur la table contenant la colonne rôle de base de données, aux rôles dont dépend le rôle actuel de base de données 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. Une zone 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 La position ordinale de la colonne dans la clé de la contrainte, commençant par la valeur 1.
POSITION_IN_UNIQUE_CONSTRAINT INT64 Pour la valeur FOREIGN KEY, la position ordinale de la colonne dans la contrainte unique, commençant par la valeur 1. Cette colonne affiche la valeur NULL 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 FOREIGN KEY de contraintes.

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'est pas nommée.
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 liste les informations sur les synonymes de la table.

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

INDEXES

Ce tableau filtré par ligne répertorie les index de la base de données. Comptes principaux avec autorisations IAM au niveau de la base de données et comptes principaux qui ont été a été autorisé à accéder au rôle système spanner_info_reader ou à des membres de ce peut voir toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent afficher que les index qui répondent à l'une des exigences suivantes:

  • Les droits de contrôle des accès précis SELECT, INSERT ou UPDATE sont accordés au niveau de la colonne sur toutes les colonnes de l'index 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.
  • Les droits de contrôle d'accès précis SELECT, INSERT, UPDATE ou DELETE sont accordés sur la table qui contient l'index du rôle de base de données actuel, des rôles dont le rôle de base de données actuel est membre ou de 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 d'une spécification PRIMARY KEY possèdent une entrée de pseudo-index générée avec le nom PRIMARY_KEY, ce qui permet de déterminer les champs de la clé primaire.
INDEX_TYPE STRING Type d'index. Le type est INDEX ou PRIMARY_KEY
PARENT_TABLE_NAME STRING Les index secondaires peuvent être entrelacés dans une table parente, comme indiqué. de la section Créer un index secondaire Cette colonne contient le nom de la table parente ou une chaîne vide si l'index n'est pas entrelacé.
IS_UNIQUE BOOL Si les clés d'index doivent être uniques.
IS_NULL_FILTERED BOOL Si l'index inclut des entrées dotées de valeurs NULL.
INDEX_STATE STRING État actuel de l'index. Voici les valeurs possibles et les états qu'elles représentent :
  • PREPARE : créer des tables vides pour un nouvel index.
  • WRITE_ONLY : remplir des données pour un nouvel index.
  • WRITE_ONLY_CLEANUP : nettoyer un nouvel index.
  • WRITE_ONLY_VALIDATE_UNIQUE: vérifier l'unicité des données dans un nouvel index.
  • READ_WRITE : opération d'index normale.
SPANNER_IS_MANAGED BOOL TRUE si l'index est géré par Spanner ; Sinon, FALSE Les index de stockage secondaires pour les clés étrangères sont gérés par Spanner.

INDEX_COLUMNS

Ce tableau filtré par ligne répertorie les colonnes d'un index. Comptes principaux avec autorisations IAM au niveau de la base de données et comptes principaux qui ont été a été autorisé à accéder au rôle système spanner_info_reader ou à des membres de ce peut voir toutes les lignes de cette vue. Tous les autres principaux ne peuvent voir que les index qui répondent à l'une des conditions suivantes :

  • Les droits de contrôle des accès précis SELECT, INSERT ou UPDATE sont accordés au niveau de la colonne sur toutes les colonnes de l'index 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.
  • Les droits de contrôle d'accès précis SELECT, INSERT ou UPDATE sont accordés sur la table qui a un indice pour le 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.
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 La position ordinale de la colonne dans l'index (ou primaire ), en 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é colonnes (par exemple, les colonnes spécifiées dans STORING d'un index).
IS_NULLABLE STRING Chaîne qui indique si la colonne peut être vide. Dans conformément à la norme SQL, la chaîne est YES ou NO, et non une valeur booléenne.
SPANNER_TYPE STRING Type de données de la colonne.

COLUMN_OPTIONS

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

  • Les droits de contrôle d'accès précis SELECT, INSERT ou UPDATE sont directement accordés sur la colonne 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.
  • Les autorisations de contrôle d'accès précis SELECT, INSERT ou UPDATE sont accordées sur la table contenant la colonne 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 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 répertorie les métadonnées des séquences. SEQUENCES est filtré sur les lignes en fonction de si un utilisateur disposant de droits d'accès précis est de les interroger.

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 de la séquence. Elle utilise le INT64 type de données.

SEQUENCE_OPTIONS

Ce tableau contient les options de configuration des séquences. SEQUENCE_OPTIONS est filtré sur les lignes en fonction des droits d'accès précis, si un utilisateur disposant des privilèges 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 obtenue à partir de l'analyse de la valeur doit permettre la conversion en OPTION_TYPE.

SPANNER_STATISTICS

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

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

VIEWS

Ce tableau filtré par ligne liste les vues de la base de données. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux auxquels l'accès au rôle système spanner_info_reader ou aux membres de ce rôle a été accordé peuvent voir toutes les lignes de cette vue. Tous les autres principaux ne peuvent voir que les vues pour lesquelles l'autorisation de contrôle d'accès précis SELECT est accordée 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 Nom du catalogue. Toujours une chaîne vide.
TABLE_SCHEMA STRING Nom du schéma. Chaîne vide si elle n'est pas nommée.
TABLE_NAME STRING Nom de la vue.
VIEW_DEFINITION STRING Texte SQL de la requête qui définit la vue.
SECURITY_TYPE STRING Type de sécurité de la vue. INVOKER ou DEFINER.

Pour en savoir plus, consultez À propos des vues.

ROLES

Ce tableau filtré par ligne liste les rôles de base de données définis pour un accès plus précis. de contrôle, y compris les rôles système. Les principaux disposant d'autorisations IAM au niveau de la base de données et les principaux auxquels l'accès au rôle système spanner_info_reader ou aux membres de ce rôle a été accordé peuvent voir tous les rôles de base de données. Tous les autres comptes principaux ne peuvent voir que la base de données rôles auxquels l'accès a été accordé, directement ou via l'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

Ce tableau filtré par ligne liste toutes les appartenances aux rôles explicitement accordées à tous rôles de base de données. Comptes principaux disposant d'autorisations IAM au niveau de la base de données et comptes principaux disposant d'un accès le rôle système spanner_info_reader ou aux membres de ce rôle peuvent voir toutes les lignes de cette vue. Tous les autres principaux ne peuvent voir que les appartenances aux rôles accordées au rôle de base de données actuel ou à un rôle dont le rôle de base de données actuel est membre.

Comme tous les rôles de base de données sont membres de l'environnement public rôle, les résultats omettent les enregistrements l'appartenance implicite au rôle public.

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

CHANGE_STREAMS

Ce tableau filtré par ligne répertorie tous les flux de modifications d'une base de données et indique ce qui ceux permettent de suivre l'ensemble de la base de données par rapport à des tableaux ou des colonnes spécifiques. Comptes principaux avec des autorisations IAM au niveau de la base de données et des comptes principaux a été autorisé à accéder au rôle système spanner_info_reader ou à des membres de ce peut voir toutes les lignes de cette vue. Tous les autres principaux ne peuvent voir que les flux de modifications pour lesquels l'autorisation de contrôle des accès précis SELECT est accordée 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 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'ensemble de la base de données. FALSE si ce flux de modifications suit des tables ou des colonnes spécifiques.

CHANGE_STREAM_TABLES

Ce tableau filtré par ligne contient des informations sur les tableaux et les flux de modifications. qui les regardent. Chaque ligne décrit une table et un flux de modifications. Les principaux disposant d'autorisations IAM au niveau de la base de données et les principaux auxquels l'accès au rôle système spanner_info_reader ou aux membres de ce rôle a été accordé peuvent voir toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les lignes des flux de modifications pour lesquels le privilège 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.

Les données de CHANGE_STREAM_TABLES n'incluent pas les relations implicites entre les tables et les flux de modifications qui suivent l'ensemble 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 tableau auquel cette ligne fait référence. Dans le cas contraire, cette valeur est définie sur FALSE.

CHANGE_STREAM_COLUMNS

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

Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux auxquels l'accès au rôle système spanner_info_reader ou aux membres de ce rôle a été accordé peuvent voir toutes les lignes de cette vue. Tous les autres 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 STRING Nom du catalogue du flux de modifications. Toujours une chaîne vide.
CHANGE_STREAM_SCHEMA STRING Nom du schéma du flux de modifications. Toujours une chaîne vide.
CHANGE_STREAM_NAME STRING Nom du flux de modifications.
TABLE_CATALOG STRING Nom du catalogue de la table. Toujours une chaîne vide.
TABLE_SCHEMA STRING Nom du schéma de la table. Toujours une chaîne vide.
TABLE_NAME STRING Nom de la table à laquelle cette ligne fait référence.
COLUMN_NAME STRING Nom de la colonne à laquelle cette ligne fait référence.

CHANGE_STREAM_OPTIONS

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

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

CHANGE_STREAM_PRIVILEGES

Ce tableau filtré par ligne liste tous les droits de contrôle des accès précis accordés pour toutes les modifications vers n'importe quel rôle de base de données, y compris public. Les principaux disposant d'autorisations IAM au niveau de la base de données et ceux auxquels l'accès au rôle système spanner_info_reader ou aux membres de ce rôle a été accordé peuvent voir toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les droits accordé dans les flux de modifications au rôle de base de données actuel, aux rôles rôle de base de données actuel est membre, 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 (seul privilège autorisé pour les flux de modifications).
GRANTEE STRING Nom du rôle de base de données auquel ce droit est accordé.

ROUTINES

Ce tableau filtré par ligne répertorie toutes les fonctions de lecture du flux de modifications d'une base de données. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux auxquels l'accès au rôle système spanner_info_reader ou aux membres de ce rôle a été accordé peuvent voir toutes les lignes de cette vue. Tous les autres principaux ne peuvent voir que les fonctions de lecture du flux de modifications pour lesquelles le droit de contrôle des accès précis 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 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 de manière unique la routine, même si son nom est surchargé.
ROUTINE_CATALOG STRING Nom du catalogue de la routine. Toujours une chaîne vide.
ROUTINE_SCHEMA STRING Nom du schéma de la routine. Toujours une chaîne vide.
ROUTINE_NAME STRING Nom de la routine. (Peut être dupliqué en cas de surcharge.)
ROUTINE_TYPE STRING Le type de la routine (FUNCTION ou PROCEDURE). Toujours FUNCTION
DATA_TYPE STRING Type de données renvoyé par la routine
ROUTINE_BODY STRING Le type du corps de la routine (SQL ou EXTERNAL).
ROUTINE_DEFINITION STRING Définition du ROUTINE_BODY.
SECURITY_TYPE STRING Type de sécurité de la routine. Toujours INVOKER.

ROUTINE_OPTIONS

Ce tableau filtré par ligne contient une ligne pour chaque option, pour chaque modification définie. la fonction de lecture de flux.

Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux auxquels l'accès au rôle système spanner_info_reader ou aux membres de ce rôle a été accordé peuvent voir toutes les lignes de cette vue. Tous les autres principaux ne peuvent voir que les options pour les fonctions de lecture du flux de modifications sur lesquelles l'autorisation de contrôle des accès précis EXECUTE est accordée 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
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 au cas où de surcharge de noms.
OPTION_NAME STRING Identifiant SQL qui identifie l'option de manière unique.
OPTION_TYPE STRING Type de données de OPTION_VALUE.
OPTION_VALUE STRING Littéral SQL décrivant la valeur de cette option. La valeur de cette colonne doit pouvoir être analysée dans le cadre d'une requête.

PARAMETERS

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

Comptes principaux disposant d'autorisations IAM au niveau de la base de données et de ceux qui L'accès au rôle système spanner_info_reader ou à des membres a été accordé à des membres peuvent voir toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que paramètres des fonctions de lecture du flux de modifications sur lesquelles le contrôle ultraprécis des accès EXECUTE des droits sont accordés au rôle de base de données actuel, auquel cas le rôle actuel de base de données 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 au cas où de surcharge de noms.
ORDINAL_POSITION INT64 Position ordinale du paramètre dans la routine, commençant par la valeur 1.
PARAMETER_NAME STRING Nom du paramètre.
DATA_TYPE STRING Type de données du paramètre.

ROUTINE_PRIVILEGES

Ce tableau filtré par ligne répertorie tous les droits de contrôle des accès ultraprécis accordés à toutes les fonctions de lecture du 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 ceux auxquels l'accès au rôle système spanner_info_reader ou aux membres de ce rôle a été accordé peuvent voir toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les droits accordés sur le flux de modifications lire les fonctions au rôle de base de données actuel, aux rôles dont de base de données 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 au cas où de surcharge de noms.
PRIVILEGE_TYPE STRING Toujours EXECUTE.
GRANTEE STRING Nom du rôle de base de données auquel ce privilège est accordé.

ROLE_TABLE_GRANTS

Ce tableau filtré par ligne liste tous les droits de contrôle des accès précis accordés sur l'ensemble des tables et les vues 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 ceux auxquels l'accès au rôle système spanner_info_reader ou aux membres de ce rôle a été accordé peuvent voir toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les autorisations accordées sur les tables et les vues au rôle de base de données actuel et aux rôles dont le rôle de base de données actuel 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 privilège 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 privilège (SELECT, INSERT, UPDATE ou DELETE).
IS_GRANTABLE STRING Non utilisé. Toujours NO.

ROLE_COLUMN_GRANTS

Ce tableau filtré par ligne répertorie tous les droits de contrôle des accès ultraprécis accordés à toutes les colonnes pour tous les rôles de base de données, y compris public. Comptes principaux avec autorisations IAM au niveau de la base de données et comptes principaux qui ont été auquel vous avez accordé l'accès le rôle système spanner_info_reader ou aux membres de ce rôle peuvent voir toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les droits accordés sur les colonnes pour le rôle de base de données actuel et aux rôles dont il dépend membre, à l'exclusion de public.

La vue inclut les droits SELECT, INSERT et UPDATE que le hérite de la table ou de la vue qui la contient.

Nom de colonne Type Description
GRANTOR STRING Non utilisé. Toujours NULL.
GRANTEE STRING Nom du rôle de base de données auquel ce privilège 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 Le type de droit (SELECT, INSERT ou UPDATE).
IS_GRANTABLE STRING Non utilisé. Toujours NO.

ROLE_CHANGE_STREAM_GRANTS

Ce tableau filtré par ligne liste les droits SELECT accordés pour toutes les modifications vers n'importe quel rôle de base de données, y compris public. Les principaux disposant d'autorisations IAM au niveau de la base de données et ceux auxquels l'accès au rôle système spanner_info_reader ou aux membres de ce rôle a été accordé peuvent voir toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les droits accordé dans les flux de modifications au rôle de base de données actuel et aux rôles dont Le rôle actuel de base de données est membre, à 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 privilège (SELECT uniquement).
GRANTEE STRING Nom du rôle de base de données auquel ce privilège est accordé.

ROLE_MODEL_GRANTS

Ce tableau filtré par ligne répertorie tous les droits de contrôle des accès précis accordés sur l'ensemble des modèles. à n'importe quel rôle de base de données, y compris public. Comptes principaux avec autorisations IAM au niveau de la base de données et comptes principaux qui ont été a été autorisé à accéder au rôle système spanner_info_reader ou à des membres de ce peut voir toutes les lignes de cette vue. Tous les autres comptes principaux ne peuvent voir que les autorisations accordées sur les tables et les vues au rôle de base de données actuel et aux rôles dont le rôle de base de données actuel 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 privilège 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 du privilège (EXECUTE).
IS_GRANTABLE STRING Non utilisé. Toujours NO.

ROLE_ROUTINE_GRANTS

Ce tableau filtré par ligne liste les droits EXECUTE accordés pour toutes les modifications diffuser des fonctions de lecture vers n'importe quel rôle de base de données, y compris public ; Comptes principaux avec IAM les autorisations au niveau de la base de données et les comptes principaux autorisés à accéder le rôle système spanner_info_reader ou aux membres de ce rôle peuvent voir toutes les lignes de cette vue. Tous les autres principaux ne peuvent voir que les droits accordés sur les fonctions de lecture du 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 est membre, à 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 la routine.
SPECIFIC_NAME STRING Nom de la routine. Identifie de manière unique la routine en cas de surcharge de nom.
PRIVILEGE_TYPE STRING Type de droit accordé. Toujours EXECUTE.
IS_GRANTABLE STRING Non utilisé. Toujours NO.

MODELS

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

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

MODEL_OPTIONS

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

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

MODEL_COLUMNS

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

Nom de la colonne Type Description
MODEL_CATALOG STRING Nom du catalogue. Toujours une chaîne vide.
MODEL_SCHEMA STRING Nom du schéma de ce modèle. Toujours une chaîne vide.
MODEL_NAME STRING Nom du modèle.
COLUMN_KIND STRING Type de colonne du modèle. "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, à conserver l'ordre des colonnes déclarées.
IS_EXPLICIT BOOL TRUE si la colonne a été spécifiée explicitement dans le DDL, 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 du 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 Type de colonne du modèle. "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 du modèle.
OPTION_VALUE STRING Valeur d'option de la colonne de modèle.

MODEL_PRIVILEGES

Ce tableau filtré par ligne liste tous les droits accordés au niveau du modèle aux rôles de base de données, y compris public. Les principaux disposant d'autorisations IAM au niveau de la base de données et les principaux auxquels l'accès au rôle système spanner_info_reader ou aux membres de ce rôle a été accordé peuvent voir toutes les lignes de cette vue. Tous les autres principaux ne peuvent voir les autorisations que pour les modèles sur lesquels le droit de contrôle des accès précis 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 est membre 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 les droits de contrôle des accès précis sont accordés.
PRIVILEGE_TYPE STRING EXECUTE>
GRANTEE STRING Nom du rôle de base de données auquel ce privilège est accordé.

PROPERTY_GRAPHS

Ce tableau filtré par ligne répertorie les graphiques de propriétés dans la base de données. Les comptes principaux disposant d'autorisations IAM au niveau de la base de données et ceux auxquels l'accès au rôle système spanner_info_reader ou aux membres de ce rôle a été accordé peuvent voir toutes les lignes de cette vue. Toutes les autres les comptes principaux ne peuvent voir les graphiques de propriétés que s'ils remplissent les conditions requises pour voir les tableaux utilisés pour définir ces graphiques.

Nom de la colonne Type Description
PROPERTY_GRAPH_CATALOG STRING Nom du catalogue. Toujours une chaîne vide.
PROPERTY_GRAPH_SCHEMA STRING Nom du schéma. Chaîne vide si elle n'est pas nommée.
PROPERTY_GRAPH_NAME STRING Nom du graphe de propriétés.
PROPERTY_GRAPH_METADATA_JSON JSON Définition du graphique de propriétés au format JSON.

La colonne PROPERTY_GRAPH_METADATA_JSON contient un objet JSON PropertyGraph défini comme suit :

Nom de l'objet JSON Nom du champ Type JSON Description
PropertyGraph catalog string Nom du catalogue. Toujours une chaîne vide.
schema string Nom du schéma. Chaîne vide si elle n'est pas nommée.
name string Nom du graphique de propriétés.
nodeTables array<object> Liste d'objets GraphElementTable pour les nœuds.
edgeTables array<object> Liste d'objets GraphElementTable pour les arêtes.
labels array<object> Liste d'objets GraphElementLabel.
propertyDeclarations array<object> Liste d'objets GraphPropertyDeclaration.
GraphElementTable name string Nom du tableau des éléments du graphique.
kind string NODE ou EDGE.
baseCatalogName string Nom du catalogue contenant la table de base.
baseSchemaName string Nom du schéma contenant la table de base.
baseTableName string Nom de la table d'entrée à partir de laquelle les éléments sont créés.
keyColumns array<string> Noms des colonnes qui constituent la clé de l'élément.
labelNames array<string> Noms des libellés associés à ce tableau d'éléments.
propertyDefinitions array<object> Liste d'objets GraphPropertyDefinition.
sourceNodeTable object Un objet GraphNodeTableReference. N'existent que lorsque le kind est EDGE.
destinationNodeTable object Un objet GraphNodeTableReference. N'existent que lorsque le kind est EDGE.
GraphNodeTableReference nodeTableName string Nom du tableau des éléments du graphique.
edgeTableColumns array<string> Le nom des colonnes associées à la source et clés de destination des arêtes.
nodeTableColumns array<string> Le nom des colonnes associées à la source et clés de destination des nœuds.
GraphElementLabel name string Nom du libellé.
propertyDeclarationNames array<string> Noms des propriétés associées à cette étiquette.
GraphPropertyDeclaration name string Nom de la propriété.
type string Type de propriété.
GraphPropertyDefinition propertyDeclarationName string Nom de l'établissement.
valueExpressionSql string Expression qui définit la propriété.

Examples

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

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

Renvoyez le nom de toutes les tables de INFORMATION_SCHEMA:

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

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

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

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

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

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

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

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

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

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

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

Renvoie tous les packages de statistiques disponibles : 

SELECT
  *
FROM
  information_schema.spanner_statistics;

Renvoyer toutes les séquences: 

SELECT
  *
FROM
  information_schema.sequences;

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

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

Renvoie les noms de tous les graphiques de propriétés et leurs définitions:

SELECT
  property_graph_name,
  property_graph_metadata_json
FROM
  information_schema.property_graphs

Renvoyez les noms de tous les graphiques de propriétés, ainsi que leurs libellés et leurs propriétés :

SELECT
  property_graph_name,
  property_graph_metadata_json.labels,
  property_graph_metadata_json.propertyDeclarations
FROM
  information_schema.property_graphs

Étape suivante

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