командлет Invoke-Sqlcmd

Invoke-Sqlcmd — это командлет SQL Server, который выполняет скрипты, содержащие инструкции на языках (Transact-SQL и XQuery) и команды, поддерживаемые служебной программой 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, были экранированы с помощью символа экранирования PowerShell "`".

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

Это пример использования поставщика SQL Server в Windows PowerShell для перехода к экземпляру сервера баз данных и использования командлета Get-Item для получения объекта SMO Server для этого экземпляра, а затем его передачи в 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 в экземпляре по умолчанию локального компьютера является главной. Затем следующие команды возвращают главный объект:

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

Следующие команды возвращают AdventureWorks2012:

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

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

Сравнение Invoke-Sqlcmd и служебной программы sqlcmd

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

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

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

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

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

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

См. также

Используйте командлеты движка базы данных
Служебная программа sqlcmd
Использование программы sqlcmd