Gérer la saisie semi-automatique via la touche Tab avec SQL Server PowerShell

  • Article

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

Les composants logiciels enfichables SQL Server PowerShell introduisent trois variables ($SqlServerMaximumTabCompletion, $SqlServerMaximumChildItems et $SqlServerIncludeSystemObjects) pour contrôler la complétion par tabulation de Windows PowerShell. La saisie semi-automatique par tabulation réduit la quantité de caractères que vous devez taper en renvoyant des tableaux d'éléments dont le nom commence par la chaîne que vous tapez.

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.

Avec la saisie semi-automatique par tabulation de Windows PowerShell, une fois que vous avez tapé une partie d'un chemin d'accès ou d'un nom d'applet de commande, vous pouvez appuyer sur la touche Tab pour obtenir la liste des éléments dont le nom correspond à ce que vous avez déjà tapé. Vous pouvez alors sélectionner l'élément souhaité dans la liste sans avoir à taper le reste du nom.

Si vous travaillez dans une base de données qui contient beaucoup d’objets, les listes de saisie semi-automatique par tabulation peuvent devenir longues. Certains types d'objets SQL Server, tels que les affichages, contiennent également de nombreux objets système.

Les composants logiciels enfichables SQL Server introduisent trois variables système que vous pouvez utiliser pour contrôler la quantité d’informations présentées par le biais de la saisie semi-automatique via la touche Tab et de Get-ChildItem.

$SqlServerMaximumTabCompletion =** n

Spécifie le nombre maximal d'objets à inclure dans une liste de saisie semi-automatique par tabulation. Si vous sélectionnez la touche TAB sur un nœud de chemin d'accès qui contient plus de n objets, la liste de saisie semi-automatique par tabulation est tronquée à n, n étant un entier. Le paramètre par défaut 0 signifie que le nombre d'objets répertoriés est illimité.

$SqlServerMaximumChildItems =** n

Spécifie le nombre maximal d’objets affichés par Get-ChildItem. Si Get-ChildItem est exécuté sur un nœud de chemin contenant plus de n objets, la liste est tronquée au niveau n, n étant un entier. Le paramètre par défaut 0 signifie que le nombre d'objets répertoriés est illimité.

$SqlServerIncludeSystemObjects =** { $True | $False }

Si cette variable est définie sur $True, les objets système sont affichés par le biais de la saisie semi-automatique par tabulation et de Get-ChildItem. Si cette variable est définie sur $False, aucun objet système n’est affiché. La valeur par défaut est $False.

Définir les variables de la saisie semi-automatique par tabulation de SQL Server

Pour chacune des variables pour lesquelles vous souhaitez utiliser une valeur autre que la valeur par défaut, définissez la nouvelle valeur de la variable.

Exemple (PowerShell)

L'exemple suivant définit les trois variables et répertorie leurs paramètres :

$SqlServerMaximumTabCompletion = 20  
$SqlServerMaximumChildItems = 10  
$SqlServerIncludeSystemObjects = $False  
dir variable:sqlserver*

Voir aussi