Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Gestisci le impostazioni di configurazione predefinite

Le impostazioni di configurazione predefinite in BigQuery possono aiutare la tua organizzazione a applicare la sicurezza, controllare i costi e ottimizzare le prestazioni delle query. In qualità di amministratore BigQuery o proprietario del progetto, puoi specificare, rimuovere e recuperare questi valori predefiniti a livello di organizzazione e progetto oppure eseguirne l'override per singoli job e sessioni.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per specificare o recuperare le impostazioni di configurazione, chiedi all'amministratore di concederti i seguenti ruoli IAM:

Specifica le impostazioni di configurazione: Amministratore BigQuery (roles/bigquery.admin) sulla tua organizzazione o sul tuo progetto
Recupera le impostazioni di configurazione: Utente job BigQuery (roles/bigquery.jobUser) nel progetto specificato

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per specificare o recuperare le impostazioni di configurazione. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per specificare o recuperare le impostazioni di configurazione sono necessarie le seguenti autorizzazioni:

Specifica le impostazioni di configurazione: bigquery.config.update sulla tua organizzazione o sul tuo progetto
Recupera le impostazioni di configurazione: bigquery.config.get nel progetto specificato

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per saperne di più sui ruoli e sulle autorizzazioni IAM in BigQuery, consulta Ruoli e autorizzazioni predefiniti.

Specificare le impostazioni globali

Le impostazioni globali si applicano a tutte le località e non utilizzano un prefisso region-REGION.. Al contrario, le impostazioni regionali si applicano solo a una località specifica. Puoi specificare le impostazioni globali a livello di organizzazione o di progetto. La località predefinita (default_location) è l'unica impostazione globale che puoi configurare.

Se non specifichi esplicitamente una località, questa viene determinata in uno dei seguenti modi:

La località dei set di dati a cui viene fatto riferimento nella richiesta. Ad esempio, se una query fa riferimento a una tabella o a una vista in un set di dati archiviato nella regione asia-northeast1, il job di query viene eseguito in asia-northeast1.
La regione specificata per una connessione a cui viene fatto riferimento in una richiesta.
La località di una tabella di destinazione.

Se la località non è specificata esplicitamente e non può essere determinata dalle risorse nella richiesta, viene utilizzata la località predefinita. Se la località predefinita non è impostata, il job viene eseguito nella multi-regione US.

Limitazioni

Le impostazioni di configurazione globali sono soggette alle seguenti limitazioni:

Le impostazioni globali dell'organizzazione e le impostazioni progetto non sono supportate nelle località BigQuery Omni. Non puoi impostare default_location su una località BigQuery Omni né configurare o visualizzare le impostazioni globali in una località BigQuery Omni.
Non puoi combinare impostazioni globali e regionali nella stessa istruzione DDL ALTER ORGANIZATION SET OPTIONS o ALTER PROJECT SET OPTIONS.
Quando modifichi l'impostazione globale default_location, la propagazione della modifica può richiedere fino a 10 minuti. Finché l'impostazione non viene propagata, BigQuery potrebbe instradare i job che si basano sulla località predefinita alla località predefinita precedente.

Configura le impostazioni globali dell'organizzazione

Puoi configurare le impostazioni globali a livello di organizzazione utilizzando l'istruzione DDL ALTER ORGANIZATION SET OPTIONS. La località predefinita (default_location) è l'unica impostazione globale che puoi configurare a livello di organizzazione. Tutte le altre impostazioni a livello di organizzazione sono impostazioni regionali.

L'istruzione DDL ALTER ORGANIZATION SET OPTIONS si applica all'organizzazione a cui appartiene il progetto attuale.

Per configurare l'impostazione default_location a livello di organizzazione, segui questi passaggi:

Console

Nella console Google Cloud , vai alla pagina BigQuery.

Vai a BigQuery
Per aprire l'editor di query, fai clic su search_insights Query senza titolo.
Per configurare l'impostazione default_location, inserisci la seguente istruzione DDL nell'editor di query:
```
  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );
```
Sostituisci LOCATION con una località regionale o multiregionale di BigQuery. Questo valore è la località che BigQuery utilizza per eseguire i job quando la località del job non può essere dedotta dalla richiesta, ad esempio quando una query non fa riferimento a set di dati o connessioni.
In alternativa, per rimuovere l'impostazione default_location a livello di organizzazione, inserisci la seguente istruzione DDL nell'editor di query:
```
  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = NULL
  );
```
Fai clic su Esegui.

bq

Per configurare l'impostazione default_location a livello di organizzazione, inserisci il comando bq query con il flag --use_legacy_sql impostato su false e fornisci la seguente istruzione DDL come parametro di query:

  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );

Sostituisci LOCATION con una località regionale o multiregionale di BigQuery. Questo valore è la località utilizzata da BigQuery per eseguire i job quando non è possibile dedurla dalla richiesta, ad esempio quando una query non fa riferimento a set di dati o connessioni.

In alternativa, per rimuovere l'impostazione default_location a livello di organizzazione, inserisci il comando bq query con il flag --use_legacy_sql impostato su false e fornisci la seguente istruzione DDL come parametro di query:

  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = NULL
  );

API

Chiama il metodo jobs.query e fornisci l'istruzione DDL nella proprietà query del corpo della richiesta.

Configurare le impostazioni progetto globali

Puoi configurare le impostazioni globali a livello di progetto utilizzando l'istruzione DDL ALTER PROJECT SET OPTIONS. La località predefinita (default_location) è l'unica impostazione globale che puoi configurare a livello di progetto. Tutte le altre impostazioni a livello di progetto sono impostazioni regionali.

L'istruzione DDL ALTER PROJECT SET OPTIONS accetta facoltativamente la variabile PROJECT_ID. Se non specifichi PROJECT_ID, l'istruzione viene impostata per impostazione predefinita sul progetto in cui esegui l'istruzione DDL ALTER PROJECT.

Le configurazioni a livello di progetto sostituiscono quelle a livello di organizzazione. A loro volta, le configurazioni a livello di sessione possono eseguire l'override delle configurazioni a livello di progetto e le configurazioni a livello di job possono eseguire l'override delle configurazioni a livello di sessione.

Per configurare l'impostazione default_location a livello di progetto, segui questi passaggi:

Console

Nella console Google Cloud , vai alla pagina BigQuery.

Vai a BigQuery
Per aprire l'editor di query, fai clic su search_insights Query senza titolo.
Per configurare l'impostazione default_location, inserisci la seguente istruzione DDL nell'editor di query:
```
  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );
```
Sostituisci quanto segue:
- PROJECT_ID: l'ID progetto
- LOCATION: una regione o una località multiregionale BigQuery. Questo valore è la località che BigQuery utilizza per eseguire i job quando la località del job non può essere dedotta dalla richiesta, ad esempio quando una query non fa riferimento a set di dati o connessioni.
In alternativa, per rimuovere l'impostazione default_location a livello di progetto, inserisci la seguente istruzione DDL nell'editor di query:
```
  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = NULL
  );
```
Se rimuovi l'impostazione default_location a livello di progetto, BigQuery utilizza l'impostazione predefinita a livello di organizzazione, se esiste, o l'impostazione predefinita di sistema.
Fai clic su Esegui.

bq

Per configurare l'impostazione default_location a livello di progetto, inserisci il comando bq query con il flag --use_legacy_sql impostato su false e fornisci la seguente istruzione DDL come parametro di query:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );

Sostituisci quanto segue:

PROJECT_ID: l'ID progetto
LOCATION: una regione o una località multiregionale BigQuery. Questo valore è la località che BigQuery utilizza per eseguire i job quando la località del job non può essere dedotta dalla richiesta, ad esempio quando una query non fa riferimento a set di dati o connessioni.

In alternativa, per rimuovere l'impostazione default_location a livello di progetto, inserisci il comando bq query con il flag --use_legacy_sql impostato su false e fornisci la seguente istruzione DDL come parametro di query:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = NULL
  );

Se rimuovi l'impostazione default_location a livello di progetto, BigQuery utilizza l'impostazione predefinita a livello di organizzazione, se esistente, o l'impostazione predefinita di sistema.

API

Chiama il metodo jobs.query e fornisci l'istruzione DDL nella proprietà query del corpo della richiesta.

Specifica le impostazioni regionali

Le impostazioni regionali si applicano a una località specifica e richiedono un prefisso region-REGION.. Puoi configurare le impostazioni regionali a livello di organizzazione o progetto.

Controlli di prenotazione e fatturazione

Puoi configurare le impostazioni a livello di progetto regionale per controllare il modo in cui le query utilizzano le prenotazioni o la fatturazione on demand. Queste impostazioni contribuiscono a garantire la prevedibilità dei costi consentendo l'utilizzo flessibile delle prenotazioni o richiedendo che le query utilizzino gli slot di prenotazione.

I controlli comuni di prenotazione e fatturazione includono reservation_override_mode (Anteprima) e disable_on_demand_billing (Anteprima). Per configurare queste impostazioni, consulta Configura le impostazioni progetto regionali. Per un elenco completo delle opzioni di progetto, consulta l'elenco delle opzioni di ALTER PROJECT SET OPTIONS.

Configurare le impostazioni dell'organizzazione regionali

Puoi configurare le impostazioni regionali a livello di organizzazione utilizzando l'istruzione DDL ALTER ORGANIZATION SET OPTIONS. Devi specificare la regione in cui si applica ogni impostazione dell'organizzazione. Puoi utilizzare una sola regione in un'istruzione.

Gli esempi in questa sezione specificano le seguenti impostazioni predefinite dell'organizzazione regionale:

Fuso orario: America/Chicago
Chiave Cloud KMS: una chiave definita dall'utente
Timeout della query: 30 minuti (1.800.000 millisecondi)
Timeout della coda di query interattive: 10 minuti (600.000 millisecondi)
Timeout della coda di query batch: 20 minuti (1.200.000 millisecondi)
Visualizzazioni dell'archiviazione delle tabelle e dell'indice della Ricerca INFORMATION_SCHEMA (enable_info_schema_storage): attivato

Per saperne di più su tutte le impostazioni dell'organizzazione a livello regionale, consulta organization_set_options_list.

Per configurare le impostazioni dell'organizzazione regionale, segui questi passaggi:

Console

Nella console Google Cloud , vai alla pagina BigQuery.

Vai a BigQuery
Per aprire l'editor di query, fai clic su search_insights Query senza titolo.

Per configurare le impostazioni dell'organizzazione regionale, inserisci la seguente istruzione DDL nell'editor di query:

  ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone`= 'America/Chicago',
  -- Ensure all service accounts under the organization have permission to KMS_KEY
  `region-REGION.default_kms_key_name` = KMS_KEY,
  `region-REGION.default_query_job_timeout_ms` = 1800000,
  `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
  `region-REGION.default_batch_query_queue_timeout_ms` = 1200000,
  `region-REGION.enable_info_schema_storage` = true);

Sostituisci quanto segue:

REGION: la regione BigQuery associata al tuo progetto o alla tua organizzazione, ad esempio us o europe-west6. Il valore di REGION deve essere lo stesso per ogni opzione del comando.
KMS_KEY: una chiave Cloud KMS definita dall'utente. Per saperne di più, consulta Chiavi Cloud KMS gestite dal cliente.

In alternativa, per rimuovere le impostazioni dell'organizzazione a livello di regione, inserisci la seguente istruzione DDL nell'editor di query:

  ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL,
  `region-REGION.enable_info_schema_storage` = NULL);

Fai clic su Esegui.

bq

Per configurare le impostazioni dell'organizzazione regionale, inserisci il comando bq query con il flag --use_legacy_sql impostato su false e fornisci la seguente istruzione DDL come parametro di query:

  ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone`= 'America/Chicago',
  -- Ensure all service accounts under the organization have permission to KMS_KEY
  `region-REGION.default_kms_key_name` = KMS_KEY,
  `region-REGION.default_query_job_timeout_ms` = 1800000,
  `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
  `region-REGION.default_batch_query_queue_timeout_ms` = 1200000,
  `region-REGION.enable_info_schema_storage` = true);

Sostituisci quanto segue:

REGION: la regione BigQuery associata al tuo progetto o alla tua organizzazione, ad esempio us o europe-west6. Il valore di REGION deve essere lo stesso per ogni opzione del comando.
KMS_KEY: una chiave Cloud KMS definita dall'utente. Per maggiori informazioni, consulta Chiavi Cloud KMS gestite dal cliente.

In alternativa, per rimuovere le impostazioni dell'organizzazione a livello di regione, inserisci il comando bq query con il flag --use_legacy_sql impostato su false e fornisci la seguente istruzione DDL come parametro di query:

  ALTER ORGANIZATION
  SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL,
  `region-REGION.enable_info_schema_storage` = NULL);

API

Chiama il metodo jobs.query e fornisci l'istruzione DDL nella proprietà query del corpo della richiesta.

Configura le impostazioni del progetto a livello di regione

Puoi configurare le impostazioni regionali a livello di progetto utilizzando l'istruzione DDL ALTER PROJECT SET OPTIONS. Devi specificare la regione in cui si applica ogni impostazione progetto. Puoi utilizzare una sola regione in un'istruzione.

Le configurazioni a livello di progetto hanno la precedenza su quelle a livello di organizzazione. A loro volta, le configurazioni a livello di sessione possono eseguire l'override delle configurazioni a livello di progetto e le configurazioni a livello di job possono eseguire l'override delle configurazioni a livello di sessione.

Gli esempi in questa sezione specificano le seguenti impostazioni predefinite del progetto regionale:

Fuso orario: America/Los_Angeles
Chiave Cloud KMS: una chiave definita dall'utente
Timeout della query: 1 ora (3.600.000 millisecondi)
Timeout della coda di query interattive: 10 minuti (600.000 millisecondi)
Timeout della coda di query batch: 20 minuti (1.200.000 millisecondi)
Equità basata sulla prenotazione: abilitata
Query globali: abilitate per l'esecuzione e l'accesso ai dati
Visualizzazioni dell'archiviazione delle tabelle e dell'indice della Ricerca INFORMATION_SCHEMA (enable_info_schema_storage): attivato

Per saperne di più su tutte le impostazioni progetto regionali, vedi project_set_options_list.

Per configurare le impostazioni progetto regionali, segui questi passaggi:

Console

Nella console Google Cloud , vai alla pagina BigQuery.

Vai a BigQuery
Per aprire l'editor di query, fai clic su search_insights Query senza titolo.

Per configurare le impostazioni progetto regionali, inserisci la seguente istruzione DDL nell'editor di query:

 ALTER PROJECT PROJECT_ID
 SET OPTIONS (
 `region-REGION.default_time_zone` = 'America/Los_Angeles',
 -- Ensure all service accounts under the project have permission to KMS_KEY
 `region-REGION.default_kms_key_name` = KMS_KEY,
 `region-REGION.default_query_job_timeout_ms` = 3600000,
 `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
 `region-REGION.default_batch_query_queue_timeout_ms` = 1200000,
 `region-REGION.enable_reservation_based_fairness` = true,
 `region-REGION.enable_global_queries_execution` = true,
 `region-REGION.enable_global_queries_data_access` = true,
 `region-REGION.enable_info_schema_storage` = true);

Sostituisci quanto segue:

PROJECT_ID: l'ID progetto
REGION: la regione BigQuery associata al tuo progetto o alla tua organizzazione, ad esempio us o europe-west6. Il valore di REGION deve essere lo stesso per ogni opzione nel comando.
KMS_KEY: una chiave Cloud KMS definita dall'utente. Per saperne di più, consulta Chiavi Cloud KMS gestite dal cliente.

In alternativa, per rimuovere le impostazioni progetto a livello di regione, inserisci la seguente istruzione DDL nell'editor di query:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL,
  `region-REGION.enable_reservation_based_fairness` = false,
  `region-REGION.enable_global_queries_execution` = NULL,
  `region-REGION.enable_global_queries_data_access` = NULL,
  `region-REGION.enable_info_schema_storage` = NULL);

Fai clic su Esegui.

bq

Per configurare le impostazioni progetto regionali, inserisci il comando bq query con il flag --use_legacy_sql impostato su false e fornisci la seguente istruzione DDL come parametro di query:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `region-REGION.default_time_zone` = 'America/Los_Angeles',
  -- Ensure all service accounts under the project have permission to KMS_KEY
  `region-REGION.default_kms_key_name` = KMS_KEY,
  `region-REGION.default_query_job_timeout_ms` = 3600000,
  `region-REGION.default_interactive_query_queue_timeout_ms` = 600000,
  `region-REGION.default_batch_query_queue_timeout_ms` = 1200000,
  `region-REGION.enable_reservation_based_fairness` = true,
  `region-REGION.enable_global_queries_execution` = true,
  `region-REGION.enable_global_queries_data_access` = true,
  `region-REGION.enable_info_schema_storage` = true);

Sostituisci quanto segue:

PROJECT_ID: l'ID progetto
REGION: la regione BigQuery associata al tuo progetto o alla tua organizzazione, ad esempio us o europe-west6. Il valore di REGION deve essere lo stesso per ogni opzione del comando.
KMS_KEY: una chiave Cloud KMS definita dall'utente. Per maggiori informazioni, consulta Chiavi Cloud KMS gestite dal cliente.

In alternativa, per rimuovere le impostazioni regionali del progetto, inserisci il comando bq query con il flag --use_legacy_sql impostato su false e fornisci la seguente istruzione DDL come parametro di query:

  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `region-REGION.default_time_zone` = NULL,
  `region-REGION.default_kms_key_name` = NULL,
  `region-REGION.default_query_job_timeout_ms` = NULL,
  `region-REGION.default_interactive_query_queue_timeout_ms` = NULL,
  `region-REGION.default_batch_query_queue_timeout_ms` = NULL,
  `region-REGION.enable_reservation_based_fairness` = false,
  `region-REGION.enable_global_queries_execution` = NULL,
  `region-REGION.enable_global_queries_data_access` = NULL,
  `region-REGION.enable_info_schema_storage` = NULL);

API

Chiama il metodo jobs.query e fornisci l'istruzione DDL nella proprietà query del corpo della richiesta.

Recupera le impostazioni di configurazione

Puoi visualizzare le impostazioni di configurazione di un'organizzazione o di un progetto utilizzando le seguenti visualizzazioni INFORMATION_SCHEMA:

INFORMATION_SCHEMA.PROJECT_OPTIONS: le configurazioni applicate a un progetto.
INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS: le configurazioni effettive applicate a un progetto. Le configurazioni effettive includono tutte le configurazioni impostate a livello di progetto, nonché tutte le impostazioni ereditate dal progetto da un'organizzazione.
INFORMATION_SCHEMA.ORGANIZATION_OPTIONS: le configurazioni applicate a un'organizzazione.

L'applicazione delle nuove configurazioni e la loro visualizzazione nelle viste di INFORMATION_SCHEMA può richiedere alcuni minuti.

Esempi di query per recuperare le impostazioni

Utilizza i seguenti esempi di query per recuperare le impostazioni del progetto e dell'organizzazione dalle visualizzazioni INFORMATION_SCHEMA.

Visualizza le impostazioni globali

Per visualizzare tutte le impostazioni globali dell'organizzazione, esegui questa query:

SELECT * FROM INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;

Per visualizzare solo l'impostazione dell'organizzazione default_location, esegui la seguente query:

SELECT
    option_value
FROM INFORMATION_SCHEMA.ORGANIZATION_OPTIONS
WHERE option_name = 'default_location'

Per visualizzare tutte le configurazioni globali effettive per il progetto predefinito, esegui la seguente query:

SELECT * FROM INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;

Per visualizzare solo l'impostazione default_location effettiva per il tuo progetto predefinito, esegui questa query:

SELECT
    option_value
FROM INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS
WHERE option_name = 'default_location'

Per visualizzare tutte le configurazioni globali per il progetto predefinito, esegui la seguente query:

SELECT * FROM INFORMATION_SCHEMA.PROJECT_OPTIONS;

Per visualizzare solo l'impostazione default_location per il progetto predefinito, esegui la seguente query:

SELECT
    option_value
FROM INFORMATION_SCHEMA.PROJECT_OPTIONS
WHERE option_name = 'default_location'

Visualizza le impostazioni regionali

Per visualizzare le configurazioni di un'organizzazione nella regione us, esegui la seguente query:

SELECT * FROM region-us.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;

Per visualizzare le configurazioni effettive nel progetto predefinito nella regione us, esegui questa query:

SELECT * FROM region-us.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;

Per visualizzare le configurazioni nel progetto predefinito nella regione us, esegui questa query:

SELECT * FROM region-us.INFORMATION_SCHEMA.PROJECT_OPTIONS;

Impostazioni di configurazione predefinite

Le sezioni seguenti descrivono le impostazioni di configurazione che puoi specificare.

Impostazioni di esecuzione di query e job

Utilizza le seguenti impostazioni per controllare l'esecuzione, la tempistica e la coda delle query.

default_batch_query_queue_timeout_ms: il periodo di tempo predefinito, in millisecondi, in cui una query batch attende in una coda di query. Se non viene impostato, il valore predefinito è 24 ore. Il valore minimo è 1 millisecondo. Il valore massimo è 48 ore. Per disattivare l'inserimento in coda delle query batch, imposta il valore su -1.
default_interactive_query_queue_timeout_ms: il periodo di tempo predefinito in millisecondi in cui una query interattiva attende in una coda di query. Se non viene impostato, il valore predefinito è 6 ore. Il valore minimo è 1 millisecondo, il valore massimo è 48 ore. Per disattivare l'inserimento in coda delle query interattive, imposta il valore su -1.
default_query_job_timeout_ms: il tempo predefinito dopo il quale un job di query va in timeout, incluso il tempo in cui il job è in coda e il tempo impiegato per l'esecuzione. Il periodo di timeout deve essere compreso tra 5 minuti e 48 ore. Questo timeout si applica solo ai singoli job di query e ai job secondari degli script. Per impostare un timeout per i job di script, utilizza il metodo API jobs.insert e imposta il campo jobTimeoutMs.

Nota: l'impostazione default_query_job_timeout_ms si applica anche ai job di query continua. Per eseguire l'override di questa impostazione a livello di progetto per una singola query continua, assegna un timeout del job alla query continua in questione. Le query continue rispettano comunque i tempi di esecuzione massimi.
default_location: l'impostazione di configurazione default_location viene utilizzata per eseguire i job quando la località non è impostata o non può essere determinata. Se default_location non è impostato, il job viene eseguito nella multi-regione US. Per maggiori informazioni, consulta Specifica le località.
enable_reservation_based_fairness: l'opzione che determina il modo in cui vengono condivisi gli slot inattivi. Per i progetti di amministrazione creati dopo il 10 ottobre 2026, questa opzione è abilitata (TRUE) per impostazione predefinita. Per i progetti creati prima del 10 ottobre 2026, il valore predefinito è FALSE, il che significa che gli slot inattivi vengono distribuiti equamente tra tutti i progetti di query. Se attivi questa opzione, gli slot inattivi vengono condivisi equamente prima tra tutte le prenotazioni e poi tra i progetti all'interno di ogni prenotazione. Per saperne di più, consulta la sezione Equità basata sulla prenotazione. Questa opzione è supportata solo a livello di progetto. Non puoi specificarlo a livello di organizzazione o job.
default_time_zone: il fuso orario predefinito da utilizzare nelle funzioni GoogleSQL dipendenti dal fuso orario, quando non ne è specificato uno come argomento. Questa configurazione non si applica a tabelle partizionate per colonne di unità di tempo (che utilizzano UTC come fuso orario), ai trasferimenti pianificati di Storage Transfer Service o al caricamento di dati con lo strumento a riga di comando bq. Per saperne di più, consulta Fusi orari.

Nota: se vuoi impostare un fuso orario predefinito, assicurati che le query esistenti che utilizzano valori letterali DATETIME non siano interessate. Le query interessate includono quelle che utilizzano la parola chiave esplicita DATETIME, i valori letterali stringa convertiti in modo implicito passati a funzioni di ora come DATETIME_DIFF('2022-10-01', ...) e la funzione PARSE_DATETIME(). Per questo motivo, è più sicuro configurare l'impostazione default_time_zone solo sui nuovi progetti.
default_query_optimizer_options: le ottimizzazioni delle query basate sulla cronologia. Questa opzione può essere una delle seguenti:
- 'adaptive=on': utilizza le ottimizzazioni delle query basate sulla cronologia.
- 'adaptive=off': non utilizzare le ottimizzazioni delle query basate sulla cronologia.
- NULL (predefinito): utilizza l'impostazione predefinita per l'ottimizzazione delle query basata sulla cronologia, che equivale a 'adaptive=on'.
default_sql_dialect_option: il dialetto della query SQL predefinito per l'esecuzione dei job di query utilizzando lo strumento a riga di comando bq o l'API BigQuery. La modifica di questa impostazione non influisce sul dialetto predefinito nella console. Questa opzione può essere una delle seguenti:
- 'default_legacy_sql' (impostazione predefinita): utilizza SQL precedente se il dialetto della query non è specificato a livello di job.
- 'default_google_sql': utilizza GoogleSQL se il dialetto della query non è specificato a livello di job.
- 'only_google_sql': utilizza GoogleSQL se il dialetto della query non è specificato a livello di job. Rifiuta i job con dialetto di query impostato su SQL legacy.
- NULL: utilizza l'impostazione predefinita del dialetto di query, che equivale a 'default_legacy_sql'.
enable_global_queries_execution: l'opzione che determina se è possibile eseguire le query globali. Il valore predefinito è FALSE, il che significa che le query globali non sono abilitate.
enable_global_queries_data_access: l'opzione che determina se le query globali possono accedere ai dati archiviati nella regione. Il valore predefinito è FALSE, il che significa che le query globali non possono copiare i dati da questa regione indipendentemente dal progetto in cui vengono eseguite.
reusable_column_aliases_mode: l'opzione che determina se gli alias di colonna riutilizzabili sono abilitati per le query. Il valore predefinito è off, il che significa che gli alias di colonna riutilizzabili non sono abilitati. Per saperne di più, consulta Alias di colonne riutilizzabili.

Impostazioni di gestione dei dati

Utilizza le seguenti impostazioni per definire le regole per la creazione, la sicurezza e il ciclo di vita dei dati.

default_column_name_character_map: l'ambito predefinito e la gestione dei caratteri nei nomi delle colonne. Se non viene impostato, i job di caricamento che utilizzano caratteri non supportati nei nomi delle colonne non vengono eseguiti e viene visualizzato un messaggio di errore. Alcune tabelle meno recenti potrebbero essere impostate per sostituire i caratteri non supportati nei nomi delle colonne. Per saperne di più, consulta load_option_list.
default_data_policy_projects: l'elenco predefinito di progetti le cui norme sui dati vengono valutate quando si accede a colonne protette da tag di governance dei dati. Per impostazione predefinita, vengono valutate solo le policy dei dati del progetto della tabella. Quando configuri un progetto di policy dei dati predefinito a livello di organizzazione, BigQuery valuta sia le policy dei dati del progetto della tabella sia quelle del progetto di policy dei dati predefinito. Se esistono policy in conflitto in entrambi i progetti, le policy dei dati nel progetto della tabella hanno la precedenza. Puoi configurare questa impostazione solo a livello di organizzazione utilizzando l'istruzione ALTER ORGANIZATION SET OPTIONS, ad esempio region-us.default_data_policy_projects = ["my_default_project"]. Per saperne di più, consulta Configura un progetto di norme sui dati predefinito.
default_kms_key_name: la chiave Cloud Key Management Service predefinita per criptare i dati delle tabelle, incluse le tabelle temporanee o anonime. Per saperne di più, consulta Chiavi Cloud KMS gestite dal cliente.

Nota: per impostare una chiave Cloud KMS predefinita, devi concedere il ruolo Autore crittografia/decrittografia a tutti i service account BigQuery utilizzati nel progetto o nell'organizzazione. Se un account di servizio all'interno del progetto o dell'organizzazione non dispone delle autorizzazioni appropriate, tutte le query eseguite dal account di servizio non vanno a buon fine. Per informazioni sull'assegnazione del ruolo Encrypter/Decrypter, consulta Assegna il ruolo Encrypter/Decrypter. Se imposti una chiave Cloud KMS predefinita senza prima assegnare i ruoli appropriati, puoi rimuoverla impostando il valore su NULL. Per visualizzare alcuni esempi, consulta Configura le impostazioni dell'organizzazione regionale e Configura le impostazioni progetto regionali.
default_max_time_travel_hours: la finestra di viaggio nel tempo predefinita in ore per i nuovi set di dati. Questa durata deve essere compresa tra 48 e 168, inclusi, e deve essere divisibile per 24. La modifica delle ore di tempo di viaggio massimo predefinito non influisce sui set di dati esistenti. Per saperne di più, consulta Viaggio nel tempo e conservazione dei dati.
enable_info_schema_storage: l'opzione che fornisce l'accesso alle visualizzazioni INFORMATION_SCHEMA.TABLE_STORAGE e SEARCH_INDEXES e alle relative varianti. Per impostazione predefinita, questa opzione non è abilitata. Se esegui query su queste visualizzazioni per la prima volta senza impostare questa opzione su TRUE, la query non va a buon fine e vengono fornite istruzioni per abilitare l'opzione. Dopo aver attivato questa opzione, le query vengono eseguite immediatamente e restituiscono i dati generati da quel momento in poi. Il backfill completo dei dati storici può richiedere circa un giorno per essere disponibile nelle visualizzazioni. Se hai utilizzato queste visualizzazioni prima dell'introduzione di questa impostazione, questa opzione è già attivata.

Impostazioni di costi e risorse

Utilizza le seguenti impostazioni per determinare come vengono fatturate e connesse le risorse.

default_storage_billing_model: il modello di fatturazione dello spazio di archiviazione predefinito per i nuovi set di dati. Imposta il valore su PHYSICAL per utilizzare i byte fisici durante il calcolo degli addebiti per lo spazio di archiviazione o su LOGICAL per utilizzare i byte logici. La modifica del modello di fatturazione dello spazio di archiviazione predefinito non influisce sui set di dati esistenti. Per saperne di più, consulta Modelli di fatturazione dello spazio di archiviazione.
default_cloud_resource_connection_id: la connessione predefinita da utilizzare quando crei tabelle e modelli. Specifica solo l'ID o il nome della connessione ed escludi i prefissi di ID progetto e regione allegati. Quando utilizzi le connessioni predefinite, BigQuery potrebbe aggiornare le autorizzazioni concesse al account di servizio della connessione, a seconda del tipo di tabella o modello che stai creando. Per saperne di più, vedi la panoramica della connessione predefinita.
reservation_override_mode (anteprima): specifica come le prenotazioni di query possono essere ignorate nella regione (ad esempio, 'ALLOW_ANY_OVERRIDE'). Per i dettagli, consulta l'elenco delle opzioni ALTER PROJECT SET OPTIONS.
disable_on_demand_billing (anteprima): determina se la fatturazione on demand è disattivata per le query nella regione. Se true, tutte le query devono utilizzare una prenotazione assegnata, altrimenti non vanno a buon fine. Per maggiori dettagli, consulta l'elenco delle opzioni ALTER PROJECT SET OPTIONS.
preflight_fluid_autoscaling_reservations: l'elenco delle prenotazioni che hanno attivato la scalabilità fluida per la fatturazione al secondo senza durata minima. Per saperne di più, vedi Informazioni sulle prenotazioni.

Prezzi

Non sono previsti costi aggiuntivi per l'utilizzo del servizio di configurazione di BigQuery. Per saperne di più, consulta la pagina relativa ai prezzi di BigQuery.