SCHEMATA 檢視表

INFORMATION_SCHEMA.SCHEMATA 檢視畫面會提供專案或區域中的資料集相關資訊。這個檢視畫面會為每個資料集傳回一列資料。

事前準備

如要查詢資料集中繼資料的 SCHEMATA 檢視畫面，您必須具備專案層級的 bigquery.datasets.get 身分與存取權管理 (IAM) 權限。

下列每個預先定義的 IAM 角色都包含取得 SCHEMATA 檢視畫面所需的權限：

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

如要進一步瞭解 BigQuery 權限，請參閱「使用身分與存取權管理功能控管存取權」。

結構定義

查詢 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`。

示例

-- 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;

結果如下所示：為了方便閱讀，我們已從結果中排除部分資料欄。

+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+
|  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"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+