Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für:
SQL Server 2025 (17.x) Azure SQL-Datenbank
Fügt der Stream-Gruppe für die Change Event Streaming (CES)- Funktion ein Objekt (also eine Tabelle) hinzu, die in SQL Server 2025 (17.x) und Azure SQL-Datenbank eingeführt wurde.
Hinweis
Das Change Event Streaming befindet sich derzeit in der Vorschau und weist Unterschiede in der Unterstützbarkeit zwischen den Produkten auf. Während der Vorschau kann dieses Feature geändert werden.
Transact-SQL-Syntaxkonventionen
Syntax
sys.sp_add_object_to_event_stream_group
[ @stream_group_name = ] N'stream_group_name'
, [ @object_name = ] N'schema_name_dot_object_name'
[ , [ @include_all_columns = ] include_all_columns ]
[ , [ @include_old_values = ] include_old_values ]
[ , [ @include_old_lob_values = ] include_old_lob_values ]
[ ; ]
Argumente
[ @stream_group_name = ] N'stream_group_name'
Gibt den Namen der Ereignisdatenstromgruppe an, der Sie die Tabelle hinzufügen möchten.
@stream_group_name ist "sysname" ohne Standard und kann nicht sein NULL.
[ @object_name = ] N'schema_name_dot_object_name'
Gibt den Namen der Tabelle an, die Sie als Teil der angegebenen Datenstromgruppe streamen möchten.
@object_name ist nvarchar(512) ohne Standard und kann nicht sein NULL.
Hinweis
Derzeit werden nur Tabellen unterstützt. Das Konfigurieren von CES für Ansichten führt zu einem Fehler.
Verwenden Sie einen zweiteiligen Namen für die Spalte, die sowohl den Schemanamen als auch den Spaltennamen enthält. Beispielsweise ist dbo.Addressesein gültiger Wert .
[ @include_all_columns = ] include_all_columns
Definiert, welche Spalten in die Nutzlast der Nachricht einbezogen werden sollen, die die an der angegebenen Tabelle vorgenommenen Änderungen streamt.
@include_all_columns ist Bit und muss einer der folgenden Werte sein:
| Wert | BESCHREIBUNG |
|---|---|
1 (Standardwert) |
Enthält alle Spalten innerhalb der Nutzlast der Nachricht, die die an der angegebenen Tabelle vorgenommenen Änderungen streamt. |
0 |
Enthält nur Spalten, die sich innerhalb der Nutzlast der Nachricht geändert haben, die die an der angegebenen Tabelle vorgenommenen Änderungen streamen. |
[ @include_old_values = ] include_old_values
Wenn angegeben, bestimmt @include_old_values , ob alte Werte in die Nutzlast der Nachricht aufgenommen werden, die die Änderungen an der angegebenen Tabelle streamt.
@include_old_values ist Bit und muss einer der folgenden Werte sein:
| Wert | BESCHREIBUNG |
|---|---|
1 (Standardwert) |
Enthält alte Werte innerhalb der Nutzlast der Nachricht, die die an der angegebenen Tabelle vorgenommenen Änderungen streamt. |
0 |
Überspringt alte Werte innerhalb der Nutzlast der Nachricht, die die an der angegebenen Tabelle vorgenommenen Änderungen streamt. |
Alte Werte sind die Werte der Spalte, bevor die Änderung vorgenommen wurde. Wenn beispielsweise eine Zeile aktualisiert wird, sind die alten Werte die Werte der Spalten vor der Aktualisierung.
[ @include_old_lob_values = ] include_old_lob_values
Bestimmt, ob alte geänderte Werte für große Objekte (LOB) in der Nutzlast der Nachricht enthalten sind, die die an der angegebenen Tabelle vorgenommenen Änderungen streamt.
@include_old_lob_values ist Bit und muss einer der folgenden Werte sein:
| Wert | BESCHREIBUNG |
|---|---|
1 |
Enthält alle Spalten innerhalb der Nutzlast der Nachricht, die die an der angegebenen Tabelle vorgenommenen Änderungen streamt. |
0 (Standardwert) |
Enthält nur Spalten, die sich innerhalb der Nutzlast der Nachricht geändert haben, die die an der angegebenen Tabelle vorgenommenen Änderungen streamen. |
Alte Werte sind die Werte der Spalte, bevor die Änderung vorgenommen wurde. Wenn beispielsweise eine Zeile aktualisiert wird, sind die alten Werte die Werte der Spalten vor der Aktualisierung.
Rückgabecodewerte
0 (erfolgreich) oder 1 Fehler.
Erlaubnisse
Ein Benutzer mit CONTROL Datenbankberechtigungen, db_owner Datenbankrollenmitgliedschaft oder sysadmin-Serverrollenmitgliedschaft kann dieses Verfahren ausführen.