Freigeben über

Bekannte Probleme und Fehler mit CDC

  • Artikel

Gilt für: SQL Server Azure SQL Managed Instance

Dieser Artikel erklärt die bekannten Probleme und Fehler beim Change Data Capture (CDC) in SQL Server und Azure SQL Managed Instance.

Informationen zu Azure SQL-Datenbank finden Sie unter CDC mit der Azure SQL-Datenbank.

Ändern von Metadaten

Damit CDC ordnungsgemäß funktioniert, sollten Sie keine CDC-Metadaten wie z. B. CDC schema, Änderungstabellen, gespeicherte CDC-Systemprozeduren, standardmäßige cdc user-Berechtigungen (sys.database_principals) manuell ändern oder cdc user umbenennen.

Alle Objekte in sys.objects mit is_ms_shipped Eigenschaftensatz 1 sollten nicht geändert werden.

SELECT    name AS object_name   
        ,SCHEMA_NAME(schema_id) AS schema_name  
        ,type_desc  
        ,is_ms_shipped  
FROM sys.objects 
WHERE is_ms_shipped= 1 AND SCHEMA_NAME(schema_id) = 'cdc'

Sortierungsunterschiede

Sie sollten wissen, was zu beachten ist, wenn eine Datenbank und die Spalten einer Tabelle, die für Change Data Capture konfiguriert sind, in unterschiedlicher Reihenfolge sortiert sind. CDC verwendet einen Zwischenspeicher, um Tabellen aufzufüllen. Wenn in einer Tabelle CHAR- oder VARCHAR-Spalten enthalten sind, deren Sortierung von der Datenbanksortierung abweicht, und wenn in diesen Spalten Zeichen enthalten sind, bei denen es sich nicht um ASCII-Zeichen handelt (z.B. Doppelbyte-Zeichensätze), kann CDC möglicherweise die geänderten Daten nicht speichern, damit diese mit den Daten in der Basistabelle übereinstimmen. Dies ist darauf zurückzuführen, dass den Zwischenspeichervariablen keine Sortierungen zugeordnet werden können.

Ziehen Sie einen der folgenden Ansätze in Betracht, um sicherzustellen, dass Change Data Capture-Daten mit den Daten in der Basistabelle übereinstimmen:

  • Verwenden Sie die Datentypen NCHAR oder NVARCHAR für Spalten, die Daten enthalten, bei denen es sich nicht um ASCII-Daten handelt.

  • Stattdessen können Sie auch die Spalten und die Datenbank in derselben Reihenfolge sortieren.

Wenn Sie z.B. über eine Datenbank verfügen, die eine SQL_Latin1_General_CP1_CI_AS-Sortierung verwendet, beachten Sie die folgende Tabelle:

CREATE TABLE T1( 
     C1 INT PRIMARY KEY, 
     C2 VARCHAR(10) collate Chinese_PRC_CI_AI)

CDC kann möglicherweise die Binärdaten für die Spalte C2 nicht speichern, da deren Sortierung von dieser Sortierung abweicht (Chinese_PRC_CI_AI). Verwenden Sie NVARCHAR, um dieses Problem zu vermeiden:

CREATE TABLE T1( 
     C1 INT PRIMARY KEY, 
     C2 NVARCHAR(10) collate Chinese_PRC_CI_AI --Unicode data type, CDC works well with this data type
     )

Beschleunigte Datenbankwiederherstellung (ADR) und Change Data Capure (CDC)

Derzeit wird das Aktivieren der Change Data Capture (CDC) und der beschleunigten Datenbankwiederherstellung (ADR) nicht unterstützt. Wenn Sie Change Data Capture (CDC) in Azure SQL Server aktivieren, ist die aggressive Protokollkürzungsfunktion der ADR deaktiviert. Grund dafür ist, dass der CDC-Scan auf das Datenbanktransaktionsprotokoll zugreift. Aktive Transaktionen blockieren weiterhin die Transaktionsprotokollkürzung, bis die Transaktion committet wird und der CDC-Scan aufholt oder die Transaktion abgebrochen wird. Dies kann zu verschiedenen Problemen führen, z. B. dazu, dass sich das Transaktionsprotokoll mehr als üblich füllt oder dass die in der Seitentabelle aufgezeichneten Datenoperationen anormal sind.

Beim Aktivieren von CDC empfehlen wir die Verwendung der Option „Fortsetzbarer Index“. Bei einem wiederaufnehmbaren Index muss keine lang laufende Transaktion geöffnet bleiben, um einen Index zu erstellen oder neu aufzubauen, so dass das Protokoll während dieses Vorgangs gekürzt werden kann und der Speicherplatz im Protokoll besser verwaltet wird. Weitere Informationen finden Sie unter Richtlinien für Onlineindexvorgänge – Überlegungen zu fortsetzbaren Indizes.

Das Aktivieren von CDC schlägt fehl, wenn das Schema oder der benannte cdc-Benutzer bereits vorhanden ist

Wenn Sie CDC für eine Datenbank aktivieren, wird ein neues Schema und ein Benutzer mit dem Namen cdc erstellt. Das manuelle Erstellen eines benutzerdefinierten Schemas oder eines benannten cdc-Benutzers wird daher nicht empfohlen, da es für die Systemverwendung reserviert ist.

Wenn Sie in Ihrer Datenbank manuell ein benutzerdefiniertes Schema oder einen Benutzer mit dem Namen cdc definiert haben, das bzw. der nicht mit CDC verbunden ist, schlägt die gespeicherte Systemprozedur sys.sp_cdc_enable_db bei der Aktivierung von CDC in der Datenbank mit der folgenden Fehlermeldung fehl.

Die Datenbank <database_name> kann nicht für die Erfassung von Änderungsdaten aktiviert werden, da ein Datenbankbenutzer namens 'cdc' oder ein Schema namens 'cdc' bereits in der aktuellen Datenbank existiert. Diese Objekte sind exklusiv für CDC erforderlich. Löschen Sie den Benutzer bzw. das Schema, oder benennen Sie ihn bzw. es um, und wiederholen Sie den Vorgang.

So beheben Sie dieses Problem:

  • Löschen Sie das leere cdc-Schema und den leeren cdc-Benutzer manuell. Anschließend kann CDC erfolgreich in der Datenbank aktiviert werden.

CDC schlägt nach ALTER COLUMN zu VARCHAR und VARBINARY fehl

Wenn der Datentyp einer Spalte in einer CDC-fähigen Tabelle von TEXT VARCHAR oder IMAGE zu VARBINARY einer vorhandenen Zeile geändert wird, und eine vorhandene Zeile auf einen Off-Row-Wert aktualisiert wird. Nach dem Update führt der CDC-Scan zu Fehlern.

DDL-Änderungen an Quelltabellen

Wenn Sie die Größe von Spalten einer CDC-fähigen Tabelle mit Hilfe von DDL-Anweisungen ändern, kann dies zu Problemen beim anschließenden CDC-Capture-Prozess führen, was zu Fehler 2628 oder Fehler 8115 führt. Denken Sie daran, dass Daten in CDC-Änderungstabellen basierend auf den vom Benutzer konfigurierten Einstellungen aufbewahrt werden. Bevor Sie also Änderungen an der Spaltengröße vornehmen, müssen Sie prüfen, ob die Änderung mit den vorhandenen Daten in CDC-Änderungstabellen kompatibel ist.

Wenn sys.dm_cdc_errors darauf hinweist, dass Scans aufgrund des Fehlers 2628 oder des Fehlers 8115 für Änderungstabellen fehlschlagen, sollten Sie zunächst die Änderungsdaten in den betroffenen Änderungstabellen verbrauchen. Danach müssen Sie CDC in der Tabelle deaktivieren und dann wieder aktivieren, um das Problem effektiv zu beheben.

Importieren einer Datenbank mithilfe von Datenansicht-Import-/Export- und Extraktions-/Veröffentlichungsvorgängen

Wenn Sie für CDC-fähige SQL-Datenbanken SqlPackage, SSDT oder andere SQL-Tools zum Importieren/Exportieren oder Extrahieren/Publizieren verwenden, werden das Schema cdc und der Benutzer in der neuen Datenbank ausgeschlossen. Andere CDC-Objekte, die nicht in Import-/Export- und Extract-/Bereitstellung-Vorgängen enthalten sind, sind die Tabellen, die als is_ms_shipped=1 "sys.objects" gekennzeichnet sind.

Selbst wenn CDC nicht aktiviert ist und Sie ein benutzerdefiniertes Schema oder einen in Ihrer Datenbank benannten cdc Benutzer definiert haben, der auch in Import-/Export- und Extract-/Bereitstellungs-Vorgängen ausgeschlossen wird, um eine neue Datenbank zu importieren/einzurichten.

Partitionswechsel mit Variablen

Das Verwenden von Variablen mit Partitionswechsel für Datenbanken oder Tabellen mit Change Data Capture (CDC) wird für die ALTER TABLE ... SWITCH TO ... PARTITION ...-Anweisung nicht unterstützt. Weitere Informationen finden Sie unter Einschränkungen zu Partitionswechseln.

Behebung von Fehlern

In diesem Abschnitt erfahren Sie, wie Sie Fehler in Zusammenhang mit CDC auf SQL Server und Azure SQL Managed Instance beheben können. Fehler im Zusammenhang mit CDC können die ordnungsgemäße Funktion des Erfassungsprozesses behindern und zur Vergrößerung des Datenbanktransaktionsprotokolls führen.

Um diese Fehler zu untersuchen, können Sie die dynamische Verwaltungssicht sys.dm_cdc_errors abfragen. Wenn die dynamische Verwaltungsansicht sys.dm_cdc_errors einen Fehler zurückgibt, lesen Sie den folgenden Abschnitt, um zu erfahren, wie Sie den Fehler beheben können.

Hinweis

Weitere Informationen zu einem bestimmten Fehlercode finden Sie unter Ereignisse und Fehler der Datenbank-Engine.

Dies sind die verschiedenen Problembehandlungskategorien, die in diesem Abschnitt enthalten sind:

Category Beschreibung
Metadaten geändert Enthält Informationen zum Ausgleich von Problemen im Zusammenhang mit CDC, wenn die nachverfolgte Tabelle geändert oder abgelegt wurde.
Datenbankspeicherplatzverwaltung Enthält Informationen zum Ausgleich von Problemen, wenn der Datenbankspeicher ausgelastet wurde.
CDC-Einschränkung Enthält Informationen zum Ausgleich von Problemen, die durch CDC-Einschränkungen verursacht werden.

Metadaten geändert

Fehler 200/208: Ungültiger Objektname

  • Ursache: Der Fehler kann auftreten, wenn CDC-Metadaten abgelegt wurden. Damit CDC ordnungsgemäß funktioniert, sollten Sie keine CDC-Metadaten wie z. B. CDC schema, Änderungstabellen, gespeicherte CDC-Systemprozeduren, standardmäßige cdc user-Berechtigungen (sys.database_principals) manuell ändern oder cdc user umbenennen.

  • Empfehlung: Um dieses Problem zu beheben, müssen Sie CDC für Ihre Datenbank deaktivieren und erneut aktivieren. Wenn Sie Change Data Capture für eine Datenbank aktivieren, werden das cdc-Schema, der cdc-Benutzer, Metadatentabellen und andere Systemobjekte für die Datenbank erstellt.

Hinweis

Objekte, die in der Systemkatalogsicht sys.objects mit is_ms_shipped=1 und schema_name='cdc' gefunden werden, dürfen nicht geändert oder gelöscht werden.

Fehler 1202 – Datenbankprinzipal ist nicht vorhanden, oder der Benutzer ist kein Mitglied

  • Ursache: Der Fehler kann auftreten, wenn der CDC-Benutzer abgelegt wurde. Damit CDC ordnungsgemäß funktioniert, sollten Sie keine CDC-Metadaten wie z. B. CDC schema, Änderungstabellen, gespeicherte CDC-Systemprozeduren, standardmäßige cdc user-Berechtigungen (sys.database_principals) manuell ändern oder cdc user umbenennen.

  • Empfehlung: Stellen Sie sicher, dass der cdc-Benutzer in Ihrer Datenbank vorhanden ist und ihm außerdem die Rolle db_owner zugewiesen ist. Informationen zum Erstellen des cdc-Benutzers finden Sie im Beispiel Erstellen des CDC-Benutzers und Zuweisen einer Rolle.

Fehler 15517 – Ausführen als Datenbankprinzipal nicht möglich, da der Prinzipal nicht vorhanden ist

  • Ursache: Dieser Prinzipaltyp kann nicht per Identitätswechsel imitiert werden, oder Sie besitzen keine Berechtigung. Der Fehler kann auftreten, wenn CDC-Metadaten abgelegt wurden oder nicht mehr Teil der Rolle db_owner sind. Damit CDC ordnungsgemäß funktioniert, sollten Sie keine CDC-Metadaten wie z. B. CDC schema, Änderungstabellen, gespeicherte CDC-Systemprozeduren, standardmäßige cdc user-Berechtigungen (sys.database_principals) manuell ändern oder cdc user umbenennen.

  • Empfehlung: Stellen Sie sicher, dass der cdc-Benutzer in Ihrer Datenbank vorhanden ist und ihm außerdem die Rolle db_owner zugewiesen ist. Informationen zum Erstellen des cdc-Benutzers finden Sie im Beispiel Erstellen des CDC-Benutzers und Zuweisen einer Rolle.

Fehler 18807 – Für die Replikationssystemtabelle wurde keine Objekt-ID gefunden

  • Ursache: Dieser Fehler tritt auf, wenn SQL Server die Replikationssystemtabelle „%s“ nicht finden oder nicht darauf zugreifen kann. Dies kann darauf zurückzuführen sein, dass die Tabelle fehlt oder nicht erreichbar ist. Damit CDC ordnungsgemäß funktioniert, sollten Sie keine CDC-Metadaten wie z. B. CDC schema, Änderungstabellen, gespeicherte CDC-Systemprozeduren, standardmäßige cdc user-Berechtigungen (sys.database_principals) manuell ändern oder cdc user umbenennen.

  • Empfehlung Stellen Sie sicher, dass die Systemtabelle vorhanden ist und darauf zugegriffen werden kann, indem Sie die Tabelle direkt abfragen. Fragen Sie den Systemkatalog sys.objects ab, legen Sie die Prädikatklausel mit is_ms_shipped=1 und schema_name='cdc' fest, um alle CDC-bezogenen Objekte aufzulisten. Wenn die Abfrage keine Objekte zurückgibt, sollten Sie CDC für Ihre Datenbank deaktivieren und erneut aktivieren. Wenn Sie Change Data Capture für eine Datenbank aktivieren, werden das cdc-Schema, der cdc-Benutzer, Metadatentabellen und andere Systemobjekte für die Datenbank erstellt.

Fehler 21050 – Nur Mitglieder der festen Serverrolle „sysadmin“ oder „db_owner“ können diesen Vorgang ausführen.

  • Ursache: Der cdc-Benutzer wurde aus der Datenbankrolle db_owner oder der Serverrolle sysadmin entfernt.

  • Empfehlung: Stellen Sie sicher, dass dem cdc-Benutzer die Rolle db_owner zugewiesen ist. Informationen zum Erstellen des cdc-Benutzers finden Sie im Beispiel Erstellen des CDC-Benutzers und Zuweisen einer Rolle.

Datenbankspeicherplatzverwaltung

Fehler 1105 – Speicherplatz für das Objekt in der Datenbank konnte nicht zugeordnet werden, da die Dateigruppe voll ist

  • Ursache: Dieser Fehler tritt auf, wenn die primäre Dateigruppe einer Datenbank nicht genügend Speicherplatz aufweist und SQL Server innerhalb dieser Dateigruppe keinen weiteren Speicherplatz für ein Objekt (z. B. eine Tabelle oder einen Index) zuweisen kann.

  • Empfehlung: Um dieses Problem zu beheben, löschen Sie alle nicht benötigten Daten in Ihrer Datenbank, um Speicherplatz freizugeben. Identifizieren Sie nicht verwendete Tabellen, Indizes oder andere Objekte in der Dateigruppe, die sicher entfernt werden können. Überwachen Sie die Speicherplatznutzung genau. Weitere Informationen finden Sie unter Verwalten von Dateispeicherplatz für Datenbanken in Azure SQL-Datenbank.

    Falls das Ablegen unnötiger Daten/Objekte keine Option ist, sollten Sie mehr Speicherplatz für Ihr Datenbank-Transaktionsprotokoll zuordnen. Weitere Informationen zur Verwaltung des Transaktionsprotokolls finden Sie im SQL Server Leitfaden zur Architektur und Verwaltung des Transaktionsprotokolls

CDC-Einschränkung

Fehler 2628 – Zeichenfolgen- oder Binärdaten würden in der Tabelle abgeschnitten.

  • Ursache: Das Ändern der Größe von Spalten einer CDC-fähigen Tabelle mithilfe von DDL-Anweisungen kann zu Problemen mit dem nachfolgenden CDC-Captureprozess führen. Die dynamische Verwaltungsansicht (Dynamic Management View, DMV) 'sys.dm_cdc_errors' ist nützlich, um CDC auf gemeldete Probleme zu überprüfen, z. B. Fehlernummer 2628 und 8115.

  • Empfehlung: Bevor Sie Änderungen an der Spaltengröße vornehmen, müssen Sie prüfen, ob die Änderung mit den vorhandenen Daten in CDC-Änderungstabellen kompatibel ist. Um dieses Problem zu beheben, müssen Sie CDC für Ihre Datenbank deaktivieren und erneut aktivieren. Weitere Informationen zur Aktivierung von CDC für eine Datenbank oder eine Tabelle finden Sie unter CDC für eine Datenbank aktivieren und CDC für eine Tabelle aktivieren.

Fehler 913 – CDC-Erfassungsjob schlägt beim Verarbeiten von Änderungen für eine Tabelle mit CLR-Systemdatentyp fehl.

  • Ursache: Dieser Fehler tritt auf, wenn CDC für eine Tabelle mit dem CLR-Systemdatentyp aktiviert wird, DML-Änderungen durchgeführt und dann DDL-Änderungen an derselben Tabelle vorgenommen werden, während der CDC-Erfassungsauftrag Änderungen verarbeitet, die sich auf andere Tabellen beziehen.

  • Empfehlung: Führen Sie die folgenden Schritte aus: legen Sie DML für die Tabelle still, führen Sie einen Erfassungsauftrag zum Verarbeiten von Änderungen aus, führen Sie DDL für die Tabelle aus, führen Sie einen Erfassungsauftrag zum Verarbeiten von DDL-Änderungen aus, und aktivieren Sie dann die DML-Verarbeitung erneut. Weitere Informationen finden Sie unter CDC-Erfassungsauftrag schlägt beim Verarbeiten von Änderungen fehl.

Erstellen eines Benutzers und Zuweisen einer Rolle

Wenn der cdc user entfernt wurde, können Sie den Benutzer manuell wieder hinzufügen.

Verwenden Sie das folgende T-SQL-Skript, um einen Benutzer (cdc) zu erstellen und die richtige Rolle für diesen zuzuweisen (db_owner).

IF NOT EXISTS 
(
    SELECT * 
    FROM sys.database_principals 
    WHERE NAME = 'cdc'
)
BEGIN
    CREATE USER [cdc] 
    WITHOUT LOGIN WITH DEFAULT_SCHEMA = [cdc];
END

EXEC sp_addrolemember 'db_owner', 'cdc';

Überprüfen und Hinzufügen der Rollenmitgliedschaft

Führen Sie die folgende T-SQL-Abfrage aus, um zu überprüfen, ob der cdc-Benutzer der Rolle sysadmin oder db_owner angehört:

EXECUTE AS USER = 'cdc';

SELECT is_srvrolemember('sysadmin'), is_member('db_owner');

Wenn der cdc-Benutzer keiner dieser Rollen angehört, führen Sie die folgende T-SQL-Abfrage aus, um dem cdc-Benutzer die Rolle db_owner hinzuzufügen.

EXEC sp_addrolemember 'db_owner' , 'cdc';

Nächste Schritte