Partager via

Propriétés de requête

  • Article

S’applique à : ✅Microsoft Fabric✅Azure Data Explorer

Les propriétés de requête contrôlent l’exécution d’une requête ou d’une commande et retournent des résultats.

Propriétés de requête prises en charge

Le tableau suivant présente les propriétés de requête prises en charge.

Remarque

Les propriétés query_weakconsistency_session_id de la requête et queryconsistency ne sont pas disponibles dans Fabic.

Nom de la propriété Type Description
best_effort bool Si la valeur est définie true, autorise la résolution approximative et les problèmes de connectivité des sources de données (jambes union).) L’ensemble de sources union est réduit à l’ensemble de références de table qui existent et sont accessibles au moment de l’exécution. Si au moins une table accessible est trouvée, la requête s’exécute. Tout échec génère un avertissement dans les résultats de l’état de la requête, mais n’empêche pas l’exécution de la requête.
client_max_redirect_count long Contrôle le nombre maximal de redirections HTTP que le client suit pendant le traitement.
client_results_reader_allow_varying_row_widths bool Si la valeur est définie true, le lecteur de résultats tolère les tables dont la largeur de ligne varie selon les lignes.
deferpartialqueryfailures bool Si la valeur est définie true, supprime la création de rapports d’échecs de requête partiels dans le jeu de résultats.
materialized_view_shuffle_query dynamic Fournit un indicateur pour utiliser la stratégie de shuffle pour les vues matérialisées référencées dans la requête. Cette propriété affecte exclusivement les vues matérialisées et non les opérations suivantes, telles que les jointures, dans la requête. Il prend un tableau de noms de vues matérialisés et leurs clés aléatoires correspondantes.

Par exemple, indique la dynamic([{ "Name": "V1", "Keys" : [ "K1", "K2" ] }]) vue V1 aléatoire par les clés K1 et K2, tandis que dynamic([ { "Name": "V1" } ]) l’affichage V1 aléatoire par toutes les clés.
max_memory_consumption_per_query_per_node long Remplace la quantité maximale de mémoire par défaut qu’une requête peut allouer par nœud.
maxmemoryconsumptionperiterator long Remplace la quantité maximale de mémoire par défaut qu’un opérateur de requête peut allouer.
maxoutputcolumns long Remplace le nombre maximal par défaut de colonnes qu’une requête est autorisée à produire.
norequesttimeout bool Définit le délai d’expiration de la requête sur sa valeur maximale. Cette option ne peut pas être modifiée dans le cadre d’une instruction set.
notruncation bool Désactive la troncation des résultats de requête retournés à l’appelant.
push_selection_through_aggregation bool Si la valeur est définie true, autorise l’envoi (push) d’une sélection simple via l’agrégation.
query_bin_auto_at literal Spécifie la valeur de début à utiliser lors de l’évaluation de la fonction bin_auto().
query_bin_auto_size literal Spécifie la valeur de taille de bac à utiliser lors de l’évaluation de la fonction bin_auto().
query_cursor_after_default string Définit la valeur de paramètre par défaut pour la fonction cursor_after() lorsqu’elle est appelée sans paramètres.
query_cursor_before_or_at_default string Définit la valeur de paramètre par défaut pour la fonction cursor_before_or_at() lorsqu’elle est appelée sans paramètres.
query_cursor_current string Remplace la valeur du curseur retournée par la fonction cursor_current().
query_cursor_disabled bool Désactive l’utilisation des fonctions de curseur dans le contexte de requête.
query_cursor_scoped_tables dynamic Répertorie les noms de tables à étendre à cursor_after_default .. cursor_before_or_at() (limite supérieure est facultative).
query_datascope string Contrôle les données auxquelles la requête s’applique. Les valeurs prises en charge sont default, allou hotcache.
query_datetimescope_column string Spécifie le nom de colonne de l’étendue datetime de la requête (query_datetimescope_to / query_datetimescope_from).
query_datetimescope_from datetime Définit la date et l’heure minimales pour l’étendue de la requête. Si elle est définie, elle sert de filtre automatiquement activé query_datetimescope_column.
query_datetimescope_to datetime Définit la date et l’heure maximales pour l’étendue de la requête. Si elle est définie, elle sert de filtre automatiquement activé query_datetimescope_column.
query_distribution_nodes_span int Contrôle le comportement de fusion de sous-requête. Le nœud en cours d’exécution introduit un niveau supplémentaire dans la hiérarchie de requêtes pour chaque sous-groupe de nœuds, et cette option définit la taille du sous-groupe.
query_fanout_nodes_percent int Spécifie le pourcentage de nœuds pour l’exécution d’un ventilateur.
query_fanout_threads_percent int Spécifie le pourcentage de threads pour l’exécution d’un ventilateur.
query_force_row_level_security bool Si la valeur est définie true, applique les règles de sécurité au niveau des lignes, même si la stratégie est désactivée.
query_language string Détermine la façon dont le texte de la requête doit être interprété. Les valeurs prises en charge sont csl, kqlou sql. Cette option ne peut pas être modifiée dans le cadre d’une instruction set.
query_log_query_parameters bool Active la journalisation des paramètres de requête pour l’affichage ultérieur dans le journal des requêtes .show.
query_max_entities_in_union long Remplace le nombre maximal par défaut de colonnes qu’une requête est autorisée à produire.
query_now datetime Remplace la valeur datetime retournée par la fonction now().
query_optimize_fts_at_relop bool Lorsque la valeur est définie true, active une optimisation expérimentale pour les requêtes qui effectuent des opérations de recherche de texte libre coûteuses. Par exemple, \|where * has "pattern".
query_python_debug bool ou int Si la valeur est définie true, génère une requête de débogage Python pour le nœud Python énuméré.
query_results_apply_getschema bool Si la valeur est définie true, récupère le schéma de chaque données tabulaires dans les résultats de la requête au lieu des données elles-mêmes.
query_results_cache_force_refresh bool Si la valeur est truedéfinie, force une actualisation du cache des résultats de requête pour une requête spécifique. Doit être utilisé en combinaison avec query_results_cache_max_age, et envoyé via la classe Kusto Data ClientRequestProperties, et non en tant qu’instruction set.
query_results_cache_max_age timespan Contrôle l’âge maximal des résultats de la requête mise en cache que le service est autorisé à retourner.
query_results_cache_per_shard bool Si la valeur est définie true, active la mise en cache des requêtes par extension .
query_results_progressive_row_count long Fournit un indicateur du nombre d’enregistrements à envoyer dans chaque mise à jour. Prend effet uniquement si results_progressive_enabled elle est définie.
query_results_progressive_update_period timespan Fournit un indicateur de la fréquence à laquelle envoyer des trames de progression. Prend effet uniquement si results_progressive_enabled elle est définie.
query_take_max_records long Limite les résultats de requête à un nombre spécifié d’enregistrements.
query_weakconsistency_session_id string Définit l’ID de session de cohérence faible de la requête. Prend effet lorsque queryconsistency le mode est défini sur weakconsistency_by_session_id. Cette option ne peut pas être modifiée dans le cadre d’une instruction set.
queryconsistency string Contrôle la cohérence des requêtes. Les valeurs prises en charge sont strongconsistency, , weakconsistencyweakconsistency_by_query, weakconsistency_by_databaseou weakconsistency_by_session_id. Lors de l’utilisation weakconsistency_by_session_id, veillez à définir également la query_weakconsistency_session_id propriété. Cette option ne peut pas être modifiée dans le cadre d’une instruction set.
request_app_name string Spécifie le nom de l’application de requête à utiliser dans la création de rapports. Par exemple, .show requêtes. Cette option ne peut pas être modifiée dans le cadre d’une instruction set.
request_block_row_level_security bool Si la valeur est définie true, bloque l’accès aux tables avec la stratégie de sécurité au niveau des lignes activée.
request_callout_disabled bool Si la valeur est truedéfinie, empêche la légende de la demande sur un service fourni par l’utilisateur.
request_description string Autorise l’inclusion de texte arbitraire comme description de la demande.
request_external_data_disabled bool Si la valeur est définie true, empêche la demande d’accéder aux données externes à l’aide de l’opérateur externaldata ou des tables externes.
request_external_table_disabled bool Si la valeur est définie true, empêche la demande d’accéder aux tables externes.
request_impersonation_disabled bool Si la valeur est définie true, indique que le service ne doit pas emprunter l’identité de l’appelant.
request_readonly bool Si la valeur est truedéfinie, empêche l’accès en écriture pour la demande. Cette option ne peut pas être modifiée dans le cadre d’une instruction set.
request_readonly_hardline bool Si la valeur est définie true, la requête fonctionne en mode lecture seule stricte. La requête n’est pas en mesure d’écrire quoi que ce soit, et aucune fonctionnalité non conforme, comme les plug-ins, est désactivée. Cette option ne peut pas être modifiée dans le cadre d’une instruction set.
request_remote_entities_disabled bool Si la valeur est définie true, empêche la demande d’accéder aux bases de données distantes et aux entités distantes.
request_sandboxed_execution_disabled bool Si la valeur est définie true, empêche la requête d’appeler du code dans le bac à sable.
request_user string Spécifie l’utilisateur de demande à utiliser dans la création de rapports. Par exemple, .show requêtes. Cette option ne peut pas être modifiée dans le cadre d’une instruction set.
results_error_reporting_placement string Détermine le positionnement des erreurs dans le jeu de résultats. Les options disponibles sont les suivantes : in_data, end_of_table et end_of_dataset.
results_progressive_enabled bool Si la valeur est définie true, active le flux de requête progressif. Cette option ne peut pas être modifiée dans le cadre d’une instruction set.
results_v2_fragment_primary_tables bool Provoque l’envoi de tables primaires dans plusieurs fragments, chacun contenant un sous-ensemble des lignes. Cette option ne peut pas être modifiée dans le cadre d’une instruction set.
results_v2_newlines_between_frames bool Ajoute de nouvelles lignes entre les images dans les résultats afin de faciliter l’analyse des images.
servertimeout timespan Remplace le délai d’expiration de la requête par défaut. Cette option ne peut pas être modifiée dans le cadre d’une instruction set. Au lieu de cela, modifiez l’option à l’aide des paramètres du tableau de bord.
truncation_max_records long Remplace le nombre maximal d’enregistrements par défaut qu’une requête est autorisé à revenir à l’appelant (troncation).
truncationmaxsize long Remplace la taille de données maximale par défaut qu’une requête est autorisée à retourner à l’appelant (troncation). Cette option ne peut pas être modifiée dans le cadre d’une instruction set.
validatepermissions bool Valide les autorisations de l’utilisateur pour effectuer la requête sans exécuter réellement la requête. Les résultats possibles pour cette propriété sont les suivants : OK (les autorisations sont présentes et valides), Incomplete (la validation n’a pas pu être effectuée en raison de l’évaluation dynamique du schéma) ou KustoRequestDeniedException (les autorisations n’ont pas été définies).

Comment définir des propriétés de requête

Vous pouvez définir les propriétés de requête de la manière suivante :

Remarque

Les propriétés de requête suivantes ne peuvent pas être définies avec une instruction set :

  • norequesttimeout
  • queryconsistency
  • query_language
  • query_weakconsistency_session_id
  • request_app_name
  • request_readonly
  • request_readonly_hardline
  • request_user
  • results_progressive_enabled
  • results_v2_fragment_primary_tables
  • servertimeout
  • truncationmaxsize

Remarque

  • Pour définir norequesttimeout et servertimeout à partir des paramètres de tableau de bord, consultez les limites de délai d’expiration.
  • Pour définir queryconsistency la cohérence faible par le biais des paramètres du tableau de bord, sélectionnez Connexion aux paramètres>. Pour plus d’informations, consultez Personnaliser les paramètres dans l’interface utilisateur web d’Azure Data Explorer.

Contenu connexe