Skip to main content
Ces paramètres sont disponibles dans system.settings et sont générés automatiquement à partir du source.

distributed_plan_default_reader_bucket_count

Nombre de tâches par défaut pour la lecture parallèle dans une requête distribuée. Les tâches sont réparties entre les différentes répliques. Utilisé par le planificateur distribué basé sur des règles. L’optimiseur basé sur les coûts choisit le fan-out de lecture selon le coût estimé et n’utilise pas ce paramètre.

distributed_plan_default_shuffle_join_bucket_count

Nombre de buckets par défaut pour la jointure shuffle-hash distribuée. Utilisé par le planificateur distribué basé sur des règles. L’optimiseur basé sur les coûts choisit le fan-out selon le coût estimé et n’utilise pas ce paramètre.

distributed_plan_execute_locally

Exécute toutes les tâches d’un plan de requête distribuée localement. Utile pour les tests et le débogage.

distributed_plan_fallback_to_local_execution

Lorsqu’un plan de requête contient une étape qui ne prend pas en charge l’exécution distribuée, la raison est consignée et la requête est exécutée sur l’initiateur au lieu de lever une exception. Désactivez ce paramètre pour obtenir une exception à la place. Ne prend effet que lorsque make_distributed_plan (private preview) est activé.

distributed_plan_force_exchange_kind

Force le type spécifié d’opérateurs Exchange entre les étapes d’une requête distribuée. Valeurs possibles :
  • ” - ne forcer aucun type d’opérateurs Exchange et laisser l’optimiseur choisir,
  • ‘Persisted’ - utiliser des fichiers temporaires sur le stockage objet,
  • ‘Streaming’ - transmettre les données d’échange sur le réseau.

distributed_plan_force_shuffle_aggregation

Utiliser la stratégie d’agrégation Shuffle au lieu de PartialAggregation + Merge dans le plan de requête distribuée. Ignoré lorsque la stratégie Shuffle ne peut pas produire un résultat correct, par exemple pour GROUPING SETS ou lorsque l’agrégation doit produire les résultats dans l’ordre des buckets.

distributed_plan_max_rows_to_broadcast

Nombre maximal de lignes à partir duquel utiliser une jointure broadcast plutôt qu’une jointure shuffle dans un plan de requête distribuée. Une heuristique destinée au planificateur distribué basé sur des règles. Lorsque l’optimiseur basé sur les coûts est activé, le choix entre broadcast et shuffle est effectué en fonction du coût estimé, et ce paramètre n’a aucun effet.

distributed_plan_optimize_exchanges

Supprime les échanges superflus du plan de requête distribuée. Désactivez-le pour le débogage.

distributed_plan_prefer_replicas_over_workers

Sérialise le plan de la requête distribuée pour l’exécuter sur les répliques.

distributed_plan_read_in_order

Autorise l’optimisation de lecture dans l’ordre pour ORDER BY dans un plan de requête distribué, afin qu’une lecture triée de la clé de tri de la table puisse éviter le tri et s’arrêter plus tôt, au lieu de parcourir puis trier les données. Désactivé par défaut : le rewrite qui distribue un tri suppose que le tri qu’il encapsule ne dépend pas du fait que son entrée soit déjà ordonnée ; or un tri qui en dépend peut se voir alimenté en rows via un exchange qui ne préserve pas l’ordre. À ce jour, seules les formes où aucun exchange ne subsiste entre la lecture et le tri sont sûres.

distributed_plan_workers_num

Nombre de workers sans état qui seront utilisés pour exécuter cette requête. Zéro désactive la location de workers sans état pour les plans distribués.

distributed_plan_workers_provisioning_timeout_ms

Durée totale écoulée, en millisecondes, qu’une requête peut consacrer au provisionnement de workers sans état avant son exécution : leur location auprès du service de découverte et la vérification qu’ils sont joignables. La requête attend, dans la limite de ce délai, que les workers loués soient prêts ; une fois ce délai écoulé, elle se poursuit avec les workers vérifiés jusque-là ou échoue si aucun n’est devenu disponible. La valeur zéro attend uniquement la passe initiale de location et de vérification (sans nouvelle tentative).
Dernière modification le 26 septembre 2026