Использование командлета Invoke-Sqlcmd

Использование командлета Invoke-Sqlcmd

Командлет Invoke-Sqlcmd позволяет запускать файлы скриптов sqlcmd в среде Windows PowerShell. Значительная часть действий, выполняемых с помощью программы sqlcmd, может быть также выполнена с помощью командлета Invoke-Sqlcmd.

Ниже приведен пример вызова командлета Invoke-Sqlcmd для выполнения простого запроса, аналогичного тому, который выполняется путем задания команды sqlcmd с параметрами -Q и -S:

Invoke-Sqlcmd -Query "SELECT GETDATE() AS TimeOfQuery;" -ServerInstance "MyComputer\MyInstance"

В этом примере вызывается командлет Invoke-Sqlcmd, указывается входной файл и вывод перенаправляется прямо в файл. Это аналогично заданию команды sqlcmd с параметрами -i и -o:

Invoke-Sqlcmd -InputFile "C:\MyFolder\TestSQLCmd.sql" | Out-File -filePath "C:\MyFolder\TestSQLCmd.rpt"

В следующем примере массив Windows PowerShell используется для передачи нескольких переменных скрипта sqlcmd в командлет Invoke-Sqlcmd. Символ «$», обозначающий переменные скрипта sqlcmd в инструкции SELECT, отмечен как специальный с помощью escape-символа обратной кавычки PowerShell «`»:

$MyArray = "MyVar1 = 'String1'", "MyVar2 = 'String2'"
Invoke-Sqlcmd -Query "SELECT `$(MyVar1) AS Var1, `$(MyVar2) AS Var2;" -Variable $MyArray

В следующем примере с помощью поставщика SQL Server PowerShell выполняется переход к экземпляру компонента Database Engine, а затем с помощью командлета Get-Item среды PowerShell Windows получается объект сервера SMO для экземпляра и передается командлету Invoke-Sqlcmd:

Set-Location SQLSERVER:\SQL\MyComputer\MyInstance
Invoke-Sqlcmd -Query "SELECT GETDATE() AS TimeOfQuery;" -ServerInstance (Get-Item .)

Параметр -Query является позиционным, ему не обязательно присваивать имя. Если первая строка, которая передается командлету Invoke-Sqlcmd, не имеет имени, то она обрабатывается как параметр -Query.

Invoke-Sqlcmd "SELECT GETDATE() AS TimeOfQuery;" -ServerInstance "MyComputer\MyInstance"

Путь к контексту в Invoke-Sqlcmd

Если параметр -Database не используется, контекст базы данных для Invoke-Sqlcmd задается активным путем при вызове командлета.

Например, предположим, что базой данных по умолчанию для используемой учетной записи Windows в экземпляре по умолчанию локального компьютера является master. В этом случае следующие команды возвратят базу данных master.

Set-Location SQLSERVER:\SQL
Invoke-Sqlcmd "SELECT DB_NAME() AS DatabaseName;"

Следующие команды возвратят базу данных База данных AdventureWorks2008R2:

Set-Location SQLSERVER:\SQL\MyComputer\DEFAULT\Databases\AdventureWorks2008R2\Tables\Person.Person
Invoke-Sqlcmd "SELECT DB_NAME() AS DatabaseName;"

Командлет Invoke-Sqlcmd выдает предупреждение при использовании пути к контексту базы данных. Чтобы отключить сообщение с предупреждением, используется параметр -SuppressProviderContextWarning. Чтобы указать командлету Invoke-Sqlcmd операцию «всегда использовать для входа базу данных» по умолчанию, используется параметр -IgnoreProviderContext.

Сравнение командлета Invoke-Sqlcmd и программы sqlcmd

Командлет Invoke-Sqlcmd может использоваться для запуска многих скриптов, которые могут быть также выполнены с помощью программы sqlcmd. Однако командлет Invoke-Sqlcmd работает в среде Windows PowerShell, которая отличается от среды командной строки, в которой работает sqlcmd. Поведение командлета Invoke-Sqlcmd изменено в целях поддержки работы в среде Windows PowerShell.

Тем не менее, в командлете Invoke-Sqlcmd реализованы не все команды sqlcmd. Нереализованные команды включают следующее: :!!, :connect, :error, :out, :ed, :list, :listvar, :reset, :perftrace и :serverlist.

Командлет Invoke-Sqlcmd не инициализирует среду sqlcmd или переменные скрипта, такие как SQLCMDDBNAME или SQLCMDWORKSTATION.

Командлет Invoke-Sqlcmd не отображает сообщения, такие как выходные данные инструкций PRINT, если не указан общий параметр -Verbose среды Windows PowerShell. Например:

Invoke-Sqlcmd -Query "PRINT N'abc';" -Verbose

В среде PowerShell требуются не все параметры sqlcmd. Например, среда Windows PowerShell форматирует все выходные данные командлетов, поэтому параметры форматирования sqlcmd не реализованы в командлете Invoke-Sqlcmd. В следующей таблице показана связь между параметрами Invoke-Sqlcmd и параметрами sqlcmd.

См. также

Справочник

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