Konfigurowanie Brama danych Qlik — dostęp bezpośredni w kontenerze

Ostatnia aktualizacja: 2026-11-10

W tym temacie opisano, jak skonfigurować skonteneryzowany Brama dostępu bezpośredniego. Zawiera wymagania wstępne i instrukcje instalacji oraz opisuje ograniczenia i kwestie, o których należy pamiętać podczas pracy ze skonteneryzowanym Brama dostępu bezpośredniego.

Obsługiwane od Brama dostępu bezpośredniego 1.8.0.

Obsługiwane źródła danych

W przypadku instalacji skonteneryzowanych obsługiwane są następujące konektory:

Obsługiwane są następujące konektory ODBC:
- PostgreSQL
- SQL Server
- Oracle
Więcej informacji o łącznikach ODBC zawiera temat Bazy danych ODBC — Qlik Cloud (tylko w języku angielskim).
REST łącznik (REST za pośrednictwem Direct Access gateway). Więcej informacji na temat źródeł danych REST zawiera temat Źródła REST ‒ Qlik Cloud (tylko w języku angielskim).
Łącznik MySQL.

InformacjaObsługiwane od Brama dostępu bezpośredniego 1.8.1.
Łączniki SAP SQL, SAP BW, SAP ODP i SAP Report. Aby uzyskać informacje na temat instalowania pakietu SAP NetWeaver RFC SDK na maszynie Qlik Data Gateway - Direct Access w przypadku instalacji skonteneryzowanych, zob. Instalowanie pakietu SAP NetWeaver RFC SDK dla Brama danych Qlik — dostęp bezpośredni (tylko w języku angielskim).

InformacjaObsługiwane od Brama dostępu bezpośredniego 1.8.1.

Czym jest skonteneryzowany Brama dostępu bezpośredniego?

Możesz wdrożyć Brama dostępu bezpośredniego do kontenera Docker. Ten typ wdrożenia jest nazywany skonteneryzowanym Brama dostępu bezpośredniego. Skonteneryzowane wdrożenia Brama dostępu bezpośredniego są obsługiwane dla systemów Linux, macOS oraz WindowsDefault formatting option was applied.

Skonteneryzowany Brama dostępu bezpośredniego zapewnia przenośność do Twojego środowiska Brama dostępu bezpośredniego.

Najlepsze praktyki podczas używania Brama danych Qlik — dostęp bezpośredni

W celu uzyskiwania oczekiwanych wyników podczas korzystania z Brama danych Qlik — dostęp bezpośredni, zdecydowanie zaleca się przestrzeganie następujących najlepszych praktyk:

Nie używaj tego samego wystąpienia Brama dostępu bezpośredniego do programowania, testów akceptacji użytkownika i produkcji, ponieważ zwiększy to ryzyko przeciążenia dostępnych zasobów i wpłynie negatywnie na stabilność systemu. Z biznesowego punktu widzenia połączenie niewystarczających zasobów i zmniejszonej stabilności może skutkować opóźnieniem aktualizacji danych aplikacji produkcyjnej.
Aby uzyskać optymalną wydajność, zainstaluj Brama dostępu bezpośredniego w środowisku znajdującym się jak najbliżej Twojego źródła danych.

Wymagania systemowe

W tej sekcji opisano wymagania dotyczące korzystania ze skonteneryzowanego Brama dostępu bezpośredniego.

Wymagania dotyczące oprogramowania

Docker Engine w wersji 20.9+ oraz wtyczka Docker Compose (docker compose, składnia v2) zainstalowane na hoście.

Wymagane porty i protokoły

Informacje o wymaganych portach i protokołach zawiera Wymagane porty i protokoły.

Zalecany sprzęt

Host: 8 rdzeni, 32 GB pamięci, 5 GB przestrzeni dyskowej dostępnej dla Dockera

Opcjonalnie: Ustaw odpowiednie limity dla kontenera w pliku compose, aby brama miała dedykowane zasoby, zamiast konkurować z innymi kontenerami lub procesami na hoście:

direct-access-agent:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "6"
          memory: 24G
...
dcaas:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "2"

Minimalny sprzęt

Minimalny sprzęt jest odpowiedni tylko do określonych zastosowań z użyciem mniejszych wdrożeń dedykowanych (deweloperskich, testowych i produkcyjnych), używanych przy stale niskich wolumenach danych i ograniczonej liczbie jednoczesnych przeładowań.

Host: 4 rdzenie, 8 GB pamięci, 5 GB pamięci masowej dostępnej dla platformy Docker

Opcjonalnie: Ustaw odpowiednie limity dla kontenera w pliku compose, aby brama miała dedykowane zasoby, zamiast konkurować z innymi kontenerami lub procesami na hoście:

direct-access-agent:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "2"
          memory: 4G
...
dcaas:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "2"

Instalowanie programu Brama danych Qlik — dostęp bezpośredni

Konfiguracja bramy Direct Access gateway obejmuje procedury, które należy wykonać zarówno w centrum aktywności Administrowanie, jak i na serwerze bramy Direct Access gateway.

Procedury bramy danych, które należy wykonać w centrum aktywności Administrowanie, wymagają uprawnień administratora dzierżawy.

Etap pierwszy: pobierz Brama danych Qlik — dostęp bezpośredni

W centrum aktywności Administrowanie wybierz Bramy danych.

Wszystkie istniejące bramy danych zostaną przedstawione w tabeli pokazującej podstawowe informacje o każdej z nich.
Kliknij przycisk Wdrażaj na pasku narzędzi.

Zostanie otwarte okno dialogowe Wdrażanie bramy danych.
Wybierz Brama danych — dostęp bezpośredni - Containerized Direct Access Gateway, zaakceptuj Umowę z klientem Qlik i kliknij Pobierz. Plik instalacyjny Direct Access gateway (docker-compose.qlik-data-gateway-direct-access.yml) zostanie pobrany na Twój komputer.

Etap drugi: Rozpocznij wdrożenie, uruchamiając plik Docker Compose

Aby rozpocząć wdrożenie Brama dostępu bezpośredniego, uruchom następujące polecenie:

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

Kopiowanie SAP NetWeaver RFC SDK do kontenera

W przypadku łączników SAP SQL, SAP BW, SAP ODP i SAP Report skopiuj pliki SAP NetWeaver RFC SDK do kontenera.

Z katalogu zawierającego foldery binarne SDK dla systemów Linux i Windows uruchom:

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

Uruchom ponownie kontener direct-access-agent-1 po skopiowaniu plików.

Etap trzeci: Konfigurowanie Brama dostępu bezpośredniego

Aby uzyskać szczegółowe instrukcje dotyczące konfiguracji, zobacz Etap trzeci: Skonfiguruj Brama dostępu bezpośredniego.

Etap czwarty: Zarejestruj bramę danych

Kolejnym krokiem jest zarejestrowanie bramy danych. Można to zrobić albo za pośrednictwem centrum aktywności Administrowanie, albo w wierszu poleceń.

Możesz zarejestrować bramę za pomocą centrum aktywności Administrowanie. Zobacz Opcja 1: Za pośrednictwem centrum aktywności Administrowanie.

Możesz także zarejestrować Brama dostępu bezpośredniego automatycznie z wiersza poleceń, bez użycia centrum aktywności Administrowanie. Ta metoda wykorzystuje krótkotrwały token sesji wygenerowany przez klienta OAuth.

Aby automatycznie rejestrować i usuwać automatycznie zarejestrowane bramy, potrzebujesz następujących uprawnień:

Automatyczna rejestracja: musisz mieć uprawnienie administratora Zarejestruj Direct Access gateway ustawione na Dozwolone.
Usuwanie automatycznie zarejestrowanych bram: Wymagane jest uprawnienie administratora Zarejestruj Direct Access gateway ustawione na Dozwolone.

Aby uzyskać więcej informacji na temat uprawnień, zobacz Domyślne uprawnienia i role niestandardowe.

Automatyczna rejestracja jest obsługiwana wyłącznie z poziomu wiersza poleceń. REST API do automatycznej rejestracji bramy nie jest obecnie dostępne.

Wymagania wstępne

Klucz API z uprawnieniami administratora dzierżawy do tworzenia klientów OAuth i zarządzania nimi.

Rejestracja bramy za pomocą automatycznej rejestracji

Najpierw musisz skonfigurować środowisko Python, aby wygenerować identyfikator klienta OAuth, a także klucz asercji (krótkotrwały token) w kontenerze direct-access-agent. Uruchom poniższe polecenia oddzielnie, w tej kolejności:
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>
W przypadku ostatniego polecenia na powyższej liście obserwuj interaktywne monity i skopiuj client_id (identyfikator klienta OAuth) oraz assertion, gdy zostaną podane. Na razie zapisz te informacje na papierze lub w tymczasowym pliku tekstowym — będą one wymagane w kolejnych krokach tego procesu.
Gdy zapiszesz client_id i assertion, wyczyść środowisko Python za pomocą następującego polecenia:

deactivate
Ustaw metodę wyrażania zgody klienta OAuth na zaufaną.

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"}]'
Zażądaj tokenu dostępu. Powoduje to również automatyczne utworzenie konta użytkownika bota używanego przez bramę.

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"

Informacja
Jeśli asercja wygasła, uruchom ponownie skrypt z wirtualnego środowiska.
Wyszukaj automatycznie utworzonego użytkownika bota.

curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <API-key>'
Skopiuj identyfikator my-bot-client.
Utwórz rolę "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"]}'
Przypisz role na poziomie dzierżawy użytkownikowi bota.

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" } ] } ]'
Pobierz przestrzeń Bramy dostępu bezpośredniego.

curl "https://<tenant-url>/api/v1/spaces" -H 'authorization: Bearer <API-key>'
Skopiuj identyfikator przestrzeni Direct Access Gateway.
Dodaj użytkownika bota do przestrzeni z uprawnieniem Może edytować.

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"}'
Jeśli istniejąca asercja wygasła, wygeneruj nową. Wykonaj następujące polecenie:

python3 generate_gateway_assertion.py --tenant-url <tenant-url>
Wykonaj niezbędne kroki w wierszu poleceń. Ponieważ klient OAuth został już utworzony, należy zaktualizować JWK za pomocą tego wywołania API:

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>"}]'
Zarejestruj bramę:

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>

Usuwanie automatycznie zarejestrowanej bramy

Wykonaj poniższe kroki, aby wyrejestrować bramę zarejestrowaną przy użyciu opisanej powyżej automatycznej metody opartej na tokenie sesji. Te kroki usuwają również klienta OAuth, użytkownika bota oraz rolę, które zostały dla niego utworzone.

Wygeneruj asercję, jak opisano w powyższej sekcji.
Usuń bramę:

dotnet ConnectorAgent.dll qcs delete_gateway --tenant_url <tenant-url> --gateway_name <gateway-name> --client-id <client-ID> --assertion <assertion>
Wyszukaj konto użytkownika bota utworzone dla bramy.

curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <api-key>'
Skopiuj identyfikator bota.
Usuń to konto użytkownika bota.

curl -X DELETE "https://<tenant-url>/api/v1/users/<bot-user-ID>" -H "Authorization: Bearer <api-key>"
Wyszukaj rolę „DAG Registration” utworzoną dla bramy.

curl "https://<tenant-url>/api/v1/roles?limit=1&filter=(name%20eq%20%22DAG%20Registration%22)" -H "Authorization: Bearer <api-key>"
Skopiuj identyfikator roli.
Usuń tę rolę.

curl -X DELETE "https://<tenant-url>/api/v1/roles/<role-ID> -H "Authorization: Bearer <api-key>"
Usuń klienta OAuth.

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>

Etap piąty: uruchom usługę Brama danych Qlik — dostęp bezpośredni na serwerze bramy Direct Access gateway

Aby uruchomić usługę Brama danych Qlik — dostęp bezpośredni, uruchom kontenery dcaas-dg i direct-access-agent.

Etap szósty: dodaj połączenie do swojego źródła danych

Zobacz Etap szósty: dodaj połączenie do swojego źródła danych.

Ustawienia środowiska

W tej sekcji wymieniono określone zmienne środowiskowe z pliku docker-compose.qlik-data-gateway-direct-access.yml, których skonfigurowanie może być konieczne w celu prawidłowego połączenia ze źródłami danych za pośrednictwem bramy.

ALLOW_SOURCES: Rozdzielana przecinkami lista dozwolonych nazw hostów i adresów IP. Gdy agent bramy musi połączyć się z czymś na Twoim własnym serwerze lub z innym hostem w sieci lokalnej lub prywatnej (na przykład z bazą danych na localhost, nazwą usługi Docker lub hostem z prywatnym adresem IP), dodajesz ten adres do ALLOW_SOURCES — w przeciwnym razie próba połączenia zostanie odrzucona.

Dowiedz się więcej

Czy ta strona była pomocna?

Jeżeli natkniesz się na problemy z tą stroną lub jej zawartością — literówkę, brakujący krok lub błąd techniczny — daj nam znać!

Przekaż tu opinię