Introduzione alla scalabilità automatica degli slot
Per le prenotazioni configurate per l'utilizzo della scalabilità automatica degli slot scalano automaticamente allocata per soddisfare le esigenze dei carichi di lavoro. Come carico di lavoro aumenta o diminuisce, BigQuery regola dinamicamente slot a un livello appropriato. Le prenotazioni con scalabilità automatica degli slot sono disponibili solo con le versioni di BigQuery.
Utilizzare le prenotazioni per la scalabilità automatica
Non è necessario acquistare impegni per gli slot prima di creare prenotazioni per l'autoscaling. Gli impegni di slot offrono una tariffa scontata per l'utilizzo costante ma sono facoltativi con le prenotazioni con scalabilità automatica. Per creare una scalabilità automatica, devi assegnare a una prenotazione un numero massimo di slot (il numero massimo dimensioni della prenotazione). Puoi identificare il numero massimo di slot con scalabilità automatica sottraendo la dimensione massima della prenotazione dagli eventuali slot di riferimento facoltativi assegnati alla prenotazione.
Quando crei prenotazioni con la scalabilità automatica, tieni presente quanto segue:
- BigQuery esegue la scalabilità delle prenotazioni quasi istantaneamente fino a quando non ha raggiunto il numero di slot necessari per eseguire i job o il numero massimo di slot disponibili per la prenotazione. La scalabilità automatica degli slot avviene sempre su un multiplo di 50.
- Lo scale up si basa sull'utilizzo effettivo e viene arrotondato ai 50 più vicini di incremento dello slot.
- Per gli slot sottoposti ad autoscaling vengono addebitati i prezzi di calcolo della capacità per l'edizione associata durante l'aumento di scala. Ti viene addebitato il numero di slot scalati, non il numero di slot utilizzati. L'addebito si applica anche se il job che causa lo scale up di BigQuery non va a buon fine. Per questo motivo, non utilizzare lo schema delle informazioni sui job per far corrispondere la fatturazione. Consulta invece Monitorare della scalabilità automatica con schema di informazioni.
- Sebbene il numero di slot sia sempre scalato di multipli di 50, può scalare più di 50 slot in un solo passaggio. Ad esempio, se il carico di lavoro richiede di 450 slot aggiuntivi, BigQuery può tentare di scalare contemporaneamente per soddisfare il requisito di capacità.
- BigQuery riduce le risorse quando i job associati alla prenotazione non ne hanno più bisogno (con un minimo di 1 minuto).
Qualsiasi capacità con scaling automatico viene conservata per almeno 60 secondi. Questo periodo di 60 secondi è chiamato finestra di riduzione. Qualsiasi picco di capacità reimposta di scale down, considerando l'intero livello di capacità come una nuova concessione. Tuttavia, se sono trascorsi almeno 60 secondi dall'ultimo aumento della capacità e se una domanda in meno, il sistema riduce la capacità senza reimpostare lo scale down che consente diminuzioni consecutive senza ritardo imposto.
Per informazioni su come utilizzare la scalabilità automatica, consulta Utilizzare la scalabilità automatica degli slot.
Utilizzo delle prenotazioni con slot di riferimento e con scalabilità automatica
Oltre a specificare la dimensione massima della prenotazione, facoltativamente puoi specificare un numero di slot di riferimento per prenotazione. La base di riferimento è il minimo di slot che saranno sempre allocati alla prenotazione e potrai addebitarle sempre. Gli slot a scalabilità automatica vengono aggiunti solo dopo che sono stati utilizzati tutti gli slot di riferimento (e gli slot inattivi, se applicabili). Puoi condividere gli slot di base inattivi di una prenotazione con altre prenotazioni che richiedono capacità.
Puoi aumentare il numero di slot di riferimento in una prenotazione ogni pochi minuti. Se vuoi ridurre gli slot di base, puoi farlo una volta ogni ora se hai modificato di recente la capacità di slot di base e gli slot di base superano gli slot impegnati. Altrimenti, puoi diminuire il valore basale a intervalli regolari di pochi minuti.
Gli slot di riferimento e con scalabilità automatica hanno lo scopo di fornire capacità in base al tuo caricamento di lavoro recente. Se prevedi un carico di lavoro elevato molto diverso da quelli del passato recente, ti consigliamo di aumentare la capacità di base prima dell'evento anziché fare affidamento sugli slot di scalabilità automatica per coprire la capacità del carico di lavoro. Se si verifica un problema durante l'aumento del valore basale capacità massima, riprova a eseguire la richiesta dopo 15 minuti.
Se la prenotazione non ha slot di riferimento o non è configurata per il prestito slot inattivi di altri delle prenotazioni, quindi BigQuery tenta di scalare. In caso contrario, gli slot di riferimento devono essere utilizzati completamente prima del ridimensionamento.
Le prenotazioni utilizzano e aggiungono slot con la priorità seguente:
- Slot di riferimento.
- Condivisione di slot inattivi (se abilitata). Le prenotazioni possono condividere solo la base di riferimento inattiva o slot impegnati da altre prenotazioni create con lo stesso e nella stessa regione.
- Slot a scalabilità automatica.
Nell'esempio seguente, gli slot vengono scalati da un importo di riferimento specificato. La
Le prenotazioni etl e dashboard hanno una dimensione di riferimento di 700 e 300 slot
rispettivamente.
In questo esempio, la prenotazione etl può scalare fino a 1300 slot (700 valori di riferimento
più 600 slot a scalabilità automatica). Se la prenotazione dashboard non è in uso,
la prenotazione etl può utilizzare i 300 slot della prenotazione dashboard
se non è in esecuzione alcun job, con un massimo di 1600 slot possibili.
La prenotazione dashboard può scalare fino a 1100 slot (300 slot di riferimento più
800 slot a scalabilità automatica). Se la prenotazione etl è completamente inattiva,
La prenotazione dashboard può scalare fino a un massimo di 1800 slot (300 base di riferimento
più 800 slot a scalabilità automatica più 700 slot inattivi nella prenotazione etl).
Se la prenotazione etl richiede più di 700 slot di riferimento, che sono
sempre disponibile, cerca di aggiungere slot utilizzando i metodi seguenti
ordine:
- 700 slot di riferimento.
- Condivisione di slot inattivi con i 300 slot di riferimento nella prenotazione
dashboard. La tua prenotazione condivide gli slot di riferimento inattivi solo con altre prenotazioni create con la stessa versione. - Aumento di 600 slot aggiuntivi fino alla dimensione massima della prenotazione.
Utilizzo degli impegni slot
L'esempio seguente mostra la scalabilità automatica degli slot utilizzando gli impegni di capacità.
Come le basi della prenotazione, gli impegni slot consentono di allocare un di slot disponibili per tutte le prenotazioni. A differenza degli slot di riferimento, non può essere ridotto durante il periodo di validità. Gli impegni slot sono facoltativo, ma può farti risparmiare sui costi se sono necessari slot di riferimento per lunghi periodi di nel tempo.
In questo esempio, ti viene addebitata una tariffa predefinita per l'impegno di capacità slot machine. Ti viene addebitata la tariffa di scalabilità automatica per il numero gli slot dopo l'attivazione della scalabilità automatica e le prenotazioni sono in stato di alto livello. Per la tariffa di scalabilità automatica, ti viene addebitato il numero di slot scalati, non il numero di slot utilizzati.
Numero massimo di slot disponibili
Puoi calcolare il numero massimo di slot che una prenotazione può utilizzare aggiungendo gli slot di riferimento, il numero massimo di slot con scalabilità automatica e gli eventuali slot nei vincoli creati con la stessa versione e non coperti dagli slot di riferimento. L'esempio nell'immagine precedente è impostato come segue:
- Un impegno di capacità di 1000 slot annuali. Questi slot sono assegnati
slot di riferimento nella prenotazione
etle nella prenotazionedashboard. - 700 slot di riferimento assegnati alla prenotazione
etl. - 300 slot di riferimento assegnati alla prenotazione
dashboard. - Slot a scalabilità automatica di 600 per la prenotazione
etl. - Slot a scalabilità automatica di 800 per la prenotazione
dashboard.
Per la prenotazione etl, il numero massimo di slot possibili è uguale agli slot di riferimento etl (700) più gli slot di riferimento dashboard (300, se tutti gli slot sono inattivi) più il numero massimo di slot con scalabilità automatica (600). Quindi,
il numero massimo di slot che la prenotazione etl potrebbe utilizzare in questo esempio è
1600. Questo numero supera il numero nell'impegno di capacità.
Nell'esempio seguente, l'impegno annuale supera gli slot di riferimento assegnati.
In questo esempio abbiamo:
- Un impegno di capacità di 1600 slot annuali.
- Una dimensione massima della prenotazione di 1500 (inclusi 500 slot con scalabilità automatica).
- 1000 slot di riferimento assegnati alla prenotazione
etl.
Il numero massimo di slot disponibili per la prenotazione è uguale agli slot di base (1000) più eventuali slot inutilizzati impegnati non dedicati agli slot di base (1600 slot annuali - 1000 slot di base = 600) più il numero di slot con scalabilità automatica (500). Pertanto, il numero massimo di slot potenziali in questa prenotazione è 2100. Gli slot a scalabilità automatica sono slot aggiuntivi rispetto all'impegno di capacità.
Best practice per la scalabilità automatica
Quando utilizzi per la prima volta il gestore della scalabilità automatica, imposta il numero di slot a scalabilità automatica su un un numero significativo basato sul rendimento passato e atteso. Una volta creata la prenotazione, monitora attivamente il tasso di errore, il rendimento e la fatturazione e regola il numero di slot di scalabilità automatica in base alle necessità.
Il gestore della scalabilità automatica ha un minimo di 1 minuto prima dello scale down, quindi è importante imposta il numero massimo di slot con scalabilità automatica per bilanciare prestazioni e ad accesso meno frequente per ridurre i costi di archiviazione. Se il numero massimo di slot a scalabilità automatica è troppo grande e il job può tutti gli slot per completare un job in pochi secondi, ti vengono comunque addebitati dei costi slot massimi per l'intero minuto. Se diminuisci il numero massimo di slot a metà importo attuale, la prenotazione viene scalata a un numero inferiore e il job può utilizza più
slot_secondsin quel minuto, riducendo gli sprechi. Per assistenza determinare i requisiti degli slot, consulta l'articolo sul monitoraggio del job del rendimento. Come approccio alternativo Per determinare i requisiti di slot, consulta Visualizzare lo slot della versione personalizzati.A volte l'utilizzo degli slot può superare la somma del valore di riferimento più gli slot scalati. Non ti viene addebitato alcun costo per l'utilizzo degli slot superiore al valore di riferimento più gli slot scalati.
Il gestore della scalabilità automatica è più efficiente per carichi di lavoro intensivi e a lunga esecuzione, come carichi di lavoro con più query simultanee. Evita di inviare query una alla volta di tempo, poiché ogni query scala la prenotazione dove rimangono in scala per un minimo di 1 minuto. Se invii continuamente query, causando un carico di lavoro costante, impostando una base di riferimento e acquistando un impegno offre capacità costante a un prezzo scontato.
La scalabilità automatica di BigQuery è soggetta alla disponibilità della capacità. BigQuery cerca di soddisfare la domanda in termini di capacità dei clienti in base all'utilizzo storico. Per ottenere garanzie di capacità, puoi impostare uno slot facoltativo base, ovvero il numero di slot garantiti in una prenotazione. Con i valori di riferimento, gli slot sono disponibili immediatamente e li paghi anche se non li utilizzi. Per garantire una capacità disponibile per grandi quantità, richieste inorganiche, ad esempio festività a traffico elevato, il team di BigQuery con diverse settimane di anticipo.
Gli slot di riferimento vengono sempre addebitati. Se un impegno di capacità scade, potresti dover modificare manualmente la quantità di slot di riferimento nelle prenotazioni per evitare addebiti indesiderati. Ad esempio, supponiamo che tu abbia un impegno di 1 anno con 100 slot e una prenotazione con 100 slot di riferimento. L'impegno scade e non ha un piano di rinnovo. Alla scadenza dell'impegno, pagherai per 100 slot di riferimento con pagamento a consumo di Google.
Monitora la scalabilità automatica
Quando monitori l'utilizzo degli slot con una risorsa amministrativa grafici, potresti notare un aumento di slot scalati rispetto all'utilizzo degli slot perché i grafici agevolano il numero di slot machine per il periodo di allineamento. Per visualizzare l'utilizzo degli slot di scalabilità automatica con dettagli più precisi, riduci l'opzione dell'intervallo di tempo. In questo modo, il periodo di allineamento viene aggiornato automaticamente con un incremento inferiore.
Nell'esempio seguente, il grafico mostra aree annuncio molto più grandi rispetto a quanto richiesto dal carico di lavoro.
Tuttavia, se riduci l'opzione relativa all'intervallo di tempo in modo che il periodo di allineamento venga per due secondi, puoi vedere che il gestore della scalabilità automatica adegua alla domanda del carico di lavoro visualizza dati più accurati. Puoi modificare l'opzione relativa all'intervallo di tempo trascinando gli intervalli di inizio e fine dell'opzione relativa all'intervallo di tempo. Per visualizzare i dati più precisi dati sulla domanda dei carichi di lavoro, seleziona p99 dall'elenco Metrica.
Per avere una visione più precisa dell'utilizzo della scalabilità automatica, utilizza un periodo di allineamento compreso tra 1 e 15 secondi. Per ulteriori informazioni sul periodo di allineamento dei grafici delle risorse amministrative, consulta l'opzione Periodo di tempo.
Per informazioni sulla visualizzazione dell'utilizzo degli slot, vedi Visualizza i grafici delle risorse amministrative
Monitora la scalabilità automatica con lo schema delle informazioni
Puoi utilizzare i seguenti script SQL per controllare i secondi di slot fatturati per una determinata edizione. Devi eseguire questi script nello stesso progetto
sono state create. Il primo script mostra i secondi di spazio fatturati coperti da
commitment_plan, mentre il secondo script mostra i secondi di spazio fatturati che non sono
coperti da un impegno.
Per eseguire questi script, devi impostare il valore di tre variabili:
start_timeend_timeedition_to_check
Questi script sono soggetti ai seguenti limiti:
Le prenotazioni eliminate e gli impegni di capacità vengono rimossi dalle visualizzazioni dello schema di informazioni al termine del periodo di conservazione dei dati. Specifica una finestra recente di che non contiene prenotazioni e impegni eliminati per i risultati sono corretti.
Il risultato degli script potrebbe non corrispondere esattamente alla fattura a causa di arrotondamenti di piccole dimensioni errori.
Il seguente script controlla l'utilizzo degli slot coperti dagli impegni per una determinata edizione.
Espandi per visualizzare lo script per gli scenari coperti
DECLARE start_time,end_time TIMESTAMP; DECLARE edition_to_check STRING; /* Google uses Pacific Time to calculate the billing period for all customers, regardless of their time zone. Use the following format if you want to match the billing report. Change the start_time and end_time values to match the desired window. */ /* The following three variables (start_time, end_time, and edition_to_check) are the only variables that you need to set in the script. During daylight savings time, the start_time and end_time variables should follow this format: 2024-02-20 00:00:00-08. */ SET start_time = "2023-07-20 00:00:00-07"; SET end_time = "2023-07-28 00:00:00-07"; SET edition_to_check = 'ENTERPRISE'; /* The following function returns the slot seconds for the time window between two capacity changes. For example, if there are 100 slots between (2023-06-01 10:00:00, 2023-06-01 11:00:00), then during that window the total slot seconds will be 100 * 3600. This script calculates a specific window (based on the variables defined above), which is why the following script includes script_start_timestamp_unix_millis and script_end_timestamp_unix_millis. */ CREATE TEMP FUNCTION GetSlotSecondsBetweenChanges( slots FLOAT64, range_begin_timestamp_unix_millis FLOAT64, range_end_timestamp_unix_millis FLOAT64, script_start_timestamp_unix_millis FLOAT64, script_end_timestamp_unix_millis FLOAT64) RETURNS INT64 LANGUAGE js AS r""" if (script_end_timestamp_unix_millis < range_begin_timestamp_unix_millis || script_start_timestamp_unix_millis > range_end_timestamp_unix_millis) { return 0; } var begin = Math.max(script_start_timestamp_unix_millis, range_begin_timestamp_unix_millis) var end = Math.min(script_end_timestamp_unix_millis, range_end_timestamp_unix_millis) return slots * Math.ceil((end - begin) / 1000.0) """; /* Sample CAPACITY_COMMITMENT_CHANGES data (unrelated columns ignored): +---------------------+------------------------+-----------------+--------+------------+--------+ | change_timestamp | capacity_commitment_id | commitment_plan | state | slot_count | action | +---------------------+------------------------+-----------------+--------+------------+--------+ | 2023-07-20 19:30:27 | 12954109101902401697 | ANNUAL | ACTIVE | 100 | CREATE | | 2023-07-27 22:29:21 | 11445583810276646822 | FLEX | ACTIVE | 100 | CREATE | | 2023-07-27 23:10:06 | 7341455530498381779 | MONTHLY | ACTIVE | 100 | CREATE | | 2023-07-27 23:11:06 | 7341455530498381779 | FLEX | ACTIVE | 100 | UPDATE | The last row indicates a special change from MONTHLY to FLEX, which happens because of commercial migration. */ WITH /* Information containing which commitment might have plan updated (e.g. renewal or commercial migration). For example: +------------------------+------------------+--------------------+--------+------------+--------+-----------+----------------------------+ | change_timestamp | capacity_commitment_id | commitment_plan | state | slot_count | action | next_plan | next_plan_change_timestamp | +---------------------+------------------------+-----------------+--------+------------+--------+-----------+----------------------------+ | 2023-07-20 19:30:27 | 12954109101902401697 | ANNUAL | ACTIVE | 100 | CREATE | ANNUAL | 2023-07-20 19:30:27 | | 2023-07-27 22:29:21 | 11445583810276646822 | FLEX | ACTIVE | 100 | CREATE | FLEX | 2023-07-27 22:29:21 | | 2023-07-27 23:10:06 | 7341455530498381779 | MONTHLY | ACTIVE | 100 | CREATE | FLEX | 2023-07-27 23:11:06 | | 2023-07-27 23:11:06 | 7341455530498381779 | FLEX | ACTIVE | 100 | UPDATE | FLEX | 2023-07-27 23:11:06 | */ commitments_with_next_plan AS ( SELECT *, IFNULL( LEAD(commitment_plan) OVER ( PARTITION BY capacity_commitment_id ORDER BY change_timestamp ASC ), commitment_plan) next_plan, IFNULL( LEAD(change_timestamp) OVER ( PARTITION BY capacity_commitment_id ORDER BY change_timestamp ASC ), change_timestamp) next_plan_change_timestamp FROM `region-us.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES_BY_PROJECT` ), /* Insert a 'DELETE' action for those with updated plans. The FLEX commitment '7341455530498381779' is has no 'CREATE' action, and is instead labeled as an 'UPDATE' action. For example: +---------------------+------------------------+-----------------+--------+------------+--------+ | change_timestamp | capacity_commitment_id | commitment_plan | state | slot_count | action | +---------------------+------------------------+-----------------+--------+------------+--------+ | 2023-07-20 19:30:27 | 12954109101902401697 | ANNUAL | ACTIVE | 100 | CREATE | | 2023-07-27 22:29:21 | 11445583810276646822 | FLEX | ACTIVE | 100 | CREATE | | 2023-07-27 23:10:06 | 7341455530498381779 | MONTHLY | ACTIVE | 100 | CREATE | | 2023-07-27 23:11:06 | 7341455530498381779 | FLEX | ACTIVE | 100 | UPDATE | | 2023-07-27 23:11:06 | 7341455530498381779 | MONTHLY | ACTIVE | 100 | DELETE | */ capacity_changes_with_additional_deleted_event_for_changed_plan AS ( SELECT next_plan_change_timestamp AS change_timestamp, project_id, project_number, capacity_commitment_id, commitment_plan, state, slot_count, 'DELETE' AS action, commitment_start_time, commitment_end_time, failure_status, renewal_plan, user_email, edition, is_flat_rate, FROM commitments_with_next_plan WHERE commitment_plan <> next_plan UNION ALL SELECT * FROM `region-us.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES_BY_PROJECT` ), /* The committed_slots change the history. For example: +---------------------+------------------------+------------------+-----------------+ | change_timestamp | capacity_commitment_id | slot_count_delta | commitment_plan | +---------------------+------------------------+------------------+-----------------+ | 2023-07-20 19:30:27 | 12954109101902401697 | 100 | ANNUAL | | 2023-07-27 22:29:21 | 11445583810276646822 | 100 | FLEX | | 2023-07-27 23:10:06 | 7341455530498381779 | 100 | MONTHLY | | 2023-07-27 23:11:06 | 7341455530498381779 | -100 | MONTHLY | | 2023-07-27 23:11:06 | 7341455530498381779 | 100 | FLEX | */ capacity_commitment_slot_data AS ( SELECT change_timestamp, capacity_commitment_id, CASE WHEN action = "CREATE" OR action = "UPDATE" THEN IFNULL( IF( LAG(action) OVER ( PARTITION BY capacity_commitment_id ORDER BY change_timestamp ASC, action ASC ) IN UNNEST(['CREATE', 'UPDATE']), slot_count - LAG(slot_count) OVER ( PARTITION BY capacity_commitment_id ORDER BY change_timestamp ASC, action ASC ), slot_count), slot_count) ELSE IF( LAG(action) OVER (PARTITION BY capacity_commitment_id ORDER BY change_timestamp ASC, action ASC) IN UNNEST(['CREATE', 'UPDATE']), -1 * slot_count, 0) END AS slot_count_delta, commitment_plan FROM capacity_changes_with_additional_deleted_event_for_changed_plan WHERE state = "ACTIVE" AND edition = edition_to_check AND change_timestamp <= end_time ), /* The total_committed_slots history for each plan. For example: +---------------------+---------------+-----------------+ | change_timestamp | capacity_slot | commitment_plan | +---------------------+---------------+-----------------+ | 2023-07-20 19:30:27 | 100 | ANNUAL | | 2023-07-27 22:29:21 | 100 | FLEX | | 2023-07-27 23:10:06 | 100 | MONTHLY | | 2023-07-27 23:11:06 | 0 | MONTHLY | | 2023-07-27 23:11:06 | 200 | FLEX | */ running_capacity_commitment_slot_data AS ( SELECT change_timestamp, SUM(slot_count_delta) OVER ( PARTITION BY commitment_plan ORDER BY change_timestamp RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW ) AS capacity_slot, commitment_plan, FROM capacity_commitment_slot_data ), /* The slot_seconds between each changes, partitioned by each plan. For example: +---------------------+--------------+-----------------+ | change_timestamp | slot_seconds | commitment_plan | +---------------------+--------------+-----------------+ | 2023-07-20 19:30:27 | 64617300 | ANNUAL | | 2023-07-27 22:29:21 | 250500 | FLEX | | 2023-07-27 23:10:06 | 6000 | MONTHLY | | 2023-07-27 23:11:06 | 0 | MONTHLY | | 2023-07-27 23:11:06 | 5626800 | FLEX | */ slot_seconds_data AS ( SELECT change_timestamp, GetSlotSecondsBetweenChanges( capacity_slot, UNIX_MILLIS(change_timestamp), UNIX_MILLIS( IFNULL( LEAD(change_timestamp) OVER (PARTITION BY commitment_plan ORDER BY change_timestamp ASC), CURRENT_TIMESTAMP())), UNIX_MILLIS(start_time), UNIX_MILLIS(end_time)) AS slot_seconds, commitment_plan, FROM running_capacity_commitment_slot_data WHERE change_timestamp <= end_time ) /* The final result is similar to the following: +-----------------+--------------------+ | commitment_plan | total_slot_seconds | +-----------------+--------------------+ | ANNUAL | 64617300 | | MONTHLY | 6000 | | FLEX | 5877300 | */ SELECT commitment_plan, SUM(slot_seconds) AS total_slot_seconds FROM slot_seconds_data GROUP BY commitment_plan
Lo script seguente verifica l'utilizzo degli slot non coperto dagli impegni per un un'edizione specifica. Questo utilizzo contiene due tipi di slot: slot scalati e slot di riferimento non coperti dagli impegni.
Espandi per visualizzare lo script per gli scenari non coperti
/* This script has several parts: 1. Calculate the baseline and scaled slots for reservations 2. Calculate the committed slots 3. Join the two results above to calculate the baseline not covered by committed slots 4. Aggregate the number */ -- variables DECLARE start_time, end_time TIMESTAMP; DECLARE edition_to_check STRING; /* Google uses Pacific Time to calculate the billing period for all customers, regardless of their time zone. Use the following format if you want to match the billing report. Change the start_time and end_time values to match the desired window. */ /* The following three variables (start_time, end_time, and edition_to_check) are the only variables that you need to set in the script. During daylight savings time, the start_time and end_time variables should follow this format: 2024-02-20 00:00:00-08. */ SET start_time = "2023-07-20 00:00:00-07"; SET end_time = "2023-07-28 00:00:00-07"; SET edition_to_check = 'ENTERPRISE'; /* The following function returns the slot seconds for the time window between two capacity changes. For example, if there are 100 slots between (2023-06-01 10:00:00, 2023-06-01 11:00:00), then during that window the total slot seconds will be 100 * 3600. This script calculates a specific window (based on the variables defined above), which is why the following script includes script_start_timestamp_unix_millis and script_end_timestamp_unix_millis. */ CREATE TEMP FUNCTION GetSlotSecondsBetweenChanges( slots FLOAT64, range_begin_timestamp_unix_millis FLOAT64, range_end_timestamp_unix_millis FLOAT64, script_start_timestamp_unix_millis FLOAT64, script_end_timestamp_unix_millis FLOAT64) RETURNS INT64 LANGUAGE js AS r""" if (script_end_timestamp_unix_millis < range_begin_timestamp_unix_millis || script_start_timestamp_unix_millis > range_end_timestamp_unix_millis) { return 0; } var begin = Math.max(script_start_timestamp_unix_millis, range_begin_timestamp_unix_millis) var end = Math.min(script_end_timestamp_unix_millis, range_end_timestamp_unix_millis) return slots * Math.ceil((end - begin) / 1000.0) """; /* Sample RESERVATION_CHANGES data (unrelated columns ignored): +---------------------+------------------+--------+---------------+---------------+ | change_timestamp | reservation_name | action | slot_capacity | current_slots | +---------------------+------------------+--------+---------------+---------------+ | 2023-07-27 22:24:15 | res1 | CREATE | 300 | 0 | | 2023-07-27 22:25:21 | res1 | UPDATE | 300 | 180 | | 2023-07-27 22:39:14 | res1 | UPDATE | 300 | 100 | | 2023-07-27 22:40:20 | res2 | CREATE | 300 | 0 | | 2023-07-27 22:54:18 | res2 | UPDATE | 300 | 120 | | 2023-07-27 22:55:23 | res1 | UPDATE | 300 | 0 | Sample CAPACITY_COMMITMENT_CHANGES data (unrelated columns ignored): +---------------------+------------------------+-----------------+--------+------------+--------+ | change_timestamp | capacity_commitment_id | commitment_plan | state | slot_count | action | +---------------------+------------------------+-----------------+--------+------------+--------+ | 2023-07-20 19:30:27 | 12954109101902401697 | ANNUAL | ACTIVE | 100 | CREATE | | 2023-07-27 22:29:21 | 11445583810276646822 | FLEX | ACTIVE | 100 | CREATE | | 2023-07-27 23:10:06 | 7341455530498381779 | MONTHLY | ACTIVE | 100 | CREATE | */ WITH /* The scaled_slots & baseline change history: +---------------------+------------------+------------------------------+---------------------+ | change_timestamp | reservation_name | autoscale_current_slot_delta | baseline_slot_delta | +---------------------+------------------+------------------------------+---------------------+ | 2023-07-27 22:24:15 | res1 | 0 | 300 | | 2023-07-27 22:25:21 | res1 | 180 | 0 | | 2023-07-27 22:39:14 | res1 | -80 | 0 | | 2023-07-27 22:40:20 | res2 | 0 | 300 | | 2023-07-27 22:54:18 | res2 | 120 | 0 | | 2023-07-27 22:55:23 | res1 | -100 | 0 | */ reservation_slot_data AS ( SELECT change_timestamp, reservation_name, CASE action WHEN "CREATE" THEN autoscale.current_slots WHEN "UPDATE" THEN IFNULL( autoscale.current_slots - LAG(autoscale.current_slots) OVER ( PARTITION BY project_id, reservation_name ORDER BY change_timestamp ASC, action ASC ), IFNULL( autoscale.current_slots, IFNULL( -1 * LAG(autoscale.current_slots) OVER ( PARTITION BY project_id, reservation_name ORDER BY change_timestamp ASC, action ASC ), 0))) WHEN "DELETE" THEN IF( LAG(action) OVER ( PARTITION BY project_id, reservation_name ORDER BY change_timestamp ASC, action ASC ) IN UNNEST(['CREATE', 'UPDATE']), -1 * autoscale.current_slots, 0) END AS autoscale_current_slot_delta, CASE action WHEN "CREATE" THEN slot_capacity WHEN "UPDATE" THEN IFNULL( slot_capacity - LAG(slot_capacity) OVER ( PARTITION BY project_id, reservation_name ORDER BY change_timestamp ASC, action ASC ), IFNULL( slot_capacity, IFNULL( -1 * LAG(slot_capacity) OVER ( PARTITION BY project_id, reservation_name ORDER BY change_timestamp ASC, action ASC ), 0))) WHEN "DELETE" THEN IF( LAG(action) OVER ( PARTITION BY project_id, reservation_name ORDER BY change_timestamp ASC, action ASC ) IN UNNEST(['CREATE', 'UPDATE']), -1 * slot_capacity, 0) END AS baseline_slot_delta, FROM `region-us.INFORMATION_SCHEMA.RESERVATION_CHANGES` WHERE edition = edition_to_check AND change_timestamp <= end_time ), -- Convert the above to running total /* +---------------------+-------------------------+----------------+ | change_timestamp | autoscale_current_slots | baseline_slots | +---------------------+-------------------------+----------------+ | 2023-07-27 22:24:15 | 0 | 300 | | 2023-07-27 22:25:21 | 180 | 300 | | 2023-07-27 22:39:14 | 100 | 300 | | 2023-07-27 22:40:20 | 100 | 600 | | 2023-07-27 22:54:18 | 220 | 600 | | 2023-07-27 22:55:23 | 120 | 600 | */ running_reservation_slot_data AS ( SELECT change_timestamp, SUM(autoscale_current_slot_delta) OVER (ORDER BY change_timestamp RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW) AS autoscale_current_slots, SUM(baseline_slot_delta) OVER (ORDER BY change_timestamp RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW) AS baseline_slots, FROM reservation_slot_data ), /* The committed_slots change history. For example: +---------------------+------------------------+------------------+ | change_timestamp | capacity_commitment_id | slot_count_delta | +---------------------+------------------------+------------------+ | 2023-07-20 19:30:27 | 12954109101902401697 | 100 | | 2023-07-27 22:29:21 | 11445583810276646822 | 100 | | 2023-07-27 23:10:06 | 7341455530498381779 | 100 | */ capacity_commitment_slot_data AS ( SELECT change_timestamp, capacity_commitment_id, CASE WHEN action = "CREATE" OR action = "UPDATE" THEN IFNULL( IF( LAG(action) OVER ( PARTITION BY capacity_commitment_id ORDER BY change_timestamp ASC, action ASC ) IN UNNEST(['CREATE', 'UPDATE']), slot_count - LAG(slot_count) OVER ( PARTITION BY capacity_commitment_id ORDER BY change_timestamp ASC, action ASC ), slot_count), slot_count) ELSE IF( LAG(action) OVER (PARTITION BY capacity_commitment_id ORDER BY change_timestamp ASC, action ASC) IN UNNEST(['CREATE', 'UPDATE']), -1 * slot_count, 0) END AS slot_count_delta FROM `region-us.INFORMATION_SCHEMA.CAPACITY_COMMITMENT_CHANGES_BY_PROJECT` WHERE state = "ACTIVE" AND edition = edition_to_check AND change_timestamp <= end_time ), /* The total_committed_slots history. For example: +---------------------+---------------+ | change_timestamp | capacity_slot | +---------------------+---------------+ | 2023-07-20 19:30:27 | 100 | | 2023-07-27 22:29:21 | 200 | | 2023-07-27 23:10:06 | 300 | */ running_capacity_commitment_slot_data AS ( SELECT change_timestamp, SUM(slot_count_delta) OVER (ORDER BY change_timestamp RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW) AS capacity_slot FROM capacity_commitment_slot_data ), /* Add next_change_timestamp to the above data, which will be used when joining with reservation data. For example: +---------------------+-----------------------+---------------+ | change_timestamp | next_change_timestamp | capacity_slot | +---------------------+-----------------------+---------------+ | 2023-07-20 19:30:27 | 2023-07-27 22:29:21 | 100 | | 2023-07-27 22:29:21 | 2023-07-27 23:10:06 | 200 | | 2023-07-27 23:10:06 | 2023-07-31 00:14:37 | 300 | */ running_capacity_commitment_slot_data_with_next_change AS ( SELECT change_timestamp, IFNULL(LEAD(change_timestamp) OVER (ORDER BY change_timestamp ASC), CURRENT_TIMESTAMP()) AS next_change_timestamp, capacity_slot FROM running_capacity_commitment_slot_data ), /* Whenever we have a change in reservations or commitments, the scaled_slots_and_baseline_not_covered_by_commitments will be changed. Hence we get a collection of all the change_timestamp from both tables. +---------------------+ | change_timestamp | +---------------------+ | 2023-07-20 19:30:27 | | 2023-07-27 22:24:15 | | 2023-07-27 22:25:21 | | 2023-07-27 22:29:21 | | 2023-07-27 22:39:14 | | 2023-07-27 22:40:20 | | 2023-07-27 22:54:18 | | 2023-07-27 22:55:23 | | 2023-07-27 23:10:06 | */ merged_timestamp AS ( SELECT change_timestamp FROM running_reservation_slot_data UNION DISTINCT SELECT change_timestamp FROM running_capacity_commitment_slot_data ), /* Change running reservation-slots and make sure we have one row when commitment changes. +---------------------+-------------------------+----------------+ | change_timestamp | autoscale_current_slots | baseline_slots | +---------------------+-------------------------+----------------+ | 2023-07-20 19:30:27 | 0 | 0 | | 2023-07-27 22:24:15 | 0 | 300 | | 2023-07-27 22:25:21 | 180 | 300 | | 2023-07-27 22:29:21 | 180 | 300 | | 2023-07-27 22:39:14 | 100 | 300 | | 2023-07-27 22:40:20 | 100 | 600 | | 2023-07-27 22:54:18 | 220 | 600 | | 2023-07-27 22:55:23 | 120 | 600 | | 2023-07-27 23:10:06 | 120 | 600 | */ running_reservation_slot_data_with_merged_timestamp AS ( SELECT change_timestamp, IFNULL( autoscale_current_slots, IFNULL( LAST_VALUE(autoscale_current_slots IGNORE NULLS) OVER (ORDER BY change_timestamp ASC), 0)) AS autoscale_current_slots, IFNULL( baseline_slots, IFNULL(LAST_VALUE(baseline_slots IGNORE NULLS) OVER (ORDER BY change_timestamp ASC), 0)) AS baseline_slots FROM running_reservation_slot_data RIGHT JOIN merged_timestamp USING (change_timestamp) ), /* Join the above, so that we will know the number for baseline not covered by commitments. +---------------------+-----------------------+-------------------------+------------------------------------+ | change_timestamp | next_change_timestamp | autoscale_current_slots | baseline_not_covered_by_commitment | +---------------------+-----------------------+-------------------------+------------------------------------+ | 2023-07-20 19:30:27 | 2023-07-27 22:24:15 | 0 | 0 | | 2023-07-27 22:24:15 | 2023-07-27 22:25:21 | 0 | 200 | | 2023-07-27 22:25:21 | 2023-07-27 22:29:21 | 180 | 200 | | 2023-07-27 22:29:21 | 2023-07-27 22:39:14 | 180 | 100 | | 2023-07-27 22:39:14 | 2023-07-27 22:40:20 | 100 | 100 | | 2023-07-27 22:40:20 | 2023-07-27 22:54:18 | 100 | 400 | | 2023-07-27 22:54:18 | 2023-07-27 22:55:23 | 220 | 400 | | 2023-07-27 22:55:23 | 2023-07-27 23:10:06 | 120 | 400 | | 2023-07-27 23:10:06 | 2023-07-31 00:16:07 | 120 | 300 | */ scaled_slots_and_baseline_not_covered_by_commitments AS ( SELECT r.change_timestamp, IFNULL(LEAD(r.change_timestamp) OVER (ORDER BY r.change_timestamp ASC), CURRENT_TIMESTAMP()) AS next_change_timestamp, r.autoscale_current_slots, IF( r.baseline_slots - IFNULL(c.capacity_slot, 0) > 0, r.baseline_slots - IFNULL(c.capacity_slot, 0), 0) AS baseline_not_covered_by_commitment FROM running_reservation_slot_data_with_merged_timestamp r LEFT JOIN running_capacity_commitment_slot_data_with_next_change c ON r.change_timestamp >= c.change_timestamp AND r.change_timestamp < c.next_change_timestamp ), /* The slot_seconds between each changes. For example: +---------------------+--------------------+ | change_timestamp | slot_seconds | +---------------------+--------------+ | 2023-07-20 19:30:27 | 0 | | 2023-07-27 22:24:15 | 13400 | | 2023-07-27 22:25:21 | 91580 | | 2023-07-27 22:29:21 | 166320 | | 2023-07-27 22:39:14 | 13200 | | 2023-07-27 22:40:20 | 419500 | | 2023-07-27 22:54:18 | 40920 | | 2023-07-27 22:55:23 | 459160 | | 2023-07-27 23:10:06 | 11841480 | */ slot_seconds_data AS ( SELECT change_timestamp, GetSlotSecondsBetweenChanges( autoscale_current_slots + baseline_not_covered_by_commitment, UNIX_MILLIS(change_timestamp), UNIX_MILLIS(next_change_timestamp), UNIX_MILLIS(start_time), UNIX_MILLIS(end_time)) AS slot_seconds FROM scaled_slots_and_baseline_not_covered_by_commitments WHERE change_timestamp <= end_time AND next_change_timestamp > start_time ) /* Final result for this example: +--------------------+ | total_slot_seconds | +--------------------+ | 13045560 | */ SELECT SUM(slot_seconds) AS total_slot_seconds FROM slot_seconds_data
Monitora le prestazioni del job
Potresti dover modificare la scalabilità automatica max_slots per evitare costi più elevati. La seguente query fornisce il contesto sulle prestazioni del tuo job in modo da poter scegliere la quantità corretta di slot di scalabilità automatica per il tuo carico di lavoro.
La seguente query fornisce dettagli sulle tue prenotazioni passate:
SELECT AVG(TIMESTAMP_DIFF(end_time, creation_time, MILLISECOND)) as avg_latency_ms, COUNT(*) as query_numbers, FROM `PROJECT_ID.region-REGION_NAME`.INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION WHERE creation_time >= START_TIME AND creation_time < END_TIME AND (statement_type != "SCRIPT" OR statement_type IS NULL) AND reservation_id = RESERVATION_ID
Sostituisci quanto segue:
PROJECT_ID: l'ID del progettoREGION_NAME: la regione del tuo progettoSTART_TIME: l'ora di creazione in cui vuoi iniziare a visualizzare i datiEND_TIME: l'ora di creazione fino alla quale vuoi interrompere la visualizzazione dei datiRESERVATION_ID: l'ID prenotazione
L'esempio seguente recupera i dettagli del job in un periodo di cinque giorni:
SELECT AVG(TIMESTAMP_DIFF(end_time, creation_time, MILLISECOND)) as avg_latency_ms, COUNT(*) as query_numbers, FROM `myproject.region-us`.INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION WHERE creation_time >= '2024-06-25 00:00:00-07' AND creation_time < '2024-06-30 00:00:00-07' AND (statement_type != "SCRIPT" OR statement_type IS NULL) AND reservation_id = reservationID
Quote
La somma delle dimensioni massime della prenotazione non deve superare la quota di slot.
Per informazioni sulle quote, consulta Quote e limiti.
Passaggi successivi
- Per ulteriori informazioni sulle versioni di BigQuery, consulta Introduzione a BigQuery.
- Per saperne di più sugli slot, consulta Informazioni slot machine.
- Per ulteriori informazioni sulle prenotazioni, consulta la sezione Introduzione alle prenotazioni.