SEARCH_INDEXES 檢視畫面

INFORMATION_SCHEMA.SEARCH_INDEXES 檢視表會針對資料集中的每個搜尋索引記錄包含一個資料列。

所需權限

如要查看搜尋索引中繼資料，您必須具備索引資料表的 bigquery.tables.get 或 bigquery.tables.list 身分與存取權管理 (IAM) 權限。以下每個預先定義的 IAM 角色都包含下列至少一項權限：

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

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

結構定義

查詢 INFORMATION_SCHEMA.SEARCH_INDEXES 檢視表時，資料集中的每個搜尋索引在查詢結果中都會有一個資料列。

INFORMATION_SCHEMA.SEARCH_INDEXES 檢視表具有下列結構定義：

資料欄名稱	資料類型	值
index_catalog	STRING	包含資料集的專案名稱。
index_schema	STRING	包含索引的資料集名稱。
table_name	STRING	建立索引的基礎資料表名稱。
index_name	STRING	索引的名稱。
index_status	STRING	索引狀態：ACTIVE、PENDING DISABLEMENT、TEMPORARILY DISABLED 或 PERMANENTLY DISABLED。 ACTIVE 表示索引可供使用或正在建立中。請參閱 coverage_percentage ，查看索引建立作業的進度。 PENDING DISABLEMENT 表示索引基礎資料表的總大小超過貴機構的限制；索引會排入待刪除的隊列。處於這個狀態時，索引可用於搜尋查詢，且您必須為搜尋索引儲存空間付費。 TEMPORARILY DISABLED 表示索引基礎資料表的總大小超出貴機構的限制，或是基礎索引資料表小於 10 GB。處於這個狀態時，索引不會用於搜尋查詢，且您不會被收取搜尋索引儲存空間費用。 PERMANENTLY DISABLED 表示在基礎資料表上有相容性不佳的結構定義變更，例如將索引欄的類型從 STRING 變更為 INT64。
creation_time	TIMESTAMP	建立索引的時間。
last_modification_time	TIMESTAMP	上次修改索引設定的時間。例如刪除已編入索引的資料欄。
last_refresh_time	TIMESTAMP	上次為表格資料建立索引的時間。NULL 值表示索引尚未可用。
disable_time	TIMESTAMP	索引狀態設為 DISABLED 的時間。如果索引狀態不是 DISABLED，則值為 NULL。
disable_reason	STRING	停用索引的原因。如果索引狀態不是 DISABLED，則為 NULL。
DDL	STRING	用來建立索引的 DDL 陳述式。
coverage_percentage	INTEGER	已編入索引的資料表資料約占總資料量的百分比。0% 表示即使部分資料已建立索引，但索引仍無法用於 SEARCH 查詢。
unindexed_row_count	INTEGER	主資料表中未建立索引的資料列數。
total_logical_bytes	INTEGER	索引的可計費邏輯位元組數。
total_storage_bytes	INTEGER	索引的可計費儲存空間位元組數。
analyzer	STRING	用於產生搜尋索引權杖的文字分析器。

範圍和語法

對這個檢視表執行的查詢必須具有資料集限定詞。下表說明此檢視區域的範圍：

檢視表名稱	資源範圍	區域範圍
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.SEARCH_INDEXES	資料集層級	資料集位置

替換下列內容：

• 選用：PROJECT_ID： Google Cloud 專案的 ID。如果未指定，系統會使用預設專案。
• DATASET_ID：資料集 ID。詳情請參閱「資料集限定詞」。

示例

-- Returns metadata for search indexes in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.SEARCH_INDEXES;

範例

以下範例會顯示專案 my_project 中資料集 my_dataset 中所有有效的搜尋索引。其中包含名稱、用於建立的 DDL 陳述式、涵蓋率百分比和文字分析器。如果索引基礎資料表小於 10 GB，則不會填入索引，此時 coverage_percentage 為 0。

SELECT table_name, index_name, ddl, coverage_percentage, analyzer
FROM my_project.my_dataset.INFORMATION_SCHEMA.SEARCH_INDEXES
WHERE index_status = 'ACTIVE';

結果應如下所示：

+-------------+-------------+--------------------------------------------------------------------------------------+---------------------+----------------+
| table_name  | index_name  | ddl                                                                                  | coverage_percentage | analyzer       |
+-------------+-------------+--------------------------------------------------------------------------------------+---------------------+----------------+
| small_table | names_index | CREATE SEARCH INDEX `names_index` ON `my_project.my_dataset.small_table`(names)      | 0                   | NO_OP_ANALYZER |
| large_table | logs_index  | CREATE SEARCH INDEX `logs_index` ON `my_project.my_dataset.large_table`(ALL COLUMNS) | 100                 | LOG_ANALYZER   |
+-------------+-------------+--------------------------------------------------------------------------------------+---------------------+----------------+