AI_INDEX_COLUMNS 檢視表

INFORMATION_SCHEMA.AI_INDEX_COLUMNS 檢視表包含資料集中每個資料表上,每個 AI 索引資料欄的一列。

所需權限

如要查看 AI 索引中繼資料,您必須具備索引資料表的 bigquery.tables.get 或 bigquery.tables.list Identity and Access Management (IAM) 權限。下列每個預先定義的 IAM 角色都至少包含其中一項權限:

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

如要進一步瞭解 BigQuery 權限,請參閱「使用 IAM 控管存取權」。

結構定義

查詢 INFORMATION_SCHEMA.AI_INDEX_COLUMNS 檢視表時,查詢結果會針對資料集中每個資料表的每個索引資料欄,顯示一個資料列。

INFORMATION_SCHEMA.AI_INDEX_COLUMNS 檢視表具有下列結構定義:

資料欄名稱 資料類型 值
index_catalog STRING 資料集所屬專案的名稱。
index_schema STRING 含有 AI 索引的資料集名稱。
table_name STRING 建立 AI 索引的資料表名稱。
index_name STRING AI 索引的名稱。
index_column_name STRING AI 索引資料欄的名稱。如果是使用 AUTO COLUMNS 建立的 AI 索引,這個檢視畫面會列出所有選取的資料欄。

範圍和語法

對這個檢視表執行的查詢必須包含資料集限定詞。下表說明這個檢視畫面的區域範圍:

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

更改下列內容:

  • PROJECT_ID: Cloud de Confiance by S3NS 專案的 ID。
  • DATASET_ID:資料集的 ID。

範例

下列查詢會列出 my_project.my_dataset 中 AI 索引的索引資料欄:

SELECT
  table_name,
  index_name,
  index_column_name
FROM
  my_project.my_dataset.INFORMATION_SCHEMA.AI_INDEX_COLUMNS;

結果大致如下:

+------------+-------------------+-------------------+
| table_name | index_name        | index_column_name |
+------------+-------------------+-------------------+
| products   | products_ai_index | name              |
| products   | products_ai_index | description       |
| products   | products_ai_index | category          |
| products   | products_ai_index | review            |
+------------+-------------------+-------------------+