KB4561725 - Amélioration : activation de la session PolyBase Xevent dans SQL Server 2019

S’applique à
SQL Server 2019 on Windows

Amélioration

Cette amélioration permet la collecte de certains événements X spécifiques à PolyBase dans SQL Server 2019

Informations supplémentaires

En raison de la mise en œuvre de PolyBase par des services externes (PolyBase Engine et PolyBase Data Movement), la capture Xevents ne peut pas être activée de la même manière que d’autres Xevents du moteur SQL Server (par exemple, les commandes T-SQL ou SQL Server Management Studio GUI).

  • Pour activer la collecte PolyBase Xevents, vous devez créer un nouveau fichierEngineService.xevents.xml qui contient les éléments suivants :

Remarque

  • <event_sessions>
       <event_session
        name="DMSCommonSession » maxMemory="2 » allowRecursiveEvents="true » eventRetentionMode="noEventLoss »
        trackCausality="false » dispatchLatency="5 » maxEventSize="1 »
        memoryPartitionMode="none »> 
  • <-- ces événements sont disponibles sur toutes les plates-formes SQL Server (Windows/Linux/Clusters Big Data) -->
         <event package="DMSCommonXEvents » name="dsql_plan » />
         <event package="DMSCommonXEvents » name="name_node_ha » />
         <event package="DMSCommonXEvents » name="polybase_authorize_begin » />
         <event package="DMSCommonXEvents » name="polybase_authorize_end » />
     
    <-- ces événements ne sont disponibles que pour SQL Server Clusters Big Data :>
         <event package="DMSCommonXEvents » name="build_openrowset_query » />
         <event package="DMSCommonXEvents » name="initialize_metadata_processor » />
  • <target package="package0 » name="event_file »>
           <parameter name="filename » value="PdwXevents.xel » />
           <parameter name="max_file_size » value="10 » />
           <parameter name="max_rollover_files » value="10 » />
         <Commande /cible>
     
       </event_session>
    </event_sessions>
  • Enregistrez le fichier dans le .. dossier \MSSQL\Binn\Polybase . Vous devrez peut-être l’enregistrer dans un autre emplacement, puis déplacer le fichier vers ce dossier.
  • Redémarrez le service PolyBase Engine et vous verrez le fichier PdwXevents_0_{#####}.xel créé dans le .. dossier \MSSQL\Log\Polybase. Vous pouvez afficher ce fichier XEL de la même manière que n’importe quelle autre capture de fichier XEvents XEL.

Descriptions des événements

xevent Champs Description de l’événement/du champ
Disponible sur toutes les plateformes
dsql_plan Informations sur le plan Dsql
memo_xml Note xml
dsql_plan_xml XML du plan dsql
showplan_xml Format xml Showplan du plan dsql.
distributed_query_hash Le hachage de requête est unique pour la même requête et sera utilisé pour identifier la régression de requête
distributed_statement_id L’ID d’instruction est unique pour chaque instruction d’un lot et peut être utilisé pour la corrélation au niveau de l’instruction
distributed_request_id L’ID de demande est unique pour chaque sp_execute_memo et peut être utilisé pour la corrélation de sp_execute_memo’exécution
distributed_query_id ID de requête
distributed_plan_step Étape d’un plan de requête distribuée
dms_plan_step Étape d’un plan DMS
sql_handle Descripteur SQL
name_node_ha NameNode ha tracing information.
URI NameNode URI
retry_count Nombre de tentatives pour ce nœud.
isActiveNamenode
shouldRetry
polybase_authorize_begin Autoriser l’événement de début PolyBase
app_name Nom de l'application
session_id ID de session
polybase_authorize_end Événement de fin d’autorisation PolyBase
app_name Nom de l'application
session_id ID de session
Disponible sur BDC
build_openrowset_query Pool de stockage de build Sélectionner à partir de la requête openrowset
select_query Requête Sélectionner dans openrowset
distributed_query_hash Le hachage de requête est unique pour la même requête et sera utilisé pour identifier la régression de requête
distributed_statement_id L’ID d’instruction est unique pour chaque instruction d’un lot et peut être utilisé pour la corrélation au niveau de l’instruction
distributed_request_id L’ID de demande est unique pour chaque sp_execute_memo et peut être utilisé pour la corrélation de sp_execute_memo’exécution
distributed_query_id ID de requête
distributed_plan_step Étape d’un plan de requête distribuée
dms_plan_step Étape d’un plan DMS
sql_handle Descripteur SQL
initialize_metadata_processor Le processeur de métadonnées est initialisé
shards_list Liste des points de terminaison de partitions

Résolution

Cette amélioration est incluse dans la mise à jour cumulative suivante pour SQL Server :

À propos des mises à jour cumulatives pour SQL Server :

Chaque nouvelle mise à jour cumulative pour SQL Server contient tous les correctifs logiciels et tous les correctifs de sécurité inclus dans la mise à jour cumulative précédente. Consultez les dernières mises à jour cumulatives pour SQL Server :

Références

En savoir plus à propos de la terminologie utilisée par Microsoft pour décrire les mises à jour logicielles.