Openflow Connector for SQL Server: Verwaltung¶

Bemerkung

Dieser Connector unterliegt den `Nutzungsbedingungen für Snowflake Connector<https://www.snowflake.com/legal/snowflake-connector-terms/>`_.

Unter diesem Thema werden Hinweise zur Wartung und Best Practices für den Openflow Connector for SQL Server erläutert, z. B. das Neuinstallieren des Konnektors oder Festlegen der Startposition der Änderungsverfolgung.

Diese Operationen werden oft in Verbindung mit Inkrementeller Replikation mit Snapshots verwendet.

Konnektor erneut installieren¶

In diesem Abschnitt finden Sie eine Anleitung, wie Sie den Konnektor neu installieren und weiterhin Daten für dieselben Tabellen replizieren können, ohne erneut Snapshots erstellen zu müssen. Dies deckt Situationen ab, in denen der neue Konnektor in derselben Laufzeitumgebung installiert wird oder wenn er in eine neue Laufzeitumgebung verschoben wird.

Voraussetzungen¶

Überprüfen und notieren Sie die Kontextwerte der Konnektorparameter. Wenn Sie den Konnektor in derselben Laufzeit neu installieren, können Sie den vorhandenen Kontext wiederverwenden. Wenn sich die neue Instanz in einer anderen Laufzeitumgebung befindet, müssen Sie alle Parameter neu eingeben.

Schließen Sie die Verarbeitung aller in Übertragung befindlichen FlowFiles im bestehenden Konnektor ab und stoppen Sie dann den Konnektor.
1. Melden Sie sich bei Snowsight an.
2. Wählen Sie im Navigationsmenü die Option Ingestion » Openflow aus.
3. Wählen Sie im Bereich Openflow die Registerkarte Runtimes aus.
4. Wählen Sie die Laufzeitumgebung aus, die den Konnektor enthält.
5. Wählen Sie den Konnektor aus.
6. Stoppen Sie den obersten Prozessor Set Tables for Replication in der Gruppe Snapshot Load.
7. Stoppen Sie den obersten Prozessor Read SQLServer Change Tracking tables in der Gruppe Incremental Load.
8. Wenn Sie den Wert des Parameters Merge Task Schedule CRON geändert haben, geben Sie ihn an * * * * * ? zurück, andernfalls werden die Warteschlangen erst bei der nächsten geplanten Ausführung geleert.
  
  Warten Sie, bis alle FlowFiles im Konnektor verarbeitet wurden und alle Warteschlangen leer sind. Wenn alle FlowFiles verarbeitet wurden, wird der Wert Queued für die Prozessorgruppe des Konnektors zu Null. Wenn sich noch Elemente in den Warteschlangen des ursprünglichen Konnektors befinden, kann es beim Starten des neuen Konnektors zu Datenlücken kommen.
9. Stoppen Sie alle Prozessoren und Controller-Dienste im Konnektor.
Vorsicht

Der bestehende Konnektor kann in der Laufzeit verbleiben und beeinträchtigt die neue Instanz nicht, solange sie angehalten bleibt.
Erstellen Sie eine neue Instanz des Konnektors. Wenn Sie dieselbe Laufzeitumgebung wie der ursprüngliche Konnektor verwenden, können Sie die vorhandenen Parameterkontexte beibehalten und die Einstellungen wiederverwenden.
Wenn Sie in eine andere Laufzeitumgebung installieren oder die vorherigen Parameterkontexte gelöscht haben, geben Sie die Konfigurationseinstellungen in die neuen Parameterkontexte ein, einschließlich der Tabellennamen und Muster, wie unter Einrichten von Openflow Connector for SQL Server beschrieben.
Navigieren Sie zum SQLServer Ingestion Parameters-Kontext, und legen Sie die folgenden Parameter fest:
- Setzen Sie den Parameter Ingestion Type auf incremental. Weitere Informationen dazu finden Sie unter Aktivieren der inkrementellen Replikation ohne Snapshots.
- Setzen Sie den Parameter Starting Change Tracking Position auf Earliest. Weitere Informationen dazu finden Sie unter Geben Sie an, ob die Position der Änderungsnachverfolgungstabelle geladen wird.
Starten Sie den neuen Konnektor.

Nutzungshinweise¶

Der neue Konnektor verwendet die vorhandenen Zieltabellen, die vom ursprünglichen Konnektor erstellt wurden, erstellt jedoch neue Journaltabellen.

Geben Sie an, ob die Position der Änderungsnachverfolgungstabelle geladen wird¶

Mit dem Konnektor Openflow Connector for SQL Server können Sie die Startposition auswählen, an der die Änderungsverfolgungstabellen gelesen werden. Standardmäßig beginnt der Konnektor den Lesevorgang an der letzten verfügbaren Position. Alternativ können Sie auch die früheste verfügbare Position in der Quellinstanz auswählen. Bei der Neuinstallation des Konnektors ist es üblich, an der frühesten Position zu beginnen. Dadurch kann die neue Instanz bestehende Tabellen auffinden und weiter replizieren, ohne jeweils einen erneuten Snapshot erstellen zu müssen.

Wenn Sie einen aktiven Konnektor von der neuesten zur frühesten Position wechseln, wird der Inhalt der Änderungsverfolgungstabellen erneut gelesen, verarbeitet und erneut auf die Zieltabelle angewendet.

Warnung

Während die Änderungsverfolgungstabellen neu gelesen werden, können die Daten in den betroffenen Zieltabellen nicht mehr mit ihren Quellen synchronisiert werden, bis alle Ereignisse neu verarbeitet und zusammengeführt wurden.

Die folgenden Parameter sind im Ingestion Parameters-Kontext verfügbar:

Parameter	Beschreibung
Startposition der Änderungsverfolgung	`Latest` (Standard): Das Lesen der Änderungsverfolgungstabelle beginnt an der letzten verfügbaren Position und wird von dort aus fortgesetzt. `Earliest`: Schaltet das inkrementelle Laden so um, dass das Lesen bei der frühesten verfügbaren Position in der Änderungsverfolgungstabelle (neu) gestartet wird.
Erneutes Lesen von Tabellen im Status	`New` (Standard): Nur bei neuen Tabellen, die hinzugefügt wurden, nachdem die Startposition auf `Earliest` umgestellt wurde, werden die Änderungsverfolgungstabellen ab der frühesten verfügbaren Position gelesen. Tabellen, bei denen die Replikation vor der Konfigurationsänderung gestartet wurde, lesen weiterhin an der letzten Position. `Any active`: Änderungen aus derzeit in der Replikation befindlichen Tabellen werden erneut gelesen und verarbeitet.

Parameter

Beschreibung

Startposition der Änderungsverfolgung

Latest (Standard): Das Lesen der Änderungsverfolgungstabelle beginnt an der letzten verfügbaren Position und wird von dort aus fortgesetzt.
Earliest: Schaltet das inkrementelle Laden so um, dass das Lesen bei der frühesten verfügbaren Position in der Änderungsverfolgungstabelle (neu) gestartet wird.

Erneutes Lesen von Tabellen im Status

New (Standard): Nur bei neuen Tabellen, die hinzugefügt wurden, nachdem die Startposition auf Earliest umgestellt wurde, werden die Änderungsverfolgungstabellen ab der frühesten verfügbaren Position gelesen. Tabellen, bei denen die Replikation vor der Konfigurationsänderung gestartet wurde, lesen weiterhin an der letzten Position.
Any active: Änderungen aus derzeit in der Replikation befindlichen Tabellen werden erneut gelesen und verarbeitet.

So stellen Sie fest, ob der Konnektor das erneute Lesen der Änderungsverfolgungstabellen beendet hat:

Navigieren Sie zur Openflow-Arbeitsoberfläche.
Öffnen Sie die Prozessgruppe Incremental Load.
Klicken Sie mit der rechten Maustaste auf den obersten Prozessor namens Read SQLServer Change Tracking tables. Wählen Sie anschließend View state aus.
Überprüfen Sie die Statuseinträge für jede Tabelle mit Schlüsseln, die mit position. beginnen. Wenn ein Wert 0/0 lautet, dann hat der Konnektor das erneute Lesen der Änderungen für diese Tabelle noch nicht abgeschlossen.

Nutzungshinweise¶

Nachdem Sie einen aktiven Konnektor so eingestellt haben, dass er von den frühesten Positionen liest, und ihn starten, können Sie den Prozess nicht mehr neu konfigurieren oder abbrechen. Er wird fortgesetzt, bis die aktuell gelesenen Positionen die neuesten Werte erreicht haben.
Wenn Sie zur frühesten Position eines aktiven Konnektors wechseln, werden für alle Tabellen, die erneut verarbeitet werden, die vorhandenen Journale beendet und neue Journaltabellen erstellt.