Utiliser PowerShell sur Windows pour gérer Microsoft SQL Server sur Linux
S’applique à : 
SQL Server - Linux
Cet article présente SQL Server PowerShell et vous guide à travers quelques exemples de son utilisation avec SQL Server sur Linux. Le support PowerShell pour SQL Server est actuellement disponible sur Windows, macOS et Linux. Cet article vous guide tout au long de l’utilisation d’une machine Windows pour se connecter à une instance distante sur Linux.
Installer la version la plus récente de SQL PowerShell sur Windows
Le module SQL Server PowerShell sur Windows est conservé dans la PowerShell Gallery. Lorsque vous utilisez SQL Server, vous devez toujours utiliser la version la plus récente du module PowerShell SqlServer.
Avant de commencer
Lisez les Problèmes connus pour SQL Server sur Linux.
Lancer PowerShell et importer le module sqlserver
Commençons par lancer PowerShell sur Windows. Utilisez Win+R, sur votre ordinateur Windows et saisissez PowerShell pour lancer une nouvelle session PowerShell Windows.
SQL Server fournit un module PowerShell nommé SqlServer. Vous pouvez utiliser le module SqlServer pour importer les composants de SQL Server (fournisseur et cmdlets SQL Server) dans un environnement ou un script PowerShell.
Copiez et collez la commande suivante à l’invite PowerShell pour importer le module SqlServer dans votre session PowerShell actuelle :
Import-Module SqlServer
À l’invite de PowerShell, tapez la commande suivante pour vérifier que le module SqlServer a été correctement importé :
Get-Module -Name SqlServer
PowerShell doit afficher des informations similaires à la sortie suivante :
ModuleType Version Name ExportedCommands
---------- ------- ---- ----------------
Script 21.1.18102 SqlServer {Add-SqlAvailabilityDatabase, Add-SqlAvailabilityGroupList...
Se connecter à SQL Server et obtenir des informations sur le serveur
Nous allons utiliser PowerShell sur Windows pour vous connecter à votre instance sur Linux et afficher plusieurs propriétés du serveur.
Copiez et collez les commandes suivantes à l’invite de PowerShell. Quand vous exécutez ces commandes, PowerShell :
- afficher une boîte de dialogue qui vous invite à entrer le nom d’hôte ou l’adresse IP de votre instance
- affichez la boîte de dialogue Requête d’informations d’identification Windows PowerShell, qui vous invite à entrer les informations d’identification. Vous pouvez utiliser votre nom d'utilisateur SQL et votre mot de passe SQL pour vous connecter à votre instance sur Linux
- Utilisez le cmdlet Get-SqlInstance pour vous connecter au Serveur et afficher quelques propriétés
Si vous le souhaitez, vous pouvez simplement remplacer la variable $serverInstance par l’adresse IP ou le nom d’hôte de votre instance.
# Prompt for instance & credentials to login into SQL Server
$serverInstance = Read-Host "Enter the name of your instance"
$credential = Get-Credential
# Connect to the Server and get a few properties
Get-SqlInstance -ServerInstance $serverInstance -Credential $credential
# done
PowerShell doit afficher des informations similaires à la sortie suivante :
Instance Name Version ProductLevel UpdateLevel HostPlatform HostDistribution
------------- ------- ------------ ----------- ------------ ----------------
your_server_instance 14.0.3048 RTM CU13 Linux Ubuntu
Notes
Si rien ne s’affiche pour ces valeurs, la connexion à l’instance cible a probablement échoué. Assurez-vous que vous pouvez utiliser les mêmes informations de connexion pour vous connecter à partir de SQL Server Management Studio. Examinez ensuite les recommandations en matière de résolution des problèmes de connexion.
Utiliser le fournisseur SQL Server PowerShell
Une autre option pour se connecter à votre instance consiste à utiliser le Fournisseur SQL Server PowerShell. Ce fournisseur vous permet de naviguer dans l’instance comme si vous naviguiez dans l’arborescence dans l’Explorateur d’objets, mais a niveau de la cmdline. Par défaut, ce fournisseur est présenté sous la forme d’un PSDrive nommé SQLSERVER:\ que vous pouvez utiliser pour vous connecter et naviguer dans les instances SQL auxquelles votre compte de domaine a accès. Pour plus d’informations sur comment configurer l’authentification Active Directory pour SQL Server sur Linux, consultez Étapes de configuration.
Vous pouvez également utiliser l’authentification SQL avec le fournisseur SQL Server PowerShell. Pour ce faire, utilisez la cmdlet New-PSDrive pour créer un nouveau PSDrive et fournir les informations d’identification appropriées pour la connexion.
Dans l’exemple ci-dessous, vous verrez un exemple de création d’un nouveau PSDrive à l’aide de l’authentification SQL.
# NOTE: We are reusing the values saved in the $credential variable from the above example.
New-PSDrive -Name SQLonDocker -PSProvider SqlServer -Root 'SQLSERVER:\SQL\localhost,10002\Default\' -Credential $credential
Vous pouvez vérifier que le lecteur a été créé en exécutant la cmdlet Get-PSDrive.
Get-PSDrive
Une fois que vous avez créé votre nouveau PSDrive, vous pouvez commencer à le parcourir.
dir SQLonDocker:\Databases
Voici à quoi peut ressembler le résultat. Vous pouvez remarquer que le résultat est similaire à ce que SQL Server Management Studio (SSMS) affiche dans le nœud Bases de données. Il affiche les bases de données utilisateur, mais pas les bases de données système.
Name Status Size Space Recovery Compat. Owner
Available Model Level
---- ------ ---- ---------- -------- ------- -----
AdventureWorks2022 Normal 209.63 MB 1.31 MB Simple 130 sa
AdventureWorksDW2022 Normal 167.00 MB 32.47 MB Simple 110 sa
AdventureWorksDW2022 Normal 188.00 MB 78.10 MB Simple 120 sa
AdventureWorksDW2022 Normal 172.00 MB 74.76 MB Simple 130 sa
AdventureWorksDW2022 Normal 208.00 MB 40.57 MB Simple 140 sa
Si vous avez besoin d’afficher toutes les bases de données sur votre instance, l’une des options consiste à utiliser la cmdlet Get-SqlDatabase.
Examiner les journaux d'erreurs SQL Server
Les étapes suivantes utilisent PowerShell sur Windows pour examiner les journaux d’erreurs se connecter à votre instance sur Linux. Nous utiliserons également la cmdlet Out-GridView pour afficher les informations des journaux d’erreurs dans un affichage de grille.
Copiez et collez les commandes suivantes à l’invite de PowerShell. L’exécution peut prendre quelques minutes. Ces commandes effectuent les opérations suivantes :
- afficher une boîte de dialogue qui vous invite à entrer le nom d’hôte ou l’adresse IP de votre instance
- affichez la boîte de dialogue Requête d’informations d’identification Windows PowerShell, qui vous invite à entrer les informations d’identification. Vous pouvez utiliser votre nom d'utilisateur SQL et votre mot de passe SQL pour vous connecter à votre instance sur Linux
- Utilisez la cmdlet SqlErrorLog pour vous connecter à l’instance sur Linux et récupérer les journaux d’erreurs depuis Hier
- Diriger la sortie vers la cmdlet Out-GridView
Si vous le souhaitez, vous pouvez remplacer la variable $serverInstance par l’adresse IP ou le nom d’hôte de votre instance.
# Prompt for instance & credentials to login into SQL Server
$serverInstance = Read-Host "Enter the name of your instance"
$credential = Get-Credential
# Retrieve error logs since yesterday
Get-SqlErrorLog -ServerInstance $serverInstance -Credential $credential -Since Yesterday | Out-GridView
# done