sys.sp_cdc_enable_table (Transact-SQL)

Anwendungsbereich: JaSQL Server (alle unterstützten Versionen)

Aktiviert Change Data Capture für die angegebene Quelltabelle in der aktuellen Datenbank. Wenn eine Tabelle für Change Data Capture aktiviert ist, wird für jeden Vorgang der Datenbearbeitungssprache (Data Manipulation Language, DML), der auf die Tabelle angewendet wird, ein Datensatz in das Transaktionsprotokoll geschrieben. Der Change Data Capture-Prozess ruft diese Informationen aus dem Protokoll ab und schreibt sie in die Änderungstabellen, auf die über eine Reihe von Funktionen zugegriffen wird.

Change Data Capture ist nicht in jeder Edition von MicrosoftSQL Server. Eine Liste der Funktionen, die von den SQL Server-Editionen unterstützt werden, finden Sie unter Von den SQL Server 2016-Editionen unterstützte Funktionen.

Symbol für Themenlink Transact-SQL-Syntaxkonventionen

Syntax

  
sys.sp_cdc_enable_table   
  [ @source_schema = ] 'source_schema',   
  [ @source_name = ] 'source_name' ,  [,[ @capture_instance = ] 'capture_instance' ]  
  [,[ @supports_net_changes = ] supports_net_changes ]  
  , [ @role_name = ] 'role_name'  
  [,[ @index_name = ] 'index_name' ]  
  [,[ @captured_column_list = ] 'captured_column_list' ]  
  [,[ @filegroup_name = ] 'filegroup_name' ]  
  [,[ @allow_partition_switch = ] 'allow_partition_switch' ]  
  [;]  

Argumente

[ @source_schema = ] 'source_schema' Der Name des Schemas, zu dem die Quelltabelle gehört. source_schema ist vom Datentyp sysname, hat keinen Standardwert und darf nicht NULL sein.

[ @source_name = ] 'source_name' Der Name der Quelltabelle, für die Change Data Capture aktiviert werden soll. source_name ist vom Datentyp sysname ohne Standardwert und darf nicht NULL sein.

source_name muss in der aktuellen Datenbank vorhanden sein. Tabellen im cdc-Schema können nicht für Change Data Capture aktiviert werden.

[ @role_name = ] 'role_name' Der Name der Datenbankrolle, mit der der Zugriff zum Ändern von Daten geschlossen wird. role_name ist sysname und muss angegeben werden. Wenn der Parameter explizit auf NULL festgelegt ist, wird keine Gatingrolle verwendet, um den Zugriff auf Änderungsdaten einzuschränken.

Wenn die Rolle derzeit vorhanden ist, wird sie verwendet. Ist die Rolle nicht vorhanden, wird versucht, eine Datenbankrolle mit dem angegebenen Namen zu erstellen. Vor dem Versuch zur Erstellung der Rolle wird der Rollenname um die in der Zeichenfolge rechts befindlichen Leerstellen gekürzt. Wenn der Aufrufer nicht berechtigt ist, Rollen in der Datenbank zu erstellen, tritt bei der gespeicherten Prozedur ein Fehler auf.

[ @capture_instance = ] 'capture_instance' Der Name der Erfassungsinstanz, die zum Benennen instanzspezifischer Change Data Capture-Objekte verwendet wird. capture_instance ist sysname und darf nicht NULL sein.

Wenn kein Name angegeben wird, wird der Name aus dem Namen des Quellschemas plus dem Namen der Quelltabelle im Format schemaname_sourcename. capture_instance darf nicht länger als 100 Zeichen sein und muss innerhalb der Datenbank eindeutig sein. Unabhängig davon, ob angegeben oder abgeleitet, capture_instance Leerraum rechts von der Zeichenfolge abgeschnitten.

Eine Quelltabelle kann maximal zwei Aufzeichnungsinstanzen aufweisen. Weitere Informationen finden Sie unter sys.sp_cdc_help_change_data_capture (Transact-SQL).

[ @supports_net_changes = ] supports_net_changes Gibt an, ob die Unterstützung für abfragen von Nettoänderungen für diese Erfassungsinstanz aktiviert werden soll. supports_net_changes ist bit mit dem Standardwert 1, wenn die Tabelle über einen Primärschlüssel verfügt oder die Tabelle über einen eindeutigen Index verfügt, der mithilfe des -Parameters identifiziert @index_name wurde. Andernfalls hat der Parameter den Standardwert 0.

Bei 0 werden nur die Unterstützungsfunktionen zum Abfragen aller Änderungen generiert.

Bei 1 werden auch die Funktionen generiert, die zum Abfragen der Nettoänderungen erforderlich sind.

Wenn supports_net_changes auf 1 festgelegt ist, index_name angegeben werden, oder die Quelltabelle muss über einen definierten Primärschlüssel verfügen.

[ @index_name = ] 'index_name_' Der Name eines eindeutigen Indexes, der zum eindeutigen Identifizieren von Zeilen in der Quelltabelle verwendet werden soll. index_name ist sysname und kann NULL sein. Wenn angegeben, index_name ein gültiger eindeutiger Index für die Quelltabelle sein. Wenn index_name angegeben wird, haben die identifizierten Indexspalten Vorrang vor allen definierten Primärschlüsselspalten als eindeutiger Zeilenbezeichner für die Tabelle.

[ @captured_column_list = ] 'captured_column_list' Identifiziert die Quelltabellenspalten, die in die Änderungstabelle eingeschlossen werden sollen. captured_column_list ist nvarchar(max) und kann NULL sein. Wenn der Wert NULL ist, werden alle Spalten in der Änderungstabelle eingeschlossen.

Spaltennamen müssen gültige Spalten in der Quelltabelle sein. Spalten, die in einem Primärschlüsselindex definiert sind, oder Spalten, die in einem Index definiert sind, auf den index_name, müssen eingeschlossen werden.

captured_column_list ist eine durch Komma getrennte Liste von Spaltennamen. Einzelne Spaltennamen innerhalb der Liste können optional mit doppelten Anführungszeichen ("") oder eckigen Klammern ([]) angegeben werden. Wenn ein Spaltenname ein eingebettetes Komma enthält, muss er in Anführungszeichen eingeschlossen sein.

captured_column_list dürfen nicht die folgenden reservierten Spaltennamen enthalten: __$start_lsn, __$end_lsn, __$seqval, __$operation und __$update_mask.

[ @filegroup_name = ] 'filegroup_name' Die Dateigruppe, die für die Änderungstabelle verwendet werden soll, die für die Erfassungsinstanz erstellt wird. filegroup_name ist sysname und kann NULL sein. Wenn angegeben, filegroup_name für die aktuelle Datenbank definiert werden. Wenn der Wert NULL ist, wird die Standarddateigruppe verwendet.

Es wird empfohlen, eine separate Dateigruppe für Change Data Capture-Änderungstabellen zu erstellen.

[ @allow_partition_switch = ] 'allow_partition_switch' Gibt an, ob der SWITCH PARTITION-Befehl von ALTER TABLE für eine Tabelle ausgeführt werden kann, die für Change Data Capture aktiviert ist. allow_partition_switch ist bit und hat den Standardwert 1.

Bei nicht partitionierten Tabellen lautet die Schaltereinstellung immer 1, und die tatsächliche Einstellung wird ignoriert. Wenn der Schalter für eine nicht partitionierte Tabelle explizit auf 0 festgelegt ist, wird Warnung 22857 ausgegeben. Dies zeigt an, dass die Schaltereinstellung ignoriert wurde. Wenn der Schalter für eine partitionierte Tabelle explizit auf 0 festgelegt ist, wird die Warnung 22356 ausgegeben. Diese zeigt an, dass SWITCH PARTITION-Vorgänge für die Quelltabelle nicht zulässig sind. Wenn die Schaltereinstellung entweder explizit auf 1 festgelegt und der Standardwert 1 zugelassen und die aktivierte Tabelle partitioniert ist, wird die Warnung 22855 ausgegeben. Diese zeigt an, dass Partitionsschalter nicht blockiert werden. Falls Partitionsschalter auftreten, werden die aus dem Schalter resultierenden Änderungen von Change Data Capture nicht nachverfolgt. Dies führt bei der Nutzung der Änderungsdaten zu Inkonsistenzen.

Wichtig

SWITCH PARTITION ist ein Metadatenvorgang, verursacht jedoch Datenänderungen. Die mit diesem Vorgang verbundenen Datenänderungen werden nicht in den Change Data Capture-Änderungstabellen aufgezeichnet. Beispiel: An einer Tabelle mit drei Partitionen werden Änderungen vorgenommen. Mit dem Aufzeichnungsprozess werden Einfüge-, Update- und Löschvorgänge verfolgt, die Benutzer in der Tabelle ausführen. Wenn jedoch eine Partition in eine andere Tabelle ausgelagert wird (z. B. zur Durchführung einer Massenlöschung), werden die verschobenen Zeilen in der Änderungstabelle nicht als gelöschte Zeilen aufgezeichnet. Wenn der Tabelle eine neue Partition mit vorab ausgefüllten Zeilen hinzugefügt wird, werden diese Zeilen auch nicht in der Änderungstabelle erfasst. Dies kann zu inkonsistenten Daten führen, wenn die Änderungen von einer Anwendung belegt und auf ein Ziel angewendet werden.

Hinweis

Wenn Sie über die aktuelle Version Partitionswechsel für SQL Server 2008 R2 aktivieren, benötigen Sie möglicherweise schon in naher Zukunft auch Teilungs- und Mergevorgänge. Stellen Sie vor dem Ausführen von Teilungs- oder Zusammenführungsvorgängen in replizierten oder CDC-fähigen Tabellen sicher, dass für die fragliche Partition keine replizierten Befehle ausstehen. Sie sollten außerdem sicherstellen, dass für die Partition während der Teilungs- und Mergevorgänge keine DML-Vorgänge ausgeführt werden. Wenn Transaktionen vorhanden sind, die nicht vom Protokollleser oder CDC-Erfassungsauftrag verarbeitet wurden, oder DML-Vorgänge für eine Partition einer replizierten oder CDC-fähigen Tabelle ausgeführt werden, während ein Teilungs- oder Zusammenführungsvorgang stattfindet (an dem die gleiche Partition beteiligt ist), kann das zu einem Verarbeitungsfehler (Fehler 608 – Kein Katalogeintrag für die Partitions-ID gefunden) beim Protokolllese-Agent oder CDC-Erfassungsauftrag führen. Um den Fehler zu beheben, ist möglicherweise eine erneute Initialisierung des Abonnements oder das Deaktivieren von CDC für diese Tabelle oder Datenbank erforderlich.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Keine

Bemerkungen

Bevor Sie eine Tabelle für Change Data Capture aktivieren können, muss die Datenbank aktiviert sein. Um zu bestimmen, ob die Datenbank für Change Data Capture aktiviert ist, fragen Sie die spalte is_cdc_enabled in der sys.databases-Katalogsicht ab. Um die Datenbank zu aktivieren, verwenden Sie die sys.sp_cdc_enable_db gespeicherte Prozedur.

Wenn Change Data Capture für eine Tabelle aktiviert wird, werden eine Änderungstabelle und eine oder zwei Abfragefunktionen generiert. Die Änderungstabelle dient als Repository für die Änderungen der Quelltabelle, die durch den Aufzeichnungsprozess aus dem Transaktionsprotokoll extrahiert wurden. Die Abfragefunktionen werden verwendet, um Daten aus der Änderungstabelle zu extrahieren. Die Namen dieser Funktionen werden wie folgt vom capture_instance-Parameter abgeleitet:

  • Funktion "Alle Änderungen": cdc.fn_cdc_get_all_changes_<capture_instance>

  • Net changes-Funktion: cdc.fn_cdc_get_net_changes_<capture_instance>

sys.sp_cdc_enable_table erstellt auch die Erfassungs- und Bereinigungsaufträge für die Datenbank, wenn die Quelltabelle die erste Tabelle in der Datenbank ist, die für Change Data Capture aktiviert werden soll und keine Transaktionsveröffentlichungen für die Datenbank vorhanden sind. Sie legt die is_tracked_by_cdc in der sys.tables-Katalogsicht auf 1 fest.

Hinweis

Der SQL Server-Agent muss nicht aktiv sein, wenn Change Data Capture für eine Tabelle aktiviert wird. Das Transaktionsprotokoll und in die Änderungstabelle geschriebene Einträge werden jedoch erst vom Aufzeichnungsprozess verarbeitet, wenn der SQL Server-Agent ausgeführt wird.

Berechtigungen

Erfordert die Mitgliedschaft in db_owner festen Datenbankrolle.

Beispiele

A. Aktivieren von Change Data Capture durch das Angeben von nur erforderlichen Parametern

Im folgenden Beispiel wird Change Data Capture für die HumanResources.Employee-Tabelle aktiviert. Nur die erforderlichen Parameter werden angegeben.

USE AdventureWorks2012;  
GO  
EXECUTE sys.sp_cdc_enable_table  
    @source_schema = N'HumanResources'  
  , @source_name = N'Employee'  
  , @role_name = N'cdc_Admin';  
GO  

B. Aktivieren von Change Data Capture durch das Angeben zusätzlicher optionaler Parameter

Im folgenden Beispiel wird Change Data Capture für die HumanResources.Department-Tabelle aktiviert. Alle Parameter außer @allow_partition_switch werden angegeben.

USE AdventureWorks2012;  
GO  
EXEC sys.sp_cdc_enable_table  
    @source_schema = N'HumanResources'  
  , @source_name = N'Department'  
  , @role_name = N'cdc_admin'  
  , @capture_instance = N'HR_Department'   
  , @supports_net_changes = 1  
  , @index_name = N'AK_Department_Name'   
  , @captured_column_list = N'DepartmentID, Name, GroupName'   
  , @filegroup_name = N'PRIMARY';  
GO  

Weitere Informationen

sys.sp_cdc_disable_table (Transact-SQL)
sys.sp_cdc_help_change_data_capture (Transact-SQL)
cdc.fn_cdc_get_all_changes_<capture_instance> (Transact-SQL)
cdc.fn_cdc_get_net_changes_<capture_instance> (Transact-SQL)
sys.sp_cdc_help_jobs (Transact-SQL)