Esquema de información para bases de datos de dialecto de GoogleSQL

El esquema de información es un esquema integrado que es común a todas las bases de datos de Spanner. Puedes ejecutar consultas en SQL en las tablas del INFORMATION_SCHEMA para recuperar metadatos del esquema de una base de datos.

Por ejemplo, la siguiente consulta recupera los nombres de todas las tablas definidas por el usuario en una base de datos:

  SELECT
    table_schema,
    table_name
  FROM
    information_schema.tables
  WHERE
    table_schema NOT IN ('information_schema', 'SPANNER_SYS')
    AND table_type = 'BASE TABLE'

Los usuarios del control de acceso detallado ven resultados filtrados para algunas tablas de INFORMATION_SCHEMA, según su rol de base de datos. Para obtener más información, consulta Acerca del control de acceso detallado.

Uso

Las tablas de INFORMATION_SCHEMA solo están disponibles a través de interfaces de SQL, por ejemplo:

  • La API de executeQuery
  • El comando gcloud spanner databases execute-sql
  • La página Spanner Studio de una base de datos en la consola de Google Cloud )

Otros métodos de lectura única no admiten INFORMATION_SCHEMA.

Estas son algunas notas adicionales sobre el uso de INFORMATION_SCHEMA:

Filtrado de filas en tablas de information_schema

Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader (o a los miembros de ese rol) pueden ver todas las filas de todas las tablas de information_schema. Para otras principales, en algunas tablas, las filas se filtran según el rol de la base de datos actual. Las descripciones de las tablas y las vistas en las siguientes secciones indican cómo se aplica el filtrado de filas para cada tabla y vista.

Tablas en INFORMATION_SCHEMA

En las siguientes secciones, se describen las tablas en INFORMATION_SCHEMA para las bases de datos de dialecto de GoogleSQL.

SCHEMATA

La tabla INFORMATION_SCHEMA.SCHEMATA enumera los esquemas en la base de datos. Estos incluyen el esquema de información y los esquemas con nombre, que contienen las tablas que defines.

Nombre de la columna Tipo Descripción
CATALOG_NAME STRING Es el nombre del catálogo. Esta columna existe para garantizar la compatibilidad con las tablas de esquema de información estándar de SQL. Esta columna siempre es una cadena vacía.
SCHEMA_NAME STRING Es el nombre del esquema. Este es un nombre para los esquemas con nombre o "" para el esquema predeterminado.
PROTO_BUNDLE STRING Si la base de datos contiene declaraciones de paquetes de proto, esta columna proporciona información sobre el paquete de proto que se usa en el esquema. Esta columna es NULL si no existe ningún paquete de proto en la base de datos.

DATABASE_OPTIONS

En esta tabla, se enumeran las opciones que se configuran en la base de datos.

Nombre de la columna Tipo Descripción
CATALOG_NAME STRING Es el nombre del catálogo. Siempre es una string vacía.
SCHEMA_NAME STRING Es el nombre del esquema. Es una string vacía si no tiene nombre.
OPTION_NAME STRING El nombre de la opción de base de datos.
OPTION_TYPE STRING Tipo de datos de la opción de base de datos.
OPTION_VALUE STRING El valor de la opción de base de datos.

PLACEMENTS

En esta tabla, se enumeran las posiciones de la base de datos.

Nombre de la columna Tipo Descripción
PLACEMENT_NAME STRING Es el nombre de la posición.
IS_DEFAULT BOOL Es un valor booleano que indica si la posición es la predeterminada.

PLACEMENT_OPTIONS

En esta tabla, se enumeran las opciones que se establecen en la ubicación en la cláusula OPTIONS de la sentencia CREATE PLACEMENT.

Los valores válidos para OPTION_NAME incluyen los siguientes:

  • instance_partition
  • default_leader
Nombre de la columna Tipo Descripción
PLACEMENT_NAME STRING Es el nombre de la posición.
OPTION_NAME STRING Es el nombre de la opción de posición.
OPTION_TYPE STRING Es el tipo de datos de la opción de posición. En ambas opciones, es STRING(MAX).
OPTION_VALUE STRING Es el valor de la opción de posición. En el caso de instance_partition, este es el nombre de la partición de la instancia. Para default_leader, es el nombre de la región líder predeterminada.

LOCALITY_GROUP_OPTIONS

Para cada grupo de localidad, en esta tabla, se enumeran el nombre y las opciones que se establecen en el grupo de localidad en la cláusula OPTIONS de la sentencia CREATE LOCALITY GROUP.

Nombre de la columna Tipo Descripción
LOCALITY_GROUP_NAME STRING Es el nombre del grupo de localidades.
OPTION_NAME STRING Es el nombre de la opción del grupo de localidades. Las opciones válidas son las siguientes:
  • STORAGE: Define el tipo de almacenamiento para el grupo de localidad.
  • SSD_TO_HDD_SPILL_TIMESPAN: Define cuánto tiempo se almacenan los datos en el almacenamiento SSD antes de que se muevan al almacenamiento HDD.
OPTION_VALUE STRING Es el valor de la opción de grupo de localidad. Para STORAGE, puede ser ssd o hdd. Para SSD_TO_HDD_SPILL_TIMESPAN, esta es la cantidad de tiempo que los datos deben almacenarse en SSD antes de que se muevan al almacenamiento HDD. Por ejemplo, 10d es de 10 días. La cantidad mínima de tiempo que puedes establecer es de una hora.

TABLES

En esta tabla con filtro de filas, se enumeran las tablas y vistas de la base de datos. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver las tablas que cumplen con cualquiera de los siguientes requisitos:

  • Los privilegios de control de acceso detallado SELECT, INSERT, UPDATE o DELETE se otorgan en la tabla al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.
  • Los privilegios SELECT, INSERT o UPDATE se otorgan en cualquier columna de la tabla al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.
Nombre de la columna Tipo Descripción
TABLE_CATALOG STRING No se usa. Siempre es una string vacía.
TABLE_SCHEMA STRING Es el nombre del esquema de la tabla. El nombre está vacío para el esquema predeterminado y contiene un valor para otros esquemas. Esta columna siempre contiene un valor.
TABLE_NAME STRING Es el nombre de la tabla, la vista o el sinónimo.
TABLE_TYPE STRING El tipo de tabla. Para las tablas, tiene el valor BASE TABLE; para las vistas, tiene el valor VIEW; para los sinónimos, tiene el valor SYNONYM.
PARENT_TABLE_NAME STRING Es el nombre de la tabla superior si esta tabla está intercalada y, de lo contrario, NULL.
ON_DELETE_ACTION STRING Se establece en CASCADE o NO ACTION para tablas intercaladas y, de lo contrario, en NULL. Consulta sentencias TABLE para obtener más información.
SPANNER_STATE STRING Una tabla puede pasar por varios estados durante la creación si se trata de operaciones masivas. Por ejemplo, cuando la tabla se crea con una clave externa que requiere el reabastecimiento de sus índices. Los estados posibles son los siguientes:
  • ADDING_FOREIGN_KEY: agrega las claves externas de la tabla
  • WAITING_FOR_COMMIT: finaliza el cambio de esquema.
  • COMMITTED: Se confirmó el cambio de esquema para crear la tabla. No puedes escribir en la tabla hasta que se confirme el cambio.
INTERLEAVE_TYPE STRING Es el texto de la expresión que indica si existe una relación superior-secundario entre esta tabla y la tabla en la que se intercala. Los valores posibles son los siguientes:
  • IN: La tabla no tiene una relación superior-secundario. Una fila de esta tabla puede existir independientemente de la existencia de la fila de la tabla superior.
  • IN PARENT: La tabla tiene una relación superior-secundario. Una fila de esta tabla requiere la existencia de su fila de tabla superior.
  • Una cadena vacía indica que esta tabla no tiene relaciones de intercalación.
ROW_DELETION_POLICY_EXPRESSION STRING Es el texto de la expresión que define la política de eliminación de filas de la tabla. Por ejemplo, OLDER_THAN(CreatedAt, INTERVAL 1 DAY) o OLDER_THAN(ExpiredDate, INTERVAL 0 DAY).

COLUMNS

En esta tabla con filtro de filas, se enumeran las columnas de una tabla. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver las columnas que cumplen con uno de los siguientes requisitos:

  • Cualquiera de los privilegios de control de acceso detallado SELECT, INSERT o UPDATE se otorgan directamente en la columna al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.
  • Cualquiera de los privilegios de control de acceso detallado SELECT, INSERT o UPDATE se otorgan en la tabla que contiene la columna al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.
Nombre de la columna Tipo Descripción
TABLE_CATALOG STRING No se usa. Siempre es una string vacía.
TABLE_SCHEMA STRING Es el nombre del esquema de la tabla de la columna. El nombre está vacío para el esquema predeterminado y contiene un valor para otros esquemas. Esta columna siempre contiene un valor.
TABLE_NAME STRING Es el nombre de la tabla.
COLUMN_NAME STRING Es el nombre de la columna
ORDINAL_POSITION INT64 Es la posición ordinal de la columna en la tabla, que comienza con un valor de 1.
COLUMN_DEFAULT STRING

Es una representación de cadena de la expresión de SQL para el valor predeterminado de la columna. NULL si la columna no tiene un valor predeterminado.

Nota: Antes de marzo de 2022, COLUMN_DEFAULT usaba el tipo BYTES.

DATA_TYPE STRING Se incluye para satisfacer el estándar de SQL. Siempre NULL. Consulta la columna SPANNER_TYPE
IS_NULLABLE STRING Es una string que indica si la columna acepta el valor NULL. De acuerdo con el estándar de SQL, la cadena es YES o NO, en lugar de un valor booleano.
SPANNER_TYPE STRING Es el tipo de datos de la columna.
IS_GENERATED STRING Es una string que indica si la columna se genera. La string es ALWAYS para una columna generada o NEVER para una columna no generada.
GENERATION_EXPRESSION STRING Una string que representa la expresión SQL de una columna generada. NULL si la columna no es una columna generada.
IS_STORED STRING Una string que indica si se almacena la columna generada. La string siempre es YES para las columnas generadas y NULL para las columnas no generadas.
IS_HIDDEN STRING Es una cadena que se establece en TRUE si la columna no aparece en una consulta SELECT * y se establece en FALSE de lo contrario. Si la columna está oculta, puedes seleccionarla con su nombre (por ejemplo, SELECT Id, Name, ColHidden FROM TableWithHiddenColumn).
SPANNER_STATE STRING El estado actual de la columna. Una nueva columna generada almacenada que se agrega a una tabla existente puede pasar por varios estados que el usuario puede observar antes de que se pueda usar por completo. Los valores posibles son los siguientes:
  • WRITE_ONLY: La columna se está reabasteciendo. No se permite la lectura.
  • COMMITTED: la columna es completamente utilizable.
IS_IDENTITY STRING Es una cadena que se establece en YES si la columna generada es una columna de identidad y, de lo contrario, en NO.
IDENTITY_GENERATION STRING Es una cadena que especifica si la columna permite solo valores generados y no valores personalizados insertados por el usuario.
  • BY DEFAULT: Es el valor predeterminado. BY DEFAULT especifica que la columna usa valores generados si no se proporcionan valores insertados por el usuario.
  • ALWAYS: La columna solo permite valores generados, no personalizados, que inserte el usuario.
IDENTITY_KIND STRING Siempre BIT_REVERSED_POSITITVE_SEQUENCE. Solo se admiten secuencias positivas con bits invertidos.
IDENTITY_START_WITH_COUNTER STRING Es el valor inicial del contador interno antes de la transformación. Por ejemplo, el valor de inicio antes de la inversión de bits.
IDENTITY_SKIP_RANGE_MIN STRING Es el valor mínimo de un rango omitido después de la transformación.
IDENTITY_SKIP_RANGE_MAX STRING Es el valor máximo de un rango omitido después de la transformación.
ON_UPDATE_EXPRESSION STRING Una STRING con la representación de SQL de la expresión `ON UPDATE` para una columna. Si la columna no tiene un valor "ON UPDATE", el valor es "NULL".

COLUMN_PRIVILEGES

En esta tabla filtrada por filas, se enumeran todos los privilegios otorgados a nivel de columna a cualquier rol de base de datos, incluido public. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales pueden ver los privilegios solo para las columnas que cumplen con cualquiera de los siguientes requisitos:

  • Cualquiera de los privilegios de control de acceso detallado SELECT, INSERT o UPDATE se otorgan directamente en la columna al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.
  • Cualquiera de los privilegios de control de acceso detallado SELECT, INSERT o UPDATE se otorgan en la tabla que contiene la columna al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.
Nombre de la columna Tipo Descripción
TABLE_CATALOG STRING No se usa. Siempre es una string vacía.
TABLE_SCHEMA STRING Es el nombre del esquema de la tabla de la columna. El nombre está vacío para el esquema predeterminado y contiene un valor para otros esquemas. Esta columna siempre contiene un valor.
TABLE_NAME STRING Es el nombre de la tabla que contiene la columna con privilegios.
COLUMN_NAME STRING Es el nombre de la columna con privilegios.
PRIVILEGE_TYPE STRING SELECT, INSERT, UPDATE
GRANTEE STRING Es el nombre del rol de la base de datos al que se otorga este privilegio.

TABLE_PRIVILEGES

En esta tabla filtrada por filas, se enumeran todos los privilegios otorgados a nivel de tabla a los roles de la base de datos, incluido public. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales pueden ver los privilegios solo para las tablas en las que se otorgan algunos de los privilegios de control de acceso detallado SELECT, INSERT, UPDATE o DELETE al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.

Nombre de la columna Tipo Descripción
TABLE_CATALOG STRING No se usa. Siempre es una string vacía.
TABLE_SCHEMA STRING Es el nombre del esquema de la tabla. El nombre está vacío para el esquema predeterminado y contiene un valor para otros esquemas. Esta columna siempre contiene un valor.
TABLE_NAME STRING Es el nombre de la tabla en la que se otorgan privilegios de control de acceso detallado.
PRIVILEGE_TYPE STRING Uno de SELECT, INSERT, UPDATE y DELETE
GRANTEE STRING Es el nombre del rol de la base de datos al que se otorga este privilegio.

TABLE_CONSTRAINTS

Esta tabla contiene una fila para cada restricción definida para las tablas en la base de datos.

Nombre de la columna Tipo Descripción
CONSTRAINT_CATALOG STRING Siempre hay una string vacía.
CONSTRAINT_SCHEMA STRING El nombre del esquema de la restricción. Es una string vacía si no tiene nombre.
CONSTRAINT_NAME STRING El nombre de la restricción.
TABLE_CATALOG STRING El nombre del catálogo de la tabla restringida. Siempre es una string vacía.
TABLE_SCHEMA STRING Es el nombre del esquema de la tabla restringida. El nombre está vacío para el esquema predeterminado y contiene un valor para otros esquemas. Esta columna siempre contiene un valor.
TABLE_NAME STRING El nombre de la tabla restringida.
CONSTRAINT_TYPE STRING El tipo de restricción. Los valores posibles son los siguientes:
  • PRIMARY KEY
  • FOREIGN KEY
  • PLACEMENT KEY
  • CHECK
  • UNIQUE
IS_DEFERRABLE STRING Siempre NO.
INITIALLY_DEFERRED STRING Siempre NO.
ENFORCED STRING NO si la restricción es una clave externa informativa (NOT ENFORCED). YES para las claves externas aplicadas o cualquier otro tipo de restricción.

CONSTRAINT_TABLE_USAGE

En la tabla, se enumeran tablas que definen o usan las restricciones. Incluye tablas que definen restricciones PRIMARY KEY y UNIQUE. También incluye las tablas a las que se hace referencia en las definiciones FOREIGN KEY.

Nombre de la columna Tipo Descripción
TABLE_CATALOG STRING Es el nombre del catálogo de la tabla restringida. Siempre es una string vacía.
TABLE_SCHEMA STRING Es el nombre del esquema de la tabla restringida. El nombre está vacío para el esquema predeterminado y contiene un valor para otros esquemas. Esta columna siempre contiene un valor.
TABLE_NAME STRING El nombre de la tabla restringida.
CONSTRAINT_CATALOG STRING El nombre del catálogo de la restricción. Siempre es una string vacía.
CONSTRAINT_SCHEMA STRING El nombre del esquema de la restricción. Es una string vacía si no tiene nombre.
CONSTRAINT_NAME STRING El nombre de la restricción.

REFERENTIAL_CONSTRAINTS

Esta tabla contiene una fila para cada restricción FOREIGN KEY.

Nombre de la columna Tipo Descripción
CONSTRAINT_CATALOG STRING El nombre del catálogo de CLAVE EXTERNA. Siempre es una string vacía.
CONSTRAINT_SCHEMA STRING El nombre del esquema de CLAVE EXTERNA. Es una string vacía si no tiene nombre.
CONSTRAINT_NAME STRING El nombre de la CLAVE EXTERNA.
UNIQUE_CONSTRAINT_CATALOG STRING Es el nombre del catálogo de la restricción clave primaria o UNIQUE a la que hace referencia la clave externa. Siempre es una string vacía.
UNIQUE_CONSTRAINT_SCHEMA STRING Es el nombre del esquema de la restricción clave primaria o UNIQUE a la que hace referencia la clave externa. Es una string vacía si no tiene nombre.
UNIQUE_CONSTRAINT_NAME STRING Es el nombre de la restricción PRIMARY KEY o UNIQUE a la que hace referencia la FOREIGN KEY.
MATCH_OPTION STRING Siempre SIMPLE.
UPDATE_RULE STRING Siempre NO ACTION.
DELETE_RULE STRING Puede ser CASCADE, SET NULL o NO ACTION.
SPANNER_STATE STRING El estado actual de la clave externa. Spanner no comienza a aplicar la restricción hasta que se crean y rellenan los índices de respaldo de la clave externa. Una vez que los índices están listos, Spanner comienza a aplicar la restricción para las transacciones nuevas mientras valida los datos existentes. Los valores posibles y los estados que representan son los siguientes:
  • BACKFILLING_INDEXES: Los índices se están reabasteciendo.
  • VALIDATING_DATA: Se están validando los datos existentes y las escrituras nuevas.
  • WAITING_FOR_COMMIT: Las operaciones masivas de clave externa se completaron correctamente o no se necesitó ninguna, pero la clave externa sigue pendiente.
  • COMMITTED: Se confirmó el cambio de esquema.

CHECK_CONSTRAINTS

La tabla information_schema.CHECK_CONSTRAINTS contiene una fila para cada restricción CHECK definida por la palabra clave CHECK o NOT NULL.

Nombre de la columna Tipo Descripción
CONSTRAINT_CATALOG STRING El nombre del catálogo de la restricción. Esta columna nunca es nula, pero siempre es una string vacía.
CONSTRAINT_SCHEMA STRING El nombre del esquema de la restricción. Es una string vacía si no tiene nombre.
CONSTRAINT_NAME STRING El nombre de la restricción. Esta columna nunca es NULL. Si no se especifica de forma explícita en la definición del esquema, se asigna un nombre definido por el sistema.
CHECK_CLAUSE STRING Las expresiones de la restricción CHECK. Esta columna nunca es NULL.
SPANNER_STATE STRING El estado actual de la restricción CHECK. Esta columna nunca es NULL. Los estados posibles son los siguientes:
  • VALIDATING: Spanner está validando los datos existentes.
  • COMMITTED: No hay un cambio de esquema activo para esta restricción.

KEY_COLUMN_USAGE

Esta tabla filtrada por filas contiene una fila sobre cada columna de las tablas de TABLE_CONSTRAINTS que están restringidas como claves por una restricción PRIMARY KEY, FOREIGN KEY o UNIQUE. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver las columnas que cumplen con los siguientes criterios:

  • Cualquiera de los privilegios de control de acceso detallado SELECT, INSERT o UPDATE se otorgan directamente en la columna al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.
  • Cualquiera de los privilegios de control de acceso detallado SELECT, INSERT o UPDATE se otorgan en la tabla que contiene la columna al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.
Nombre de la columna Tipo Descripción
CONSTRAINT_CATALOG STRING El nombre del catálogo de la restricción. Siempre es una string vacía.
CONSTRAINT_SCHEMA STRING El nombre del esquema de la restricción. Esta columna nunca es NULL. Es una cadena vacía si no tiene nombre.
CONSTRAINT_NAME STRING El nombre de la restricción.
TABLE_CATALOG STRING El nombre del catálogo de la columna restringida. Siempre es una string vacía.
TABLE_SCHEMA STRING El nombre del esquema de la tabla de la columna restringida. El nombre está vacío para el esquema predeterminado y contiene un valor para otros esquemas. Esta columna siempre contiene un valor.
TABLE_NAME STRING El nombre de la tabla de la columna restringida.
COLUMN_NAME STRING Es el nombre de la columna
ORDINAL_POSITION INT64 Es la posición ordinal de la columna dentro de la clave de la restricción, que comienza con un valor de 1.
POSITION_IN_UNIQUE_CONSTRAINT INT64 Para las FOREIGN KEY, la posición ordinal de la columna dentro de la restricción única, que comienza con un valor de 1. Esta columna es nula para otros tipos de restricciones.

CONSTRAINT_COLUMN_USAGE

Esta tabla contiene una fila para cada columna que usa una restricción. Incluye las columnas PRIMARY KEY y UNIQUE, además de las columnas a las que se hace referencia de las restricciones FOREIGN KEY.

Nombre de la columna Tipo Descripción
TABLE_CATALOG STRING El nombre del catálogo de la tabla de la columna. Siempre es una string vacía.
TABLE_SCHEMA STRING Es el nombre del esquema de la tabla de la columna. El nombre está vacío para el esquema predeterminado y contiene un valor para otros esquemas. Esta columna siempre contiene un valor.
TABLE_NAME STRING El nombre de la tabla de la columna.
COLUMN_NAME STRING El nombre de la columna que se usa en la restricción.
CONSTRAINT_CATALOG STRING El nombre del catálogo de la restricción. Siempre es una string vacía.
CONSTRAINT_SCHEMA STRING El nombre del esquema de la restricción. Es una string vacía si no tiene nombre.
CONSTRAINT_NAME STRING El nombre de la restricción.

TABLE_SYNONYMS

En esta tabla, se muestra información sobre los sinónimos de la tabla.

Nombre de la columna Tipo Descripción
TABLE_CATALOG STRING No se usa. Siempre es una string vacía.
TABLE_SCHEMA STRING Es el nombre del esquema de la tabla. El nombre está vacío para el esquema predeterminado y contiene un valor para otros esquemas. Esta columna siempre contiene un valor.
TABLE_NAME STRING Es el nombre de la tabla.
SYNONYM_CATALOG STRING Es el nombre del catálogo del sinónimo.
SYNONYM_SCHEMA STRING Es el nombre del esquema del sinónimo.
SYNONYM_TABLE_NAME STRING Es el nombre de la tabla para el sinónimo.

INDEXES

En esta tabla con filtro de filas, se enumeran los índices de la base de datos. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver los índices que cumplen con cualquiera de los siguientes requisitos:

  • Cualquiera de los privilegios de control de acceso detallado SELECT, INSERT o UPDATE se otorgan a nivel de columna en todas las columnas del índice al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.
  • Cualquiera de los privilegios de control de acceso detallado SELECT, INSERT, UPDATE o DELETE se otorgan en la tabla que tiene el índice para el rol de base de datos actual, para los roles de los que el rol de base de datos actual es miembro o para public.
Nombre de la columna Tipo Descripción
TABLE_CATALOG STRING Es el nombre del catálogo. Siempre es una string vacía.
TABLE_SCHEMA STRING Es el nombre del esquema de la tabla de índices. El nombre está vacío para el esquema predeterminado y contiene un valor para otros esquemas. Esta columna siempre contiene un valor.
TABLE_NAME STRING Es el nombre de la tabla.
INDEX_NAME STRING Es el nombre del índice. Las tablas con una especificación PRIMARY KEY tienen una entrada de seudoíndice generada con el nombre PRIMARY_KEY, que permite determinar los campos de la clave primaria.
INDEX_TYPE STRING Es el tipo de índice. El tipo es INDEX o PRIMARY_KEY.
PARENT_TABLE_NAME STRING Los índices secundarios se pueden intercalar en una tabla superior, como se analiza en Crea un índice secundario. Esta columna contiene el nombre de esa tabla superior o una cadena vacía si el índice no está intercalado.
IS_UNIQUE BOOL Se indica si las claves de índice deben ser únicas.
IS_NULL_FILTERED BOOL Se indica si el índice incluye entradas con valores NULL.
INDEX_STATE STRING Es el estado actual del índice. Los valores posibles y los estados que representan son los siguientes:
  • PREPARE: Crea tablas vacías para un índice nuevo.
  • WRITE_ONLY: Reabastece los datos para un índice nuevo.
  • WRITE_ONLY_CLEANUP: Limpia un índice nuevo.
  • WRITE_ONLY_VALIDATE_UNIQUE: Verifica la unicidad de los datos en un índice nuevo.
  • READ_WRITE: Operación de índice normal.
SPANNER_IS_MANAGED BOOL TRUE si Spanner administra el índice; de lo contrario, FALSE. Spanner administra los índices de respaldo secundarios para las claves externas.

INDEX_COLUMNS

En esta tabla con filtro de filas, se enumeran las columnas de un índice. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver los índices que cumplen con cualquiera de los siguientes requisitos:

  • Cualquiera de los privilegios de control de acceso detallado SELECT, INSERT o UPDATE se otorgan a nivel de columna en todas las columnas del índice al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.
  • Cualquiera de los privilegios de control de acceso detallado SELECT, INSERT o UPDATE se otorgan en la tabla que tiene un índice para el rol de base de datos actual, para los roles de los que el rol de base de datos actual es miembro o para public.
Nombre de la columna Tipo Descripción
TABLE_CATALOG STRING Es el nombre del catálogo. Siempre es una string vacía.
TABLE_SCHEMA STRING Es el nombre del esquema de la tabla de índices. El nombre está vacío para el esquema predeterminado y contiene un valor para otros esquemas. Esta columna siempre contiene un valor.
TABLE_NAME STRING Es el nombre de la tabla.
INDEX_NAME STRING Es el nombre del índice.
COLUMN_NAME STRING Es el nombre de la columna
ORDINAL_POSITION INT64 Es la posición ordinal de la columna en el índice (o clave primaria), que comienza con un valor de 1. Este valor es NULL para las columnas que no son clave (por ejemplo, las columnas especificadas en la cláusula STORING de un índice).
COLUMN_ORDERING STRING Es el orden de la columna. El valor es ASC o DESC para las columnas de clave, y NULL para las columnas que no son de clave (por ejemplo, las columnas especificadas en la cláusula STORING de un índice).
IS_NULLABLE STRING Es una string que indica si la columna acepta el valor NULL. De acuerdo con el estándar de SQL, la cadena es YES o NO, en lugar de un valor booleano.
SPANNER_TYPE STRING Es el tipo de datos de la columna.

COLUMN_OPTIONS

En esta tabla filtrada por filas, se enumeran las opciones de columna de una tabla. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todos los demás principales solo pueden ver las opciones de las columnas que cumplen con alguno de los siguientes requisitos:

  • Cualquiera de los privilegios de control de acceso detallado SELECT, INSERT o UPDATE se otorgan directamente en la columna al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.
  • Cualquiera de los privilegios de control de acceso detallado SELECT, INSERT o UPDATE se otorgan en la tabla que contiene la columna al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.
Nombre de la columna Tipo Descripción
TABLE_CATALOG STRING Es el nombre del catálogo. Siempre es una string vacía.
TABLE_SCHEMA STRING Es el nombre del esquema. El nombre está vacío en el esquema predeterminado y no está vacío en otros esquemas (por ejemplo, en el INFORMATION_SCHEMA). Esta columna nunca es NULL.
TABLE_NAME STRING Es el nombre de la tabla.
COLUMN_NAME STRING Es el nombre de la columna
OPTION_NAME STRING Un identificador de SQL que identifica la opción de forma única. Este identificador es la clave de la cláusula OPTIONS en DDL.
OPTION_TYPE STRING Es un nombre de tipo de datos que es el tipo de este valor de opción.
OPTION_VALUE STRING Un literal de SQL que describe el valor de esta opción. El valor de esta columna debe poder analizarse como parte de una consulta. La expresión resultante de este análisis del valor debe poder convertirse en OPTION_TYPE. Esta columna nunca es NULL.

SEQUENCES

En esta tabla, se enumeran los metadatos de las secuencias. SEQUENCES se filtra por filas según los privilegios de acceso detallado, si un usuario con privilegios de acceso detallado lo consulta.

Nombre de la columna Tipo Descripción
CATALOG STRING Es el nombre del catálogo que contiene la secuencia.
SCHEMA STRING Es el nombre del esquema que contiene la secuencia.
NAME STRING Es el nombre de la secuencia.
DATA_TYPE STRING Es el tipo de los valores de la secuencia. Usa el tipo de datos INT64.

SEQUENCE_OPTIONS

En esta tabla, se incluyen las opciones de configuración de las secuencias. SEQUENCE_OPTIONS se filtra por filas según los privilegios de acceso detallado, si un usuario con privilegios de acceso detallado la consulta.

Nombre de la columna Tipo Descripción
CATALOG STRING Es el nombre del catálogo que contiene la secuencia.
SCHEMA STRING Es el nombre del esquema que contiene la secuencia.
NAME STRING Es el nombre de la secuencia.
OPTION_NAME STRING Es el nombre de la opción de secuencia.
OPTION_TYPE STRING Es un nombre de tipo de datos que es el tipo de este valor de opción.
OPTION_VALUE STRING Es el valor de la opción de secuencia. La expresión que se obtiene de analizar el valor debe permitir la conversión a OPTION_TYPE.

SPANNER_STATISTICS

En esta tabla, se enumeran los paquetes de estadísticas del optimizador de consultas disponibles.

Nombre de la columna Tipo Descripción
CATALOG_NAME STRING Es el nombre del catálogo. Siempre es una string vacía.
SCHEMA_NAME STRING Es el nombre del esquema. El nombre está vacío en el esquema predeterminado y no está vacío en otros esquemas (por ejemplo, en el INFORMATION_SCHEMA). Esta columna nunca es NULL.
PACKAGE_NAME STRING El nombre del paquete de estadísticas.
ALLOW_GC BOOL FALSE si el paquete de estadísticas está exento de la recolección de elementos no utilizados; de lo contrario, TRUE.
Este atributo se debe establecer en FALSE para hacer referencia al paquete de estadísticas en una sugerencia o a través de la API del cliente.

VIEWS

Esta tabla filtrada por filas enumera las vistas de la base de datos. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver las vistas en las que se otorga el privilegio de control de acceso detallado SELECT al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.

Nombre de la columna Tipo Descripción
TABLE_CATALOG STRING Es el nombre del catálogo. Siempre es una string vacía.
TABLE_SCHEMA STRING Es el nombre del esquema. Es una string vacía si no tiene nombre.
TABLE_NAME STRING El nombre de la vista.
VIEW_DEFINITION STRING El texto SQL de la consulta que define la vista.
SECURITY_TYPE STRING Es el tipo de seguridad de la vista. INVOKER o DEFINER

Para obtener más información, consulta Acerca de las vistas.

ROLES

En esta tabla filtrada por filas, se enumeran los roles de base de datos definidos para el control de acceso detallado, incluidos los roles del sistema. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todos los roles de la base de datos. Todas las demás principales solo pueden ver los roles de base de datos a los que se les otorgó acceso, ya sea de forma directa o a través de la herencia.

Nombre de la columna Tipo Descripción
ROLE_NAME STRING Es el nombre del rol de la base de datos.
IS_SYSTEM BOOL TRUE si el rol de la base de datos es un rol del sistema; FALSE de lo contrario.

ROLE_GRANTEES

En esta tabla con filtro de filas, se enumeran todas las membresías de roles otorgadas de forma explícita a todos los roles de la base de datos. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver las membresías de rol otorgadas al rol de base de datos actual o a un rol del que el rol de base de datos actual sea miembro.

Debido a que todos los roles de base de datos son miembros del rol público, los resultados omiten los registros de membresía implícita en el rol público.

Nombre de la columna Tipo Descripción
ROLE_NAME STRING Es el nombre del rol de la base de datos en el que se otorga esta membresía.
GRANTEE STRING Es el nombre del rol de la base de datos al que se otorga esta membresía.

CHANGE_STREAMS

En esta tabla filtrada por filas, se enumeran todos los flujos de cambios de una base de datos y se indica cuáles realizan un seguimiento de toda la base de datos en comparación con tablas o columnas específicas. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver los flujos de cambios en los que se otorga el privilegio de control de acceso detallado SELECT al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.

Nombre de la columna Tipo Descripción
CHANGE_STREAM_CATALOG STRING Es el nombre del catálogo del flujo de cambios. Siempre es una string vacía.
CHANGE_STREAM_SCHEMA STRING Es el nombre del esquema de este flujo de cambios. Siempre es una string vacía.
CHANGE_STREAM_NAME STRING Es el nombre del flujo de cambios.
ALL BOOL TRUE si este flujo de cambios hace un seguimiento de toda la base de datos. FALSE si este flujo de cambios hace un seguimiento de tablas o columnas específicas.

CHANGE_STREAM_TABLES

Esta tabla filtrada por filas contiene información sobre las tablas y los flujos de cambios que las supervisan. Cada fila describe una tabla y un flujo de cambios. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver las filas de los flujos de cambios en los que se otorga el privilegio SELECT al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.

Los datos de CHANGE_STREAM_TABLES no incluyen las relaciones implícitas entre las tablas y los flujos de cambios que hacen un seguimiento de toda la base de datos.

Nombre de la columna Tipo Descripción
CHANGE_STREAM_CATALOG STRING Es el nombre del catálogo del flujo de cambios. Siempre es una string vacía.
CHANGE_STREAM_SCHEMA STRING Es el nombre del esquema del flujo de cambios. Siempre es una string vacía.
CHANGE_STREAM_NAME STRING Es el nombre del flujo de cambios al que se refiere esta fila.
TABLE_CATALOG STRING Es el nombre del catálogo de la tabla. Siempre es una string vacía.
TABLE_SCHEMA STRING Es el nombre del esquema de la tabla. Siempre es una string vacía.
TABLE_NAME STRING Es el nombre de la tabla a la que se refiere esta fila.
ALL_COLUMNS BOOL TRUE si el flujo de cambios de esta fila hace un seguimiento de toda la tabla a la que se refiere esta fila. En caso contrario, FALSE.

CHANGE_STREAM_COLUMNS

Esta tabla filtrada por filas contiene información sobre las columnas de la tabla y los flujos de cambios que las supervisan. Cada fila describe un flujo de cambios y una columna. Si un flujo de cambios hace un seguimiento de una tabla completa, las columnas de esa tabla no se muestran en esta vista.

Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver las filas de los flujos de cambios en los que se otorga el privilegio SELECT al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.

Nombre de la columna Tipo Descripción
CHANGE_STREAM_CATALOG STRING Es el nombre del catálogo del flujo de cambios. Siempre es una string vacía.
CHANGE_STREAM_SCHEMA STRING Es el nombre del esquema del flujo de cambios. Siempre es una string vacía.
CHANGE_STREAM_NAME STRING Es el nombre del flujo de cambios.
TABLE_CATALOG STRING Es el nombre del catálogo de la tabla. Siempre es una string vacía.
TABLE_SCHEMA STRING Es el nombre del esquema de la tabla. Siempre es una string vacía.
TABLE_NAME STRING Es el nombre de la tabla a la que se refiere esta fila.
COLUMN_NAME STRING Es el nombre de la columna a la que hace referencia esta fila.

CHANGE_STREAM_OPTIONS

Esta tabla filtrada por filas contiene las opciones de configuración de los flujos de cambios. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver las opciones de los flujos de cambios en los que se otorga el privilegio SELECT al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.

Nombre de la columna Tipo Descripción
CHANGE_STREAM_CATALOG STRING Es el nombre del catálogo del flujo de cambios. Siempre es una string vacía.
CHANGE_STREAM_SCHEMA STRING Es el nombre del esquema del flujo de cambios. Siempre es una string vacía.
CHANGE_STREAM_NAME STRING Es el nombre del flujo de cambios.
OPTION_NAME STRING Es el nombre de la opción de flujo de cambios.
OPTION_TYPE STRING Es el tipo de datos de la opción de flujo de cambios.
OPTION_VALUE STRING Es el valor de la opción de flujo de cambios.

CHANGE_STREAM_PRIVILEGES

En esta tabla filtrada por filas, se enumeran todos los privilegios de control de acceso detallado otorgados en todos los flujos de cambios a cualquier rol de base de datos, incluido public. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver los privilegios otorgados en los flujos de cambios al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.

Nombre de la columna Tipo Descripción
CHANGE_STREAM_CATALOG STRING Es el nombre del catálogo que contiene el flujo de cambios (una cadena vacía).
CHANGE_STREAM_SCHEMA STRING Es el nombre del esquema que contiene el flujo de cambios (una cadena vacía).
CHANGE_STREAM_NAME STRING Es el nombre del flujo de cambios.
PRIVILEGE_TYPE STRING SELECT (el único privilegio permitido para los flujos de cambios)
GRANTEE STRING Es el nombre del rol de la base de datos al que se otorga este privilegio.

ROUTINES

En esta tabla filtrada por filas, se enumeran todas las funciones de lectura de flujos de cambios de una base de datos. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver las funciones de lectura de flujos de cambios en las que se otorga el privilegio de control de acceso detallado EXECUTE al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.

Nombre de la columna Tipo Descripción
SPECIFIC_CATALOG STRING Es el nombre del catálogo de la rutina. Siempre es una string vacía.
SPECIFIC_SCHEMA STRING Es el nombre del esquema de la rutina. Siempre es una string vacía.
SPECIFIC_NAME STRING Es el nombre de la rutina. Identifica de forma única la rutina, incluso si su nombre está sobrecargado.
ROUTINE_CATALOG STRING Es el nombre del catálogo de la rutina. Siempre es una string vacía.
ROUTINE_SCHEMA STRING Es el nombre del esquema de la rutina. Siempre es una string vacía.
ROUTINE_NAME STRING Es el nombre de la rutina. (Se puede duplicar en caso de sobrecarga).
ROUTINE_TYPE STRING Es el tipo de rutina (FUNCTION o PROCEDURE). Siempre es FUNCTION.
DATA_TYPE STRING Es el tipo de datos que devuelve la rutina.
ROUTINE_BODY STRING Es el tipo de cuerpo de la rutina (SQL o EXTERNAL).
ROUTINE_DEFINITION STRING Es la definición de ROUTINE_BODY.
SECURITY_TYPE STRING Es el tipo de seguridad de la rutina. Siempre INVOKER.

ROUTINE_OPTIONS

Esta tabla filtrada por filas contiene una fila para cada opción de cada función de lectura de flujo de cambios definida.

Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver las opciones de las funciones de lectura de flujos de cambios en las que se otorga el privilegio de control de acceso detallado EXECUTE al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.

Nombre de la columna Tipo Descripción
SPECIFIC_CATALOG STRING Es el nombre del catálogo de la rutina. Siempre es una string vacía.
SPECIFIC_SCHEMA STRING Es el nombre del esquema de la rutina. Siempre es una string vacía.
SPECIFIC_NAME STRING Es el nombre de la rutina. Identifica de forma inequívoca la rutina en caso de sobrecarga de nombres.
OPTION_NAME STRING Un identificador de SQL que identifica la opción de forma única.
OPTION_TYPE STRING Es el tipo de datos de OPTION_VALUE.
OPTION_VALUE STRING Un literal de SQL que describe el valor de esta opción. El valor de esta columna debe poder analizarse como parte de una consulta.

PARAMETERS

Esta tabla filtrada por filas define los argumentos para cada función de lectura de flujo de cambios. Cada fila describe un argumento para una función de lectura de flujo de cambios.

Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver los parámetros de las funciones de lectura de flujos de cambios en las que se otorga el privilegio de control de acceso detallado EXECUTE al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.

Nombre de la columna Tipo Descripción
SPECIFIC_CATALOG STRING Es el nombre del catálogo de la rutina. Siempre es una string vacía.
SPECIFIC_SCHEMA STRING Es el nombre del esquema de la rutina. Siempre es una string vacía.
SPECIFIC_NAME STRING Es el nombre de la rutina. Identifica de forma inequívoca la rutina en caso de sobrecarga de nombres.
ORDINAL_POSITION INT64 Es la posición ordinal del parámetro en la rutina, que comienza con un valor de 1.
PARAMETER_NAME STRING Es el nombre del parámetro.
DATA_TYPE STRING Es el tipo de datos del parámetro.
PARAMETER_DEFAULT STRING El valor predeterminado del parámetro o NULL para los parámetros que no tienen un valor predeterminado.

ROUTINE_PRIVILEGES

En esta tabla filtrada por filas, se enumeran todos los privilegios de control de acceso detallado otorgados en todas las funciones de lectura de flujos de cambios a cualquier rol de base de datos, incluido public. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver los privilegios otorgados en las funciones de lectura de flujos de cambios al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.

Nombre de la columna Tipo Descripción
SPECIFIC_CATALOG STRING Es el nombre del catálogo de la rutina. Siempre es una string vacía.
SPECIFIC_SCHEMA STRING Es el nombre del esquema de la rutina. Siempre es una string vacía.
SPECIFIC_NAME STRING Es el nombre de la rutina. Identifica de forma inequívoca la rutina en caso de sobrecarga de nombres.
PRIVILEGE_TYPE STRING Siempre EXECUTE.
GRANTEE STRING Es el nombre del rol de la base de datos al que se otorga este privilegio.

ROLE_TABLE_GRANTS

En esta tabla filtrada por filas, se enumeran todos los privilegios de control de acceso detallado otorgados en todas las tablas y vistas a cualquier rol de base de datos, incluido public. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver los privilegios otorgados en tablas y vistas al rol de base de datos actual y a los roles de los que el rol de base de datos actual es miembro, sin incluir public.

Nombre de la columna Tipo Descripción
GRANTOR STRING No se usa. Siempre NULL.
GRANTEE STRING Es el nombre del rol de la base de datos al que se otorga este privilegio.
TABLE_CATALOG STRING No se usa. Siempre es una string vacía.
TABLE_SCHEMA STRING No se usa. Siempre es una string vacía.
TABLE_NAME STRING El nombre de la tabla o vista.
PRIVILEGE_TYPE STRING Es el tipo de privilegio (SELECT, INSERT, UPDATE o DELETE).
IS_GRANTABLE STRING No se usa. Siempre NO.

ROLE_COLUMN_GRANTS

En esta tabla filtrada por filas, se enumeran todos los privilegios de control de acceso detallado otorgados en todas las columnas a cualquier rol de base de datos, incluido public. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver los privilegios otorgados en las columnas al rol de base de datos actual y a los roles de los que el rol de base de datos actual es miembro, sin incluir public.

La vista incluye los privilegios SELECT, INSERT y UPDATE que la columna hereda de la tabla o vista que contiene la columna.

Nombre de la columna Tipo Descripción
GRANTOR STRING No se usa. Siempre NULL.
GRANTEE STRING Es el nombre del rol de la base de datos al que se otorga este privilegio.
TABLE_CATALOG STRING No se usa. Siempre es una string vacía.
TABLE_SCHEMA STRING No se usa. Siempre es una string vacía.
TABLE_NAME STRING Es el nombre de la tabla o vista que contiene la columna.
COLUMN_NAME STRING Es el nombre de la columna en la que se otorga el privilegio.
PRIVILEGE_TYPE STRING Es el tipo de privilegio (SELECT, INSERT o UPDATE).
IS_GRANTABLE STRING No se usa. Siempre NO.

ROLE_CHANGE_STREAM_GRANTS

En esta tabla filtrada por filas, se enumeran los privilegios de SELECT otorgados en todos los flujos de cambios a cualquier rol de base de datos, incluido public. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver los privilegios otorgados en los flujos de cambios al rol de base de datos actual y a los roles de los que el rol de base de datos actual es miembro, sin incluir public.

Nombre de la columna Tipo Descripción
CHANGE_STREAM_CATALOG STRING No se usa. Siempre es una string vacía.
CHANGE_STREAM_SCHEMA STRING Es el nombre del esquema que contiene el flujo de cambios.
CHANGE_STREAM_NAME STRING Es el nombre del flujo de cambios.
PRIVILEGE_TYPE STRING Es el tipo de privilegio (solo SELECT).
GRANTEE STRING Es el nombre del rol de la base de datos al que se otorga este privilegio.

ROLE_MODEL_GRANTS

En esta tabla filtrada por filas, se enumeran todos los privilegios de control de acceso detallado otorgados en todos los modelos a cualquier rol de base de datos, incluido public. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver los privilegios otorgados en tablas y vistas al rol de base de datos actual y a los roles de los que el rol de base de datos actual es miembro, sin incluir public.

Nombre de la columna Tipo Descripción
GRANTOR STRING No se usa. Siempre NULL.
GRANTEE STRING Es el nombre del rol de la base de datos al que se otorga este privilegio.
MODEL_CATALOG STRING No se usa. Siempre es una string vacía.
MODEL_SCHEMA STRING No se usa. Siempre es una string vacía.
MODEL_NAME STRING El nombre del modelo.
PRIVILEGE_TYPE STRING Es el tipo de privilegio (EXECUTE).
IS_GRANTABLE STRING No se usa. Siempre NO.

ROLE_ROUTINE_GRANTS

En esta tabla filtrada por filas, se enumeran los privilegios EXECUTE otorgados en todas las funciones de lectura de flujos de cambios a cualquier rol de la base de datos, incluido public. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver los privilegios otorgados en las funciones de lectura de los flujos de cambios al rol de base de datos actual y a los roles de los que el rol de base de datos actual es miembro, sin incluir public.

Nombre de la columna Tipo Descripción
GRANTOR STRING No se usa. Siempre NULL.
GRANTEE STRING Es el nombre del rol al que se le otorga el privilegio.
SPECIFIC_CATALOG STRING Es el nombre del catálogo de rutinas.
SPECIFIC_SCHEMA STRING Es el nombre del esquema de la rutina.
SPECIFIC_NAME STRING Es el nombre de la rutina. Identifica de forma inequívoca la rutina en caso de sobrecarga de nombres.
PRIVILEGE_TYPE STRING Es el tipo de privilegio otorgado. Siempre EXECUTE.
IS_GRANTABLE STRING No se usa. Siempre NO.

MODELS

En esta tabla, se enumeran todos los modelos de una base de datos.

Nombre de la columna Tipo Descripción
MODEL_CATALOG STRING Es el nombre del catálogo. Siempre es una string vacía.
MODEL_SCHEMA STRING Es el nombre del esquema de este modelo. Siempre es una string vacía.
MODEL_NAME STRING El nombre del modelo.
IS_REMOTE BOOL TRUE si se trata de un modelo remoto. FALSE si este es un modelo administrado.

MODEL_OPTIONS

Esta tabla contiene las opciones de configuración de los modelos.

Nombre de la columna Tipo Descripción
MODEL_CATALOG STRING Es el nombre del catálogo. Siempre es una string vacía.
MODEL_SCHEMA STRING Es el nombre del esquema de este modelo. Siempre es una string vacía.
MODEL_NAME STRING El nombre del modelo.
OPTION_NAME STRING Es el nombre de la opción del modelo.
OPTION_TYPE STRING Es el tipo de datos de la opción del modelo.
OPTION_VALUE STRING Es el valor de la opción del modelo.

MODEL_COLUMNS

En esta tabla, se enumeran las columnas de un modelo.

Nombre de la columna Tipo Descripción
MODEL_CATALOG STRING Es el nombre del catálogo. Siempre es una string vacía.
MODEL_SCHEMA STRING Es el nombre del esquema de este modelo. Siempre es una string vacía.
MODEL_NAME STRING El nombre del modelo.
COLUMN_KIND STRING Es el tipo de columna del modelo. Uno de los siguientes: "INPUT" o "OUTPUT".
COLUMN_NAME STRING Es el nombre de la columna
DATA_TYPE STRING Es el tipo de datos de SQL estándar de la columna.
ORDINAL_POSITION INT64 Es la posición ordinal de la columna, que comienza con el valor 1, para conservar el orden de las columnas declaradas.
IS_EXPLICIT BOOL TRUE si la columna se especificó de forma explícita en el DDL, FALSE si la columna se descubrió desde el extremo.

MODEL_COLUMN_OPTIONS

Esta tabla contiene las opciones de configuración para las columnas del modelo.

Nombre de la columna Tipo Descripción
MODEL_CATALOG STRING Es el nombre del catálogo. Siempre es una string vacía.
MODEL_SCHEMA STRING Es el nombre del esquema de este modelo. Siempre es una string vacía.
MODEL_NAME STRING El nombre del modelo.
COLUMN_KIND STRING Es el tipo de columna del modelo. Uno de los siguientes: "INPUT" o "OUTPUT".
COLUMN_NAME STRING Es el nombre de la columna
OPTION_NAME STRING Es el nombre de la opción de columna del modelo.
OPTION_TYPE STRING Es el tipo de datos de la opción de columna del modelo.
OPTION_VALUE STRING Es el valor de la opción de la columna del modelo.

MODEL_PRIVILEGES

En esta tabla con filtro de filas, se enumeran todos los privilegios otorgados a nivel de modelo a los roles de la base de datos, incluido public. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver los privilegios de los modelos en los que se otorga el privilegio de control de acceso detallado de EXECUTE al rol de base de datos actual, a los roles de los que el rol de base de datos actual es miembro o a public.

Nombre de la columna Tipo Descripción
MODEL_CATALOG STRING No se usa. Siempre es una string vacía.
MODEL_SCHEMA STRING No se usa. Siempre es una string vacía.
MODEL_NAME STRING Es el nombre del modelo en el que se otorgan privilegios de control de acceso detallado.
PRIVILEGE_TYPE STRING EXECUTE>
GRANTEE STRING Es el nombre del rol de la base de datos al que se otorga este privilegio.

PROPERTY_GRAPHS

En esta tabla filtrada por filas, se enumeran los grafos de propiedades de la base de datos. Las principales con permisos de IAM a nivel de la base de datos y las principales a las que se les otorgó acceso al rol del sistema spanner_info_reader o a los miembros de ese rol pueden ver todas las filas de esta vista. Todas las demás principales solo pueden ver los grafos de propiedades si cumplen con los requisitos para ver todas las tablas que se usan para definir esos grafos.

Nombre de la columna Tipo Descripción
PROPERTY_GRAPH_CATALOG STRING Es el nombre del catálogo. Siempre es una string vacía.
PROPERTY_GRAPH_SCHEMA STRING Es el nombre del esquema. Es una string vacía si no tiene nombre.
PROPERTY_GRAPH_NAME STRING Es el nombre del grafo de propiedades.
PROPERTY_GRAPH_METADATA_JSON JSON Es la definición del grafo de propiedades en formato JSON.

La columna PROPERTY_GRAPH_METADATA_JSON contiene un objeto JSON PropertyGraph definido de la siguiente manera:

Nombre del objeto JSON Nombre del campo Tipo JSON Descripción
PropertyGraph catalog string Es el nombre del catálogo. Siempre es una string vacía.
schema string Es el nombre del esquema. Es una string vacía si no tiene nombre.
name string Es el nombre del grafo de propiedades.
nodeTables array<object> Es una lista de objetos GraphElementTable para los nodos.
edgeTables array<object> Es una lista de objetos GraphElementTable para los bordes.
labels array<object> Una lista de objetos GraphElementLabel.
propertyDeclarations array<object> Una lista de objetos GraphPropertyDeclaration.
GraphElementTable name string Es el nombre de la tabla de elementos del grafo.
kind string NODE o EDGE
baseCatalogName string Es el nombre del catálogo que contiene la tabla base.
baseSchemaName string Es el nombre del esquema que contiene la tabla base.
baseTableName string Es el nombre de la tabla de entrada a partir de la cual se crean los elementos.
keyColumns array<string> Son los nombres de las columnas que constituyen la clave del elemento.
labelNames array<string> Son los nombres de las etiquetas adjuntas a esta tabla de elementos.
propertyDefinitions array<object> Una lista de objetos GraphPropertyDefinition.
dynamicLabelExpr string Es el nombre de la columna que contiene la definición de DYNAMIC LABEL.
dynamicPropertyExpr string Es el nombre de la columna que contiene la definición de DYNAMIC PROPERTIES.
sourceNodeTable object Un objeto GraphNodeTableReference. Solo existe cuando el kind es EDGE.
destinationNodeTable object Un objeto GraphNodeTableReference. Solo existe cuando el kind es EDGE.
GraphNodeTableReference nodeTableName string Es el nombre de la tabla de elementos del grafo.
edgeTableColumns array<string> Es el nombre de las columnas que están asociadas con las claves de origen y destino de las aristas.
nodeTableColumns array<string> Es el nombre de las columnas que están asociadas con las claves de origen y destino de los nodos.
GraphElementLabel name string Es el nombre de la etiqueta.
propertyDeclarationNames array<string> Son los nombres de las propiedades asociadas con esta etiqueta.
GraphPropertyDeclaration name string Es el nombre de la propiedad.
type string Es el tipo de propiedad.
GraphPropertyDefinition propertyDeclarationName string Es el nombre de la propiedad.
valueExpressionSql string Es la expresión que define la propiedad.

Ejemplos

Muestra información sobre cada tabla en el esquema del usuario:

SELECT
  t.table_schema,
  t.table_name,
  t.parent_table_name
FROM
  information_schema.tables AS t
WHERE
  t.table_catalog = ''
  AND
  t.table_schema NOT IN ('information_schema', 'SPANNER_SYS')
  AND t.table_type = 'BASE TABLE'
ORDER BY
  t.table_catalog,
  t.table_schema,
  t.table_name

Muestra el nombre de todas las tablas en INFORMATION_SCHEMA:

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

Muestra información sobre las columnas de la tabla de usuario MyTable en el esquema predeterminado:

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

Muestra información sobre la región líder predeterminada de la base de datos. Se muestra vacía si no está configurado el líder predeterminado:

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

Muestra información sobre cada índice en el esquema del usuario:

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

Muestra todas las columnas que usan opciones distintas de la predeterminada:

SELECT
  t.table_schema,
  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 NOT IN ('information_schema', 'SPANNER_SYS')

Muestra las opciones actuales de la base de datos relacionada con el optimizador: 

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')

Muestra todos los paquetes de estadísticas disponibles: 

SELECT
  *
FROM
  information_schema.spanner_statistics;

Devuelve todas las secuencias: 

SELECT
  *
FROM
  information_schema.sequences;

Muestra todas las opciones de secuencia para la secuencia llamada "MySequence" 

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

Devuelve los nombres de todos los grafos de propiedades y sus definiciones:

SELECT
  property_graph_name,
  property_graph_metadata_json
FROM
  information_schema.property_graphs

Muestra los nombres de todos los grafos de propiedades junto con sus etiquetas y propiedades:

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

¿Qué sigue?