Tampilan SEARCH_INDEX_COLUMN_OPTIONS

Tampilan INFORMATION_SCHEMA.SEARCH_INDEX_COLUMN_OPTIONS berisi satu baris untuk setiap set opsi di kolom yang diindeks penelusuran dalam tabel di set data.

Izin yang diperlukan

Untuk melihat metadata indeks penelusuran, Anda memerlukan izin Identity and Access Management (IAM) bigquery.tables.get atau bigquery.tables.list pada tabel dengan indeks. Setiap peran IAM yang telah ditetapkan berikut menyertakan setidaknya salah satu izin ini:

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

Untuk mengetahui informasi selengkapnya tentang izin BigQuery, lihat Kontrol akses dengan IAM.

Skema

Saat Anda membuat kueri tampilan INFORMATION_SCHEMA.SEARCH_INDEX_COLUMN_OPTIONS, hasil kueri akan berisi satu baris untuk setiap set opsi pada kolom yang diindeks penelusuran di tabel dalam set data.

Tampilan INFORMATION_SCHEMA.SEARCH_INDEX_OPTIONS memiliki skema berikut:

Nama kolom Jenis data Nilai
index_catalog STRING Nama project yang berisi set data.
index_schema STRING Nama set data yang berisi indeks.
table_name STRING Nama tabel dasar tempat indeks dibuat.
index_name STRING Nama indeks.
column_name STRING Nama kolom yang diindeks tempat opsi ditetapkan.
option_name STRING Nama opsi yang ditentukan di kolom.
option_type STRING Jenis opsi.
option_value STRING Nilai opsi.

Cakupan dan sintaksis

Kueri terhadap tampilan ini harus memiliki penentu set data. Tabel berikut menjelaskan cakupan wilayah untuk tampilan ini:

Nama Tampilan Cakupan resource Cakupan region
[PROJECT_ID.]DATASET_ID.INFORMATION_SCHEMA.SEARCH_INDEX_COLUMN_OPTIONS Level set data Lokasi set data
Ganti kode berikut:
  • Opsional: PROJECT_ID: ID project Trusted Cloud Anda. Jika tidak ditentukan, project default akan digunakan.
  • DATASET_ID: ID set data Anda. Untuk mengetahui informasi selengkapnya, lihat Penentu set data.

Contoh

-- Returns metadata for search index column options in a single dataset.
SELECT * FROM myDataset.INFORMATION_SCHEMA.SEARCH_INDEX_COLUMN_OPTIONS;

Contoh

Contoh berikut menetapkan perincian kolom indeks default ke COLUMN, dan secara terpisah menetapkan perincian untuk col2 dan col3 ke GLOBAL dan COLUMN masing-masing. Dalam contoh ini, kolom col2 dan col3 muncul dalam hasil karena perinciannya ditetapkan secara eksplisit. Perincian untuk kolom col1 tidak ditampilkan karena menggunakan perincian default.

CREATE SEARCH INDEX index1 ON `mydataset.table1` (
  ALL COLUMNS WITH COLUMN OPTIONS (
    col2 OPTIONS(index_granularity = 'GLOBAL'),
    col3 OPTIONS(index_granularity = 'COLUMN')
  )
)
OPTIONS(
  default_index_column_granularity = 'COLUMN'
);

SELECT
  index_column_name, option_name, option_type, option_value
FROM
  mydataset.INFORMATION_SCHEMA.SEARCH_INDEX_COLUMN_OPTIONS
WHERE
  index_schema = 'mydataset' AND index_name = 'index1' AND table_name = 'table1';

Hasilnya mirip dengan berikut ini:

+-------------------+-------------------+---------------+--------------+
| index_column_name |  option_name      | option_type   | option_value |
+-------------------+-------------------+---------------+--------------+
| col2              | index_granularity | STRING        | GLOBAL       |
| col3              | index_granularity | STRING        | COLUMN       |
+-------------------+-------------------+---------------+--------------+

Contoh setara berikut, yang tidak menggunakan ALL COLUMNS, menetapkan perincian kolom indeks default ke COLUMN dan menetapkan perincian untuk dua kolom ke GLOBAL dan COLUMN secara terpisah:

CREATE SEARCH INDEX index1 ON `mydataset.table1` (
  col1,
  col2 OPTIONS(index_granularity = 'GLOBAL'),
  col3 OPTIONS(index_granularity = 'COLUMN')
)
OPTIONS(
  default_index_column_granularity = 'COLUMN'
);

SELECT
  index_column_name, option_name, option_type, option_value
FROM
  mydataset.INFORMATION_SCHEMA.SEARCH_INDEX_COLUMN_OPTIONS
WHERE
  index_schema = 'mydataset' AND index_name = 'index1' AND table_name = 'table1';

Hasilnya mirip dengan berikut ini:

+-------------------+-------------------+---------------+--------------+
| index_column_name |  option_name      | option_type   | option_value |
+-------------------+-------------------+---------------+--------------+
| col2              | index_granularity | STRING        | GLOBAL       |
| col3              | index_granularity | STRING        | COLUMN       |
+-------------------+-------------------+---------------+--------------+