Einrichten von Qlik Data Gateway – direkter Zugriff in einer Sammelbox

Letzte Aktualisierung: 2026-11-10

In diesem Thema wird beschrieben, wie containerisiertes Direct Access Gateway eingerichtet wird. Es enthält Voraussetzungen und Installationsanweisungen und beschreibt die Einschränkungen und Aspekte, die Sie bei der Arbeit mit containerisiertem Direct Access Gateway beachten sollten.

Unterstützt ab Direct Access Gateway 1.8.0.

Unterstützte Datenquellen

Die folgenden Konnektoren werden für containerisierte Installationen unterstützt:

Die folgenden ODBC-Connectors werden unterstützt:
- PostgreSQL
- SQL Server
- Oracle
Weitere Informationen zu ODBC-Konnektoren finden Sie unter ODBC-Datenbanken – Qlik Cloud (nur auf Englisch).
REST Konnektor (REST über Direct Access gateway). Weitere Informationen zu REST-Datenquellen finden Sie unter REST-Quellen ‒ Qlik Cloud (nur auf Englisch).
MySQL-Konnektor.

InformationshinweisWird ab Direct Access Gateway 1.8.1 unterstützt.
SAP SQL-, SAP BW-, SAP ODP- und SAP Report-Konnektoren. Informationen zum Installieren des SAP NetWeaver RFC SDK auf dem Qlik Data Gateway - Direct Access-Computer für containerisierte Installationen finden Sie unter Installieren des SAP NetWeaver RFC SDK für Qlik Data Gateway – direkter Zugriff (nur auf Englisch).

InformationshinweisWird ab Direct Access Gateway 1.8.1 unterstützt.

Was ist containerisiertes Direct Access Gateway?

Sie können Direct Access Gateway in eine Docker-Sammelbox bereitstellen. Diese Art der Bereitstellung wird containerisierte Direct Access Gateway genannt. Containerisierte Direct Access Gateway-Bereitstellungen werden für Linux, macOS und Windows unterstützt.

Containerisiertes Direct Access Gateway bietet Portabilität für Ihre Direct Access Gateway-Umgebung.

Best Practices bei der Verwendung von Qlik Data Gateway – direkter Zugriff

Für eine erfolgreiche Erfahrung bei Verwendung von Qlik Data Gateway – direkter Zugriff wird dringend empfohlen, die folgenden Best Practices einzuhalten:

Verwenden Sie nicht das gleiche Direct Access Gateway für Entwicklung, Benutzerakzeptanztests und Produktion, da dies die Gefahr einer Überlastung der verfügbaren Ressourcen erhöht und die Systemstabilität beeinträchtigen kann. Aus geschäftlicher Perspektive kann die Kombination aus ungenügenden Ressourcen und verringerter Stabilität zu verzögerten Aktualisierungen von Produktionsanwendungsdaten führen.
Für eine optimale Leistung installieren Sie Direct Access Gateway in einer Umgebung, die sich so nah wie möglich an Ihrer Datenquelle befindet.

Systemvoraussetzungen

Dieser Abschnitt beschreibt die Anforderungen für die Verwendung von containerisiertem Direct Access Gateway.

Softwareanforderungen

Docker Engine-Version 20.9+ und das Docker Compose-Plugin (docker compose, v2-Syntax) auf dem Host installiert.

Erforderliche Ports und Protokolle

Informationen zu den erforderlichen Ports und Protokollen finden Sie unter Erforderliche Ports und Protokolle.

Empfohlene Hardware

Host: 8 Kerne, 32 GB Arbeitsspeicher, 5 GB Speicherplatz für Docker verfügbar
Optional: Legen Sie in der Compose-Datei entsprechende Limits für die Sammelbox fest, damit das Gateway über dedizierte Kapazität verfügt, anstatt mit anderen Sammelboxen oder Prozessen auf dem Host zu konkurrieren:
```
direct-access-agent:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "6"
          memory: 24G
...
dcaas:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "2"
```

Minimal erforderliche Hardware

Die minimal erforderliche Hardware ist nur spezifische Szenarios mit kleineren dedizierten Bereitstellungen (Entwicklung, Test und Produktion) ausreichend, die mit kontinuierlich geringem Datenvolumen und einer begrenzten Anzahl gleichzeitiger Ladevorgänge verwendet werden.

Host: 4 Kerne, 8 GB Arbeitsspeicher, 5 GB Speicherplatz für Docker verfügbar
Optional: Legen Sie in der Compose-Datei entsprechende Limits für die Sammelbox fest, damit das Gateway über dedizierte Kapazität verfügt, anstatt mit anderen Sammelboxen oder Prozessen auf dem Host zu konkurrieren:
```
direct-access-agent:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "2"
          memory: 4G
...
dcaas:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "2"
```

Installieren von Qlik Data Gateway – direkter Zugriff

Das Setup des Direct Access Gateway umfasst Verfahren, die sowohl im Aktivitätscenter Administration als auch auf dem Server des Direct Access Gateway durchgeführt werden müssen.

Für Daten-Gateway-Verfahren, die im Administration Aktivitätscenter ausgeführt werden müssen, ist die Genehmigung des Mandantenadministrators erforderlich.

Phase 1: herunterladenQlik Data Gateway – direkter Zugriff

Wählen Sie im Aktivitätscenter Administration Daten-Gateways aus.

Vorhandene Daten-Gateways werden in einer Tabelle mit grundlegenden Informationen zu jedem Gateway aufgelistet.
Klicken Sie in der Symbolleiste auf die Schaltfläche Bereitstellen.

Das Dialogfenster Daten-Gateway bereitstellen wird geöffnet.
Wählen Sie Daten-Gateway – direkter Zugriff - Containerized Direct Access Gateway aus, akzeptieren Sie die Qlik-Kundenvereinbarung und klicken Sie auf Herunterladen. Die Setup-Datei für das Direct Access gateway (docker-compose.qlik-data-gateway-direct-access.yml) wird auf Ihren Computer heruntergeladen.

Phase zwei: Starten Sie die Bereitstellung durch Ausführen der Docker Compose-Datei

Um die Bereitstellung von Direct Access Gateway zu starten, führen Sie den folgenden Befehl aus:

docker compose -f docker-compose.qlik-data-gateway-direct-access.yml up

Kopieren des SAP NetWeaver RFC SDK in die Sammelbox

Für die Konnektoren SAP SQL, SAP BW, SAP ODP und SAP Report kopieren Sie die SAP NetWeaver RFC SDK-Dateien in die Sammelbox.

Führen Sie aus dem Verzeichnis, das sowohl die Linux- als auch die Windows-SDK-Binärordner enthält, Folgendes aus:

docker cp . direct-access-agent-1:/usr/share/Qlik/Gateway/sap-sdk

Starten Sie die Sammelbox direct-access-agent-1 nach dem Kopieren der Dateien neu.

Phase drei: Einrichten von Direct Access Gateway

Für detaillierte Einrichtungsanweisungen siehe Phase drei: Direct Access Gateway einrichten.

Phase vier: Datengateway registrieren

Der nächste Schritt besteht darin, das Datengateway zu registrieren. Dies kann entweder über das Administration-Aktivitätscenter oder über die Befehlszeile erfolgen.

Sie können das Gateway über das Administration-Aktivitätscenter registrieren. Siehe Option 1: Über das Aktivitätscenter Administration.

Sie können Direct Access Gateway auch automatisch über die Befehlszeile registrieren, ohne das Aktivitätscenter Administration zu verwenden. Diese Methode verwendet ein kurzlebiges Sitzungs-Token, das von einem OAuth-Client generiert wurde.

Um Gateways automatisch zu registrieren und automatisch registrierte Gateways zu entfernen, benötigen Sie die folgenden Berechtigungen:

Automatische Registrierung: Sie benötigen die Administratorberechtigung Direct Access gateway registrieren, die auf Zulässig eingestellt ist.
Entfernen automatisch registrierter Gateways: Sie benötigen die Administratorberechtigung Direct Access gateway registrieren, die auf Zulässig festgelegt ist.

Weitere Informationen zu Berechtigungen finden Sie unter Standardberechtigungen und benutzerdefinierte Rollen.

Die automatische Registrierung wird nur über die Befehlszeile unterstützt. Eine REST-API für die automatische Gateway-Registrierung ist derzeit nicht verfügbar.

Voraussetzungen

Ein API-Schlüssel mit Mandantenadministrator-Berechtigung zum Erstellen und Verwalten von OAuth-Clients.

Registrieren des Gateways mit automatischer Registrierung

Zuerst müssen Sie eine Python-Umgebung einrichten, um eine OAuth-Client-ID sowie einen Assertion-Schlüssel (kurzlebiges Token) in der Sammelbox direct-access-agent zu generieren. Führen Sie die folgenden Befehle separat in dieser Reihenfolge aus:
1. docker exec -it --user root direct-access-agent-1 bash
2. apt-get update && apt-get install -y python3 python3-pip
3. apt install python3.11-venv
4. python3 -m venv .venv
5. source .venv/bin/activate
6. pip install cryptography pyjwt
7. python3 generate_gateway_assertion.py --tenant-url <tenant-url>
Für den letzten Befehl in der obigen Liste folgen Sie den interaktiven Eingabeaufforderungen und kopieren Sie client_id (OAuth-Client-ID) und assertion, wenn diese bereitgestellt werden. Notieren Sie diese Details vorerst auf Papier oder in einer temporären Textdatei – sie werden für spätere Schritte des Prozesses benötigt.
Wenn Sie client_id und assertion notiert haben, bereinigen Sie die Python-Umgebung mit dem folgenden Befehl:

deactivate
Legen Sie die Zustimmungsmethode des OAuth-Clients auf „trusted“ fest.

curl "https://<tenant-url>/api/v1/oauth-clients/<client-id>/connection-configs/me" -X PATCH -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <api-key>' -d '[{"op":"replace","path":"/consentMethod","value":"trusted"}]'
Fordern Sie ein Zugriffstoken an. Dies löst auch die automatische Erstellung des vom Gateway verwendeten Bot-Benutzerkontos aus.

curl "https://<tenant-url>/oauth/token" -X POST -H 'content-type: application/x-www-form-urlencoded' -d "grant_type=client_credentials" -d "client_id=<client-id>" -d "client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer" -d "client_assertion=<assertion>" -d "scope=admin.direct-access-gateways:register_gateway admin.direct-access-gateways:delete_gateway"

Informationshinweis
Wenn die Assertion abgelaufen ist, führen Sie das Skript aus der virtuellen Umgebung erneut aus.
Suchen Sie den automatisch erstellten Bot-Benutzer.

curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <API-key>'
Kopieren Sie die ID von my-bot-client.
Erstellen Sie eine Rolle "DAG Registration".

curl "https://<tenant-url>/api/v1/roles" -X POST -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <API-key>' -d '{"name":"DAG Registration","description":"Role for registering a gateway","assignedScopes":["admin.direct-access-gateways:register_gateway", "admin.direct-access-gateways:delete_gateway"]}'
Weisen Sie dem Bot-Benutzer Rollen auf Mandantenebene zu.

curl "https://<tenant-url>/api/v1/users/<bot-user-ID>" -X PATCH -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <API-key>' -d ' [ { "op": "replace", "path": "/assignedRoles", "value": [ { "name": "DAG Registration" } ] } ]'
Rufen Sie den Bereich für das Gateway für direkten Zugriff ab.

curl "https://<tenant-url>/api/v1/spaces" -H 'authorization: Bearer <API-key>'
Kopieren Sie die Direct Access Gateway-Space-ID.
Fügen Sie den Bot-Benutzer mit der Berechtigung Kann bearbeiten zum Space hinzu.

curl "https://<tenant-url>/api/v1/spaces/<DAG-space-ID>/assignments" -X POST -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <API-key>' -d '{"assigneeId": "<bot-user-ID>","roles": ["consumer","dataconsumer","producer"], "type": "user"}'
Falls die bestehende Assertion abgelaufen ist, generieren Sie eine neue. Führen Sie den folgenden Befehl aus:

python3 generate_gateway_assertion.py --tenant-url <tenant-url>
Führen Sie die erforderlichen Schritte in der Eingabeaufforderung aus. Da der OAuth-Client bereits erstellt wurde, muss JWK mithilfe dieses API-Aufrufs aktualisiert werden:

curl "https://<tenant-url>/api/v1/oauth-clients/<client-ID>" -X PATCH -H 'accept: application/json' -H 'content-type: application/json' -H 'authorization: Bearer <API-key>' -d '[{"op":"replace","path":"/publicKeys/0/y","value":"<Y-value-from-JWK>"},{"op":"replace","path":"/publicKeys/0/x","value":"<X-value-from-JWK>"},{"op":"remove","path":"/publicKeys/0/use"},{"op":"replace","path":"/publicKeys/0/kid","value":"<kid-value-from-JWK>"}]'
Registrieren Sie das Gateway:

dotnet ConnectorAgent.dll qcs register_gateway --tenant_url <tenant-url> --gateway_name <DAG-name> --gateway_description <DAG-description> --space_name <space-name> --client-id <client-ID> --assertion <assertion>

Entfernen eines automatisch registrierten Gateways

Führen Sie die folgenden Schritte aus, um die Registrierung eines Gateways aufzuheben, das mit der oben beschriebenen automatischen, auf Sitzungs-Token basierenden Methode registriert wurde. Diese Schritte entfernen auch den OAuth-Client, den Bot-Benutzer und die Rolle, die dafür erstellt wurden.

Generieren Sie eine Assertion, wie in dem obigen Abschnitt beschrieben.
Löschen Sie das Gateway:

dotnet ConnectorAgent.dll qcs delete_gateway --tenant_url <tenant-url> --gateway_name <gateway-name> --client-id <client-ID> --assertion <assertion>
Suchen Sie nach dem Bot-Benutzerkonto, das für das Gateway erstellt wurde.

curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <api-key>'
Kopieren Sie die Bot-ID.
Löschen Sie dieses Bot-Benutzerkonto.

curl -X DELETE "https://<tenant-url>/api/v1/users/<bot-user-ID>" -H "Authorization: Bearer <api-key>"
Suchen Sie nach der Rolle „DAG Registration“, die für das Gateway erstellt wurde.

curl "https://<tenant-url>/api/v1/roles?limit=1&filter=(name%20eq%20%22DAG%20Registration%22)" -H "Authorization: Bearer <api-key>"
Kopieren Sie die Rollen-ID.
Löschen Sie diese Rolle.

curl -X DELETE "https://<tenant-url>/api/v1/roles/<role-ID> -H "Authorization: Bearer <api-key>"
Löschen Sie den OAuth-Client.

curl -X DELETE https://<tenant-url>/api/v1/oauth-clients/<OAuth-client-ID> -H "qlik-confirm-delete: <OAuth-client-ID>" -H "Authorization: Bearer <api-key>

Phase 5: Den Qlik Data Gateway – direkter Zugriff-Dienst auf dem Server des Direct Access Gateway starten

Um den Dienst Qlik Data Gateway – direkter Zugriff zu starten, starten Sie die Container dcaas-dg und direct-access-agent.

Phase 6: Eine Verbindung zu Ihrer Datenquelle hinzufügen

Siehe Phase 6: Eine Verbindung zu Ihrer Datenquelle hinzufügen.

Umgebungseinstellungen

Dieser Abschnitt listet bestimmte Umgebungsvariablen aus der Datei docker-compose.qlik-data-gateway-direct-access.yml auf, die Sie möglicherweise konfigurieren müssen, um Ihre Datenquellen ordnungsgemäß über das Gateway zu verbinden.

ALLOW_SOURCES: Eine kommagetrennte Zulassungsliste von Hostnamen und IP-Adressen. Wenn der Gateway-Agent eine Verbindung zu etwas auf Ihrem eigenen Server oder einem anderen Host im lokalen oder privaten Netzwerk herstellen muss (zum Beispiel eine Datenbank auf localhost, ein Docker-Servicename oder ein Host mit privater IP-Adresse), fügen Sie diese Adresse zu ALLOW_SOURCES hinzu – andernfalls wird der Verbindungsversuch abgelehnt.

Weitere Informationen

Hat diese Seite Ihnen geholfen?

Wenn Sie ein Problem mit dieser Seite oder ihrem Inhalt feststellen, sei es ein Tippfehler, ein ausgelassener Schritt oder ein technischer Fehler, informieren Sie uns bitte!

Geben Sie hier Ihr Feedback ab