Introduzione alla ricerca in BigQuery

Gli indici di ricerca di BigQuery ti consentono di utilizzare GoogleSQL per trovare facilmente elementi unici di dati nascosti in dati JSON semi-strutturati e testi non strutturati, senza dover conoscere in anticipo gli schemi delle tabelle.

Grazie agli indici di ricerca, BigQuery offre un'efficace archiviazione a colonne e una ricerca testuale in un'unica piattaforma, consentendo una ricerca efficiente delle righe quando hai bisogno di trovare singole righe di dati. Un caso d'uso comune è l'analisi dei log. Ad esempio, potresti voler identificare le righe di dati associate a un utente per i report relativi al Regolamento generale sulla protezione dei dati (GDPR) o trovare codici di errore specifici in un payload di testo.

BigQuery archivia e gestisce gli indici in modo che, quando i dati diventano disponibili in BigQuery, possano recuperarli immediatamente con la funzione SEARCH. Scopri di più sulle best practice per l'utilizzo della funzione SEARCH.

Casi d'uso

Gli indici di ricerca di BigQuery consentono di eseguire le attività seguenti:

  • Cercare i log di sistema, di rete o delle applicazioni archiviati nelle tabelle BigQuery.
  • Identificare gli elementi di dati da eliminare per rispettare i processi normativi.
  • Assistenza per la risoluzione dei problemi degli sviluppatori.
  • Eseguire controlli di sicurezza.
  • Crea una dashboard che richieda filtri di ricerca altamente selettivi.
  • Cercare le corrispondenze esatte nei dati pre-elaborati.

Per ulteriori informazioni, consulta Creare un indice di ricerca e Eseguire ricerche con un indice.

Prezzi

Non è previsto alcun costo per l'elaborazione necessaria per creare e aggiornare gli indici di ricerca quando la dimensione totale delle tabelle indicizzate nella tua organizzazione è inferiore al limite della tua regione. Per supportare l'indicizzazione oltre questo limite, devi fornire una prenotazione personalizzata per la gestione dei job di gestione dell'indice. Gli indici di ricerca attivi comportano costi di archiviazione. Le dimensioni dell'archiviazione dell'indice sono indicate nella visualizzazione INFORMATION_SCHEMA.SEARCH_INDEXES.

Ruoli e autorizzazioni

Per creare un indice di ricerca, devi disporre dell'autorizzazione IAM bigquery.tables.createIndex nella tabella in cui stai creando l'indice. Per eliminare un indice di ricerca, devi avere l'autorizzazione bigquery.tables.deleteIndex. Ciascuno dei seguenti ruoli IAM predefiniti include le autorizzazioni necessarie per lavorare con gli indici di ricerca:

  • Proprietario dati BigQuery (roles/bigquery.dataOwner)
  • Editor dati BigQuery (roles/bigquery.dataEditor)
  • Amministratore BigQuery (roles/bigquery.admin)

Limitazioni

  • Non puoi creare un indice di ricerca direttamente in una vista o una vista materializzata, ma la chiamata della funzione SEARCH in una vista di una tabella indicizzata utilizza l'indice di ricerca sottostante.
  • Se rinomini una tabella dopo aver creato un indice di ricerca su di essa, l'indice non sarà più valido.
  • La funzione SEARCH è progettata per le ricerche di punti. Non sono disponibili ricerche parziali, correzioni di battitura, caratteri jolly e altri tipi di ricerche nei documenti.
  • Se l'indice di ricerca non ha ancora una copertura al 100%, ti viene comunque addebitata tutta l'archiviazione dell'indice riportata nella vista INFORMATION_SCHEMA.SEARCH_INDEXES.
  • Le query che contengono la funzione SEARCH non vengono accelerate da BigQuery BI Engine.

  • Gli indici di ricerca non vengono utilizzati quando la tabella indicizzata viene modificata da un'istruzione DML, ma possono essere utilizzati quando la funzione SEARCH fa parte di una sottoquery in un'istruzione DML.

    • Un indice di ricerca non viene utilizzato nella seguente query:
    DELETE FROM my_dataset.indexed_table
WHERE SEARCH(user_id, '123');
    • Un indice di ricerca può essere utilizzato nella seguente query:
    DELETE FROM my_dataset.other_table
WHERE
  user_id IN (
    SELECT user_id
    FROM my_dataset.indexed_table
    WHERE SEARCH(user_id, '123')
  );

  • Gli indici di ricerca non vengono utilizzati quando la query fa riferimento alle viste materializzate.

Passaggi successivi