Write-SqlTableData

Syntax

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>]

Beschreibung

Das cmdlet Write-SqlTableData fügt Daten in eine Tabelle einer SQL-Datenbank ein. Dieses Cmdlet akzeptiert die folgenden Eingabetypen für die folgenden Ausgabeformate:

• System.Data.DataSet
• System.Data.DataTable
• System.Data.DateRow-Objekte
• Auflistung von Objekten

Wenn Sie eine DataSet-bereitstellen, wird nur die erste Tabelle im Dataset in die Datenbank geschrieben.

Sie können dieses Cmdlet mit dem Windows PowerShell SQL-Anbieter verwenden.

Dieses Cmdlet kann Informationen wie Server, Datenbank, Schema und Tabelle aus dem aktuellen Pfad ableiten.

Dieses Cmdlet erwartet, dass die Tabelle vorhanden ist. Standardmäßig fügt das Cmdlet Daten an diese Tabelle an.

Wenn Sie den Parameter Force angeben, generiert das Cmdlet fehlende Objekte, die die Datenbank, das Tabellenschema und die Tabelle selbst enthalten. Diese Verwendung ermöglicht eine schnelle Übertragung von Daten in eine Datenbank. Das Cmdlet leitet das Schema der Tabelle aus den Daten ab. Das Ergebnis ist möglicherweise nicht optimal. Beispielsweise werden Zeichenfolgen NVARCHAR(MAX) zugeordnet.

Beispiele

Beispiel 1: Schreiben von Informationen zu Prozessen in eine Tabelle

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

In diesem Beispiel werden Informationen zu Prozessen, die auf einem System ausgeführt werden, in eine Tabelle geschrieben.

Das aktuelle Cmdlet schreibt die Daten in MyServer\MyInstancein MyDatabase.dbo.TaskManagerDump. Da Sie den Parameter Force angeben, wenn die Datenbank, das Schema und die Tabelle nicht vorhanden sind, erstellt dieses Cmdlet diese.

Beispiel 2: Schreiben von Daten in eine Tabelle

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

Der erste Befehl ändert den Speicherort als Speicherort im SQLSERVER-Anbieter. Die Eingabeaufforderung gibt den neuen Speicherort wieder. Geben Sie Get-Help about_Providers ein, um weitere Informationen zu erfahren.

Der letzte Befehl zeigt den Inhalt der $Table Variablen mithilfe des Cmdlets Read-SqlTableData an.

Beispiel 3: Importieren von Daten aus einer Datei in eine Tabelle

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

In diesem Beispiel wird die Dateiaufforderung vollständig ausgeführt. Kontextinformationen können nicht verwendet werden. Daher müssen Sie alle relevanten Parameter angeben.

Beachten Sie die Verwendung des "," vor der Zeile: Dies besteht darin, PowerShell zu erzwingen, den gesamten Inhalt der Datei direkt an das cmdlet Write-SqlTableData zu übergeben, was wiederum ein Masseneinfügevorgang ausführen kann (was eine einfachere Leistung als eine Zeile nach Zeileneinfügung ist)

Beispiel 4: Abrufen von Daten aus einer Instanz und Push in eine Tabelle einer Datenbank in einer anderen Instanz

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

In diesem Beispiel werden Informationen zu Datenbankdateien aus einer Instanz mithilfe des cmdlets Invoke-SqlCmd abgerufen und die resultierenden Zeilen in eine Datenbank in einer anderen Instanz von SQL Server eingefügt. Beachten Sie, dass während dieses Beispiel Daten zwischen Instanzen von SQL Server auf demselben Computer verschiebt, können sich die Instanzen auf zwei vollständig unterschiedlichen Servern befinden.

Beispiel 5: Schreiben von Daten in eine vorhandene Tabelle einer Azure SQL-Datenbank (oder einer beliebigen Datenbank mit SQL Auth)

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

In diesem Beispiel wird gezeigt, wie Sie das cmdlet Write-SqlTableData mit SQL-Authentifizierung verwenden. Der großteil des Codes ist nur ADO.Net und SMO-Textbausteine erforderlich, um das erforderliche Objekt (das SMO Table-Objekt, das die Zieltabelle darstellt) zu erstellen, die über den parameter -InputOject an das Cmdlet übergeben wird.

Beispiel 6: Schreiben (und Lesen) von Daten in eine vorhandene Tabelle einer Azure SQL-Datenbank mithilfe der verwalteten Identität einer Azure-VM.

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
#

Parameter

-AccessToken

-ConnectionTimeout

-ConnectToDatabase

-Credential

-DatabaseName

-Encrypt

-Force

-HostNameInCertificate

-IgnoreProviderContext

-InputData

-InputObject

-Passthru

-Path

-ProgressAction

-SchemaName

-ServerInstance

-SuppressProviderContextWarning

-TableName

-Timeout

-TrustServerCertificate

Eingaben

System.Management.Automation.PSObject

System.String[]

Microsoft.SqlServer.Management.Smo.Table[]

Ähnliche Themen

• Read-SqlTableData