SCHEMATA 檢視畫面

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

事前準備

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

下列每個預先定義的 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。
sync_status JSON 主要和次要副本之間的同步狀態，適用於跨區域複製和災難復原資料集。如果副本是主要副本，或資料集未使用複製功能，則傳回 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"                          |
|                |               |                     |                     |            | );                                       |
+----------------+---------------+---------------------+---------------------+------------+------------------------------------------+