Voraussetzungen

Vergewissern Sie sich, dass Sie die folgenden Voraussetzungen erfüllen, bevor Sie Daten bereitstellen oder replizieren:

• Installieren des benötigten driver auf dem Gateway-Server für Datenbewegungen

• Gewähren der benötigten Berechtigungen für die Datenquelle

• Konfigurieren des Datenquellenkonnektors

Treibereinrichtung

Sie können den driver mit dem Treiberinstallations-Dienstprogramm (empfohlen) oder manuell installieren. Eine manuelle Installation sollte nur in dem unwahrscheinlichen Fall versucht werden, dass Sie beim Verwenden des Treiberinstallations-Dienstprogramms auf Probleme stoßen.

Verwenden des Treiberinstallations-Dienstprogramms zum Installieren des Treibers

In diesem Abschnitt wird die Installation des erforderlichen driver beschrieben. Der Prozess umfasst das Ausführen eines Skripts, das den erforderlichen driver automatisch herunterlädt, installiert und konfiguriert. Sie können auch Skripte ausführen, um den driver bei Bedarf zu aktualisieren und zu deinstallieren.

Vorbereiten der Installation

• Vergewissern Sie sich, dass Python 3.6 oder höher auf dem Data Movement-Gateway-Server installiert ist.

  Python ist in den meisten Linux-Distributionen vorinstalliert. Führen Sie den folgenden Befehl aus, um zu prüfen, welche Python-Version auf Ihrem System installiert ist.

  python3 --version

Installieren von driver

So laden Sie den driver herunter und installieren ihn:

1. Ändern Sie auf dem Data Movement-Gateway-Computer das Arbeitsverzeichnis zu:

   opt/qlik/gateway/movement/drivers/bin

2. Führen Sie den folgenden Befehl aus:

   Syntax:

   ./install sqlserver

   Wenn der driver (aufgrund von Zugriffsbeschränkungen oder technischen Fehlern) nicht heruntergeladen werden kann, wird eine Meldung mit Anleitungen dazu angezeigt, wo Sie den driver herunterladen können und wohin er im Data Movement-Gateway-Computer kopiert werden muss. Führen Sie dann den Befehl install sqlserver erneut aus.

   Andernfalls wird die Endbenutzer-Lizenzvereinbarung für den driver angezeigt.

3. Gehen Sie folgendermaßen vor:

   • Drücken Sie mehrmals die [Eingabetaste], um langsam durch die Endbenutzer-Lizenzvereinbarung zu scrollen.
   • Drücken Sie mehrmals die Leertaste, um schnell durch die Endbenutzer-Lizenzvereinbarung zu scrollen.
   • Drücken Sie q, um den Lizenztext zu schließen und die Optionen zum Akzeptieren der Endbenutzer-Lizenzvereinbarung anzuzeigen.

4. Gehen Sie folgendermaßen vor:

   • Geben Sie „y“ ein und drücken Sie die [Eingabetaste], um die Endbenutzer-Lizenzvereinbarung zu akzeptieren und mit der Installation zu beginnen.
   • Geben Sie „n“ ein und drücken Sie die [Eingabetaste], um die Endbenutzer-Lizenzvereinbarung abzulehnen und den Installationsvorgang abzubrechen.

   • Geben Sie „v“ ein und drücken Sie die [Eingabetaste], um die Endbenutzer-Lizenzvereinbarung erneut anzuzeigen.

Der driver wird installiert.

Aktualisieren des driver

Führen Sie den Befehl „update“ aus, wenn Sie vorherige Versionen des driver deinstallieren möchten, bevor Sie den bereitgestellten driver installieren.

So laden Sie den driver herunter und aktualisieren ihn:

1. Ändern Sie auf dem Data Movement-Gateway-Computer das Arbeitsverzeichnis zu:

   opt/qlik/gateway/movement/drivers/bin

2. Führen Sie den folgenden Befehl aus:

   Syntax:

   ./update sqlserver

   Wenn der driver (aufgrund von Zugriffsbeschränkungen oder technischen Fehlern) nicht heruntergeladen werden kann, wird eine Meldung mit Anleitungen dazu angezeigt, wo Sie den driver herunterladen können und wohin er im Data Movement-Gateway-Computer kopiert werden muss. Führen Sie dann den Befehl update sqlserver erneut aus.

   Andernfalls wird die Endbenutzer-Lizenzvereinbarung für den driver angezeigt.

3. Gehen Sie folgendermaßen vor:

   • Drücken Sie mehrmals die [Eingabetaste], um langsam durch die Endbenutzer-Lizenzvereinbarung zu scrollen.
   • Drücken Sie mehrmals die Leertaste, um schnell durch die Endbenutzer-Lizenzvereinbarung zu scrollen.
   • Drücken Sie q, um den Lizenztext zu schließen und die Optionen zum Akzeptieren der Endbenutzer-Lizenzvereinbarung anzuzeigen.

4. Gehen Sie folgendermaßen vor:

   • Geben Sie „y“ ein und drücken Sie die [Eingabetaste], um die Endbenutzer-Lizenzvereinbarung zu akzeptieren und mit der Installation zu beginnen.
   • Geben Sie „n“ ein und drücken Sie die [Eingabetaste], um die Endbenutzer-Lizenzvereinbarung abzulehnen und den Installationsvorgang abzubrechen.
   • Geben Sie „v“ ein und drücken Sie die [Eingabetaste], um die Endbenutzer-Lizenzvereinbarung von Anfang an anzuzeigen.

Der alte driver wird deinstalliert und der neue driver installiert.

Deinstallieren des driver

Führen Sie den Befehl „uninstall“ aus, wenn Sie den driver deinstallieren möchten.

So deinstallieren Sie den driver:

1. Halten Sie alle Aufgaben an, die für die Verwendung dieses Konnektors konfiguriert sind.

2. Ändern Sie auf dem Data Movement-Gateway-Computer das Arbeitsverzeichnis zu:

   opt/qlik/gateway/movement/drivers/bin

3. Führen Sie den folgenden Befehl aus:

   Syntax:

   ./uninstall sqlserver

   Der driver wird deinstalliert.

Manuelles Installieren des Treibers

Nehmen Sie nur dann eine manuelle Installation des driver vor, wenn die automatische Treiberinstallation nicht erfolgreich abgeschlossen werden konnte.

Nachdem Data Movement Gateway installiert wurde, laden Sie den Treiber msodbcsql<version>.x86_64.rpm herunter. Einen direkten Download-Link zur unterstützten Version finden Sie unter binary-artifacts in /opt/qlik/gateway/movement/drivers/manifests/sqlserver.yaml. Kopieren Sie nach Abschluss des Downloads die RPM auf den Data Movement Gateway-Rechner.

Öffnen Sie auf dem Data Movement gateway-Server eine Shell-Eingabeaufforderung und führen Sie Folgendes durch:

1. Halten Sie den Data Movement gateway-Dienst an:

   sudo systemctl stop repagent

2. Bestätigen Sie optional, dass der Dienst angehalten wurde:

   sudo systemctl status repagent

Der Status lautet wie folgt:

Active: inactive (dead) since <timestamp> ago

3. Installieren Sie den Treiber (RPM).

4. Ändern Sie das Arbeitsverzeichnis in <product_dir>/bin.

5. Kopieren Sie den Treiberspeicherort wie folgt in die Datei site_arep_login.sh:

   echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/microsoft/msodbcsql<version>/lib64/" >> site_arep_login.sh

   Dadurch wird der Treiber zu „LD_LIBRARY_PATH“ hinzugefügt und der Treiberspeicherort in der Datei site_arep_login.sh hinzugefügt.

6. Bestätigen Sie optional, dass der Speicherort des Treibers kopiert wurde:

   cat site_arep_login.sh

7. Starten Sie den Data Movement gateway-Dienst:

   sudo systemctl start repagent

8. Bestätigen Sie optional, dass der Dienst gestartet wurde:

   sudo systemctl status repagent

   Der Status lautet wie folgt:

   Active: active (running) since <timestamp> ago

9. Data Movement gateway erfordert die folgende ODBC-Bibliothek: msodbcsql-18.1.so.1.1

   Um zu prüfen, welche Bibliotheksversion derzeit installiert ist, führen Sie den folgenden Befehl aus:

   ls /opt/microsoft/msodbcsql<version>/lib64/

   Wenn die vorhandene Bibliothek eine andere Versionsnummer hat (z. B. libmsodbcsql-18.0.so.1.1), müssen Sie einen symbolischen Link zwischen der bestehenden Bibliothek und der erforderlichen Bibliothek erstellen.

   Führen Sie dazu die folgenden Befehle aus:

   cd /opt/microsoft/msodbcsql<version>/lib64/
   ln -s existing_library_name msodbcsql-18.1.so.1.1

   wo existing_library_name der Name der derzeit installierten Bibliothek ist (z. B. libmsodbcsql-18.0.so.1.1).

Datenbankauswahl

Damit eine Datenbank ausgewählt werden kann (durch Klicken auf Datenbanken laden im Konnektor-Dialogfeld) muss der Benutzer, der in den Konnektoreinstellungen angegeben ist, in der Master-Datenbank erstellt sein.

Port

Der Port 1434 muss standardmäßig für die ausgehende Kommunikation auf dem Data Movement Gateway-Server geöffnet werden. Sie können dies in den Konnektoreinstellungen ändern.

Vorbereiten der Datenbank für CDC

Der folgende Abschnitt erläutert, wie Sie die Datenbank für CDC einrichten.

So richten Sie die Datenbank für CDC ein:

1. Richten Sie die Datenbank für MS-CDC ein, indem Sie Folgendes ausführen:

   exec source_db_name.dbo.sp_cdc_enable_db

   Dabei ist source_db_name der Name der Quelldatenbank.

2. Die landing-Aufgabe aktiviert MS-CDC für alle Quelltabellen automatisch. Wenn Sie jedoch MS-CDC lieber manuell aktivieren, führen Sie das folgende Skript (für jede der beabsichtigten Quelltabellen) aus:

   exec sys.sp_cdc_enable_table

   @source_schema = N'schema_name',

   @source_name = N'table_name',

   @role_name = NULL

   Dabei sind schema_name und table_name die Namen des Quellschemas bzw. der Quelltabelle.

   Informationshinweis

   • Die CT-Tabellennamen müssen das Standardbenennungsformat verwenden: <SchemaName>_<TableName>_CT

   • Die CT-Tabelle muss die folgenden Spalten beinhalten: [__$start_lsn], [__$end_lsn], [__$seqval], [__$operation], [__$update_mask], <alle Datenspalten>, [__$command_id]

3. Stellen Sie sicher, dass die MS-CDC-Erfassungs- und Bereinigungsaufträge ausgeführt werden.

   Informationshinweis

   • Sie können die Aufträge mithilfe von sys.sp_cdc_change_job steuern. Weitere Informationen finden Sie in der Microsoft-Hilfe.
   • Um die Latenz zu verringern, ist es ratsam, den Parameter @pollinginterval auf einen kleinen Wert zu setzen.