Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Visualizzazione SEARCH_INDEXES
La vista INFORMATION_SCHEMA.SEARCH_INDEXES contiene una riga per ogni indice di ricerca in un set di dati.
Autorizzazioni obbligatorie
Per visualizzare i metadati dell'indice di ricerca, devi disporre dell'autorizzazione IAM (Identity and Access Management) bigquery.tables.get o bigquery.tables.list per la tabella con l'indice. Ciascuno dei seguenti ruoli IAM predefiniti include almeno una di queste autorizzazioni:
Quando esegui una query sulla visualizzazione INFORMATION_SCHEMA.SEARCH_INDEXES, i risultati della query contengono una riga per ogni indice di ricerca in un set di dati.
La vista INFORMATION_SCHEMA.SEARCH_INDEXES ha lo schema seguente:
Nome colonna
Tipo di dati
Valore
index_catalog
STRING
Il nome del progetto che contiene il set di dati.
index_schema
STRING
Il nome del set di dati contenente l'indice.
table_name
STRING
Il nome della tabella di base su cui viene creato l'indice.
index_name
STRING
Il nome dell'indice.
index_status
STRING
Lo stato dell'indice: ACTIVE, PENDING
DISABLEMENT, TEMPORARILY DISABLED o
PERMANENTLY DISABLED.
ACTIVE indica che l'indice è utilizzabile o è in fase di creazione. Consulta coverage_percentage
per controllare lo stato di avanzamento della creazione dell'indice.
PENDING DISABLEMENT indica che le dimensioni totali delle tabelle di base indicizzate superano il limite dell'organizzazione. L'indice è in coda per l'eliminazione. In questo stato, l'indice è utilizzabile nelle query di ricerca e ti viene addebitato lo spazio di archiviazione dell'indice di ricerca.
TEMPORARILY DISABLED indica che le dimensioni totali delle tabelle di base indicizzate superano il limite della tua organizzazione oppure che la tabella di base indicizzata è inferiore a 10 GB. In questo stato, l'indice
non viene utilizzato nelle query di ricerca e non ti viene addebitato alcun costo per lo spazio di archiviazione dell'indice di ricerca.
PERMANENTLY DISABLED indica che nella tabella di base è presente una
modifica dello schema incompatibile, ad esempio la modifica del
tipo di una colonna indicizzata da STRING a
INT64.
creation_time
TIMESTAMP
L'ora in cui è stato creato l'indice.
last_modification_time
TIMESTAMP
L'ultima volta che è stata modificata la configurazione dell'indice. Ad esempio,
l'eliminazione di una colonna indicizzata.
last_refresh_time
TIMESTAMP
L'ultima volta che i dati della tabella sono stati indicizzati. Un valore NULL
indica che l'indice non è ancora disponibile.
disable_time
TIMESTAMP
L'ora in cui lo stato dell'indice è stato impostato su DISABLED. Il valore è NULL se lo stato dell'indice non è DISABLED.
disable_reason
STRING
Il motivo per cui l'indice è stato disattivato. NULL se lo stato
dell'indice non è DISABLED.
DDL
STRING
L'istruzione DDL utilizzata per creare l'indice.
coverage_percentage
INTEGER
La percentuale approssimativa di dati della tabella che sono stati indicizzati. 0%
significa che l'indice non è utilizzabile in una query SEARCH, anche se alcuni dati sono già stati indicizzati.
unindexed_row_count
INTEGER
Il numero di righe nella tabella di base che non sono state indicizzate.
total_logical_bytes
INTEGER
Il numero di byte logici fatturabili per l'indice.
total_storage_bytes
INTEGER
Il numero di byte di spazio di archiviazione fatturabili per l'indice.
Le query su questa vista devono avere un qualificatore del set di dati. La tabella seguente illustra l'ambito della regione per questa visualizzazione:
-- Returns metadata for search indexes in a single dataset.SELECT*FROMmyDataset.INFORMATION_SCHEMA.SEARCH_INDEXES;
Esempio
L'esempio seguente mostra tutti gli indici di ricerca attivi nelle tabelle del set di datimy_dataset, nel progetto my_project. Sono inclusi i nomi, le istruzioni DDL utilizzate per crearli, la percentuale di copertura e l'analizza del testo. Se una tabella di base indicizzata è inferiore a 10 GB, l'indice non viene compilato, nel qual caso coverage_percentage è 0.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-09 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```"]]
