Gérer les paramètres de configuration

Les administrateurs BigQuery et les propriétaires de projet peuvent gérer les paramètres de configuration au niveau de l'organisation et du projet. Vous pouvez définir des configurations pour renforcer la sécurité, contrôler les coûts et optimiser les performances des requêtes dans l'ensemble de votre infrastructure de données. En définissant des valeurs par défaut, vous pouvez assurer une conformité et une efficacité opérationnelle cohérentes, ce qui facilite la gestion de votre environnement BigQuery.

Les sections suivantes expliquent comment spécifier les paramètres de configuration par défaut. Les paramètres par défaut sont configurés au niveau de l'organisation ou du projet, mais peuvent être remplacés au niveau de la session ou du job.

Rôles requis

Pour obtenir l'autorisation dont vous avez besoin pour spécifier un paramètre de configuration, demandez à votre administrateur de vous accorder le rôle IAM Administrateur BigQuery (roles/bigquery.admin). Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient l'autorisation bigquery.config.update, qui est nécessaire pour spécifier un paramètre de configuration.

Vous pouvez également obtenir cette autorisation avec des rôles personnalisés ou d'autres rôles prédéfinis.

Pour en savoir plus sur les rôles et les autorisations IAM dans BigQuery, consultez la page Rôles prédéfinis et autorisations.

Spécifier les paramètres généraux

Vous pouvez spécifier des paramètres globaux au niveau de l'organisation ou du projet.

Limites

Les paramètres de configuration globale sont soumis aux limites suivantes :

Les paramètres globaux de l'organisation et du projet ne sont pas disponibles dans les emplacements BigQuery Omni.
Lorsque vous modifiez le paramètre global default_location, la propagation peut prendre jusqu'à 10 minutes. Tant que le paramètre n'est pas propagé, il est possible que les requêtes éligibles soient acheminées vers l'ancien emplacement par défaut.

Configurer les paramètres généraux de l'organisation

Si vous ne spécifiez pas explicitement d'emplacement, il est déterminé de l'une des manières suivantes :

Emplacement des ensembles de données référencés dans la requête. Par exemple, si une requête fait référence à une table ou à une vue d'un ensemble de données stocké dans la région asia-northeast1, la tâche de requête est exécutée dans asia-northeast1.
Région spécifiée pour une connexion référencée dans une requête.
Emplacement d'une table de destination.

Si l'emplacement n'est pas spécifié de manière explicite et qu'il ne peut pas être déterminé à partir des ressources de la requête, l'emplacement par défaut est utilisé. Si l'emplacement par défaut n'est pas défini, le job s'exécute dans la région multirégionale US.

Vous pouvez configurer les paramètres globaux au niveau de l'organisation à l'aide de l'instruction LDD ALTER ORGANIZATION SET OPTIONS. L'emplacement par défaut est le seul paramètre d'organisation global. L'emplacement par défaut est utilisé pour exécuter les jobs lorsque l'emplacement ne peut pas être déduit de la requête.

Lorsque vous configurez l'emplacement par défaut, vous ne spécifiez pas de région dans laquelle le paramètre s'applique. Vous ne pouvez pas combiner des paramètres globaux et régionaux dans la même instruction LDD.

Pour configurer default_location au niveau de l'organisation, procédez comme suit :

Console

Accédez à la page BigQuery de la console Google Cloud .

Accéder à BigQuery
Cliquez sur l'éditeur de requête. Cet onglet est intitulé search_insights Requête sans titre.
Pour configurer default_location, saisissez l'instruction LDD suivante dans l'éditeur de requête :
```
  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );
```
Remplacez LOCATION par un emplacement régional ou multirégional. Cette valeur correspond à l'emplacement utilisé pour exécuter les jobs lorsqu'il ne peut pas être déduit de la requête. Par exemple, l'emplacement par défaut est utilisé si l'emplacement des ensembles de données d'une requête ne peut pas être déterminé.
Vous pouvez également effacer les paramètres globaux au niveau de l'organisation default_location en saisissant l'instruction LDD suivante dans l'éditeur de requête :
```
  ALTER ORGANIZATION
  SET OPTIONS (
  `default_location` = NULL
  );
```
Cliquez sur Exécuter.

bq

Pour configurer default_location au niveau de l'organisation, saisissez la commande bq query et indiquez l'instruction LDD suivante comme paramètre de requête. Définissez le flag use_legacy_sql sur false.
```
ALTER ORGANIZATION
SET OPTIONS (
`default_location` = 'LOCATION'
);
```
Remplacez LOCATION par un emplacement régional ou multirégional. Cette valeur correspond à l'emplacement utilisé pour exécuter les jobs lorsqu'il ne peut pas être déduit de la requête. Par exemple, l'emplacement par défaut est utilisé si l'emplacement des ensembles de données dans une requête ne peut pas être déterminé.
Pour effacer default_location au niveau de l'organisation, saisissez la commande bq query et indiquez l'instruction LDD suivante comme paramètre de requête. Définissez l'indicateur use_legacy_sql sur false.
```
ALTER ORGANIZATION
SET OPTIONS (
`default_location` = NULL
);
```

API

Appelez la méthode jobs.query et indiquez l'instruction LDD dans la propriété query du corps de la requête.

Configurer les paramètres généraux du projet

Si vous ne spécifiez pas explicitement d'emplacement, il est déterminé de l'une des manières suivantes :

Emplacement des ensembles de données référencés dans la requête. Par exemple, si une requête fait référence à une table ou à une vue d'un ensemble de données stocké dans la région asia-northeast1, la tâche de requête est exécutée dans asia-northeast1.
Région spécifiée pour une connexion référencée dans une requête.
Emplacement d'une table de destination.

Vous pouvez configurer les paramètres globaux au niveau du projet à l'aide de l'instruction LDD ALTER PROJECT SET OPTIONS. L'instruction LDD ALTER PROJECT SET OPTIONS accepte éventuellement la variable PROJECT_ID. Si PROJECT_ID n'est pas spécifié, il s'agit par défaut du projet en cours dans lequel vous exécutez l'instruction LDD ALTER PROJECT.

L'emplacement par défaut est le seul paramètre de projet global. Lorsque vous configurez l'emplacement par défaut, vous ne spécifiez pas de région dans laquelle le paramètre s'applique. Vous ne pouvez pas mélanger les paramètres globaux et régionaux dans la même instruction LDD.

Les configurations au niveau du projet remplacent les configurations au niveau de l'organisation. Les configurations au niveau du projet peuvent à leur tour être remplacées par des configurations au niveau de la session, qui peuvent être remplacées par des configurations au niveau du job.

Pour configurer default_location au niveau du projet, procédez comme suit :

Console

Accédez à la page BigQuery de la console Google Cloud .

Accéder à BigQuery
Cliquez sur l'éditeur de requête. Cet onglet est intitulé search_insights Requête sans titre.
Pour configurer default_location, saisissez l'instruction LDD suivante dans l'éditeur de requête :
```
  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = 'LOCATION'
  );
```
Remplacez les éléments suivants :
- PROJECT_ID : ID du projet.
- LOCATION : emplacement régional ou multirégional. Cette valeur correspond à l'emplacement utilisé pour exécuter les tâches lorsqu'il ne peut pas être déduit de la requête. Par exemple, l'emplacement par défaut est utilisé si l'emplacement des ensembles de données dans une requête ne peut pas être déterminé.
Vous pouvez également effacer le paramètre default_location en saisissant l'instruction LDD suivante dans l'éditeur de requête. Si vous décochez la case default_location au niveau du projet, les paramètres par défaut au niveau de l'organisation sont utilisés, s'ils existent. Sinon, le paramètre système par défaut est utilisé.
```
  ALTER PROJECT PROJECT_ID
  SET OPTIONS (
  `default_location` = NULL
  );
```
Cliquez sur Exécuter.

bq

Pour configurer default_location au niveau du projet, saisissez la commande bq query et indiquez l'instruction LDD suivante comme paramètre de requête. Définissez le flag use_legacy_sql sur false.
```
ALTER PROJECT PROJECT_ID
SET OPTIONS (
`default_location` = 'LOCATION'
);
```
Remplacez les éléments suivants :
- PROJECT_ID : ID du projet.
- LOCATION : emplacement régional ou multirégional. Cette valeur correspond à l'emplacement utilisé pour exécuter les jobs lorsqu'il ne peut pas être déduit de la requête. Par exemple, l'emplacement par défaut est utilisé si l'emplacement des ensembles de données d'une requête ne peut pas être déterminé.
Vous pouvez également effacer default_location au niveau du projet en saisissant la commande bq query et en fournissant l'instruction LDD suivante comme paramètre de requête. Définissez l'indicateur use_legacy_sql sur false. Si vous décochez la case default_location au niveau du projet, les paramètres par défaut au niveau de l'organisation sont utilisés, s'ils existent. Sinon, le paramètre système par défaut est utilisé.
```
ALTER PROJECT PROJECT_ID
SET OPTIONS (
`default_location` = NULL
);
```

API

Appelez la méthode jobs.query et indiquez l'instruction LDD dans la propriété query du corps de la requête.

Spécifier les paramètres régionaux

Vous pouvez configurer les paramètres régionaux au niveau de l'organisation ou du projet.

Configurer les paramètres régionaux de l'organisation

Vous pouvez configurer les paramètres régionaux au niveau de l'organisation à l'aide de l'instruction LDD ALTER ORGANIZATION SET OPTIONS. Vous devez spécifier la région dans laquelle chaque paramètre d'organisation s'applique. Vous ne pouvez utiliser qu'une seule région dans une instruction.

Pour configurer les paramètres régionaux de l'organisation, procédez comme suit. L'exemple suivant spécifie plusieurs configurations régionales par défaut, y compris les suivantes :

Fuseau horaire : America/Chicago
Clé Cloud KMS : clé définie par l'utilisateur
Délai avant expiration de la requête : 30 minutes (1 800 000 millisecondes)
Délai avant expiration de la file d'attente des requêtes interactives : 10 minutes (600 000 millisecondes)
Délai avant expiration de la file d'attente des requêtes par lot : 20 minutes (1 200 000 millisecondes)
INFORMATION_SCHEMA : activé

Pour afficher tous les paramètres régionaux de l'organisation, accédez à organization_set_options_list.

Console

Accédez à la page BigQuery de la console Google Cloud .

Accéder à BigQuery
Cliquez sur l'éditeur de requête. Cet onglet est intitulé search_insights Requête sans titre.

Pour configurer les paramètres régionaux de l'organisation, saisissez l'instruction LDD suivante dans l'éditeur de requête :

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

Remplacez les éléments suivants :

REGION : région associée à votre projet ou à votre organisation (par exemple, us ou europe-west6). La valeur de REGION doit être la même pour chaque option de la commande.
KMS_KEY : clé Cloud KMS définie par l'utilisateur. Pour en savoir plus, consultez Clés Cloud KMS gérées par le client.

Vous pouvez également effacer les paramètres régionaux de l'organisation en saisissant l'instruction LDD suivante dans l'éditeur de requête :

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

Cliquez sur Exécuter.

bq

Pour configurer les paramètres régionaux de l'organisation, saisissez la commande bq query et indiquez l'instruction LDD suivante comme paramètre de requête. Définissez l'indicateur use_legacy_sql sur 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);

Remplacez les éléments suivants :

REGION : région associée à votre projet ou à votre organisation (par exemple, us ou europe-west6). La valeur de REGION doit être la même pour chaque option de la commande.
KMS_KEY : clé Cloud KMS définie par l'utilisateur. Pour en savoir plus, consultez Clés Cloud KMS gérées par le client.

Vous pouvez également effacer les paramètres régionaux de l'organisation en saisissant la commande bq query et en fournissant l'instruction LDD suivante comme paramètre de requête. Définissez l'indicateur use_legacy_sql sur 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

Appelez la méthode jobs.query et indiquez l'instruction LDD dans la propriété query du corps de la requête.

Configurer les paramètres régionaux du projet

Vous pouvez configurer les paramètres régionaux au niveau du projet à l'aide de l'instruction LDD ALTER PROJECT SET OPTIONS. Lorsque vous spécifiez la configuration, vous devez indiquer la région dans laquelle elle s'applique. Vous ne pouvez utiliser qu'une seule région par instruction.

L'instruction LDD ALTER PROJECT SET OPTIONS accepte éventuellement la variable PROJECT_ID. Si la variable PROJECT_ID n'est pas spécifiée, elle est définie par défaut sur le projet en cours dans lequel vous exécutez l'instruction LDD ALTER PROJECT.

L'exemple suivant spécifie plusieurs paramètres régionaux au niveau du projet, y compris les suivants :

Fuseau horaire : America/Los_Angeles
Clé Cloud KMS : exemple de clé
Délai avant expiration de la requête : 1 heure (1 800 000 millisecondes)
Délai avant expiration de la file d'attente des requêtes interactives : 10 minutes (600 000 millisecondes)
Délai avant expiration de la file d'attente des requêtes par lot : 20 minutes (1 200 000 millisecondes)
Équité basée sur les réservations : activée
Requêtes globales : activées pour l'exécution et l'accès aux données
INFORMATION_SCHEMA : activé

Pour afficher tous les paramètres régionaux du projet, accédez à project_set_options_list.

Console

Accédez à la page BigQuery de la console Google Cloud .

Accéder à BigQuery
Cliquez sur l'éditeur de requête. Cet onglet est intitulé search_insights Requête sans titre.

Pour configurer les paramètres régionaux du projet, saisissez l'instruction LDD suivante dans l'éditeur de requête :

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

Remplacez les éléments suivants :

PROJECT_ID : ID du projet.
REGION : région associée à votre projet ou à votre organisation (par exemple, us ou europe-west6). La valeur de REGION doit être la même pour chaque option de la commande.
KMS_KEY : clé Cloud KMS définie par l'utilisateur. Pour en savoir plus, consultez la section Clés Cloud KMS gérées par le client.

Vous pouvez également saisir l'instruction LDD suivante dans l'éditeur de requête pour effacer les paramètres régionaux du projet :

  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_info_schema_storage` = NULL);

Cliquez sur Exécuter.

bq

Pour configurer les paramètres régionaux du projet, saisissez la commande bq query et indiquez l'instruction LDD suivante comme paramètre de requête. Définissez l'indicateur use_legacy_sql sur 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);
```
Remplacez les éléments suivants :
- PROJECT_ID : ID du projet.
- REGION : région associée à votre projet ou à votre organisation (par exemple, us ou europe-west6). La valeur de REGION doit être la même pour chaque option de la commande.
- KMS_KEY : clé Cloud KMS définie par l'utilisateur. Pour en savoir plus, consultez Clés Cloud KMS gérées par le client.

Pour effacer les paramètres du projet régional, vous pouvez également saisir la commande bq query et indiquer l'instruction LDD suivante comme paramètre de requête. Définissez l'indicateur use_legacy_sql sur 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

Appelez la méthode jobs.query et indiquez l'instruction LDD dans la propriété query du corps de la requête.

Récupérer les paramètres de configuration

Vous pouvez afficher les paramètres de configuration d'une organisation ou d'un projet à l'aide des vues INFORMATION_SCHEMA suivantes :

INFORMATION_SCHEMA.PROJECT_OPTIONS : configurations appliquées à un projet.
INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS : configurations effectives appliquées à un projet. Les configurations effectives incluent toutes les configurations définies au niveau du projet ainsi que tous les paramètres hérités par le projet d'une organisation.
INFORMATION_SCHEMA.ORGANIZATION_OPTIONS : configurations appliquées à une organisation.

L'application des nouvelles configurations et leur prise en compte dans la vue INFORMATION_SCHEMA peuvent prendre quelques minutes.

Rôles requis

Pour obtenir l'autorisation dont vous avez besoin pour récupérer les paramètres de configuration, demandez à votre administrateur de vous accorder le rôle IAM Utilisateur de job BigQuery (roles/bigquery.jobUser) sur le projet spécifié. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient l'autorisation bigquery.config.get, qui est nécessaire pour récupérer les paramètres de configuration.

Vous pouvez également obtenir cette autorisation avec des rôles personnalisés ou d'autres rôles prédéfinis.

Pour en savoir plus sur les rôles et les autorisations IAM dans BigQuery, consultez la page Rôles prédéfinis et autorisations.

Exemples

Utilisez les exemples de requêtes suivants pour récupérer les paramètres de votre projet et de votre organisation à partir des vues INFORMATION_SCHEMA.

Afficher les paramètres généraux

Pour afficher tous les paramètres globaux de l'organisation, exécutez la requête suivante :

SELECT * FROM INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;

Pour afficher uniquement le paramètre d'organisation de l'emplacement par défaut, exécutez la requête suivante :

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

Pour afficher toutes les configurations globales effectives de votre projet par défaut, exécutez la requête suivante :

SELECT * FROM INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;

Pour afficher uniquement la configuration globale effective de l'emplacement par défaut pour votre projet par défaut, exécutez la requête suivante :

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

Pour afficher toutes les configurations globales de votre projet par défaut, exécutez la requête suivante :

SELECT * FROM INFORMATION_SCHEMA.PROJECT_OPTIONS;

Pour afficher uniquement le paramètre de localisation par défaut de votre projet par défaut, exécutez la requête suivante :

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

Afficher les paramètres régionaux

Pour afficher les configurations d'une organisation dans la région us, exécutez la requête suivante :

SELECT * FROM region-us.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS;

Pour afficher les configurations effectives de votre projet par défaut dans la région us, exécutez la requête suivante :

SELECT * FROM region-us.INFORMATION_SCHEMA.EFFECTIVE_PROJECT_OPTIONS;

Pour afficher les configurations de votre projet par défaut dans la région us, exécutez la requête suivante :

SELECT * FROM region-us.INFORMATION_SCHEMA.PROJECT_OPTIONS;

Paramètres de configuration

Les sections suivantes décrivent les paramètres de configuration que vous pouvez spécifier.

Paramètres d'exécution des requêtes et des jobs

Utilisez les paramètres suivants pour contrôler la façon dont les requêtes sont exécutées, chronométrées et mises en file d'attente.

default_batch_query_queue_timeout_ms : durée par défaut, en millisecondes, pendant laquelle une requête par lot est placée en file d'attente. Si elle n'est pas spécifiée, la valeur par défaut est de 24 heures. La valeur minimale est de 1 milliseconde. La valeur maximale est de 48 heures. Pour désactiver la mise en file d'attente des requêtes par lot, définissez la valeur sur -1.
default_interactive_query_queue_timeout_ms : durée par défaut, en millisecondes, pendant laquelle une requête interactive est placée en file d'attente. Si elle n'est pas spécifiée, la valeur par défaut est de six heures. La valeur minimale est de 1 milliseconde. La valeur maximale est de 48 heures. Pour désactiver la mise en file d'attente des requêtes interactives, définissez la valeur sur -1.
default_query_job_timeout_ms : délai par défaut au bout duquel un job de requête expire, comprenant le délai de mise en file d'attente du job et son temps d'exécution. Le délai avant expiration doit être compris entre 5 minutes et 48 heures. Ce délai ne s'applique qu'aux jobs de requête individuels et aux jobs enfants des scripts. Pour définir un délai avant expiration pour les tâches de script, vous devez utiliser la méthode API jobs.insert et définir le champ jobTimeoutMs.

Remarque : Le paramètre default_query_job_timeout_ms s'applique également aux tâches de requête continue. Pour remplacer ce paramètre au niveau du projet pour une requête continue individuelle, attribuez un délai avant expiration du job à la requête continue en question. Les requêtes continues respectent toujours les durées d'exécution maximales.
default_location : le paramètre de configuration default_location permet d'exécuter des jobs lorsque la position n'est pas définie ou ne peut pas être déterminée. Si default_location n'est pas défini, le job s'exécute dans la région multirégionale US.
enable_reservation_based_fairness : option qui détermine comment les emplacements inactifs sont partagés. La valeur par défaut est "false", ce qui signifie que les emplacements inactifs sont répartis de manière égale entre tous les projets de requête. Si cette option est activée, les emplacements inactifs sont d'abord partagés équitablement entre toutes les réservations, puis entre les projets de la réservation. Pour en savoir plus, consultez Équité basée sur les réservations. Cette option n'est disponible qu'au niveau du projet. Vous ne pouvez pas le spécifier au niveau de l'organisation ni de la tâche.
default_time_zone : Fuseau horaire par défaut à utiliser dans les fonctions GoogleSQL dépendantes du fuseau horaire, lorsqu'un fuseau horaire n'est pas spécifié en tant qu'argument. Cette configuration ne s'applique pas aux tables partitionnées par colonnes d'unités de temps (qui utilisent le fuseau horaire UTC), aux transferts planifiés du service de transfert de stockage ni au chargement des données à l'aide de l'outil de ligne de commande bq. Pour en savoir plus, consultez la section Fuseaux horaires.

Remarque : Si vous souhaitez définir un fuseau horaire par défaut, assurez-vous que les requêtes existantes utilisant des littéraux DATETIME ne sont pas affectées. Cela inclut les requêtes avec le mot clé explicite DATETIME, les littéraux de chaîne implicitement transmis en tant que paramètre à des fonctions temporelles telles que DATETIME_DIFF('2022-10-01', ...), la fonction PARSE_DATETIME(), etc. Pour cette raison, il est plus sûr de ne définir le paramètre default_time_zone que sur les nouveaux projets.
default_query_optimizer_options : optimisations des requêtes basées sur l'historique. Cette option peut prendre l'une des valeurs suivantes :
- 'adaptive=on' : utiliser les optimisations de requêtes basées sur l'historique.
- 'adaptive=off' : n'utilise pas les optimisations de requêtes basées sur l'historique.
- NULL (par défaut) : utilisez le paramètre par défaut des optimisations de requêtes basées sur l'historique, qui équivaut à 'adaptive=on'.
default_sql_dialect_option : dialecte de requête SQL par défaut pour l'exécution des jobs de requête à l'aide de l'outil de ligne de commande bq ou de l'API BigQuery. La modification de ce paramètre n'affecte pas le dialecte par défaut dans la console. Cette option peut être l'une des suivantes :
- 'default_legacy_sql' (par défaut) : utilisez l'ancien SQL si le dialecte de requête n'est pas spécifié au niveau de la tâche.
- 'default_google_sql' : utilisez GoogleSQL si le dialecte de requête n'est pas spécifié au niveau du job.
- 'only_google_sql' : utilisez GoogleSQL si le dialecte de requête n'est pas spécifié au niveau du job. Rejeter les tâches dont le dialecte de requête est défini sur l'ancien SQL.
- NULL : utilisez le paramètre de dialecte de requête par défaut, qui équivaut à 'default_legacy_sql'.
enable_global_queries_execution : option qui détermine si les requêtes globales peuvent être exécutées. La valeur par défaut est FALSE, ce qui signifie que les requêtes globales ne sont pas activées.
enable_global_queries_data_access : option qui détermine si les requêtes globales peuvent accéder aux données stockées dans la région. La valeur par défaut est FALSE, ce qui signifie que les requêtes globales ne peuvent pas copier de données à partir de cette région, quel que soit le projet dans lequel elles sont exécutées.

Paramètres de gestion des données

Utilisez les paramètres suivants pour définir des règles de création, de sécurité et de cycle de vie des données.

default_column_name_character_map : champ d'application et gestion par défaut des caractères dans les noms de colonnes. Si cette valeur n'est pas définie, les jobs de chargement qui utilisent des caractères non compatibles dans les noms de colonnes échouent et renvoient un message d'erreur. Certaines anciennes tables peuvent être configurées pour remplacer les caractères non autorisés dans les noms de colonnes. Pour en savoir plus, consultez la page sur la méthode load_option_list.
default_kms_key_name : clé Cloud Key Management Service par défaut pour le chiffrement des données de table, y compris les tables temporaires ou anonymes. Pour en savoir plus, consultez la section Clés Cloud KMS gérées par le client.

Remarque : Pour définir une clé Cloud KMS par défaut, vous devez attribuer le rôle de chiffreur/déchiffreur à tous les comptes de service BigQuery utilisés dans le projet ou l'organisation. Si un compte de service du projet ou de l'organisation ne dispose pas des autorisations appropriées, toutes les requêtes exécutées par le compte de service échouent. Pour savoir comment attribuer le rôle de chiffreur/déchiffreur, consultez Attribuer le rôle de chiffreur/déchiffreur. Si vous définissez une clé Cloud KMS par défaut sans attribuer au préalable les rôles appropriés, vous pouvez supprimer la clé par défaut en définissant la valeur sur NULL. Pour obtenir des exemples, consultez les sections Configurer les paramètres de l'organisation et Configurer les paramètres du projet.
default_max_time_travel_hours : fenêtre temporelle par défaut en heures pour les nouveaux ensembles de données. Cette durée doit être comprise entre 48 et 168 heures (inclus) et doit être divisible par 24. La modification du nombre maximal d'heures de déplacement par défaut n'a aucune incidence sur les ensembles de données existants. Pour en savoir plus, consultez Fonctionnalité temporelle et conservation des données.
enable_info_schema_storage : option qui permet d'accéder aux vues INFORMATION_SCHEMA.TABLE_STORAGE et SEARCH_INDEXES et à leurs variantes. Par défaut, cette option n'est pas activée. Si vous interrogez ces vues pour la première fois sans définir cette option sur TRUE, la requête échoue et des instructions s'affichent pour vous indiquer comment l'activer. Une fois cette option activée, les requêtes aboutissent immédiatement et renvoient les données générées à partir de ce moment. Le remplissage complet des données historiques peut prendre environ une journée avant d'être disponible dans les vues. Si vous avez utilisé ces vues avant l'introduction de ce paramètre, cette option est déjà activée.

Paramètres de coût et de ressources

Utilisez les paramètres suivants pour déterminer comment les ressources sont facturées et connectées.

default_storage_billing_model : modèle de facturation du stockage par défaut pour les nouveaux ensembles de données. Définissez la valeur sur PHYSICAL pour utiliser des octets physiques lors du calcul des frais de stockage ou sur LOGICAL pour utiliser des octets logiques. Notez que la modification du modèle de facturation du stockage par défaut n'a aucune incidence sur les ensembles de données existants. Pour en savoir plus, consultez Modèles de facturation du stockage.
default_cloud_resource_connection_id : connexion par défaut à utiliser lors de la création de tables et de modèles. Indiquez uniquement l'ID ou le nom de la connexion, et excluez les préfixes de l'ID et de la région du projet associé. L'utilisation de connexions par défaut peut entraîner la mise à jour des autorisations accordées au compte de service de la connexion, en fonction du type de tableau ou de modèle que vous créez. Pour en savoir plus, consultez la présentation de la connexion par défaut.

Tarifs

L'utilisation du service de configuration BigQuery est sans frais. Pour en savoir plus, reportez-vous à la page Tarifs.