Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

INFORMATION_SCHEMA 簡介

BigQuery INFORMATION_SCHEMA 檢視區塊可讓您擷取 BigQuery 物件的中繼資料。您可以查詢這些唯讀的系統定義檢視區塊，分析資料集、工作和存取權控管等資源。

在 BigQuery 中，您可以指定範圍和檢視區塊，使用 GoogleSQL 查詢 INFORMATION_SCHEMA 檢視區塊。舉例來說，如要取得資料集中資料表的中繼資料，請指定 myDataset.INFORMATION_SCHEMA.TABLES。

下表列出可用的檢視畫面：

資源類型	INFORMATION_SCHEMA 檢視畫面
存取控管	`OBJECT_PRIVILEGESscience`
BI Engine	`BI_CAPACITIES` `BI_CAPACITY_CHANGES`
設定	`EFFECTIVE_PROJECT_OPTIONS` `ORGANIZATION_OPTIONS` `ORGANIZATION_OPTIONS_CHANGES` `PROJECT_OPTIONS` `PROJECT_OPTIONS_CHANGES`
資料集	`SCHEMATA SCHEMATA_LINKS SCHEMATA_OPTIONS SHARED_DATASET_USAGE SCHEMATA_REPLICAS SCHEMATA_REPLICAS_BY_FAILOVER_RESERVATION`
圖表	`PROPERTY_GRAPHS`
工作	`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^†` `FAILOVER_HISTORY_BY_PROJECT^†science` `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` `SEARCH_INDEXES_BY_ORGANIZATION`
工作階段	`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_VIEWS`
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 會傳回相同結果。

定價

如果專案採用隨需價格，即使查詢處理的位元組少於 10 MB，針對檢視區塊執行的查詢仍會產生至少 10 MB 的資料處理費用。INFORMATION_SCHEMA以量計價查詢的最低計費金額為 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

如果提供區域限定符，系統只會顯示指定位置的結果。區域限定符並非階層式，也就是說，歐盟多區域不包含europe-*區域，美國多區域也不包含us-*區域。舉例來說，下列查詢會傳回查詢執行所在專案的 US 多區域中所有資料集的中繼資料，但不包括 us-west1 區域中的資料集：

-- Returns metadata for all datasets in the US multi-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 檢視畫面列出資源時，系統只會檢查上層層級的權限，不會檢查個別列層級的權限。因此，系統會忽略任何使用標記有條件地指定個別資料列的拒絕政策 (預覽)。