Gestire le impostazioni di configurazione

Gli amministratori BigQuery e i proprietari dei progetti possono gestire le impostazioni di configurazione a livello di organizzazione e progetto. Puoi impostare configurazioni per applicare la sicurezza, controllare i costi e ottimizzare le prestazioni delle query nell'intera infrastruttura di dati. Impostando i valori predefiniti, puoi garantire una conformità e un'efficienza operativa coerenti, semplificando la gestione dell'ambiente BigQuery.

Le sezioni seguenti descrivono come specificare le impostazioni di configurazione predefinite. Le impostazioni predefinite vengono configurate a livello di organizzazione o progetto, ma possono essere sostituite a livello di sessione o job.

Ruoli obbligatori

Per ottenere l'autorizzazione necessaria per specificare un'impostazione di configurazione, chiedi all'amministratore di concederti il ruolo IAM Amministratore BigQuery (roles/bigquery.admin). Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione bigquery.config.update necessaria per specificare un'impostazione di configurazione.

Potresti anche ottenere questa autorizzazione 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

Puoi specificare le impostazioni globali a livello di organizzazione o progetto.

Limitazioni

Le impostazioni di configurazione globali sono soggette alle seguenti limitazioni:

  • Le impostazioni globali dell'organizzazione e del progetto non sono disponibili nelle posizioni BigQuery Omni.
  • Quando modifichi l'impostazione globale default_location, la propagazione può richiedere fino a 10 minuti. Fino a quando l'impostazione non viene propagata, è possibile che le query idonee vengano indirizzate alla posizione predefinita precedente.

Configurare le impostazioni globali dell'organizzazione

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

  • La posizione 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 dataset 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 posizione di una tabella di destinazione.

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

Puoi configurare le impostazioni globali a livello di organizzazione utilizzando l'istruzione DDL ALTER ORGANIZATION SET OPTIONS. La località predefinita è l'unica impostazione globale dell'organizzazione. La località predefinita viene utilizzata per eseguire i job quando la località non può essere dedotta dalla richiesta.

Quando configuri la località predefinita, non specifichi una regione in cui si applica l'impostazione. Non puoi combinare impostazioni globali e regionali nella stessa istruzione DDL.

Per configurare default_location a livello di organizzazione:

Console

  1. Vai alla pagina BigQuery nella console Google Cloud .

    Vai a BigQuery

  2. Fai clic sull'editor di query. Questa scheda è etichettata search_insights Query senza titolo.

  3. Per configurare 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. Questo valore è la località utilizzata per eseguire i job quando non può essere dedotto dalla richiesta. Ad esempio, la posizione predefinita viene utilizzata se non è possibile determinare la posizione dei set di dati in una query.

  4. In alternativa, per cancellare le impostazioni globali a livello di organizzazione default_location, inserisci la seguente istruzione DDL nell'editor di query:

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

  5. Fai clic su Esegui.

bq

  1. Per configurare default_location a livello di organizzazione, inserisci il comando bq query e fornisci la seguente istruzione DDL come parametro di query. Imposta il flag use_legacy_sql su false.

      bq query --use_legacy_sql=false \
  'ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = 'LOCATION');'

    Sostituisci LOCATION con una località regionale o multiregionale. Questo valore è la località utilizzata per eseguire i job quando non può essere dedotta dalla richiesta. Ad esempio, la posizione predefinita viene utilizzata se non è possibile determinare la posizione dei set di dati in una query.

  2. Per cancellare default_location a livello di organizzazione, inserisci il comando bq query e fornisci la seguente istruzione DDL come parametro della query. Imposta il flag use_legacy_sql su false.

      bq query --use_legacy_sql=false \
  '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.

La funzionalità DDL estende le informazioni restituite da una risorsa Jobs. statistics.query.statementType include i seguenti valori aggiuntivi:

  • CREATE_TABLE
  • CREATE_TABLE_AS_SELECT
  • DROP_TABLE
  • CREATE_VIEW
  • DROP_VIEW

statistics.query ha due campi aggiuntivi:

  • ddlOperationPerformed: l'operazione DDL eseguita, possibilmente a seconda dell'esistenza della destinazione DDL. I valori attuali includono:
    • CREATE: la query ha creato la destinazione DDL.
    • SKIP: nessuna operazione. Esempi: CREATE TABLE IF NOT EXISTS è stato inviato e la tabella esiste. oppure è stato inviato DROP TABLE IF EXISTS e la tabella non esiste.
    • REPLACE: la query ha sostituito la destinazione DDL. Esempio: CREATE OR REPLACE TABLE è stato inviato e la tabella esiste già.
    • DROP: la query ha eliminato il target DDL.
  • ddlTargetTable: quando invii un'istruzione CREATE TABLE/VIEW o un'istruzione DROP TABLE/VIEW, la tabella di destinazione viene restituita come oggetto con tre campi:
    • "projectId": string
    • "datasetId": string
    • "tableId": string

Configurare le impostazioni globali del progetto

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

  • La posizione 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 dataset 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 posizione di una tabella di destinazione.

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

Puoi configurare le impostazioni globali a livello di progetto utilizzando l'istruzione DDL ALTER PROJECT SET OPTIONS. L'istruzione DDL ALTER PROJECT SET OPTIONS accetta facoltativamente la variabile PROJECT_ID. Se PROJECT_ID non è specificato, il valore predefinito è il progetto corrente in cui esegui l'istruzione DDL ALTER PROJECT.

La località predefinita è l'unica impostazione globale del progetto. Quando configuri la posizione predefinita, non specifichi una regione in cui si applica l'impostazione. Non puoi combinare impostazioni globali e regionali nella stessa istruzione DDL.

Le configurazioni a livello di progetto sostituiscono quelle a livello di organizzazione. Le configurazioni a livello di progetto possono a loro volta essere sostituite dalle configurazioni a livello di sessione, che possono essere sostituite dalle configurazioni a livello di job.

Per configurare default_location a livello di progetto:

Console

  1. Vai alla pagina BigQuery nella console Google Cloud .

    Vai a BigQuery

  2. Fai clic sull'editor di query. Questa scheda è etichettata search_insights Query senza titolo.

  3. Per configurare 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 multi-regione location. Questo valore è la località utilizzata per eseguire i job quando non può essere dedotta dalla richiesta. Ad esempio, la località predefinita viene utilizzata se non è possibile determinare la posizione dei set di dati in una query.

  4. In alternativa, per cancellare l'impostazione default_location, inserisci la seguente istruzione DDL nell'editor di query. Se deselezioni default_location a livello di progetto, vengono utilizzate le impostazioni predefinite a livello di organizzazione, se esistenti. In caso contrario, viene utilizzata l'impostazione predefinita del sistema.

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

  5. Fai clic su Esegui.

bq

  1. Per configurare default_location a livello di progetto, inserisci il comando bq query e fornisci la seguente istruzione DDL come parametro di query. Imposta il flag use_legacy_sql su false.

      bq query --use_legacy_sql=false \
  'ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = 'LOCATION');'

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto
    • LOCATION: una regione o una multi-regione location. Questo valore è la località utilizzata per eseguire i job quando non può essere dedotto dalla richiesta. Ad esempio, la posizione predefinita viene utilizzata se non è possibile determinare la posizione dei set di dati in una query.

  2. In alternativa, per cancellare default_location a livello di progetto, inserisci il comando bq query e fornisci la seguente istruzione DDL come parametro della query. Imposta il flag use_legacy_sql su false. Se deselezioni default_location a livello di progetto, vengono utilizzate le impostazioni predefinite a livello di organizzazione, se esistenti. In caso contrario, viene utilizzata l'impostazione predefinita del sistema.

      bq query --use_legacy_sql=false \
  'ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = NULL);'

API

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

La funzionalità DDL estende le informazioni restituite da una risorsa Jobs. statistics.query.statementType include i seguenti valori aggiuntivi:

  • CREATE_TABLE
  • CREATE_TABLE_AS_SELECT
  • DROP_TABLE
  • CREATE_VIEW
  • DROP_VIEW

statistics.query ha due campi aggiuntivi:

  • ddlOperationPerformed: l'operazione DDL eseguita, possibilmente a seconda dell'esistenza della destinazione DDL. I valori attuali includono:
    • CREATE: la query ha creato la destinazione DDL.
    • SKIP: nessuna operazione. Esempi: CREATE TABLE IF NOT EXISTS è stato inviato e la tabella esiste. oppure è stato inviato DROP TABLE IF EXISTS e la tabella non esiste.
    • REPLACE: la query ha sostituito la destinazione DDL. Esempio: CREATE OR REPLACE TABLE è stato inviato e la tabella esiste già.
    • DROP: la query ha eliminato il target DDL.
  • ddlTargetTable: quando invii un'istruzione CREATE TABLE/VIEW o un'istruzione DROP TABLE/VIEW, la tabella di destinazione viene restituita come oggetto con tre campi:
    • "projectId": string
    • "datasetId": string
    • "tableId": string

Specificare le impostazioni regionali

Puoi configurare le impostazioni regionali a livello di organizzazione o progetto.

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.

Per configurare le impostazioni dell'organizzazione regionali: L'esempio seguente specifica diverse configurazioni regionali predefinite, tra cui le seguenti:

  • 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)

Per visualizzare tutte le impostazioni dell'organizzazione regionale, vai a organization_set_options_list.

Console

  1. Vai alla pagina BigQuery nella console Google Cloud .

    Vai a BigQuery

  2. Fai clic sull'editor di query. Questa scheda è etichettata search_insights Query senza titolo.

  3. 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);

    Sostituisci quanto segue:

    • REGION: la regione 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.

  4. In alternativa, per cancellare le impostazioni dell'organizzazione regionale, 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);

  5. Fai clic su Esegui.

bq

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

  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);

Sostituisci quanto segue:

  • REGION: la regione 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 cancellare le impostazioni dell'organizzazione regionale, inserisci il comando bq query e fornisci la seguente istruzione DDL come parametro di query. Imposta il flag use_legacy_sql su false:

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.default_storage_billing_model`= NULL,
  `region-REGION.default_max_time_travel_hours` = NULL,
  `region-REGION.default_cloud_resource_connection_id` = NULL,
  `region-REGION.default_sql_dialect_option` = NULL,
  `region-REGION.enable_reservation_based_fairness` = NULL,
  `region-REGION.enable_global_queries_execution` = NULL,
  `region-REGION.enable_global_queries_data_access` = NULL);

API

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

La funzionalità DDL estende le informazioni restituite da una risorsa Jobs. statistics.query.statementType include i seguenti valori aggiuntivi:

  • CREATE_TABLE
  • CREATE_TABLE_AS_SELECT
  • DROP_TABLE
  • CREATE_VIEW
  • DROP_VIEW

statistics.query ha due campi aggiuntivi:

  • ddlOperationPerformed: l'operazione DDL eseguita, possibilmente a seconda dell'esistenza della destinazione DDL. I valori attuali includono:
    • CREATE: la query ha creato la destinazione DDL.
    • SKIP: nessuna operazione. Esempi: CREATE TABLE IF NOT EXISTS è stato inviato e la tabella esiste. oppure è stato inviato DROP TABLE IF EXISTS e la tabella non esiste.
    • REPLACE: la query ha sostituito la destinazione DDL. Esempio: CREATE OR REPLACE TABLE è stato inviato e la tabella esiste già.
    • DROP: la query ha eliminato il target DDL.
  • ddlTargetTable: quando invii un'istruzione CREATE TABLE/VIEW o un'istruzione DROP TABLE/VIEW, la tabella di destinazione viene restituita come oggetto con tre campi:
    • "projectId": string
    • "datasetId": string
    • "tableId": string

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. Quando specifichi la configurazione, devi specificare la regione in cui si applica. Puoi utilizzare una sola regione in ogni istruzione.

Le configurazioni a livello di progetto sostituiscono quelle a livello di organizzazione. Le configurazioni a livello di progetto possono a loro volta essere sostituite dalle configurazioni a livello di sessione, che possono essere sostituite dalle configurazioni a livello di job.

L'istruzione DDL ALTER PROJECT SET OPTIONS accetta facoltativamente la variabile PROJECT_ID. Se la variabile PROJECT_ID non è specificata, viene utilizzato per impostazione predefinita il progetto corrente in cui esegui l'istruzione DDL ALTER PROJECT.

L'esempio seguente specifica diverse impostazioni a livello di progetto e regione, tra cui:

  • Fuso orario: America/Los_Angeles
  • Chiave Cloud KMS: una chiave di esempio
  • Timeout della query: 1 ora (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)
  • Equità basata sulla prenotazione: attivata
  • Query globali: abilitate per l'esecuzione e l'accesso ai dati

Per visualizzare tutte le impostazioni regionali del progetto, vai a project_set_options_list.

Console

  1. Vai alla pagina BigQuery nella console Google Cloud .

    Vai a BigQuery

  2. Fai clic sull'editor di query. Questa scheda è etichettata search_insights Query senza titolo.

  3. Per configurare le impostazioni del 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` = '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);

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto
    • REGION: la regione 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.

  4. In alternativa, per cancellare le impostazioni del 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);

  5. Fai clic su Esegui.

bq

  1. Per configurare le impostazioni del progetto regionali, inserisci il comando bq query e fornisci la seguente istruzione DDL come parametro di query. Imposta il flag use_legacy_sql su false.

      ALTER PROJECT PROJECT_ID
  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_reservation_based_fairness` = true);

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto
    • REGION: la regione 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.

  2. In alternativa, per cancellare le impostazioni del progetto a livello di regione, inserisci il comando bq query e fornisci la seguente istruzione DDL come parametro di query. Imposta il flag use_legacy_sql su false:

      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_reservation_based_fairness` = false,
`region-REGION.enable_global_queries_execution` = NULL,
`region-REGION.enable_global_queries_data_access` = NULL);

API

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

La funzionalità DDL estende le informazioni restituite da una risorsa Jobs. statistics.query.statementType include i seguenti valori aggiuntivi:

  • CREATE_TABLE
  • CREATE_TABLE_AS_SELECT
  • DROP_TABLE
  • CREATE_VIEW
  • DROP_VIEW

statistics.query ha due campi aggiuntivi:

  • ddlOperationPerformed: l'operazione DDL eseguita, possibilmente a seconda dell'esistenza della destinazione DDL. I valori attuali includono:
    • CREATE: la query ha creato la destinazione DDL.
    • SKIP: nessuna operazione. Esempi: CREATE TABLE IF NOT EXISTS è stato inviato e la tabella esiste. oppure è stato inviato DROP TABLE IF EXISTS e la tabella non esiste.
    • REPLACE: la query ha sostituito la destinazione DDL. Esempio: CREATE OR REPLACE TABLE è stato inviato e la tabella esiste già.
    • DROP: la query ha eliminato il target DDL.
  • ddlTargetTable: quando invii un'istruzione CREATE TABLE/VIEW o un'istruzione DROP TABLE/VIEW, la tabella di destinazione viene restituita come oggetto con tre campi:
    • "projectId": string
    • "datasetId": string
    • "tableId": string

Recupera le impostazioni di configurazione

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

Potrebbero essere necessari alcuni minuti prima che le nuove configurazioni diventino effettive e vengano visualizzate nella vista INFORMATION_SCHEMA.

Ruoli obbligatori

Per ottenere l'autorizzazione necessaria per recuperare le impostazioni di configurazione, chiedi all'amministratore di concederti il ruolo IAM Utente job BigQuery (roles/bigquery.jobUser) sul progetto specificato. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione bigquery.config.get necessaria per recuperare le impostazioni di configurazione.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

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

Esempi

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

Visualizzare 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 della località predefinita, 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 la configurazione globale effettiva della località predefinita per il progetto predefinito, esegui la seguente 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 della località predefinita per il progetto predefinito, esegui la query seguente:

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

Visualizzare le impostazioni regionali

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

SELECT * FROM region-us.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;

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

SELECT * FROM region-us.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;

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

SELECT * FROM region-us.INFORMATION_SCHEMA.PROJECT_OPTIONS;

Impostazioni di configurazione

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

Impostazioni di esecuzione di query e job

Utilizza le seguenti impostazioni per controllare come vengono eseguite, temporizzate e messe in coda le query.

  • default_batch_query_queue_timeout_ms: Il periodo di tempo predefinito, in millisecondi, in cui una query batch viene messa in coda. 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 viene messa in coda. Se non viene impostato, il valore predefinito è sei 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 scade, incluso il tempo in cui il job è in coda e il tempo di 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, devi utilizzare il metodo API jobs.insert e impostare il campo jobTimeoutMs.

  • default_location: l'impostazione di configurazione default_location viene utilizzata per eseguire i job quando la posizione non è impostata o non può essere determinata. Se default_location non è impostato, il job viene eseguito nella multi-regione US.

  • enable_reservation_based_fairness: l'opzione che determina la modalità di condivisione degli slot inattivi. Il valore predefinito è false, il che significa che gli slot inattivi sono distribuiti equamente tra tutti i progetti di query. Se abilitati, gli slot inattivi vengono condivisi equamente tra tutte le prenotazioni e poi tra i progetti all'interno della 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 lavoro.

  • 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.

  • 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 (impostazione predefinita): utilizza l'impostazione predefinita per l'ottimizzazione delle query basata sulla cronologia, che equivale a 'adaptive=on'.

  • default_sql_dialect_option: il dialetto di 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 il dialetto della query impostato su SQL precedente.
    • NULL: utilizza l'impostazione predefinita del dialetto della query, che equivale a 'default_legacy_sql'.

  • enable_global_queries_execution: l'opzione che determina se è possibile eseguire 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.

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_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.

  • default_max_time_travel_hours: la finestra di spostamento cronologico 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 viaggio massime predefinite non influisce sui set di dati esistenti. Per ulteriori informazioni, vedi Time Travel e conservazione dei dati.

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. Tieni presente che 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 per la creazione di tabelle e modelli. Specifica solo l'ID o il nome della connessione ed escludi i prefissi di ID progetto e regione allegati. L'utilizzo delle connessioni predefinite può causare l'aggiornamento delle autorizzazioni concesse alaccount di serviziot della connessione, a seconda del tipo di tabella o modello che stai creando. Per saperne di più, vedi la panoramica della connessione predefinita.

Prezzi

Non sono previsti costi aggiuntivi per l'utilizzo del servizio di configurazione BigQuery. Per ulteriori informazioni, vedi Prezzi.