Prenotare la capacità di BI Engine

Acquisti la capacità di BI Engine creando una prenotazione. BI Engine è disponibile solo per i progetti con un'edizione supportata. Le prenotazioni vengono misurate in GiB di memoria. La prenotazione è collegata a un progetto e a una regione che identifichi al momento della creazione. BI Engine utilizza questa capacità per memorizzare i dati nella cache. Per informazioni sulla dimensione massima della prenotazione per BI Engine, consulta Quote e limiti.

Quando usi BI Engine, gli addebiti si basano sulla capacità di BI Engine acquistata per il progetto. Le prenotazioni di BI Engine vengono addebitate per GiB/ora, con prezzi per regione. Consulta Prezzi di BI Engine.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare ed eliminare le prenotazioni, chiedi all'amministratore di concederti il ruolo IAM Amministratore risorse BigQuery (roles/bigquery.resourceAdmin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea una prenotazione

Per prenotare la capacità di BI Engine on demand:

Console

  1. Nella pagina BigQuery, in Amministrazione, vai alla BI Engine pagina.

    Vai a BI Engine

  2. Fai clic su Crea prenotazione.

  3. Nella pagina Crea prenotazione, per il Passaggio 1:

    • Verifica il nome del progetto.
    • Scegli la tua località. La località deve corrispondere a quella dei set di dati su cui stai eseguendo query.
    • Regola il dispositivo di scorrimento in base alla quantità di capacità di memoria che stai prenotando. L'esempio seguente imposta la capacità su 2 GiB. Il valore massimo attuale è 250 GiB. Puoi richiedere un aumento della capacità di prenotazione massima per i tuoi progetti. Gli aumenti delle prenotazioni sono disponibili nella maggior parte delle regioni e l'elaborazione può richiedere da 3 giorni a una settimana.

      Località della capacità di BI Engine

  4. Fai clic su Avanti.

  5. Tabelle preferite (facoltativo). Le tabelle preferite ti consentono di limitare l'accelerazione di BI Engine a un insieme specifico di tabelle. Tutte le altre tabelle utilizzano gli slot BigQuery standard.

    Nel campo ID tabella, specifica la tabella che vuoi accelerare utilizzando il pattern: PROJECT.DATASET.TABLE.

    Sostituisci quanto segue:

    • PROJECT: il tuo Google Cloud ID progetto
    • DATASET: il set di dati
    • TABLE: la tabella che vuoi accelerare
  6. Fai clic su Avanti.

  7. Per il Passaggio 3, esamina i dettagli della prenotazione e poi fai clic su Crea.

Dopo aver confermato la prenotazione, i dettagli vengono visualizzati nella pagina Prenotazioni.

SQL

Utilizza l'istruzione DDL ALTER BI_CAPACITY SET OPTIONS per creare o modificare una prenotazione di BI Engine.

  1. Nella Google Cloud console, vai alla pagina BigQuery.

    Vai a BigQuery

  2. Nell'editor di query, inserisci la seguente istruzione:

    ALTER BI_CAPACITY `PROJECT_ID.LOCATION_ID.default`
    SET OPTIONS (
      size_gb = VALUE,
      preferred_tables =
        ['TABLE_PROJECT_ID.DATASET.TABLE1',
        'TABLE_PROJECT_ID.DATASET.TABLE2']);

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID facoltativo del progetto che usufruirà dell'accelerazione di BI Engine. Se omesso, viene utilizzato il progetto predefinito.
    • LOCATION_ID: la località in cui i dati devono essere memorizzati nella cache, con il prefisso region-. Esempi: region-us, region-us-central1.
    • VALUE: la dimensione della prenotazione per la capacità di BI Engine in gibibyte, da 1 a 250 GiB.INT64 Puoi richiedere un aumento della capacità di prenotazione massima per i tuoi progetti. Gli aumenti delle prenotazioni sono disponibili nella maggior parte delle regioni e l'elaborazione può richiedere da 3 giorni a una settimana. L'impostazione di VALUE sostituisce il valore esistente, se presente. L'impostazione su NULL cancella il valore per questa opzione.
    • TABLE_PROJECT_ID.DATASET.TABLE: l'elenco facoltativo delle tabelle preferite a cui deve essere applicata l'accelerazione. Formato: TABLE_PROJECT_ID.DATASET.TABLE or DATASET.TABLE. Se il progetto viene omesso, viene utilizzato il progetto predefinito.

  3. Fai clic su Esegui.

Per saperne di più su come eseguire le query, consulta Eseguire una query interattiva.

bq

Utilizza il bq update comando e fornisci l' istruzione DDL (Data Definition Language) come parametro di query:

bq --project_id=PROJECT_ID update \
    --bi_reservation_size=SIZE \
    --location=LOCATION \
    --reservation

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto
  • SIZE: la capacità di memoria della prenotazione in gibibyte, da 1 a 250 GiB. Puoi richiedere un aumento della capacità di prenotazione massima per i tuoi progetti. Gli aumenti delle prenotazioni sono disponibili nella maggior parte delle regioni e l'elaborazione può richiedere da 3 giorni a una settimana.
  • LOCATION: la località del set di dati su cui stai eseguendo query

Stimare e misurare la capacità

Per stimare i requisiti di capacità per una prenotazione di BI Engine:

  1. Visualizza la visualizzazione TOTAL_LOGICAL_BYTESview per determinare la dimensione logica della tabella e utilizzala per la tua prenotazione iniziale di BI Engine. Ad esempio:

    SELECT
      SUM(TOTAL_LOGICAL_BYTES) / 1024.0 / 1024.0 / 1024.0 AS logical_size_gb
    FROM
      `region-us.INFORMATION_SCHEMA.TABLE_STORAGE`
    WHERE
      TABLE_NAME IN UNNEST(["Table1", "Table2"]);

    Ad esempio, per le query su un insieme di tabelle che contengono un totale di 200 GiB di dati, come best practice puoi iniziare con una prenotazione di BI Engine di 200 GiB. Le query più selettive che utilizzano solo un sottoinsieme di campi o partizioni disponibili potrebbero iniziare con una dimensione di prenotazione più piccola.

  2. Esegui tutte le query che devono essere ottimizzate e che sono state create nello stesso progetto e nella stessa regione della prenotazione di BI Engine. L'obiettivo è approssimare il carico di lavoro che devi ottimizzare. L'aumento del carico richiede più memoria per gestire le query. I dati vengono caricati in BI Engine dopo la ricezione della query.

  3. Confronta la prenotazione della RAM di BI Engine con il numero di byte utilizzati, reservation/used_bytes nelle metriche bigquerybiengine di Cloud Monitoring.

  4. Regola la capacità di prenotazione in base ai risultati. In molti casi d'uso, una prenotazione più piccola può accelerare la maggior parte delle query, risparmiando denaro e risorse. Per saperne di più sul monitoraggio di BI Engine, consulta Monitoraggio di BI Engine.

I seguenti fattori influiscono sulla dimensione della prenotazione di BI Engine:

  • BI Engine memorizza nella cache solo le colonne e le righe a cui si accede di frequente necessarie per elaborare la query.
  • Quando una prenotazione è completamente utilizzata, BI Engine tenta di scaricare i dati utilizzati meno di recente per liberare capacità per le nuove query.
  • Se più query a elevato utilizzo di risorse di calcolo utilizzano lo stesso set di dati, BI Engine carica copie aggiuntive dei dati per ridistribuire e ottimizzare i tempi di risposta.

Modifica una prenotazione

Per modificare una prenotazione esistente:

Console

Per specificare un insieme di tabelle per l'accelerazione in una prenotazione esistente:

  1. Nella Google Cloud console, vai alla pagina BigQuery.

    Vai a BigQuery

  2. Nel menu di navigazione di BigQuery, fai clic su BI Engine.

    Se il progetto è configurato per le tabelle preferite, nella colonna Tabelle preferite viene visualizzato un insieme di tabelle.

    immagine

  3. Nella riga della prenotazione che vuoi modificare, fai clic sull'icona nella colonna Azioni e poi seleziona Modifica.

  4. Regola il dispositivo di scorrimento GiB di capacità in base alla quantità di capacità di memoria che stai prenotando. Fai clic su Avanti.

  5. Tabelle preferite: per specificare un insieme di tabelle per l'accelerazione in una prenotazione esistente, nel campo ID tabella, specifica la tabella che vuoi accelerare utilizzando il pattern: PROJECT.DATASET.TABLE.

    Sostituisci quanto segue:

    • PROJECT: il tuo Google Cloud ID progetto
    • DATASET: il set di dati
    • TABLE: la tabella che vuoi accelerare

    L'applicazione delle modifiche può richiedere fino a dieci secondi. Solo le tabelle nell'elenco delle tabelle preferite possono utilizzare l'accelerazione di BI Engine.

    Fai clic su Avanti.

  6. Conferma la prenotazione modificata. Se accetti, fai clic su Aggiorna.

SQL

Puoi utilizzare l'istruzione DDL ALTER BI_CAPACITY SET OPTIONS per creare o modificare una prenotazione di BI Engine.

  1. Nella Google Cloud console, vai alla pagina BigQuery.

    Vai a BigQuery

  2. Nell'editor di query, inserisci la seguente istruzione:

    ALTER BI_CAPACITY `PROJECT_ID.LOCATION_ID.default`
    SET OPTIONS (
      size_gb = VALUE,
      preferred_tables =
        [`TABLE_PROJECT_ID.DATASET.TABLE1`,
        `TABLE_PROJECT_ID.DATASET.TABLE2`]);

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID facoltativo del progetto che usufruirà dell'accelerazione di BI Engine. Se omesso, viene utilizzato il progetto predefinito.
    • LOCATION_ID: la località in cui i dati devono essere memorizzati nella cache, con il prefisso region-. Esempi: region-us, region-us-central1.
    • VALUE: la dimensione INT64 della prenotazione per la capacità di BI Engine in gibibyte, da 1 a 250 GiB. Puoi richiedere un aumento della capacità di prenotazione massima per i tuoi progetti. Gli aumenti delle prenotazioni sono disponibili nella maggior parte delle regioni e l'elaborazione può richiedere da 3 giorni a una settimana. L'impostazione di VALUE sostituisce il valore esistente, se presente. L'impostazione su NULL cancella il valore per questa opzione.
    • TABLE_PROJECT_ID.DATASET.TABLE: elenco facoltativo delle tabelle preferite a cui deve essere applicata l'accelerazione. Formato: TABLE_PROJECT_ID.DATASET.TABLE or DATASET.TABLE. Se il progetto viene omesso, viene utilizzato il progetto predefinito.

  3. Fai clic su Esegui.

Per saperne di più su come eseguire le query, consulta Eseguire una query interattiva.

Elimina una prenotazione

Per eliminare una prenotazione della capacità:

Console

  1. Nella pagina BigQuery, in Amministrazione, vai alla BI Engine pagina.

    Vai a BI Engine

  2. Nella sezione Prenotazioni, individua la prenotazione.

  3. Nella colonna Azioni, fai clic sull'icona a destra della tua prenotazione e scegli Elimina.

  4. Nella finestra di dialogo Eliminare la prenotazione?, inserisci Elimina e poi fai clic su ELIMINA.

SQL

Imposta le opzioni per la capacità di BI Engine.

  1. Nella Google Cloud console, vai alla pagina BigQuery.

    Vai a BigQuery

  2. Nell'editor di query, inserisci la seguente istruzione:

    ALTER BI_CAPACITY `PROJECT_ID.LOCATION_ID.default`
    SET OPTIONS (
      size_gb = 0);

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID facoltativo del progetto che usufruirà dell'accelerazione di BI Engine. Se omesso, viene utilizzato il progetto predefinito.
    • LOCATION_ID: la località in cui i dati devono essere memorizzati nella cache, con il prefisso region-. Esempi: region-us, region-us-central1.

    Quando elimini tutte le prenotazioni della capacità in un progetto, BI Engine viene disattivato per quel progetto.

  3. Fai clic su Esegui.

Per saperne di più su come eseguire le query, consulta Eseguire una query interattiva.

bq

Utilizza il bq update comando e fornisci l'istruzione DDL come parametro di query.

bq --project_id="PROJECT_ID" \
update --reservation
    --bi_reservation_size=0 \
    --location=LOCATION

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto
  • LOCATION: la località del set di dati su cui stai eseguendo query

Verificare le informazioni di BI Engine

Puoi ottenere informazioni sulla capacità di BI Engine eseguendo query sulle tabelle INFORMATION_SCHEMA.

Verificare lo stato della prenotazione

Per verificare lo stato della prenotazione, incluso un insieme di tabelle preferite, visualizza la visualizzazione INFORMATION_SCHEMA.BI_CAPACITIES utilizzando una query SQL. Ad esempio:

SELECT
  *
FROM
  `<PROJECT_ID>.region-<REGION>.INFORMATION_SCHEMA.BI_CAPACITIES`;

Nella Google Cloud console, il risultato di questa query SQL è simile al seguente:

immagine

Visualizzare le modifiche alla prenotazione

Per visualizzare la cronologia delle modifiche per una determinata prenotazione, utilizza la visualizzazione INFORMATION_SCHEMA.BI_CAPACITY_CHANGES utilizzando una query SQL. Ad esempio:

SELECT
  *
FROM
  `<PROJECT_ID>.region-<REGION>.INFORMATION_SCHEMA.BI_CAPACITY_CHANGES`
ORDER BY
  change_timestamp DESC
LIMIT 3;

Nella Google Cloud console, il risultato di questa query SQL è simile al seguente:

righe dei risultati con change_timestamp project_id project_number

Passaggi successivi