Identificateurs SQL Server dans PowerShell

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Le fournisseur SQL Server pour Windows PowerShell utilise les identificateurs SQL Server dans les chemins Windows PowerShell. SQL Server Les identificateurs peuvent contenir des caractères que Windows PowerShell ne prend pas en charge dans les chemins. Vous devez placer ces caractères dans une séquence d’échappement ou leur appliquer un codage spécial lors de l’utilisation des identificateurs dans les chemins Windows PowerShell.

Notes

Il existe deux modules SQL Server PowerShell : SqlServer et SQLPS.

Le module SqlServer est le module PowerShell actuel à utiliser.

Le module SQLPS fait partie de l’installation de SQL Server (à des fins de compatibilité descendante), mais il n’est plus mis à jour.

Le module SqlServer contient les versions mises à jour des applets de commande disponibles dans SQLPS ainsi que de nouvelles applets de commande pour prendre en charge les dernières fonctionnalités SQL.

Installez le module SqlServer à partir de PowerShell Gallery.

Pour plus d’informations, consultez SQL Server PowerShell.

Identificateurs SQL Server dans les chemins d'accès Windows PowerShell

Les fournisseurs Windows PowerShell présentent les hiérarchies de données à l’aide d’une structure de chemin semblable à celle du système de fichiers Windows. Le fournisseur SQL Server implémente les chemins d'accès aux objets SQL Server . Pour le Moteur de base de données, le lecteur est défini sur SQLSERVER:, le premier dossier est défini sur \SQL et les objets de base de données sont référencés sous forme de conteneurs et d’éléments. Voici le chemin de la table Vendor dans le schéma Purchasing de la base de données AdventureWorks2019 dans une instance par défaut du Moteur de base de données:

SQLSERVER:\SQL\MyComputer\DEFAULT\Databases\AdventureWorks2012\Tables\Purchasing.Vendor  

SQL Server Les identificateurs sont les noms des objets SQL Server , tels que des noms de tables ou de colonnes. Il existe deux types d'identificateurs SQL Server :

  • Les identificateurs standard sont limités à un jeu des caractères qui sont également pris en charge dans les chemins d'accès Windows PowerShell. Ces noms peuvent être utilisés dans les chemins d'accès Windows PowerShell sans être modifiés.

  • Les identificateurs délimités peuvent utiliser des caractères non pris en charge dans les noms de chemins d'accès Windows PowerShell. Ils sont appelés « identificateurs délimités » s'ils sont placés entre crochets et ([NomIdentificateur]) et « identificateurs entre guillemets » s'ils sont placés entre les guillemets ("NomIdentificateur"). Si un identificateur délimité utilise des caractères non pris en charge dans les chemins d'accès Windows PowerShell, les caractères doivent être codés ou placés dans une séquence d'échappement avant d'utiliser l'identificateur comme conteneur ou nom d'élément. L'encodage fonctionne pour tous les caractères. Certains caractères, comme les deux-points (:), ne peuvent pas être placés dans une séquence d'échappement.

Identificateurs SQL Server dans les applets de commande

Certaines applets de commande SQL Server contiennent un paramètre dont l'entrée est un identificateur. Les valeurs de paramètres sont généralement fournies sous forme de constantes de chaîne entre guillemets ou dans des variables chaîne. Lorsque les identificateurs sont fournis sous forme de constantes de chaîne ou dans des variables, il n'y a aucun conflit avec l'ensemble des caractères pris en charge par Windows PowerShell.

Tâches des identificateurs SQL Server

Description de la tâche Article
Décrit comment spécifier un nom d'instance, y compris le nom de l'ordinateur sur lequel l'instance s'exécute. Spécifier des instances dans le fournisseur SQL Server PowerShell
Décrit comment spécifier le codage hexadécimal des caractères dans les identificateurs délimités qui ne sont pas pris en charge dans les chemins d'accès Windows PowerShell. Décrit également comment décoder les caractères hexadécimaux. Encoder et décoder des identificateurs SQL Server
Décrit comment utiliser le caractère d'échappement Windows PowerShell pour les caractères non pris en charge dans les chemins d'accès PowerShell. Placer des identificateurs SQL Server dans une séquence d’échappement

Voir aussi