Ga naar hoofdinhoud Ga naar aanvullende inhoud
Qlik-bronnen

Vereisten

Voordat u gegevens tijdelijk kunt opslaan of repliceren, moet u zorgen dat er aan de volgende vereisten is voldaan:

  • Installeer de vereiste driver op de server van de Gateway voor gegevensverplaatsing

    Informatie

    Dit is alleen vereist als u hebt opgegeven dat u werkt met Gateway voor gegevensverplaatsing. Raadpleeg Qlik Gegevensgateway - Gegevensverplaatsing voor informatie over de voordelen van Gateway voor gegevensverplaatsing en wanneer deze is vereist.

    Let op dat Gateway voor gegevensverplaatsing niet beschikbaar is met het Qlik Talend Cloud Starter-abonnement.

  • Verleen de vereiste machtigingen voor de gegevensbron

  • De gegevensbronconnector configureren

Setup stuurprogramma

U kunt het driver installeren met het installatieprogramma (aanbevolen) of handmatig. U moet een handmatige installatie alleen uitvoeren als er een probleem ontstaat bij het hulpprogramma.

Het hulpprogramma gebruiken om het stuurprogramma te installeren

In deze sectie wordt beschreven hoe u het vereiste driver installeert. Het proces omvat het uitvoeren van een script dat automatisch het vereiste driver downloadt, installeert en configureert. U kunt indien nodig ook scripts uitvoeren om het driver bij te werken en verwijderen.

De installatie voorbereiden

  • Controleer of Python 3.6 of hoger is geïnstalleerd op de Gegevensverplaatsing-gatewayserver.

    Python is al geïnstalleerd op de meeste Linux-distributies. U kunt controleren welke Python-versie is geïnstalleerd op uw systeem door de volgende opdracht uit te voeren:

    python3 --version

De driver installeren

Ga als volgt te werk om het driverte downloaden en installeren:

  1. Op de Gegevensverplaatsing-gatewaymachine wijzigt u de werkdirectory in:

    opt/qlik/gateway/movement/drivers/bin

  2. Voer dan de volgende opdracht uit:

    Syntaxis:

    ./install sqlserver

    Als het driver niet kan worden gedownload (vanwege toegangsbeperkingen of technische problemen), wordt er een melding getoond met de instructies voor het downloaden van het driver en waarnaar u het moet kopiëren op de Gegevensverplaatsing-gatewaymachine. Nadat u dit hebt gedaan, voert u de opdracht install sqlserver nogmaals uit.

    Anders wordt de gebruiksrechtovereenkomst voor het driver getoond.

  3. Voer een van de volgende handelingen uit:

    • Druk herhaaldelijk op [Enter] om langzaam door de gebruiksrechtovereenkomst te scrollen.
    • Druk herhaaldelijk op de spatiebalk om snel door de gebruiksrechtovereenkomst te scrollen.
    • Druk op q om de licentietekst af te sluiten en de opties te tonen voor het aanvaarden van de gebruiksrechtovereenkomst.

  4. Voer een van de volgende handelingen uit:

    • Typ "y" en druk op [Enter] om de gebruiksrechtovereenkomst te accepteren en de installatie te starten.
    • Typ "n" en druk op [Enter] om de gebruiksrechtovereenkomst af te wijzen en de installatie af te sluiten.

    • Typ "v" en druk op [Enter] om de gebruiksrechtovereenkomst nogmaals te tonen.

    5. Het driver wordt geïnstalleerd.

Het driver bijwerken

Voer de update-opdracht uit als u eerdere versies van het driver wilt verwijderen voordat u het meegeleverde driver installeert.

Ga als volgt te werk om het driver te downloaden en bij te werken:

  1. Op de Gegevensverplaatsing-gatewaymachine wijzigt u de werkdirectory in:

    opt/qlik/gateway/movement/drivers/bin

  2. Voer dan de volgende opdracht uit:

    Syntaxis:

    ./update sqlserver

    Als het driver niet kan worden gedownload (vanwege toegangsbeperkingen of technische problemen), wordt er een melding getoond met de instructies voor het downloaden van het driver en waarnaar u het moet kopiëren op de Gegevensverplaatsing-gatewaymachine. Nadat u dit hebt gedaan, voert u de opdracht update sqlserver nogmaals uit.

    Anders wordt de gebruiksrechtovereenkomst voor het driver getoond.

  3. Voer een van de volgende handelingen uit:

    • Druk herhaaldelijk op [Enter] om langzaam door de gebruiksrechtovereenkomst te scrollen.
    • Druk herhaaldelijk op de spatiebalk om snel door de gebruiksrechtovereenkomst te scrollen.
    • Druk op q om de licentietekst af te sluiten en de opties te tonen voor het aanvaarden van de gebruiksrechtovereenkomst.

  4. Voer een van de volgende handelingen uit:

    • Typ "y" en druk op [Enter] om de gebruiksrechtovereenkomst te accepteren en de installatie te starten.
    • Typ "n" en druk op [Enter] om de gebruiksrechtovereenkomst af te wijzen en de installatie af te sluiten.
    • Typ "v" en druk op [Enter] om de gebruiksrechtovereenkomst nogmaals vanaf het begin te tonen.

    5. Het oude driver wordt verwijderd en het nieuwe driver wordt geïnstalleerd.

Het driver verwijderen

Voer de uninstall-opdracht uit als u het driver wilt verwijderen.

Ga als volgt te werken om het driver te verwijderen:

  1. Stop alle taken die zijn geconfigureerd om deze connector te gebruiken.

  2. Op de Gegevensverplaatsing-gatewaymachine wijzigt u de werkdirectory in:

    opt/qlik/gateway/movement/drivers/bin

  3. Voer dan de volgende opdracht uit:

    Syntaxis:

    ./uninstall sqlserver

    driver wordt verwijderd.

Het stuurprogramma handmatig installeren

U moet het driver alleen handmatig uitvoeren als de geautomatiseerde installatie van het stuurprogramma niet is voltooid.

Nadat Gateway voor gegevensverplaatsing is geïnstalleerd, downloadt u het msodbcsql<version>.x86_64.rpm stuurprogramma. U vindt een directe downloadlink naar de ondersteunde versie onder binary-artifacts in /opt/qlik/gateway/movement/drivers/manifests/sqlserver.yaml. Nadat de download is voltooid, kopieert u de RPM naar de machine met de Gateway voor gegevensverplaatsing.

Open op de Data Movement gateway-server een opdrachtregel en doe het volgende:

  1. Stop de Data Movement gateway-service:

    sudo systemctl stop repagent

  2. Bevestig eventueel dat de service is gestopt:

    sudo systemctl status repagent

    3. De status zou als volgt moeten zijn:

    Active: inactive (dead) since <timestamp> ago

  3. Installeer het stuurprogramma (RPM).

  4. Wijzig de werkmap in <product_dir>/bin.

  5. Kopieer de locatie van het stuurprogramma als volgt naar het site_arep_login.sh-bestand:

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

    Hiermee wordt het stuurprogramma toevoegd aan 'LD_LIBRARY_PATH' en wordt de locatie van het stuurprogramma bijgewerkt in het site_arep_login.sh -bestand.

  6. Bevestig eventueel dat de locatie van het stuurpogramma is gekopieerd:

    cat site_arep_login.sh

  7. Start de Data Movement gateway-service:

    sudo systemctl start repagent

  8. Bevestig eventueel dat de service is gestart:

    sudo systemctl status repagent

    De status zou als volgt moeten zijn:

    Active: active (running) since <timestamp> ago

  9. Voor Data Movement gateway is de volgende ODBC-bibliotheek vereist: msodbcsql-18.1.so.1.1

    Gebruik de volgende opdracht om te controleren welke bibliotheekversie momenteel is geïnstalleerd:

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

    Als de bestaande bibliotheek een ander versienummer heeft (bijvoorbeeld libmsodbcsql-18.0.so.1.1), moet u een symbolische koppeling maken tussen de bestaande bibliotheek en de vereiste bibliotheek.

    Gebruik hiervoor de volgende opdrachten:

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

    waarbij existing_library_name de naam is van de momenteel geïnstalleerde bibliotheek (bijvoorbeeld libmsodbcsql-18.0.so.1.1).

WaarschuwingAls u een Microsoft Fabric-doel gebruikt en het Microsoft ODBC-stuurprogramma voor de SQL Server-stuurprogramma verwijdert, wordt de verbinding met Microsoft Fabric ook verbroken omdat ze hetzelfde stuurprogramma delen.

Databaseselectie

Om een database te selecteren (door in het connectorvenster op Databases laden te klikken), moet de gebruiker die in de connectorinstellingen is gespecificeerd in de masterdatabase worden aangemaakt.

Poort

Poort 1434 moet standaard zijn geopend voor uitgaande communicatie op de Data Movement gateway-server. U kunt dit wijzigen in de connectorinstellingen.

De database voorbereiden voor CDC

In de volgende sectie wordt uitgelegd hoe u de database voor CDC instelt.

De database voor CDC instellen:

  1. Stel de database voor MS-CDC in door het volgende uit te voeren:

    exec source_db_name.dbo.sp_cdc_enable_db

    waarbij source_db_name de naam van de brondatabase is.

  2. De landing-taak schakelt MS-CDC automatisch voor alle brontabellen in. Als u echter MS-CDC handmatig wilt inschakelen, moet u het volgende script (voor elk van de beoogde brontabellen) uitvoeren:

    exec sys.sp_cdc_enable_table

    @source_schema = N'schema_name',

    @source_name = N'table_name',

    @role_name = NULL

    waarbij schema_name en table_name de namen zijn van het bronschema en de brontabel.

    Informatie
    • De CT-tabelnamen moeten de standaardindeling voor namen gebruiken: <SchemaName>_<TableName>_CT

    • De CT-tabel moet de volgende kolommen bevatten: [__$start_lsn], [__$end_lsn], [__$seqval], [__$operation], [__$update_mask], <all the data columns>, [__$command_id]

  3. Zorg dat de MS-CDC-taken voor vastleggen en opschonen worden uitgevoerd.

    Informatie
    • U kunt de taken beheren met sys.sp_cdc_change_job. Raadpleeg de Microsoft Help voor meer informatie.
    • Om latentie te verminderen, kunt u de parameter @pollinginterval op een kleine waarde instellen.

Was deze pagina nuttig?

Als u problemen ervaart op deze pagina of de inhoud onjuist is – een typfout, een ontbrekende stap of een technische fout – laat het ons weten zodat we dit kunnen verbeteren!

Geef hier uw feedback