GoogleSQL 方言数据库的信息架构

信息架构是每个 Cloud Spanner 数据库通用的内置架构。您可以对 INFORMATION_SCHEMA 中的表运行 SQL 查询来提取数据库的架构元数据。

例如，以下查询可提取数据库中所有用户定义的表的名称：

  SELECT
    table_name
  FROM
    information_schema.tables
  WHERE
    table_schema = ''

精细的访问权限控制用户会看到某些 INFORMATION_SCHEMA 表的过滤结果，具体取决于其数据库角色。如需了解详情，请参阅关于精细访问权限控制。

使用情况

INFORMATION_SCHEMA 表只能通过 SQL 接口使用，例如：

• executeQuery API
• gcloud spanner databases execute-sql 命令
• Google Cloud 控制台中数据库的查询页面）

其他单次读取方法不支持 INFORMATION_SCHEMA。

下面是一些额外的 INFORMATION_SCHEMA 使用说明：

• 针对 INFORMATION_SCHEMA 的查询可以用于只读事务，但不能用于读写事务。
• 针对 INFORMATION_SCHEMA 的查询可以使用强、有界限过时或精确过时时间戳边界。
• 如果您使用的是 PostgreSQL 方言数据库，请参阅 PostgreSQL 方言数据库的信息架构。
• 如果您是精细访问权限控制用户，INFORMATION_SCHEMA 表会进行过滤，以仅显示您有权访问的架构元素。

information_schema 表中的行过滤

具有数据库级 IAM 权限的主账号和已被授予 spanner_info_reader 系统角色（或该角色的成员）访问权限的主账号可以查看所有 information_schema 表中的所有行。对于其他主帐号，对于某些表，系统会根据当前的数据库角色过滤行。以下部分中的表和视图说明介绍了如何为每个表和视图应用行过滤。

INFORMATION_SCHEMA 中的表

SCHEMATA

INFORMATION_SCHEMA.SCHEMATA 表列出了数据库中的架构。这些架构包括信息架构和一个未命名架构（以下称为“默认架构”），后者包含您定义的表。

列名	类型	说明
CATALOG_NAME	STRING	目录的名称。此列是为了与 SQL 标准信息架构表兼容而存在的。此列始终为空字符串。
SCHEMA_NAME	STRING	架构的名称。这对于默认架构为空，对于命名架构不为空。

DATABASE_OPTIONS

此表列出了在数据库上设置的选项。

列名	类型	说明
CATALOG_NAME	STRING	目录的名称。始终为空字符串。
SCHEMA_NAME	STRING	架构的名称。如果未命名，则为空字符串。
OPTION_NAME	STRING	数据库选项的名称。
OPTION_TYPE	STRING	数据库选项的数据类型。
OPTION_VALUE	STRING	数据库选项值。

TABLES

此按行过滤的表格列出了数据库中的表和视图。具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主帐号只能查看符合以下任一要求的表：

• 针对表向以下角色授予 SELECT、INSERT、UPDATE 或 DELETE 精细访问权限控制权限：当前数据库角色、当前数据库角色所属的角色或 public。
• 针对任何表列向当前数据库角色授予当前数据库角色、当前数据库角色所属的角色或 public 的 SELECT、INSERT 或 UPDATE 权限。

列名	类型	说明
TABLE_CATALOG	STRING	未使用。始终为空字符串。
TABLE_SCHEMA	STRING	未使用。始终为空字符串。
TABLE_NAME	STRING	表或视图的名称。
TABLE_TYPE	STRING	表的类型。对于表，该值为 BASE TABLE；对于视图，其值为 VIEW。
PARENT_TABLE_NAME	STRING	如果此表交错，则为父表的名称，否则为 NULL。
ON_DELETE_ACTION	STRING	对于交错表，此字段设置为 CASCADE 或 NO ACTION，否则设置为 NULL。如需了解详情，请参阅 TABLE 语句。
SPANNER_STATE	STRING	如果涉及批量操作，表可能会在创建过程中经历多种状态。例如，当使用需要回填索引的外键创建表时。可能的状态包括： ADDING_FOREIGN_KEY：添加表的外键。 WAITING_FOR_COMMIT：完成架构更改。 COMMITTED：用于创建表的架构更改已提交。在提交更改之前，您无法向表中写入数据。

COLUMNS

此按行过滤的表格列出了表格中的列。具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主帐号只能查看符合以下任一要求的列：

• 您可以直接将列的任何 SELECT、INSERT 或 UPDATE 精细访问权限控制权限授予当前数据库角色、当前数据库角色所属的角色或 public。
• 对包含当前数据库角色的列、当前数据库角色所属的角色或 public 列所属的表，授予任何 SELECT、INSERT 或 UPDATE 精细访问权限控制权限。

列名	类型	说明
TABLE_CATALOG	STRING	未使用。始终为空字符串。
TABLE_SCHEMA	STRING	未使用。始终为空字符串。
TABLE_NAME	STRING	表的名称。
COLUMN_NAME	STRING	列的名称。
ORDINAL_POSITION	INT64	表中列的序号位置，从 1 开始。
COLUMN_DEFAULT	STRING	列默认值的 SQL 表达式的字符串表示法。如果列没有默认值，则返回 NULL。 注意：在 2022 年 3 月之前，COLUMN_DEFAULT 使用类型 BYTES。
DATA_TYPE	STRING	包含在内，用于满足 SQL 标准。始终为 NULL。请参阅 SPANNER_TYPE 列
IS_NULLABLE	STRING	指明列是否可以为 Null 的字符串。根据 SQL 标准，字符串可以是 YES 或 NO，而不是布尔值。
SPANNER_TYPE	STRING	列的数据类型。
IS_GENERATED	STRING	指明是否生成列的字符串。对于生成的列，字符串为 ALWAYS；对于非生成的列，该字符串为 NEVER。
GENERATION_EXPRESSION	STRING	表示所生成列的 SQL 表达式的字符串。如果该列不是生成的列，则为 NULL。
IS_STORED	STRING	指明是否存储生成的列的字符串。对于生成的列，字符串始终为 YES；对于非生成的列，该字符串始终为 NULL。
SPANNER_STATE	STRING	列的当前状态。向现有表添加的新的生成的已存储列可能需要经过多个用户可观察状态才能充分利用。可能的 值如下： WRITE_ONLY：正在回填列。不允许读取。 COMMITTED：该列完全可用。

COLUMN_PRIVILEGES

这个按行过滤的表列出了在列级别授予任何数据库角色（包括 public）的所有权限。具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主帐号只能查看满足以下任一要求的列的权限：

• 您可以直接将列的任何 SELECT、INSERT 或 UPDATE 精细访问权限控制权限授予当前数据库角色、当前数据库角色所属的角色或 public。
• 对包含当前数据库角色的列、当前数据库角色所属的角色或 public 列所属的表，授予任何 SELECT、INSERT 或 UPDATE 精细访问权限控制权限。

列名	类型	说明
TABLE_CATALOG	STRING	未使用。始终为空字符串。
TABLE_SCHEMA	STRING	未使用。始终为空字符串。
TABLE_NAME	STRING	包含特权列的表的名称。
COLUMN_NAME	STRING	特权列的名称。
PRIVILEGE_TYPE	STRING	SELECT、INSERT、UPDATE
GRANTEE	STRING	授予此权限的数据库角色的名称。

TABLE_PRIVILEGES

这个按行过滤的表格列出了在表级层授予数据库角色的所有权限，包括 public。具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主帐号只能查看符合以下条件的表的权限：SELECT、INSERT、UPDATE 或 DELETE 具有任何精细访问权限控制权限被授予给当前数据库角色、当前数据库角色所属的角色或 public 的表。

列名	类型	说明
TABLE_CATALOG	STRING	未使用。始终为空字符串。
TABLE_SCHEMA	STRING	未使用。始终为空字符串。
TABLE_NAME	STRING	授予精细访问权限控制特权的表的名称。
PRIVILEGE_TYPE	STRING	SELECT、INSERT、UPDATE 和 DELETE 中的一个
GRANTEE	STRING	授予此权限的数据库角色的名称。

TABLE_CONSTRAINTS

此表为数据库中的表定义的每个限制条件都包含了一行。

列名	类型	说明
CONSTRAINT_CATALOG	STRING	始终为空字符串。
CONSTRAINT_SCHEMA	STRING	限制条件的架构名称。如果未命名，则为空字符串。
CONSTRAINT_NAME	STRING	限制条件的名称。
TABLE_CATALOG	STRING	受限表的目录名称。始终为空字符串。
TABLE_SCHEMA	STRING	受限表的架构名称。如果未命名，则为空字符串。
TABLE_NAME	STRING	受限表的名称。
CONSTRAINT_TYPE	STRING	限制条件的类型。可能的 值如下： PRIMARY KEY FOREIGN KEY CHECK UNIQUE
IS_DEFERRABLE	STRING	始终为 NO。
INITIALLY_DEFERRED	STRING	始终为 NO。
ENFORCED	STRING	始终为 YES。

CONSTRAINT_TABLE_USAGE

此表列出了定义限制条件或限制条件使用的表。包括用于定义 PRIMARY KEY 和 UNIQUE 限制条件的表。此外，还包括引用的 FOREIGN KEY 定义的表。

列名	类型	说明
TABLE_CATALOG	STRING	受限表的目录名称。始终为空字符串。
TABLE_SCHEMA	STRING	受限表的架构名称。如果未命名，则为空字符串。
TABLE_NAME	STRING	受限表的名称。
CONSTRAINT_CATALOG	STRING	限制条件的目录名称。始终为空字符串。
CONSTRAINT_SCHEMA	STRING	限制条件的架构名称。如果未命名，则为空字符串。
CONSTRAINT_NAME	STRING	限制条件的名称。

REFERENTIAL_CONSTRAINTS

此表包含一行有关每个 FOREIGN KEY 限制条件的信息。

列名	类型	说明
CONSTRAINT_CATALOG	STRING	外键的目录名称。始终为空字符串。
CONSTRAINT_SCHEMA	STRING	外键的架构名称。如果未命名，则为空字符串。
CONSTRAINT_NAME	STRING	外键的名称。
UNIQUE_CONSTRAINT_CATALOG	STRING	主键或唯一键的目录名称限制了 FOREIGN 键引用。始终为空字符串。
UNIQUE_CONSTRAINT_SCHEMA	STRING	主键或唯一限制的 FOREIGN KEY 引用的架构名称。如果未命名，则为空字符串。
UNIQUE_CONSTRAINT_NAME	STRING	主键的名称或用于约束 FOREIGN 键引用的唯一键的名称。
MATCH_OPTION	STRING	始终为 SIMPLE。
UPDATE_RULE	STRING	始终为 NO ACTION。
DELETE_RULE	STRING	CASCADE 或 NO ACTION。
SPANNER_STATE	STRING	外键的当前状态。在创建和回填外键的后备索引之前，Spanner 不会开始强制执行限制条件。索引准备就绪后，Spanner 会在验证现有数据时开始对新事务强制执行限制条件。可能的值和它们所代表的状态如下： BACKFILLING_INDEXES：正在回填的索引。 VALIDATING_DATA：正在验证现有数据和新的写入。 WAITING_FOR_COMMIT：外键批量操作已成功完成，或者不需要任何外键操作，但外键仍处于待处理状态。 COMMITTED：已提交架构更改。

CHECK_CONSTRAINTS

information_schema.CHECK_CONSTRAINTS 表包含关于 CHECK 或 NOT NULL 关键字定义的各个 CHECK 限制条件的一行。

列名	类型	说明
CONSTRAINT_CATALOG	STRING	限制条件的目录名称。此列从来不会为 null，但始终为空字符串。
CONSTRAINT_SCHEMA	STRING	限制条件的架构名称。如果未命名，则为空字符串。
CONSTRAINT_NAME	STRING	限制条件的名称。此列从来不会为 null。如果未在架构定义中明确指定，将分配系统定义的名称。
CHECK_CLAUSE	STRING	CHECK 限制条件的表达式。此列从来不会为 null。
SPANNER_STATE	STRING	CHECK 限制条件的当前状态。此列从来不会为 null。 可能的状态如下： VALIDATING：Spanner 正在验证现有数据。 COMMITTED：此限制条件没有有效的架构更改。

KEY_COLUMN_USAGE

这个按行过滤的表包含一行，关于 TABLE_CONSTRAINTS 中受 PRIMARY KEY、FOREIGN KEY 或 UNIQUE 限制条件约束为键的表的每一列。具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主帐号只能查看符合以下条件的列：

• 您可以直接将列的任何 SELECT、INSERT 或 UPDATE 精细访问权限控制权限授予当前数据库角色、当前数据库角色所属的角色或 public。
• 对包含当前数据库角色的列、当前数据库角色所属的角色或 public 列所属的表，授予任何 SELECT、INSERT 或 UPDATE 精细访问权限控制权限。

列名	类型	说明
CONSTRAINT_CATALOG	STRING	限制条件的目录名称。始终为空字符串。
CONSTRAINT_SCHEMA	STRING	限制条件的架构名称。此列从来不会为 null。如果未命名，则为空字符串。
CONSTRAINT_NAME	STRING	限制条件的名称。
TABLE_CATALOG	STRING	受限列的目录名称。始终为空字符串。
TABLE_SCHEMA	STRING	受限列的架构名称。此列从来不会为 null。 如果未命名，则为空字符串。
TABLE_NAME	STRING	受限列的表的名称。
COLUMN_NAME	STRING	列的名称。
ORDINAL_POSITION	INT64	约束条件键内列的序数位置，从值 1 开始。
POSITION_IN_UNIQUE_CONSTRAINT	INT64	对于 FOREIGN KEY，这是唯一约束条件内列的序数位置，从值 1 开始。对于其他限制条件类型，此列为 null。

CONSTRAINT_COLUMN_USAGE

此表包含一行有关限制条件使用的每一列的信息。包括 PRIMARY KEY 和 UNIQUE 列，以及 FOREIGN KEY 限制条件引用的列。

列名	类型	说明
TABLE_CATALOG	STRING	列表的目录名称。始终为空字符串。
TABLE_SCHEMA	STRING	列表的架构名称。此列从来不会为 null。如果未命名，则为空字符串。
TABLE_NAME	STRING	列的表名称。
COLUMN_NAME	STRING	限制条件使用的列的名称。
CONSTRAINT_CATALOG	STRING	限制条件的目录名称。始终为空字符串。
CONSTRAINT_SCHEMA	STRING	限制条件的架构名称。如果未命名，则为空字符串。
CONSTRAINT_NAME	STRING	限制条件的名称。

INDEXES

此按行过滤的表列出了数据库中的索引。具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主帐号只能查看符合以下任一要求的索引：

• SELECT、INSERT 或 UPDATE 中的任何精细访问权限控制权限都是在列级别针对当前数据库角色的所有列授予的，此类权限针对当前数据库角色所属的角色或 public。
• 对具有当前数据库角色索引的表、当前数据库角色所属的角色或 public 表，授予任何 SELECT、INSERT、UPDATE 或 DELETE 精细访问权限控制权限。

列名	类型	说明
TABLE_CATALOG	STRING	目录的名称。始终为空字符串。
TABLE_SCHEMA	STRING	架构的名称。如果未命名，则为空字符串。
TABLE_NAME	STRING	表的名称。
INDEX_NAME	STRING	索引的名称。具有 PRIMARY KEY 规范的表具有一个名为 PRIMARY_KEY 的伪索引条目，该条目允许确定主键的字段。
INDEX_TYPE	STRING	索引的类型。类型为 INDEX 或 PRIMARY_KEY。
PARENT_TABLE_NAME	STRING	二级索引可以在父表中交错，如创建二级索引中所述。此列保存该父表的名称，如果索引未交错，则保留一个空字符串。
IS_UNIQUE	BOOL	索引键是否必须是唯一的。
IS_NULL_FILTERED	BOOL	索引是否包含值为 NULL 的条目。
INDEX_STATE	STRING	索引的当前状态。可能的值及其所代表的状态如下： PREPARE：为新索引创建空表。 WRITE_ONLY：回填新索引的数据。 WRITE_ONLY_CLEANUP：清理新索引。 WRITE_ONLY_VALIDATE_UNIQUE：检查新索引中数据的唯一性。 READ_WRITE：正常索引操作。
SPANNER_IS_MANAGED	BOOL	如果索引由 Spanner 管理，则为 TRUE；否则，code> FALSE。外键的辅助后备索引由 Spanner 管理。

INDEX_COLUMNS

此按行过滤的表格列出了索引中的列。具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主帐号只能查看符合以下任一要求的索引：

• SELECT、INSERT 或 UPDATE 中的任何精细访问权限控制权限都是在列级别针对当前数据库角色的所有列授予的，此类权限针对当前数据库角色所属的角色或 public。
• 对包含当前数据库角色索引的表、当前数据库角色所属的角色或 public 表，授予任何 SELECT、INSERT 或 UPDATE 精细访问权限控制权限。

列名	类型	说明
TABLE_CATALOG	STRING	目录的名称。始终为空字符串。
TABLE_SCHEMA	STRING	架构的名称。如果未命名，则为空字符串。
TABLE_NAME	STRING	表的名称。
INDEX_NAME	STRING	索引的名称。
COLUMN_NAME	STRING	列的名称。
ORDINAL_POSITION	INT64	索引（或主键）中列的序号位置，从 1 开始。对于非键列（例如，索引的 STORING 子句中指定的列），此值为 NULL。
COLUMN_ORDERING	STRING	列的排序。对于键列，值为 ASC 或 DESC；对于非键列（例如，索引的 STORING 子句中指定的列），值为 NULL。
IS_NULLABLE	STRING	指明列是否可以为 Null 的字符串。根据 SQL 标准，字符串可以是 YES 或 NO，但不能是布尔值。
SPANNER_TYPE	STRING	列的数据类型。

COLUMN_OPTIONS

此按行过滤的表格列出了表格中的列选项。具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主帐号只能查看满足以下任一要求的列的选项：

• 您可以直接将列的任何 SELECT、INSERT 或 UPDATE 精细访问权限控制权限授予当前数据库角色、当前数据库角色所属的角色或 public。
• 对包含当前数据库角色的列、当前数据库角色所属的角色或 public 列所属的表，授予任何 SELECT、INSERT 或 UPDATE 精细访问权限控制权限。

列名	类型	说明
TABLE_CATALOG	STRING	目录的名称。始终为空字符串。
TABLE_SCHEMA	STRING	架构的名称。默认架构的名称为空，其他架构（例如，INFORMATION_SCHEMA 本身）的名称为非空。 此列从来不会为 null。
TABLE_NAME	STRING	表的名称。
COLUMN_NAME	STRING	列的名称。
OPTION_NAME	STRING	唯一标识选项的 SQL 标识符。此标识符是 DDL 中 OPTIONS 子句的键。
OPTION_TYPE	STRING	表示此选项值的类型的数据类型名称。
OPTION_VALUE	STRING	描述此选项值的 SQL 字面量。此列的值必须作为查询的一部分进行分析。解析该值所得到的表达式必须可强制转换为 OPTION_TYPE。此列从来不会为 null。

SEQUENCES

下表列出了序列元数据。如果拥有精细访问权限的用户查询 SEQUENCES，则系统会根据精细的访问权限对 SEQUENCES 进行行过滤。

列名	类型	说明
CATALOG	STRING	包含序列的目录的名称。
SCHEMA	STRING	包含序列的架构的名称。
NAME	STRING	序列的名称。
DATA_TYPE	STRING	序列值的类型。它使用 INT64 数据类型。

SEQUENCE_OPTIONS

下表包含序列的配置选项。如果具有精细访问权限的用户正在查询 SEQUENCE_OPTIONS，则系统会根据精细的访问权限对 SEQUENCE_OPTIONS 进行行过滤。

列名	类型	说明
CATALOG	STRING	包含序列的目录的名称。
SCHEMA	STRING	包含序列的架构的名称。
NAME	STRING	序列的名称。
OPTION_NAME	STRING	序列选项的名称。
OPTION_TYPE	STRING	表示此选项值的类型的数据类型名称。
OPTION_VALUE	STRING	序列选项值。解析该值的表达式必须允许转换为 OPTION_TYPE。

SPANNER_STATISTICS

下表列出了可用的查询优化器统计信息软件包。

列名	类型	说明
CATALOG_NAME	STRING	目录的名称。始终为空字符串。
SCHEMA_NAME	STRING	架构的名称。默认架构的名称为空，其他架构（例如，INFORMATION_SCHEMA 本身）的名称为非空。 此列从来不会为 null。
PACKAGE_NAME	STRING	统计信息软件包的名称。
ALLOW_GC	BOOL	如果统计信息包无需进行垃圾回收，则返回 FALSE；否则为 TRUE。 此属性必须设置为 FALSE，才能提示或通过客户端 API 引用统计信息软件包。

VIEWS

此按行过滤的表格列出了数据库中的视图。具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主帐号只能查看符合以下条件的视图：SELECT 精细访问权限控制权限被授予给当前数据库角色、当前数据库角色所属的角色或 public。

列名	类型	说明
TABLE_CATALOG	STRING	目录的名称。始终为空字符串。
TABLE_SCHEMA	STRING	架构的名称。如果未命名，则为空字符串。
TABLE_NAME	STRING	视图的名称。
VIEW_DEFINITION	STRING	定义视图的查询的 SQL 文本。
SECURITY_TYPE	STRING	视图的安全类型。可以选择 INVOKER 或 DEFINER。 如需了解详情，请参阅视图简介。

ROLES

此按行过滤的表列出了为精细访问权限控制定义的数据库角色，包括系统角色。具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号可以查看所有数据库角色。所有其他主帐号只能查看直接向其授予或通过继承获得访问权限的数据库角色。

列名	类型	说明
ROLE_NAME	STRING	数据库角色的名称。
IS_SYSTEM	BOOL	如果数据库角色是系统角色，则为 TRUE；否则为 FALSE。

ROLE_GRANTEES

此行过滤表列出了明确授予所有数据库角色的所有角色成员资格。具有数据库级 IAM 权限的主帐号以及已被授予对 spanner_info_reader 系统角色或该角色中成员的访问权限的主帐号可以查看此视图中的所有行。所有其他主账号只能查看已授予当前数据库角色或当前数据库角色所属角色的角色成员资格。

由于所有数据库角色都是公共角色的成员，因此结果省略了公共角色中的隐式成员资格的记录。

列名	类型	说明
ROLE_NAME	STRING	授予此成员资格的数据库角色的名称。
GRANTEE	STRING	授予此成员资格的数据库角色的名称。

CHANGE_STREAMS

这个按行过滤的表格列出了数据库的所有变更数据流，并注明了哪些变更数据流跟踪整个数据库，哪些变更跟踪的是特定表或列。具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主帐号只能查看符合以下条件的更改数据流：已将 SELECT 精细访问权限控制权限授予当前数据库角色、当前数据库角色所属的角色或 public。

列名	类型	说明
CHANGE_STREAM_CATALOG	STRING	变更数据流目录的名称。始终为空字符串。
CHANGE_STREAM_SCHEMA	STRING	此变更数据流的架构的名称。始终为空字符串。
CHANGE_STREAM_NAME	STRING	变更数据流的名称。
ALL	BOOL	TRUE（如果此变更数据流会跟踪整个数据库）。 FALSE（如果此变更数据流跟踪特定的表或列）。

CHANGE_STREAM_TABLES

这个按行过滤的表包含有关表以及监视它们的变更数据流的信息。每行描述一个表和一个变更数据流。具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主账号只能查看变更数据流的行，其中 SELECT 权限被授予以下角色：当前数据库角色、当前数据库角色所属的角色或 public 的成员。

CHANGE_STREAM_TABLES 中的数据不包含跟踪整个数据库的表与变更数据流之间的隐式关系。

列名	类型	说明
CHANGE_STREAM_CATALOG	STRING	变更数据流目录的名称。始终为空字符串。
CHANGE_STREAM_SCHEMA	STRING	变更数据流的架构名称。始终为空字符串。
CHANGE_STREAM_NAME	STRING	此行所引用的变更数据流的名称。
TABLE_CATALOG	STRING	表的目录名称。始终为空字符串。
TABLE_SCHEMA	STRING	表架构的名称。始终为空字符串。
TABLE_NAME	STRING	此行所引用的表的名称。
ALL_COLUMNS	BOOL	如果此行的变更流跟踪此行引用的整个表，则为 TRUE。否则，FALSE。

CHANGE_STREAM_COLUMNS

这个按行过滤的表格包含有关表列以及监控这些列的变更数据流的信息。每行描述一个变更数据流和一列。如果变更数据流跟踪整个表，则该表中的列不会显示在此视图中。

具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主账号只能查看以下变更数据流的行：当前数据库角色被授予 SELECT 权限、当前数据库角色所属的角色或 public。

列名	类型	说明
CHANGE_STREAM_CATALOG	STRING	变更数据流目录的名称。始终为空字符串。
CHANGE_STREAM_SCHEMA	STRING	变更数据流的架构名称。始终为空字符串。
CHANGE_STREAM_NAME	STRING	变更数据流的名称。
TABLE_CATALOG	STRING	表的目录名称。始终为空字符串。
TABLE_SCHEMA	STRING	表架构的名称。始终为空字符串。
TABLE_NAME	STRING	此行所引用的表的名称。
COLUMN_NAME	STRING	此行所引用的列的名称。

CHANGE_STREAM_OPTIONS

此行过滤表格包含变更数据流的配置选项。 具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主账号只能看到以下变更数据流选项：当前数据库角色被授予 SELECT 权限、当前数据库角色所属的角色或 public 被授予了权限。

列名	类型	说明
CHANGE_STREAM_CATALOG	STRING	变更数据流目录的名称。始终为空字符串。
CHANGE_STREAM_SCHEMA	STRING	变更数据流的架构名称。始终为空字符串。
CHANGE_STREAM_NAME	STRING	变更数据流的名称。
OPTION_NAME	STRING	变更数据流选项的名称。
OPTION_TYPE	STRING	变更流选项的数据类型。
OPTION_VALUE	STRING	变更数据流选项值。

CHANGE_STREAM_PRIVILEGES

这个按行过滤的表列出了对任何数据库角色（包括 public）的所有更改流授予的所有精细访问权限控制权限。具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主账号只能查看对当前数据库角色、当前数据库角色所属的角色或 public 的变更数据流授予的权限。

列名	类型	说明
CHANGE_STREAM_CATALOG	STRING	包含变更流的目录的名称（空字符串）。
CHANGE_STREAM_SCHEMA	STRING	包含变更数据流的架构的名称（空字符串）。
CHANGE_STREAM_NAME	STRING	变更数据流的名称。
PRIVILEGE_TYPE	STRING	SELECT（变更数据流允许的唯一权限）。
GRANTEE	STRING	授予此权限的数据库角色的名称。

ROUTINES

此按行过滤的表列出了数据库的所有变更数据流读取函数。具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主帐号只能查看符合以下条件的更改数据流读取函数：EXECUTE 精细访问权限控制权限被授予给当前数据库角色、当前数据库角色所属的角色或 public。

列名	类型	说明
SPECIFIC_CATALOG	STRING	例程目录的名称。始终为空字符串。
SPECIFIC_SCHEMA	STRING	例程的架构名称。始终为空字符串。
SPECIFIC_NAME	STRING	例程的名称。唯一标识例程，即使其名称过载也是如此。
ROUTINE_CATALOG	STRING	例程目录的名称。始终为空字符串。
ROUTINE_SCHEMA	STRING	例程的架构名称。始终为空字符串。
ROUTINE_NAME	STRING	例程的名称。（如果过载，可能会重复。）
ROUTINE_TYPE	STRING	例程的类型（FUNCTION 或 PROCEDURE）。始终为 FUNCTION
DATA_TYPE	STRING	例程返回的数据类型
ROUTINE_BODY	STRING	例程正文的类型（SQL 或 EXTERNAL）。
ROUTINE_DEFINITION	STRING	ROUTINE_BODY 的定义。
SECURITY_TYPE	STRING	例程的安全类型。始终为 INVOKER。

ROUTINE_OPTIONS

此行过滤表包含每个定义的变更流读取函数的每个选项对应的一行。

具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主帐号只能查看变更数据流读取函数的选项，针对当前数据库角色、当前数据库角色所属的角色或 public 授予 EXECUTE 精细访问权限控制权限。

列名	类型	说明
SPECIFIC_CATALOG	STRING	例程目录的名称。始终为空字符串。
SPECIFIC_SCHEMA	STRING	例程的架构名称。始终为空字符串。
SPECIFIC_NAME	STRING	例程的名称。唯一标识例程，以防名称过载。
OPTION_NAME	STRING	唯一标识选项的 SQL 标识符。
OPTION_TYPE	STRING	OPTION_VALUE 的数据类型。
OPTION_VALUE	STRING	描述此选项值的 SQL 字面量。此列的值必须作为查询的一部分进行解析。

PARAMETERS

此行过滤表定义了每个变更数据流读取函数的参数。每行描述一个变更数据流读取函数的一个参数。

具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主帐号只能查看变更数据流读取函数的参数，针对当前数据库角色、当前数据库角色所属的角色或 public 授予 EXECUTE 精细访问权限控制权限。

列名	类型	说明
SPECIFIC_CATALOG	STRING	例程目录的名称。始终为空字符串。
SPECIFIC_SCHEMA	STRING	例程的架构名称。始终为空字符串。
SPECIFIC_NAME	STRING	例程的名称。唯一标识例程，以防名称过载。
ORDINAL_POSITION	INT64	例程中参数的序号位置，从 1 开始。
PARAMETER_NAME	STRING	参数的名称。
DATA_TYPE	STRING	参数的数据类型。

ROUTINE_PRIVILEGES

这个按行过滤的表格列出了针对任何数据库角色（包括 public）的所有变更数据流读取函数授予的所有精细访问权限控制权限。具有数据库级 IAM 权限的主帐号和已被授予对 spanner_info_reader 系统角色或该角色中成员的访问权限的主帐号可以查看此视图中的所有行。所有其他主账号只能查看以下权限：对当前数据库角色、当前数据库角色所属的角色或 public 的变更数据流读取函数授予的权限。

列名	类型	说明
SPECIFIC_CATALOG	STRING	例程目录的名称。始终为空字符串。
SPECIFIC_SCHEMA	STRING	例程的架构名称。始终为空字符串。
SPECIFIC_NAME	STRING	例程的名称。唯一标识例程，以防名称过载。
PRIVILEGE_TYPE	STRING	始终为 EXECUTE。
GRANTEE	STRING	授予此权限的数据库角色的名称。

ROLE_TABLE_GRANTS

这个按行过滤的表列出了向任何数据库角色（包括 public）授予的所有表和视图的所有精细访问权限控制权限。具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主账号只能查看对表和视图授予当前数据库角色以及当前数据库角色所属的角色（不包括 public）的权限。

列名称	类型	说明
GRANTOR	STRING	未使用。始终为 NULL。
GRANTEE	STRING	授予此权限的数据库角色的名称。
TABLE_CATALOG	STRING	未使用。始终为空字符串。
TABLE_SCHEMA	STRING	未使用。始终为空字符串。
TABLE_NAME	STRING	表或视图的名称。
PRIVILEGE_TYPE	STRING	权限的类型（SELECT、INSERT、UPDATE 或 DELETE）。
IS_GRANTABLE	STRING	未使用。始终为 NO。

ROLE_COLUMN_GRANTS

此按行过滤的表列出了对任何数据库角色（包括 public）的所有列授予的所有精细访问权限控制权限。具有数据库级 IAM 权限的主帐号以及已被授予对 spanner_info_reader 系统角色或其成员的访问权限的主帐号可以查看此视图中的所有行。所有其他主账号只能查看对当前数据库角色以及当前数据库角色所属角色（不包括 public）授予的列权限。

该视图包含该列从包含该列的表或视图继承的 SELECT、INSERT 和 UPDATE 权限。

列名称	类型	说明
GRANTOR	STRING	未使用。始终为 NULL。
GRANTEE	STRING	授予此权限的数据库角色的名称。
TABLE_CATALOG	STRING	未使用。始终为空字符串。
TABLE_SCHEMA	STRING	未使用。始终为空字符串。
TABLE_NAME	STRING	包含该列的表或视图的名称。
COLUMN_NAME	STRING	授予权限的列的名称。
PRIVILEGE_TYPE	STRING	权限的类型（SELECT、INSERT 或 UPDATE）。
IS_GRANTABLE	STRING	未使用。始终为 NO。

ROLE_CHANGE_STREAM_GRANTS

此按行过滤的表列出了对任何数据库角色（包括 public）的所有更改流授予的 SELECT 权限。具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主账号只能查看对当前数据库角色以及当前数据库角色所属的角色（不包括 public）的变更数据流授予的权限。

列名称	类型	说明
CHANGE_STREAM_CATALOG	STRING	未使用。始终为空字符串。
CHANGE_STREAM_SCHEMA	STRING	包含变更流的架构的名称。
CHANGE_STREAM_NAME	STRING	变更数据流的名称。
PRIVILEGE_TYPE	STRING	权限的类型（仅限 SELECT）。
GRANTEE	STRING	授予此权限的数据库角色的名称。

ROLE_MODEL_GRANTS

这个按行过滤的表列出了向任何数据库角色（包括 public）授予的所有模型的所有精细访问权限控制权限。具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主账号只能查看对表和视图授予当前数据库角色以及当前数据库角色所属的角色（不包括 public）的权限。

列名称	类型	说明
GRANTOR	STRING	未使用。始终为 NULL。
GRANTEE	STRING	授予此权限的数据库角色的名称。
MODEL_CATALOG	STRING	未使用。始终为空字符串。
MODEL_SCHEMA	STRING	未使用。始终为空字符串。
MODEL_NAME	STRING	模型的名称。
PRIVILEGE_TYPE	STRING	权限的类型 (EXECUTE)。
IS_GRANTABLE	STRING	未使用。始终为 NO。

ROLE_ROUTINE_GRANTS

这个按行过滤表列出了针对任何数据库角色（包括 public）的所有变更流读取函数授予的 EXECUTE 权限。具有 IAM 数据库级权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主账号只能查看对当前数据库角色以及当前数据库角色所属的角色（不包括 public）的变更数据流读取函数授予的权限。

列名	类型	说明
GRANTOR	STRING	未使用。始终为 NULL。
GRANTEE	STRING	授予了权限的角色的名称。
SPECIFIC_CATALOG	STRING	例程目录的名称。
SPECIFIC_SCHEMA	STRING	例程架构的名称。
SPECIFIC_NAME	STRING	例程的名称。唯一标识例程，以防名称过载。
PRIVILEGE_TYPE	STRING	授予的权限的类型。始终为 EXECUTE。
IS_GRANTABLE	STRING	未使用。始终为 NO。

MODELS

下表列出了数据库的所有模型。

列名	类型	说明
MODEL_CATALOG	STRING	目录的名称。始终为空字符串。
MODEL_SCHEMA	STRING	此模型架构的名称。始终为空字符串。
MODEL_NAME	STRING	模型的名称。
IS_REMOTE	BOOL	如果这是远程模型，则为 TRUE。如果这是代管式模型，则为 FALSE。

MODEL_OPTIONS

下表包含模型的配置选项。

列名	类型	说明
MODEL_CATALOG	STRING	目录的名称。始终为空字符串。
MODEL_SCHEMA	STRING	此模型架构的名称。始终为空字符串。
MODEL_NAME	STRING	模型的名称。
OPTION_NAME	STRING	模型选项的名称。
OPTION_TYPE	STRING	模型选项的数据类型。
OPTION_VALUE	STRING	模型选项值。

MODEL_COLUMNS

下表列出了模型中的列。

列名	类型	说明
MODEL_CATALOG	STRING	目录的名称。始终为空字符串。
MODEL_SCHEMA	STRING	此模型架构的名称。始终为空字符串。
MODEL_NAME	STRING	模型的名称。
COLUMN_KIND	STRING	模型列种类。以下各项中的一项："INPUT" 或 "OUTPUT"。
COLUMN_NAME	STRING	列的名称。
DATA_TYPE	STRING	列的标准 SQL 数据类型。
ORDINAL_POSITION	INT64	列的序数位置，从值 1 开始，以保持声明的列的顺序。
IS_EXPLICIT	BOOL	如果已在 DDL 中明确指定该列，则为 TRUE；如果从端点发现列，则为 FALSE。

MODEL_COLUMN_OPTIONS

下表包含模型列的配置选项。

列名	类型	说明
MODEL_CATALOG	STRING	目录的名称。始终为空字符串。
MODEL_SCHEMA	STRING	此模型架构的名称。始终为空字符串。
MODEL_NAME	STRING	模型的名称。
COLUMN_KIND	STRING	模型列种类。以下各项中的一项："INPUT" 或 "OUTPUT"。
COLUMN_NAME	STRING	列的名称。
OPTION_NAME	STRING	模型列选项的名称。
OPTION_TYPE	STRING	模型列选项的数据类型。
OPTION_VALUE	STRING	模型列选项值。

MODEL_PRIVILEGES

此按行过滤的表格列出了在模型级层向数据库角色授予的所有权限，包括 public。具有数据库级 IAM 权限的主账号以及已被授予 spanner_info_reader 系统角色或该角色成员访问权限的主账号都可以查看此视图中的所有行。所有其他主账号只能查看符合以下条件的模型的权限：对当前数据库角色、当前数据库角色所属的角色或 public 授予了 EXECUTE 精细访问权限控制权限的模型。

列名	类型	说明
MODEL_CATALOG	STRING	未使用。始终为空字符串。
MODEL_SCHEMA	STRING	未使用。始终为空字符串。
MODEL_NAME	STRING	授予精细访问权限控制权限的模型的名称。
PRIVILEGE_TYPE	STRING	EXECUTE>
GRANTEE	STRING	授予此权限的数据库角色的名称。

示例

返回有关用户架构中每个表的信息：

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

返回 INFORMATION_SCHEMA 中所有表的名称：

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

返回有关用户表 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

返回有关数据库的默认主要区域的信息。如果未设置默认主要区域，则返回空值：

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

返回有关用户架构中每个索引的信息：

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

返回使用默认值以外的选项的所有列：

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

返回当前与优化器相关的数据库选项：

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

返回所有可用的统计信息包：

SELECT
  *
FROM
  information_schema.spanner_statistics;

返回所有序列：

SELECT
  *
FROM
  information_schema.sequences;

返回名为“MySequence”的序列的所有序列选项

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

后续步骤

• 了解可用的内省工具以帮助您调查数据库问题。