Get-SqlUpdateStatement

ÜBERSICHT

Generiert ein SQL-UPDATE-Statement für eine Tabelle basierend auf einer Hashtable von Spaltenwerten.

SYNTAX

Get-SqlUpdateStatement [[-Tablename] <string>] [[-Fields] <hashtable>] [[-WhereClause] <string>]
    [[-Conn] <__ComObject>] [<CommonParameters>]

BESCHREIBUNG

Erzeugt ein SQL-UPDATE-Statement anhand von angegebenen Feldwerten für eine spezifische Tabelle. Die Spaltentypen werden automatisch aus der Datenbank abgerufen, um Werte korrekt zu formatieren wie z.B. Zahlen, Strings, Datumswerte usw.

SQL-Funktionen oder Ausdrücke wie z.B. 'dbo.GetDate()' können direkt übergeben werden und werden unverändert in das Statement integriert.

PARAMETER

-Tablename

Type: string

Name der Zieltabelle, für die das UPDATE-Statement erzeugt wird.

-Fields

Type: hashtable

Hashtable mit Feldnamen und deren neuen Werten, die aktualisiert werden sollen.

-WhereClause

Type: string

Bedingung für die WHERE-Klausel des UPDATE-Statements (z.B. "Id = 123").

-Conn

Type: __ComObject

Aktive ADO-Verbindung zur Datenbank, über die Spalteninformationen abgerufen werden.

AUSGABEN

string, void

Gibt ein ausführbares SQL-UPDATE-Statement zurück. Falls keine Felder angegeben wurden, wird ein leerer String zurückgegeben. Im Fehlerfall (z.B. ungültige Verbindung oder fehlende Metadaten) wird `$null` zurückgegeben.

BEISPIELE

# Ergibt z.B.: UPDATE Artikel SET [Preis] = 12.99, [Aktiv] = 1 WHERE Id = 123
$updateSql = Get-SqlUpdateStatement -Tablename "Artikel" -Fields @{Preis=12.99; Aktiv=$true} -WhereClause "Id = 123" -Conn $conn

HINWEISE

• Erfordert die Hilfsfunktionen 'Test-AdoConnection' und 'Get-TableColumnTypes'.
• Textwerte werden automatisch auf die maximal erlaubte Länge gekürzt.