Utilizzo del cmdlet Invoke-Sqlcmd

Utilizzo di Invoke-Sqlcmd

Il cmdlet Invoke-Sqlcmd consente di eseguire file script sqlcmd in un ambiente Windows PowerShell. Molte operazioni consentite da sqlcmd possono essere eseguite anche utilizzando Invoke-Sqlcmd.

Di seguito viene riportato un esempio di chiamata a Invoke-Sqlcmd per l'esecuzione di una query semplice, simile alla specifica di sqlcmd con le opzioni -Q e -S:

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

Di seguito viene riportato un esempio di chiamata a Invoke-Sqlcmd, specifica di un file di input e inoltro tramite pipe dell'output in un file. Si tratta di un'operazione simile alla specifica di sqlcmd con le opzioni -i e -o:

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

Di seguito viene riportato un esempio di utilizzo di una matrice Windows PowerShell per passare più variabili di scripting sqlcmd a Invoke-Sqlcmd. Per caratteri "$" che identificano le variabili di scripting sqlcmd nell'istruzione SELECT è stato utilizzato il carattere di escape PowerShell "`" (apice inverso):

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

Di seguito viene riportato un esempio dell'utilizzo del provider di SQL Server per Windows PowerShell per passare a un'istanza di Motore di database, nonché dell'utilizzo del cmdlet Get-Item di Windows PowerShell per recuperare un oggetto server SMO per l'istanza e passarlo a Invoke-Sqlcmd:

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

Il parametro -Query è un parametro basato sulla posizione e non deve essere denominato. Se la prima stringa che viene passata a Invoke-Sqlcmd è senza nome, viene trattata come il parametro -Query.

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

Contesto del percorso in Invoke-Sqlcmd

Se non si utilizza il parametro -Database, il contesto del database per Invoke-Sqlcmd viene impostato dal percorso che è attivo al momento della chiamata di cmdlet.

Si supponga, ad esempio, che il database predefinito per l'account di Windows nell'istanza predefinita del computer locale sia master. I seguenti comandi restituirebbero master:

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

I seguenti comandi restituirebbero AdventureWorks2008R2:

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

Invoke-Sqlcmd visualizza un avviso quando utilizza il contesto del database per il percorso. È possibile utilizzare il parametro -SuppressProviderContextWarning per disattivare il messaggio di avviso. Il parametro -IgnoreProviderContext può essere utilizzato per indicare a Invoke-Sqlcmd di utilizzare sempre il database predefinito per l'accesso.

Confronto tra Invoke-Sqlcmd e l'utilità sqlcmd

Invoke-Sqlcmd può essere utilizzato per eseguire molti degli script eseguibili tramite l'utilità sqlcmd. Tuttavia, Invoke-Sqlcmd viene eseguito in un ambiente Windows PowerShell, che è diverso dall'ambiente del prompt dei comandi in cui viene eseguito sqlcmd. Il comportamento di Invoke-Sqlcmd è stato modificato per l'utilizzo in un ambiente Windows PowerShell.

Non tutti i comandi sqlcmd sono implementati in Invoke-Sqlcmd. I comandi non implementati includono: :!!, :connect, :error, :out, :ed, :list, :listvar, :reset, :perftrace e :serverlist.

Invoke-Sqlcmd non inizializza l'ambiente o le variabili di scripting sqlcmd, quali SQLCMDDBNAME o SQLCMDWORKSTATION.

Invoke-Sqlcmd non visualizza messaggi come l'output di istruzioni PRINT, a meno che non venga specificato il parametro comune di Windows PowerShell -Verbose. Esempio:

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

Non tutti i parametri sqlcmd sono necessari in un ambiente PowerShell. Ad esempio, Windows PowerShell formatta tutto l'output dei cmdlet, pertanto i parametri sqlcmd che specificano le opzioni di formattazione non vengono implementati in Invoke-Sqlcmd. Nella tabella seguente viene mostrata la relazione tra i parametri Invoke-Sqlcmd e le opzioni sqlcmd:

Vedere anche

Riferimento

Concetti