Introduzione alla ricerca in BigQuery

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

Grazie agli indici di ricerca, BigQuery offre un'efficace piattaforma di archiviazione a colonne e ricerca di testo in modo da poter effettuare ricerche efficienti nelle righe quando devi 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. Quando i dati diventano disponibili in BigQuery, puoi recuperarli immediatamente con la funzione SEARCH.

Casi d'uso

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

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

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

Prezzi

Non viene addebitato 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 comportano costi di archiviazione quando sono attivi. Puoi trovare la dimensione di archiviazione dell'indice 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 disporre dell'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 diventa non 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 del 100%, ti viene comunque addebitata l'intera archiviazione dell'indice indicata nella vista INFORMATION_SCHEMA.SEARCH_INDEXES.
  • Le query che contengono la funzione SEARCH non sono 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')
  );

Passaggi successivi