Gérer les paramètres de configuration par défaut

Les paramètres de configuration par défaut de BigQuery peuvent aider votre organisation à renforcer la sécurité, à contrôler les coûts et à optimiser les performances des requêtes. En tant qu'administrateur BigQuery ou propriétaire de projet, vous pouvez spécifier, supprimer et récupérer ces valeurs par défaut au niveau de l'organisation et du projet, ou les remplacer pour des sessions et des jobs individuels.

Rôles requis

Pour obtenir les autorisations nécessaires pour spécifier ou récupérer les paramètres de configuration, demandez à votre administrateur de vous accorder les rôles IAM suivants :

  • Spécifier les paramètres de configuration : Administrateur BigQuery (roles/bigquery.admin) sur votre organisation ou votre projet
  • Récupérer les paramètres de configuration : 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.

Ces rôles prédéfinis contiennent les autorisations requises pour spécifier ou récupérer des paramètres de configuration. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour spécifier ou récupérer des paramètres de configuration :

  • Spécifier les paramètres de configuration : bigquery.config.update sur votre organisation ou votre projet
  • Récupérer les paramètres de configuration : bigquery.config.get sur le projet spécifié

Vous pouvez également obtenir ces autorisations 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

Les paramètres globaux s'appliquent à tous les emplacements et n'utilisent pas de préfixe region-REGION.. En revanche, les paramètres régionaux ne s'appliquent qu'à un lieu spécifique. Vous pouvez spécifier des paramètres globaux au niveau de l'organisation ou du projet. L'emplacement par défaut (default_location) est le seul paramètre global que vous pouvez configurer.

Si vous ne spécifiez pas explicitement d'emplacement, l'emplacement 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, le job de requête est exécuté 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 explicitement spécifié 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 l'emplacement multirégional US.

Limites

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

  • Les paramètres d'organisation et les paramètres du projet globaux ne sont pas compatibles avec les emplacements BigQuery Omni. Vous ne pouvez pas définir default_location sur un emplacement BigQuery Omni, ni configurer ou afficher les paramètres globaux dans un emplacement BigQuery Omni.
  • Vous ne pouvez pas combiner des paramètres globaux et régionaux dans la même instruction LDD ALTER ORGANIZATION SET OPTIONS ou ALTER PROJECT SET OPTIONS.
  • Lorsque vous modifiez le paramètre global default_location, la propagation de la modification peut prendre jusqu'à 10 minutes. Tant que le paramètre n'est pas propagé, BigQuery peut acheminer les jobs qui s'appuient sur l'emplacement par défaut vers l'emplacement par défaut précédent.

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

Vous pouvez configurer les paramètres généraux au niveau de l'organisation à l'aide de l'instruction LDD ALTER ORGANIZATION SET OPTIONS. L'emplacement par défaut (default_location) est le seul paramètre global que vous pouvez configurer au niveau de l'organisation. Tous les autres paramètres au niveau de l'organisation sont des paramètres régionaux.

L'instruction LDD ALTER ORGANIZATION SET OPTIONS s'applique à l'organisation à laquelle appartient le projet actuel.

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

Console

  1. Dans la console Google Cloud , accédez à la page BigQuery.

    Accéder à BigQuery

  2. Pour ouvrir l'éditeur de requête, cliquez sur search_insights Requête sans titre.

  3. Pour configurer le paramètre default_location, saisissez l'instruction LDD suivante dans l'éditeur de requête :

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

    Remplacez LOCATION par une région ou une zone multirégionale BigQuery. Cette valeur correspond à l'emplacement utilisé par BigQuery pour exécuter les jobs lorsque l'emplacement du job ne peut pas être déduit de la requête (par exemple, lorsqu'une requête ne fait référence à aucun ensemble de données ni aucune connexion).

  4. Vous pouvez également supprimer le paramètre default_location au niveau de l'organisation en saisissant l'instruction LDD suivante dans l'éditeur de requête :

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

  5. Cliquez sur Exécuter.

bq

Pour configurer le paramètre default_location au niveau de l'organisation, saisissez la commande bq query avec le flag --use_legacy_sql défini sur false, puis indiquez l'instruction LDD suivante comme paramètre de requête :

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

Remplacez LOCATION par une région ou une zone multirégionale BigQuery. Cette valeur correspond à l'emplacement utilisé par BigQuery pour exécuter les jobs lorsque l'emplacement du job ne peut pas être déduit de la requête (par exemple, lorsqu'une requête ne fait référence à aucun ensemble de données ni aucune connexion).

Vous pouvez également supprimer le paramètre default_location au niveau de l'organisation en saisissant la commande bq query avec le flag --use_legacy_sql défini sur false, et en fournissant l'instruction LDD suivante comme paramètre de requête :

  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

Vous pouvez configurer les paramètres globaux au niveau du projet à l'aide de l'instruction LDD ALTER PROJECT SET OPTIONS. L'emplacement par défaut (default_location) est le seul paramètre global que vous pouvez configurer au niveau du projet. Tous les autres paramètres au niveau du projet sont des paramètres régionaux.

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

Les configurations au niveau du projet remplacent les configurations au niveau de l'organisation. À leur tour, les configurations au niveau de la session peuvent remplacer les configurations au niveau du projet, et les configurations au niveau du job peuvent remplacer les configurations au niveau de la session.

Pour configurer le paramètre default_location au niveau du projet, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page BigQuery.

    Accéder à BigQuery

  2. Pour ouvrir l'éditeur de requête, cliquez sur search_insights Requête sans titre.

  3. Pour configurer le paramètre 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 BigQuery. Cette valeur correspond à l'emplacement utilisé par BigQuery pour exécuter les jobs lorsque l'emplacement du job ne peut pas être déduit de la requête (par exemple, lorsqu'une requête ne fait référence à aucun ensemble de données ni aucune connexion).

  4. Vous pouvez également saisir l'instruction LDD suivante dans l'éditeur de requête pour supprimer le paramètre default_location au niveau du projet :

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

    Si vous supprimez le paramètre default_location au niveau du projet, BigQuery utilise le paramètre par défaut au niveau de l'organisation, s'il existe, ou le paramètre système par défaut.

  5. Cliquez sur Exécuter.

bq

Pour configurer le paramètre default_location au niveau du projet, saisissez la commande bq query avec l'option --use_legacy_sql définie sur false, puis fournissez l'instruction LDD suivante comme paramètre de requête :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet.
  • LOCATION : région ou emplacement multirégion BigQuery. Cette valeur correspond à l'emplacement utilisé par BigQuery pour exécuter les jobs lorsque l'emplacement du job ne peut pas être déduit de la requête (par exemple, lorsqu'une requête ne fait référence à aucun ensemble de données ni aucune connexion).

Vous pouvez également supprimer le paramètre default_location au niveau du projet en saisissant la commande bq query avec l'option --use_legacy_sql définie sur false, et en fournissant l'instruction LDD suivante comme paramètre de requête :

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

Si vous supprimez le paramètre default_location au niveau du projet, BigQuery utilise le paramètre par défaut au niveau de l'organisation, s'il existe, ou le paramètre système par défaut.

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 des paramètres régionaux

Les paramètres régionaux s'appliquent à un lieu spécifique et nécessitent un préfixe region-REGION.. Vous pouvez configurer les paramètres régionaux au niveau de l'organisation ou du projet.

Paramètres de réservation et de facturation

Vous pouvez configurer des paramètres régionaux au niveau du projet pour contrôler la façon dont les requêtes utilisent les réservations ou la facturation à la demande. Ces paramètres permettent de garantir la prévisibilité des coûts en autorisant une utilisation flexible des réservations ou en exigeant que les requêtes utilisent des emplacements de réservation.

Les contrôles de réservation et de facturation courants incluent reservation_override_mode (bêta) et disable_on_demand_billing (bêta). Pour configurer ces paramètres, consultez Configurer les paramètres régionaux du projet. Pour obtenir la liste complète des options de projet, consultez la liste des options ALTER PROJECT SET OPTIONS.

Configurer les paramètres d'organisation régionaux

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.

Les exemples de cette section spécifient les paramètres régionaux par défaut suivants pour l'organisation :

  • 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)
  • Vues de stockage de tables et d'index de recherche INFORMATION_SCHEMA (enable_info_schema_storage) : activées

Pour en savoir plus sur tous les paramètres d'organisation régionaux, consultez organization_set_options_list.

Pour configurer les paramètres régionaux de l'organisation, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page BigQuery.

    Accéder à BigQuery

  2. Pour ouvrir l'éditeur de requête, cliquez sur search_insights Requête sans titre.

  3. Pour configurer les paramètres de l'organisation régionale, 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 BigQuery associée à votre projet ou 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.

  4. Vous pouvez également supprimer les paramètres d'organisation régionaux 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);

  5. Cliquez sur Exécuter.

bq

Pour configurer les paramètres régionaux de l'organisation, saisissez la commande bq query avec le flag --use_legacy_sql défini sur false, et indiquez l'instruction LDD suivante comme paramètre 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 BigQuery associée à votre projet ou 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.

Pour supprimer les paramètres d'organisation régionaux, vous pouvez également saisir la commande bq query avec l'option --use_legacy_sql définie sur false, et fournir l'instruction LDD suivante comme paramètre 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);

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. Vous devez spécifier la région dans laquelle chaque paramètre de projet s'applique. Vous ne pouvez utiliser qu'une seule région dans une instruction.

Les configurations au niveau du projet remplacent les configurations au niveau de l'organisation. À leur tour, les configurations au niveau de la session peuvent remplacer les configurations au niveau du projet, et les configurations au niveau du job peuvent remplacer les configurations au niveau de la session.

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

Les exemples de cette section spécifient les paramètres de projet régionaux par défaut suivants :

  • Fuseau horaire : America/Los_Angeles
  • Clé Cloud KMS : clé définie par l'utilisateur
  • Délai avant expiration de la requête : 1 heure (3 600 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
  • Vues de stockage de table et d'index de recherche INFORMATION_SCHEMA (enable_info_schema_storage) : activées

Pour en savoir plus sur tous les paramètres de projet régionaux, consultez project_set_options_list.

Pour configurer les paramètres régionaux du projet, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page BigQuery.

    Accéder à BigQuery

  2. Pour ouvrir l'éditeur de requête, cliquez sur search_insights Requête sans titre.

  3. 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 BigQuery associée à votre projet ou 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.

  4. Vous pouvez également supprimer les paramètres régionaux du projet en saisissant l'instruction LDD suivante dans l'éditeur de requête :

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

  5. Cliquez sur Exécuter.

bq

Pour configurer les paramètres régionaux du projet, saisissez la commande bq query avec l'option --use_legacy_sql définie sur false, puis indiquez l'instruction LDD suivante comme paramètre 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 BigQuery associée à votre projet ou 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.

Pour supprimer les paramètres de projet régionaux, vous pouvez également saisir la commande bq query avec l'option --use_legacy_sql définie sur false, et fournir l'instruction LDD suivante comme paramètre de requête :

  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

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 :

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

Exemples de requêtes pour récupérer des paramètres

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 n'afficher que le paramètre d'organisation default_location, 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 le paramètre default_location effectif de 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 default_location 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 par défaut

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 attend dans une file d'attente de requêtes. 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 attend dans une file d'attente de requêtes. Si elle n'est pas spécifiée, la valeur par défaut est de six heures. La valeur minimale est de 1 milliseconde et la valeur maximale 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 avant expiration 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 jobs de script, utilisez la méthode d'API jobs.insert et définissez le champ jobTimeoutMs.

  • default_location : le paramètre de configuration default_location est utilisé pour 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. Pour en savoir plus, consultez Spécifier des emplacements.

  • enable_reservation_based_fairness : option qui détermine comment les emplacements inactifs sont partagés. Pour les projets d'administration créés après le 10 octobre 2026, cette option est activée (TRUE) par défaut. Pour les projets créés avant le 10 octobre 2026, 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 vous activez cette option, les emplacements inactifs sont d'abord partagés de manière égale entre toutes les réservations, puis entre les projets de chaque 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 la spécifier au niveau de l'organisation ou du job.

  • 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 ou au chargement des données à l'aide de l'outil de ligne de commande bq. Pour en savoir plus, consultez la section Fuseaux horaires.

  • default_query_optimizer_options : optimisations des requêtes basées sur l'historique. Cette option peut être l'une des suivantes :

    • 'adaptive=on' : utilisez 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 d'optimisation des requêtes par défaut basé 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'a aucune incidence sur le dialecte par défaut dans la console. Cette option peut prendre l'une des valeurs suivantes :

    • 'default_legacy_sql' (par défaut) : utilisez l'ancien SQL si le dialecte de requête n'est pas spécifié au niveau du job.
    • '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. Refuser les jobs 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 s'exécuter. 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.

  • reusable_column_aliases_mode : option qui détermine si les alias de colonne réutilisables sont activés pour les requêtes. La valeur par défaut est off, ce qui signifie que les alias de colonne réutilisables ne sont pas activés. Pour en savoir plus, consultez Alias de colonnes réutilisables.

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_data_policy_projects : liste par défaut des projets dont les Règles relatives aux données sont évaluées lors de l'accès aux colonnes protégées par des tags de gouvernance des données. Par défaut, seules les règles de données du projet de la table sont évaluées. Lorsque vous configurez un projet de règles de données par défaut au niveau de l'organisation, BigQuery évalue à la fois les règles de données du projet de la table et celles du projet de règles de données par défaut. Si des stratégies conflictuelles existent dans les deux projets, les stratégies de données du projet de la table prévalent. Vous ne pouvez configurer ce paramètre qu'au niveau de l'organisation à l'aide de l'instruction ALTER ORGANIZATION SET OPTIONS (par exemple, region-us.default_data_policy_projects = ["my_default_project"]). Pour en savoir plus, consultez Configurer un projet de stratégie de données par défaut.

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

  • 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 voyage temporel par défaut n'affecte pas 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 fournit des instructions pour activer l'option. 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. Un remplissage complet des données historiques peut prendre environ un jour 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. La modification du modèle de facturation du stockage par défaut n'affecte pas 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 lorsque vous créez des tables et des modèles. Spécifiez uniquement l'ID ou le nom de la connexion, et excluez les préfixes d'ID de projet et de région associés. Lorsque vous utilisez des connexions par défaut, BigQuery peut mettre à jour les autorisations accordées au compte de service de la connexion, en fonction du type de table ou de modèle que vous créez. Pour en savoir plus, consultez la présentation de la connexion par défaut.
  • reservation_override_mode (preview) : spécifie comment les réservations de requêtes peuvent être remplacées dans la région (par exemple, 'ALLOW_ANY_OVERRIDE'). Pour en savoir plus, consultez la liste des options ALTER PROJECT SET OPTIONS.
  • disable_on_demand_billing (aperçu) : détermine si la facturation à la demande est désactivée pour les requêtes dans la région. Si la valeur est true, toutes les requêtes doivent utiliser une réservation attribuée, sinon elles échouent. Pour en savoir plus, consultez la liste des options ALTER PROJECT SET OPTIONS.
  • preflight_fluid_autoscaling_reservations : liste des réservations pour lesquelles le scaling fluide est activé pour la facturation à la seconde sans durée minimale. Pour en savoir plus, consultez Comprendre les réservations.

Tarifs

L'utilisation du service de configuration BigQuery n'entraîne aucuns frais supplémentaires. Pour en savoir plus, consultez la page relative aux tarifs de BigQuery.