Utiliser le fournisseur PowerShell pour les événements étendus

S’applique à :SQL ServerAzure SQL Database

Vous pouvez gérer les événements étendus SQL Server à l’aide du fournisseur SQL Server PowerShell. Le sous-dossier XEvent est disponible sous le lecteur SQLSERVER. Vous pouvez accéder à ce dossier selon l'une des méthodes suivantes :

• À l’invite de commandes, saisissez sqlps, puis appuyez sur ENTRÉE. Saisissez cd xevent, puis appuyez sur ENTRÉE. De là, vous pouvez utiliser les commandes cd et dir (ou les applets de commande Set-Location et Get-Childitem ) pour accéder au nom du serveur et de l’instance.

• Dans l’Explorateur d’objets, développez le nom de l’instance, développez Gestion, cliquez avec le bouton droit sur Événements étendus, puis cliquez sur Démarrer PowerShell. Cela démarre PowerShell selon le chemin d'accès suivant :

  PS SQLSERVER:\XEvent\ServerName InstanceName\>

  Note

  Vous pouvez démarrer PowerShell à partir de n'importe quel nœud sous Événements étendus. Par exemple, vous pouvez cliquer avec le bouton droit sur Sessions, puis cliquer sur Démarrer PowerShell. Cela démarre PowerShell à un niveau plus profond, au niveau du dossier Sessions.

Vous pouvez parcourir l'arborescence des dossiers XEvent pour consulter les sessions Événements étendus existantes, ainsi que leurs événements, cibles et prédicats associés. Par exemple, à partir du chemin PS SQLSERVER:\XEvent\ServerName\InstanceName>, si vous tapez des sessions cd, appuyez sur Entrée, tapez dir, puis appuyez sur Entrée, vous pouvez voir la liste des sessions stockées sur cette instance. Vous pouvez également voir si la session est en cours (et si c'est le cas, pour combien de temps), et savoir si elle est configurée pour démarrer en même temps que l'instance.

Pour consulter les événements, leurs prédicats et les cibles associés à une session, vous pouvez attribuer le nom de la session aux répertoires, puis voir le dossier des événements ou des cibles. Par exemple, pour afficher les événements et leurs prédicats associés à la session d’intégrité système par défaut, à partir du chemin PS SQLSERVER:\XEvent\ServerName\InstanceName\Sessions>, tapez cd system_health\events, appuyez sur ENTRÉE, tapez dir, puis appuyez sur Entrée.

Le fournisseur SQL Server PowerShell est un outil puissant que vous pouvez utiliser pour créer, modifier et gérer des sessions d’événements étendus. La section suivante fournit quelques exemples simples d'utilisation de scripts PowerShell avec des Événements étendus.

Examples

Dans les exemples ci-après, notez les éléments suivants :

• Les scripts doivent être exécutés à partir de l’invite PS SQLSERVER:\> (disponible en tapant sqlps à une invite de commandes).

• Les scripts utilisent l’instance par défaut de SQL Server.

• Les scripts doivent être enregistrés avec une extension .ps1.

• La stratégie d'exécution de PowerShell doit autoriser l'exécution du script. Pour définir la stratégie d’exécution, utilisez l’applet de commande Set-Executionpolicy . (Pour plus d’informations, tapez get-help set-executionpolicy -detailed, puis appuyez sur Entrée).

Le script suivant crée une nouvelle session nommée « TestSession ».

#Script for creating a session.  
cd XEvent  
$h = hostname  
cd $h  
  
#Use the default instance.  
$store = dir | where {$_.DisplayName -ieq 'default'}  
$session = new-object Microsoft.SqlServer.Management.XEvent.Session -argumentlist $store, "TestSession"  
$event = $session.AddEvent("sqlserver.file_written")  
$event.AddAction("package0.callstack")  
$session.Create()  

Le script suivant ajoute la cible de mémoire tampon en anneau à la session créée dans l'exemple précédent. (Cet exemple montre l’utilisation du Alter , méthode. N’oubliez pas que vous pouvez ajouter la cible lors de la première création de la session.)

#Script to alter a session.  
cd XEvent  
$h = hostname  
cd $h  
cd DEFAULT\Sessions  
  
#Used to find the specified session.  
$session = dir|where {$_.Name -eq 'TestSession'}  
  
#Add the ring buffer target and call the Alter method.  
$session.AddTarget("package0.ring_buffer")  
$session.Alter()  

Le script suivant crée une nouvelle session qui utilise une expression de prédicat. Dans ce cas, la session recueille les informations portant sur le moment où a été créé le fichier c:\temp.log (par le biais de l’événement sqlserver.file_written).

#Script for creating a session.  
cd XEvent  
$h = hostname  
cd $h  
  
#Use the default instance.  
$store = dir | where {$_.DisplayName -ieq 'default'}  
$session = new-object Microsoft.SqlServer.Management.XEvent.Session -argumentlist $store, "TestSession2"  
$event = $session.AddEvent("sqlserver.file_written")  
  
#Construct a predicate "equal_i_unicode_string(path, N'c:\temp.log')".  
$column = $store.SqlServerPackage.EventInfoSet["file_written"].DataEventColumnInfoSet["path"]  
$operand = new-object Microsoft.SqlServer.Management.XEvent.PredOperand -argumentlist $column  
$value = new-object Microsoft.SqlServer.Management.XEvent.PredValue -argumentlist "c:\temp.log"  
$compare = $store.Package0Package.PredCompareInfoSet["equal_i_unicode_string"]  
$predicate = new-object Microsoft.SqlServer.Management.XEvent.PredFunctionExpr -argumentlist $compare, $operand, $value  
$event.SetPredicate($predicate)  
$session.Create()  

Sécurité

Pour créer, modifier ou supprimer une session Événements étendus, vous devez disposer de l'autorisation ALTER ANY EVENT SESSION.

Voir aussi

SQL Server PowerShell
Utiliser la session system_health
Outils associés aux événements étendus