本頁面由 Cloud Translation API 翻譯而成。

INFORMATION_SCHEMA 簡介

BigQuery INFORMATION_SCHEMA 檢視畫面是系統定義的唯讀檢視畫面，可提供 BigQuery 物件的中繼資料資訊。下表列出可用於查詢中繼資料資訊的所有 INFORMATION_SCHEMA 檢視畫面：

資源類型	INFORMATION_SCHEMA 檢視畫面
存取權控管	`OBJECT_PRIVILEGESscience`
BI Engine	`BI_CAPACITIES` `BI_CAPACITY_CHANGES`
設定	`EFFECTIVE_PROJECT_OPTIONS` `ORGANIZATION_OPTIONS` `ORGANIZATION_OPTIONS_CHANGESscience` `PROJECT_OPTIONS` `PROJECT_OPTIONS_CHANGESscience`
資料集	`SCHEMATA SCHEMATA_LINKS SCHEMATA_OPTIONS SHARED_DATASET_USAGE SCHEMATA_REPLICASscience SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATIONscience`
工作	`JOBS_BY_PROJECT^†` `JOBS_BY_USER` `JOBS_BY_FOLDER` `JOBS_BY_ORGANIZATION`
各個時間片的工作	`JOBS_TIMELINE_BY_PROJECT^†` `JOBS_TIMELINE_BY_USER` `JOBS_TIMELINE_BY_FOLDER` `JOBS_TIMELINE_BY_ORGANIZATION`
最佳化建議和洞察	`INSIGHTSscience` `RECOMMENDATIONSscience` `RECOMMENDATIONS_BY_ORGANIZATIONscience`
保留項目	`ASSIGNMENTS_BY_PROJECT^†` `ASSIGNMENT_CHANGES_BY_PROJECT^†` `CAPACITY_COMMITMENTS_BY_PROJECT^†` `CAPACITY_COMMITMENT_CHANGES_BY_PROJECT^†` `RESERVATIONS_BY_PROJECT^†` `RESERVATION_CHANGES_BY_PROJECT^†` `RESERVATIONS_TIMELINE_BY_PROJECT^†`
處理常式	`PARAMETERS` `ROUTINES` `ROUTINE_OPTIONS`
搜尋索引	`SEARCH_INDEXES` `SEARCH_INDEX_COLUMNS` `SEARCH_INDEX_COLUMN_OPTIONSscience` `SEARCH_INDEX_OPTIONS`
工作階段	`SESSIONS_BY_PROJECT^†` `SESSIONS_BY_USER`
串流	`STREAMING_TIMELINE_BY_PROJECT^†` `STREAMING_TIMELINE_BY_FOLDER` `STREAMING_TIMELINE_BY_ORGANIZATION`
資料表	`COLUMNS` `COLUMN_FIELD_PATHS` `CONSTRAINT_COLUMN_USAGE` `KEY_COLUMN_USAGE` `PARTITIONSscience` `TABLES` `TABLE_OPTIONS` `TABLE_CONSTRAINTS` `TABLE_SNAPSHOTS` `TABLE_STORAGE_BY_PROJECT^†` `TABLE_STORAGE_BY_FOLDER` `TABLE_STORAGE_BY_ORGANIZATION` `TABLE_STORAGE_USAGE_TIMELINEscience` `TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDERscience` `TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATIONscience`
向量索引	`VECTOR_INDEXES` `VECTOR_INDEX_COLUMNS` `VECTOR_INDEX_OPTIONS`
瀏覽次數	`VIEWS` `MATERIALIZED_VIEWSscience`
Write API	`WRITE_API_TIMELINE_BY_PROJECT^†` `WRITE_API_TIMELINE_BY_FOLDER` `WRITE_API_TIMELINE_BY_ORGANIZATION`

^†對於 *BY_PROJECT 檢視畫面，BY_PROJECT 後置字元為選用項目。舉例來說，查詢 INFORMATION_SCHEMA.JOBS_BY_PROJECT 和 INFORMATION_SCHEMA.JOBS 會傳回相同的結果。

定價

對於使用以量計價方案的專案，對 INFORMATION_SCHEMA 檢視表執行查詢時，即使查詢所處理的位元組數少於 10 MB，也會產生最少 10 MB 的資料處理費。10 MB 是以量計價查詢的最低收費標準。詳情請參閱「以量計價」。

如果專案採用以容量計價，針對 INFORMATION_SCHEMA 檢視區塊和資料表執行的查詢會消耗您購買的 BigQuery 運算單元。詳情請參閱「以容量為準的定價」。

由於 INFORMATION_SCHEMA 查詢並不會快取，因此即使您每次執行 INFORMATION_SCHEMA 查詢時的查詢文字都相同，系統也會向您收費。

系統不會收取 INFORMATION_SCHEMA 資料檢視的儲存費用。

語法

INFORMATION_SCHEMA 檢視畫面必須參照資料集或區域。

注意：您必須指定位置，才能查詢 INFORMATION_SCHEMA 檢視畫面。如果查詢執行的位置與資料集或所用區域限定詞的位置不符，查詢 INFORMATION_SCHEMA 檢視畫面會失敗，並顯示以下錯誤：

Table myproject: region-us.INFORMATION_SCHEMA.[VIEW] not found in location US

資料集限定詞

資料集限定條件存在時，會將結果限制在指定的資料集中。例如：

-- Returns metadata for tables in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.TABLES;

下列 INFORMATION_SCHEMA 檢視畫面支援資料集限定詞：

COLUMNS
COLUMN_FIELD_PATHS
MATERIALIZED_VIEWS
PARAMETERS
PARTITIONS
ROUTINES
ROUTINE_OPTIONS
TABLES
TABLE_OPTIONS
VIEWS

區域限定詞

區域限定詞會以 region-REGION 語法表示。REGION 可使用任何資料集位置名稱。舉例來說，下列區域限定詞有效：

region-us
region-asia-east2
region-europe-north1

當地區限定條件存在時，系統會將搜尋結果限制在指定位置。舉例來說，下列查詢會傳回 US 多區域專案中所有資料集的中繼資料：

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

下列 INFORMATION_SCHEMA 檢視畫面不支援區域限定詞：

如果未指定區域限定條件或資料集限定條件，系統會傳回錯誤。

針對區域限定的 INFORMATION_SCHEMA 檢視畫面執行的查詢會在您指定的區域中執行，這表示您無法編寫單一查詢，將不同區域檢視畫面中的資料彙整在一起。如要合併來自多個地區的 INFORMATION_SCHEMA 檢視畫面，請在本機讀取及合併查詢結果，或複製產生的資料表至共同的地區。

專案限定詞

出現專案限定條件時，系統會將結果限制在指定專案。例如：

-- Returns metadata for the specified project and region.
SELECT * FROM myProject.`region-us`.INFORMATION_SCHEMA.TABLES;

-- Returns metadata for the specified project and dataset.
SELECT * FROM myProject.myDataset.INFORMATION_SCHEMA.TABLES;

所有 INFORMATION_SCHEMA 檢視畫面都支援專案限定詞。如果未指定專案限定詞，檢視畫面預設會顯示執行查詢的專案。

為機構層級檢視畫面指定專案限定條件 (例如 STREAMING_TIMELINE_BY_ORGANIZATION) 不會影響結果。

限制

BigQuery INFORMATION_SCHEMA 查詢必須使用 GoogleSQL 語法，INFORMATION_SCHEMA 並不支援舊版 SQL。
INFORMATION_SCHEMA 查詢結果不會快取。
INFORMATION_SCHEMA 檢視畫面無法用於 DDL 陳述式。
INFORMATION_SCHEMA 檢視畫面不含隱藏資料集的相關資訊。
INFORMATION_SCHEMA 含有區域限定條件的查詢可能會包含在時間旅行期間內刪除的資料集中，該區域資源的中繼資料。
當您從 INFORMATION_SCHEMA 檢視畫面列出資源時，系統只會在父項層級檢查權限，而不會在個別列層級檢查。因此，系統會忽略任何使用標記以條件指定個別資料列的拒絕政策 (預覽)。