Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Tampilan SEARCH_INDEXES
Tampilan INFORMATION_SCHEMA.SEARCH_INDEXES berisi satu baris untuk setiap indeks
penelusuran dalam 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:
Saat Anda membuat kueri tampilan INFORMATION_SCHEMA.SEARCH_INDEXES, hasil kueri akan berisi satu baris untuk setiap indeks penelusuran dalam set data.
Tampilan INFORMATION_SCHEMA.SEARCH_INDEXES 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.
index_status
STRING
Status indeks: ACTIVE, PENDING
DISABLEMENT, TEMPORARILY DISABLED, atau PERMANENTLY DISABLED.
ACTIVE berarti indeks dapat digunakan atau sedang dibuat. Lihat coverage_percentage
untuk melihat progres pembuatan indeks.
PENDING DISABLEMENT berarti ukuran total tabel dasar yang diindeks melebihi batas organisasi Anda; indeks dimasukkan ke dalam antrean untuk dihapus. Dalam status ini, indeks dapat digunakan dalam kueri penelusuran dan Anda akan dikenai biaya untuk penyimpanan indeks penelusuran.
TEMPORARILY DISABLED berarti ukuran total tabel dasar yang diindeks melebihi batas organisasi Anda, atau tabel dasar yang diindeks lebih kecil dari 10 GB. Selama dalam status ini, indeks tidak digunakan dalam kueri penelusuran dan Anda tidak akan dikenai biaya untuk penyimpanan indeks penelusuran.
PERMANENTLY DISABLED berarti ada perubahan skema yang tidak kompatibel pada tabel dasar, seperti mengubah jenis kolom yang diindeks dari STRING menjadi INT64.
creation_time
TIMESTAMP
Waktu pembuatan indeks.
last_modification_time
TIMESTAMP
Terakhir kali konfigurasi indeks diubah. Misalnya, menghapus kolom yang diindeks.
last_refresh_time
TIMESTAMP
Terakhir kali data tabel diindeks. Nilai NULL berarti indeks belum tersedia.
disable_time
TIMESTAMP
Waktu status indeks ditetapkan ke DISABLED. Nilainya adalah NULL jika status indeks bukan DISABLED.
disable_reason
STRING
Alasan indeks dinonaktifkan. NULL jika status indeks bukan DISABLED.
DDL
STRING
Pernyataan DDL yang digunakan untuk membuat indeks.
coverage_percentage
INTEGER
Perkiraan persentase data tabel yang telah diindeks. 0% berarti indeks tidak dapat digunakan dalam kueri SEARCH, meskipun jika beberapa data telah diindeks.
unindexed_row_count
INTEGER
Jumlah baris dalam tabel dasar yang belum diindeks.
total_logical_bytes
INTEGER
Jumlah byte logis yang dapat ditagih untuk indeks.
total_storage_bytes
INTEGER
Jumlah byte penyimpanan yang dapat ditagih untuk indeks.
analyzer
STRING
Penganalisis teks yang digunakan untuk menghasilkan token untuk indeks penelusuran.
Cakupan dan sintaksis
Kueri terhadap tampilan ini harus memiliki penentu set data. Tabel
berikut menjelaskan cakupan wilayah untuk tampilan ini:
Opsional: PROJECT_ID: ID project Google 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 indexes in a single dataset.SELECT*FROMmyDataset.INFORMATION_SCHEMA.SEARCH_INDEXES;
Contoh
Contoh berikut menunjukkan semua indeks penelusuran aktif pada tabel dalam set data my_dataset, yang terletak di project my_project. Contoh ini mencakup nama indeks,
pernyataan DDL yang digunakan untuk membuatnya, persentase cakupannya, dan
penganalisis teksnya. Jika tabel dasar yang diindeks
kurang dari 10 GB, maka indeksnya tidak terisi, dan dalam hal ini
coverage_percentage adalah 0.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-17 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eINFORMATION_SCHEMA.SEARCH_INDEXES\u003c/code\u003e view provides metadata for each search index within a dataset, with each row representing a unique index.\u003c/p\u003e\n"],["\u003cp\u003eAccessing search index metadata requires either the \u003ccode\u003ebigquery.tables.get\u003c/code\u003e or \u003ccode\u003ebigquery.tables.list\u003c/code\u003e IAM permission on the indexed table, which are included in several predefined IAM roles such as \u003ccode\u003eroles/bigquery.admin\u003c/code\u003e and \u003ccode\u003eroles/bigquery.dataViewer\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe view's schema includes details like \u003ccode\u003eindex_name\u003c/code\u003e, \u003ccode\u003eindex_status\u003c/code\u003e, \u003ccode\u003ecreation_time\u003c/code\u003e, \u003ccode\u003eDDL\u003c/code\u003e, \u003ccode\u003ecoverage_percentage\u003c/code\u003e, \u003ccode\u003eanalyzer\u003c/code\u003e and more, offering comprehensive information about each search index.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eindex_status\u003c/code\u003e field indicates the current state of the index, such as \u003ccode\u003eACTIVE\u003c/code\u003e, \u003ccode\u003ePENDING DISABLEMENT\u003c/code\u003e, \u003ccode\u003eTEMPORARILY DISABLED\u003c/code\u003e, or \u003ccode\u003ePERMANENTLY DISABLED\u003c/code\u003e, each having different implications on its usability and storage charges.\u003c/p\u003e\n"],["\u003cp\u003eQueries to this view must use a dataset qualifier, specifying the \u003ccode\u003ePROJECT_ID\u003c/code\u003e and \u003ccode\u003eDATASET_ID\u003c/code\u003e, and its scope is limited to the dataset's location, allowing users to retrieve metadata for search indexes within a specific dataset.\u003c/p\u003e\n"]]],[],null,["# SEARCH_INDEXES view\n===================\n\nThe `INFORMATION_SCHEMA.SEARCH_INDEXES` view contains one row for each search\nindex in a dataset.\n\nRequired permissions\n--------------------\n\nTo see [search index](/bigquery/docs/search-index) metadata, you need the\n`bigquery.tables.get` or `bigquery.tables.list` Identity and Access Management (IAM)\npermission on the table with the index. Each of the following predefined\nIAM roles includes at least one of these permissions:\n\n- `roles/bigquery.admin`\n- `roles/bigquery.dataEditor`\n- `roles/bigquery.dataOwner`\n- `roles/bigquery.dataViewer`\n- `roles/bigquery.metadataViewer`\n- `roles/bigquery.user`\n\nFor more information about BigQuery permissions, see\n[Access control with IAM](/bigquery/docs/access-control).\n\nSchema\n------\n\nWhen you query the `INFORMATION_SCHEMA.SEARCH_INDEXES` view, the query results contain one row for each search index in a dataset.\n\n\u003cbr /\u003e\n\nThe `INFORMATION_SCHEMA.SEARCH_INDEXES` view has the following schema:\n\nScope and syntax\n----------------\n\nQueries against this view must have a [dataset qualifier](/bigquery/docs/information-schema-intro#syntax). The\nfollowing table explains the region scope for this view:\n\nReplace the following:\n\n- Optional: \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of your Google Cloud project. If not specified, the default project is used.\n- \u003cvar translate=\"no\"\u003eDATASET_ID\u003c/var\u003e: the ID of your dataset. For more information, see [Dataset qualifier](/bigquery/docs/information-schema-intro#dataset_qualifier).\n\n\u003cbr /\u003e\n\n**Example** \n\n -- Returns metadata for search indexes in a single dataset.\n SELECT * FROM myDataset.INFORMATION_SCHEMA.SEARCH_INDEXES;\n\nExample\n-------\n\nThe following example shows all active search indexes on tables in the dataset\n`my_dataset`, located in the project `my_project`. It includes their names, the\nDDL statements used to create them, their coverage percentage, and their\ntext analyzer. If an indexed base table is\nless than 10GB, then its index is not populated, in which case\n`coverage_percentage` is 0. \n\n SELECT table_name, index_name, ddl, coverage_percentage, analyzer\n FROM my_project.my_dataset.INFORMATION_SCHEMA.SEARCH_INDEXES\n WHERE index_status = 'ACTIVE';\n\nThe results should look like the following: \n\n```\n+-------------+-------------+--------------------------------------------------------------------------------------+---------------------+----------------+\n| table_name | index_name | ddl | coverage_percentage | analyzer |\n+-------------+-------------+--------------------------------------------------------------------------------------+---------------------+----------------+\n| small_table | names_index | CREATE SEARCH INDEX `names_index` ON `my_project.my_dataset.small_table`(names) | 0 | NO_OP_ANALYZER |\n| large_table | logs_index | CREATE SEARCH INDEX `logs_index` ON `my_project.my_dataset.large_table`(ALL COLUMNS) | 100 | LOG_ANALYZER |\n+-------------+-------------+--------------------------------------------------------------------------------------+---------------------+----------------+\n```"]]
