Write-SqlTableData

Sintassi

Write-SqlTableData
     [-Force]
     -InputData <PSObject>
     [-Passthru]
     [-Timeout <Int32>]
     [[-Path] <String[]>]
     [-AccessToken <PSObject>]
     [-TrustServerCertificate]
     [-HostNameInCertificate <String>]
     [-Encrypt <String>]
     [-ProgressAction <ActionPreference>]
     [<CommonParameters>]

Write-SqlTableData
     [-DatabaseName <String>]
     [-SchemaName <String>]
     [-TableName <String>]
     [-IgnoreProviderContext]
     [-SuppressProviderContextWarning]
     [-Force]
     -InputData <PSObject>
     [-Passthru]
     [-Timeout <Int32>]
     [-ConnectToDatabase]
     [[-ServerInstance] <String[]>]
     [-Credential <PSCredential>]
     [-ConnectionTimeout <Int32>]
     [-AccessToken <PSObject>]
     [-TrustServerCertificate]
     [-HostNameInCertificate <String>]
     [-Encrypt <String>]
     [-ProgressAction <ActionPreference>]
     [<CommonParameters>]

Write-SqlTableData
     [-Force]
     -InputData <PSObject>
     [-Passthru]
     [-Timeout <Int32>]
     [-InputObject] <Table[]>
     [-AccessToken <PSObject>]
     [-TrustServerCertificate]
     [-HostNameInCertificate <String>]
     [-Encrypt <String>]
     [-ProgressAction <ActionPreference>]
     [<CommonParameters>]

Descrizione

Il cmdlet write-SqlTableData inserisce i dati in una tabella di un database SQL. Questo cmdlet accetta i tipi di input seguenti i formati di output seguenti:

• System.Data.DataSet
• System.Data.DataTable
• Oggetti System.Data.DateRow
• Raccolta di oggetti

Se si specifica un DataSet, nel database viene scritta solo la prima tabella del set di dati.

È possibile usare questo cmdlet con il provider SQL di Windows PowerShell.

Questo cmdlet può dedurre informazioni quali server, database, schema e tabella dal percorso corrente.

Questo cmdlet prevede che la tabella esista. Per impostazione predefinita, il cmdlet aggiunge i dati a tale tabella.

Se si specifica il parametro Force, il cmdlet genera oggetti mancanti, che includono il database, lo schema della tabella e la tabella stessa. Questo utilizzo consente il trasferimento rapido dei dati in un database. Il cmdlet deduce lo schema della tabella dai dati. Il risultato potrebbe non essere ottimale. Ad esempio, le stringhe vengono mappate a NVARCHAR(MAX).

Esempio

Esempio 1: Scrivere informazioni sui processi in una tabella

PS C:\> (Get-Process | Select-Object -Property Id,ProcessName,StartTime,UserProcessorTime,WorkingSet,Description) |
         Write-SqlTableData -ServerInstance "MyServer\MyInstance" -DatabaseName "MyDatabase" -SchemaName "dbo" -TableName "TaskManagerDump" -Force

Questo esempio ottiene informazioni sui processi eseguiti in un sistema e lo scrive in una tabella.

Il cmdlet corrente scrive i dati in MyDatabase.dbo.TaskManagerDump in MyServer\MyInstance. Poiché si specifica il parametro Force, se il database, lo schema e la tabella non esistono, questo cmdlet li crea.

Esempio 2: Scrivere dati in una tabella

PS C:\> cd SQLSERVER:\SQL\MyServer\MyInstance\Databases\MyDatabase\Tables
PS SQLSERVER:\SQL\MyServer\MyInstance\Databases\MyDatabase\Tables> $Table = Write-SqlTableData -TableName "KeyValuePairs" -SchemaName "dbo" -InputData @{ cca=10; cac='Hello'; aac=1.2 } -PassThru
PS SQLSERVER:\SQL\MyServer\MyInstance\Databases\MyDatabase\Tables> Read-SqlTableData -InputObject $Table

WARNING: Using provider context. Server = MyServer\MyInstance, Database = [MyDatabase]. 

Key Value
--- -----
aac   1.2
cac Hello
cca    10

Il primo comando modifica il percorso in modo che sia un percorso nel provider SQLSERVER. Il prompt dei comandi riflette il nuovo percorso. Per altre informazioni, digitare Get-Help about_Providers.

Il comando finale visualizza il contenuto della variabile $Table usando il cmdlet Read-SqlTableData.

Esempio 3: Importare dati da un file in una tabella

PS C:\> ,(Import-Csv -Path ".\a.csv" -Header "Id","Name","Amount") | Write-SqlTableData -ServerInstance "MyServer\MyInstance" -DatabaseName "MyDatabase" -SchemaName "dbo" -TableName "CSVTable" -Force
PS C:\> Read-SqlTableData -ServerInstance "MyServer\MyInstance" -DatabaseName "MyDatabase" -SchemaName "dbo" -TableName "CSVTable"

Id Name  Amount
-- ----  ------
10 AAAA  -1.2
11 BBBB   1.2
12 CCCC  -1.0

The first command imports the contents of a file by using the Import-Csv cmdlet. The file contains the following content:
    
10,AAAA,-1.2
11,BBBB,1.2
12,CCCC,-1.0

Questo esempio viene eseguito completamente dal prompt dei file. Non può usare le informazioni di contesto. Pertanto, è necessario specificare tutti i parametri pertinenti.

Si noti l'uso di "," davanti alla riga: si tratta di forzare PowerShell a passare l'intero contenuto del file direttamente al cmdlet write-SqlTableData, che a sua volta può eseguire un inserimento bulk (che è il modo più efficiente di una riga per inserimento di riga)

Esempio 4: Recuperare dati da un'istanza e eseguire il push alla tabella di un database in un'altra istanza

PS C:\> (Invoke-Sqlcmd -query "SELECT @@SERVERNAME AS 'ServerName', DB_NAME(dbid) AS 'Database',
                              name, CONVERT(BIGINT, size) * 8 AS 'size_in_kb', filename
                              FROM master..sysaltfiles" `
   -ServerInstance MyServer\MyInstance -database master -OutputAs DataTables) |
   Write-SqlTableData -ServerInstance MyServer\MyOtherInstance -Database ServerStats -SchemaName dbo -TableName DatabasesSizes -Force

Questo esempio ottiene informazioni sulle dimensioni dei file di database da un'istanza usando il cmdlet Invoke-SqlCmd e inserisce le righe risultanti in un database in un'istanza diversa di SQL Server. Si noti che mentre questo esempio sposta i dati tra istanze di SQL Server nello stesso computer, le istanze potrebbero trovarsi in due server completamente diversi.

Esempio 5: Scrivere dati in una tabella esistente di un database SQL di Azure (o in qualsiasi database usando l'autenticazione SQL)

Import-Module SqlServer

# Set your connection string to Azure SQL DB.
# If your server is not in Azure, just tweak the 'Data Source' field to point to your server.
# Warning: putting clear text passwords in your scripts is highly discoraged, so instead
# of using "User ID" and "Password" in the connection string, we prompt for the credentials.
$cred = Get-Credential -Message "Enter your SQL Auth credentials"
$cred.Password.MakeReadOnly()

# Get access to the SMO Server object.
$srv = Get-SqlInstance -ServerInstance "<your_server_name>.database.windows.net" -Credential $cred

# Get access to table 'MyTable1' on database 'MyDB'.
# Note: both objects are assumed to exists already.
$db = $srv.Databases["MyDB"]
$table = $db.Tables["MyTable1"]

# Write the first 4 integers into the table.
# Note: 'MyTable1' has a column 'Col1' of type 'int'
Write-SqlTableData -InputData (1..4) -InputObject $table

# Now, we read the data back to verify all went ok.
Read-SqlTableData -InputObject $table

# Output:
#
# Col1
# ----
#   1
#   2
#   3
#   4

Questo esempio illustra come usare il cmdlet Write-SqlTableData con l'autenticazione SQL. La maggior parte del codice è solo ADO.Net e SMO boilerplate necessario per creare l'oggetto necessario (l'oggetto SMO Table che rappresenta la tabella di destinazione) che viene passato al cmdlet tramite il parametro -InputOject.

Esempio 6: Scrivere (e leggere) dati in una tabella esistente di un database SQL di Azure usando l'identità gestita di una macchina virtuale di Azure.

Import-Module Az.Accounts,SQLServer

# Change these 3 variables to match your configuration.
# The example assumes you have a SQL Azure DB with the AdventureWorksLT sample DB on server sql-240627023957.
$Server = 'sql-240627023957.database.windows.net'
$Database = 'AdventureWorksLT'

# Connect to Azure using the system managed identify of the Azure VM this script is running on...
Add-AzAccount -Identity

# ... and fetch an access token to get to the DB.
$AccessToken = (Get-AzAccessToken -ResourceUrl 'https://database.windows.net').Token

# The assumption here is that the Microsoft Entra Admin on the server granted access
# to the managed identity of the VM by running something like:
#   CREATE USER [<Name of the VM>] FROM EXTERNAL PROVIDER
#   ALTER ROLE db_owner ADD MEMBER [<Name of the VM>]
# on the database ($Database).

# Insert a new record into the SalesLT.ProductDescription table
# Note that we are using -ConnectToDatabase to connect directly to the database, since it is unlikely for the
# managed identity of the VM to have access to anything but such database.
Write-SqlTableData -ServerInstance $Server -Database $Database -AccessToken $AccessToken -SchemaName SalesLT -TableName ProductDescription -InputData @{ Description = 'Hello SQLServer' } -ConnectToDatabase

# Confirm that the new record was successfully added
# Note that -ConnectToDatabase it not necessary in this case, as the connection if done directly to the database.
Read-SqlTableData -ServerInstance $Server -Database $Database -AccessToken $AccessToken -SchemaName SalesLT -TableName ProductDescription -OrderBy ModifiedDate -TopN 1 -ColumnOrderType DESC

# Output:
#
# ProductDescriptionID Description     rowguid                              ModifiedDate
# -------------------- -----------     -------                              ------------
#                 2011 Hello SQLServer f5f43821-aacd-4748-9d14-4a525c6a036b 6/30/2024 10:19:26 AM
#

Parametri

-AccessToken

-ConnectionTimeout

-ConnectToDatabase

-Credential

-DatabaseName

-Encrypt

-Force

-HostNameInCertificate

-IgnoreProviderContext

-InputData

-InputObject

-Passthru

-Path

-ProgressAction

-SchemaName

-ServerInstance

-SuppressProviderContextWarning

-TableName

-Timeout

-TrustServerCertificate

Input

System.Management.Automation.PSObject

System.String[]

Microsoft.SqlServer.Management.Smo.Table[]

Collegamenti correlati

• Read-SqlTableData