SCHEMATA 视图

INFORMATION_SCHEMA.SCHEMATA 视图提供有关项目或区域中的数据集的信息。视图会为每个数据集返回一行。

准备工作

要查询数据集元数据的 SCHEMATA 视图，您需要拥有项目级层的 bigquery.datasets.get Identity and Access Management (IAM) 权限。

以下每个预定义 IAM 角色都包含获取 SCHEMATA 视图所需的权限：

• roles/bigquery.admin
• roles/bigquery.dataEditor
• roles/bigquery.dataOwner
• roles/bigquery.dataViewer

如需详细了解 BigQuery 权限，请参阅使用 IAM 进行访问权限控制。

架构

当您查询 INFORMATION_SCHEMA.SCHEMATA 视图时，指定项目中的每个数据集都会有一行对应的查询结果。

INFORMATION_SCHEMA.SCHEMATA 视图具有如下架构：

列名	数据类型	值
CATALOG_NAME	STRING	包含数据集的项目的名称
SCHEMA_NAME	STRING	数据集的名称（也称为 datasetId）
SCHEMA_OWNER	STRING	值始终为 NULL
CREATION_TIME	TIMESTAMP	数据集的创建时间
LAST_MODIFIED_TIME	TIMESTAMP	数据集的上次修改时间
LOCATION	STRING	数据集的地理位置
DDL	STRING	可用于创建数据集的 CREATE SCHEMA DDL 语句
DEFAULT_COLLATION_NAME	STRING	默认排序规则规范的名称（如果存在），否则为 NULL。

范围和语法

针对此视图的查询必须包含区域限定符。如果您未指定区域限定符，则系统会从美国区域检索元数据。 下表说明了此视图的区域范围：

视图名称	资源范围	区域范围
[PROJECT_ID.]INFORMATION_SCHEMA.SCHEMATA	项目级	美国区域
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.SCHEMATA	项目级	REGION

替换以下内容：

• 可选：PROJECT_ID：您的 Google Cloud 项目的 ID。如果未指定，则使用默认项目。
• REGION：任何数据集区域名称。例如 region-us。

注意：您必须指定位置以查询 INFORMATION_SCHEMA 视图，并且查询执行的位置必须与 INFORMATION_SCHEMA 视图的区域相匹配。

示例

-- Returns metadata for datasets in a region.
SELECT * FROM region-us.INFORMATION_SCHEMA.SCHEMATA;

示例

如需对非默认项目运行查询，请按以下格式将相应的项目 ID 添加到数据集：

`PROJECT_ID`.INFORMATION_SCHEMA.SCHEMATA

例如 `myproject`.INFORMATION_SCHEMA.SCHEMATA。

SELECT
  * EXCEPT (schema_owner)
FROM
  INFORMATION_SCHEMA.SCHEMATA;

注意：INFORMATION_SCHEMA 视图名称区分大小写。

结果类似于以下内容。为改善可读性，结果中没有保留某些列。

+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
|  catalog_name  |  schema_name  |    creation_time    | last_modified_time  |  location  |                   ddl                    |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
| myproject      | mydataset1    | 2018-11-07 19:50:24 | 2018-11-07 19:50:24 | US         | CREATE SCHEMA `myproject.mydataset1`     |
|                |               |                     |                     |            | OPTIONS(                                 |
|                |               |                     |                     |            |   location="us"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
| myproject      | mydataset2    | 2018-07-16 04:24:22 | 2018-07-16 04:24:22 | US         | CREATE SCHEMA `myproject.mydataset2`     |
|                |               |                     |                     |            | OPTIONS(                                 |
|                |               |                     |                     |            |   default_partition_expiration_days=3.0, |
|                |               |                     |                     |            |   location="us"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
| myproject      | mydataset3    | 2018-02-07 21:08:45 | 2018-05-01 23:32:53 | US         | CREATE SCHEMA `myproject.mydataset3`     |
|                |               |                     |                     |            | OPTIONS(                                 |
|                |               |                     |                     |            |   description="My dataset",              |
|                |               |                     |                     |            |   location="us"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+