Управление завершением по нажатию клавиши Tab (SQL Server PowerShell)

В SQL Server PowerShell введены три системные переменные ($SqlServerMaximumTabCompletion, $SqlServerMaximumChildItems и $SqlServerIncludeSystemObjects) для управления функцией завершения Windows PowerShell по клавише TAB. Функция завершения по клавише TAB позволяет сократить объем вводимого текста, поскольку возвращает таблицы элементов, имена которых начинаются с набранной строки.

Перед началом

Функция завершения по клавише TAB среды Windows PowerShell дает возможность после ввода части имени пути или командлета нажать клавишу TAB, чтобы получить список элементов, имена которых согласуются с уже набранным текстом. Затем можно выбрать нужный элемент из списка, не набирая остальную часть его имени.

При работе с базой данных, содержащей большое количество объектов, списки завершения по клавише TAB могут стать очень большими. Кроме того, для некоторых типов объектов SQL Server, например для представлений, предусмотрено большое число системных объектов.

В оснастках SQL Server впервые представлены три системные переменные, которые используются для управления объемом данных, выводимых функцией завершения по клавише TAB и командлетом Get-ChildItem.

• $SqlServerMaximumTabCompletion = n
  Указывает максимальное число объектов, включаемых в список завершения по клавише TAB. Если нажать клавишу TAB в узле пути, для которого существует более n подходящих объектов, список завершения по TAB будет усечен до n объектов. n является целым числом. 0 — значение по умолчанию, которое означает, что число перечисляемых объектов не ограничено.

• $SqlServerMaximumChildItems = n
  Указывает максимальное количество объектов, отображаемых командлетом Get-ChildItem. Если командлет Get-ChildItem выполняется в узле пути, для которого существует более n объектов, список будет усечен до n объектов. n является целым числом. 0 — значение по умолчанию, которое означает, что число перечисляемых объектов не ограничено.

• $SqlServerIncludeSystemObjects = { $True | $False }
  Если указано значение $True, функция завершения по клавише TAB и командлет Get-ChildItem отображают системные объекты. Если значение равно $False, системные объекты не отображаются. Значение по умолчанию равно $False.

Установка переменных функции завершения по клавише TAB для SQL Server

Задайте новое значение для любой переменной, значение которой необходимо заменить на отличное от применяемого по умолчанию.

Пример (PowerShell)

В следующем примере задаются все три переменные и выводятся их значения:

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

См. также

Основные понятия

SQL Server PowerShell