Bir kapsayıcıda Qlik Data Gateway - Doğrudan Erişim kurulumu

Son güncelleme: 2026-11-10

Bu konu, kapsayıcılı Doğrudan Erişim ağ geçidi kurulumunun nasıl yapılacağını ana hatlarıyla açıklar. Önkoşulları ve kurulum talimatlarını sağlar ve kapsayıcılaştırılmış Doğrudan Erişim ağ geçidi ile çalışırken bilmeniz gereken sınırlamaları ve hususları açıklar.

Doğrudan Erişim ağ geçidi 1.8.0 sürümünden itibaren desteklenir.

Desteklenen veri kaynakları

Kapsayıcılaştırılmış kurulumlar için aşağıdaki bağlayıcılar desteklenmektedir:

Aşağıdaki ODBC bağlayıcıları desteklenir:
- PostgreSQL
- SQL Server
- Oracle
ODBC bağlayıcıları hakkında daha fazla bilgi için bkz. ODBC veritabanları ‒ Qlik Cloud (yalnızca İngilizce).
REST bağlayıcı (REST Direct Access gateway üzerinden). REST veri kaynakları hakkında daha fazla bilgi için bkz. REST kaynakları ‒ Qlik Cloud (yalnızca İngilizce).
MySQL bağlayıcısı.

Bilgi notuDoğrudan Erişim ağ geçidi 1.8.1 sürümünden itibaren desteklenir.
SAP SQL, SAP BW, SAP ODP ve SAP Report bağlayıcıları. Kapsayıcılı kurulumlar için Qlik Data Gateway - Direct Access makinesine SAP NetWeaver RFC SDK yükleme hakkında bilgi için bkz. Qlik Data Gateway - Doğrudan Erişim için SAP NetWeaver RFC SDK Yükleme (yalnızca İngilizce).

Bilgi notuDoğrudan Erişim ağ geçidi 1.8.1 sürümünden itibaren desteklenir.

Kapsayıcıya alınmış Doğrudan Erişim ağ geçidi nedir?

Bir Docker kapsayıcısına Doğrudan Erişim ağ geçidi dağıtabilirsiniz. Bu dağıtım türü, kapsayıcılı Doğrudan Erişim ağ geçidi olarak adlandırılır. Konteynerleştirilmiş Doğrudan Erişim ağ geçidi dağıtımları Linux, macOS ve Windows için desteklenmektedir.

Kapsayıcıya alınmış Doğrudan Erişim ağ geçidi, Doğrudan Erişim ağ geçidi ortamınıza taşınabilirlik sağlar.

Qlik Data Gateway - Doğrudan Erişim kullanırken en iyi uygulamalar

Qlik Data Gateway - Doğrudan Erişim kullanırken başarılı bir deneyim için aşağıdaki en iyi uygulamalara uyulması önemle tavsiye edilir:

Mevcut kaynaklara aşırı yüklenme riskini artıracağından ve sistem kararlılığını etkileyeceğinden, geliştirme, kullanıcı kabul testi ve üretim için aynı Doğrudan Erişim ağ geçidi öğesini kullanmayın. İş perspektifinden bakıldığında, yetersiz kaynaklar ve azalan kararlılığın birleşimi, üretim uygulama verilerinin gecikmeli olarak güncellenmesine neden olabilir.
Optimum performans için, Doğrudan Erişim ağ geçidi öğesini veri kaynağınıza mümkün olduğunca yakın bir ortama kurun.

Sistem önkoşulları

Bu bölümde, kapsayıcıya alınmış Doğrudan Erişim ağ geçidi kullanımı için gereksinimler açıklanmaktadır.

Yazılım gereksinimleri

Ana makinede Docker Engine 20.9+ sürümü ve Docker Compose eklentisi (docker compose, v2 söz dizimi) yüklü olmalıdır.

Gerekli bağlantı noktaları ve protokoller

Gerekli bağlantı noktaları ve protokoller için bkz. Gerekli bağlantı noktaları ve protokoller.

Önerilen donanım

Ana makine: 8 çekirdek, 32 GB bellek, Docker için kullanılabilir 5 GB depolama alanı
İsteğe bağlı: Ağ geçidinin ana makinedeki diğer kapsayıcılar veya işlemlerle rekabet etmek yerine ayrılmış bir kapasiteye sahip olması için compose dosyasındaki kapsayıcı üzerinde eşleşen sınırları belirleyin:
```
direct-access-agent:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "6"
          memory: 24G
...
dcaas:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "2"
```

Minimum donanım

Minimum donanım yalnızca sürekli düşük veri hacimleri ve sınırlı sayıda eşzamanlı yeniden yükleme ile daha küçük özel dağıtımlar (geliştirme, test veya üretim) kullanılan belirli senaryolar için uygundur.

Ana makine: 4 çekirdek, 8 GB bellek, Docker için kullanılabilir 5 GB depolama alanı
İsteğe bağlı: Ağ geçidinin ana makinedeki diğer kapsayıcılar veya işlemlerle rekabet etmek yerine ayrılmış bir kapasiteye sahip olması için compose dosyasındaki kapsayıcı üzerinde eşleşen sınırları belirleyin:
```
direct-access-agent:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "2"
          memory: 4G
...
dcaas:
    image: ...
    deploy:
      resources:
        limits:
          cpus: "2"
```

Qlik Data Gateway - Doğrudan Erişim yükleme

Direct Access gateway'i kurma işlemi, gerek Yönetim etkinlik merkezinde gerekse Direct Access gateway sunucusunda gerçekleştirilmesi gereken yordamlar içerir.

Yönetim etkinlik merkezinde gerçekleştirilmesi gereken veri ağ geçidi prosedürleri, kiracı yöneticisi izni gerektirir.

Birinci aşama: Qlik Data Gateway - Doğrudan Erişim indirme

Yönetim etkinlik merkezindeki Veri ağ geçitleri öğesini seçin.

Mevcut veri ağ geçitleri her ağ geçidi hakkında temel bilgiler gösteren bir tabloda listelenir.
Dağıt araç çubuğu düğmesine tıklayın.

Veri Ağ Geçidini Dağıt diyalog penceresi açılır.
Data Gateway - Doğrudan Erişim - Kapsayıcılı Doğrudan Erişim Ağ Geçidi öğesini seçin, Qlik Müşteri Sözleşmesi'ni kabul edin ve İndir'e tıklayın. Direct Access gateway kurulum dosyası (docker-compose.qlik-data-gateway-direct-access.yml) makinenize indirilecektir.

İkinci aşama: Docker Compose dosyasını çalıştırarak dağıtımı başlatın

Doğrudan Erişim ağ geçidi dağıtımını başlatmak için aşağıdaki komutu çalıştırın:

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

SAP NetWeaver RFC SDK'sini kapsayıcıya kopyalama

SAP SQL, SAP BW, SAP ODP ve SAP Report bağlayıcıları için SAP NetWeaver RFC SDK dosyalarını kapsayıcıya kopyalayın.

Hem Linux hem de Windows SDK ikili klasörlerini içeren dizinden şunu çalıştırın:

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

Dosyaları kopyaladıktan sonra direct-access-agent-1 kapsayıcısını yeniden başlatın.

Üçüncü aşama: Doğrudan Erişim ağ geçidi kurulumu

Ayrıntılı kurulum talimatları için bkz. 3. Aşama: Doğrudan Erişim ağ geçidi kurulumu.

Dördüncü aşama: Veri ağ geçidini kaydetme

Bir sonraki adım, veri ağ geçidini kaydetmektir. Bu işlem, Yönetim etkinlik merkezi üzerinden veya komut satırından yapılabilir.

Yönetim etkinlik merkezini kullanarak ağ geçidini kaydedebilirsiniz. Bkz. Seçenek 1: Yönetim etkinlik merkezi üzerinden.

Ayrıca Yönetim etkinlik merkezini kullanmadan, komut satırından otomatik olarak Doğrudan Erişim ağ geçidi kaydı yapabilirsiniz. Bu yöntem, bir OAuth istemcisinden oluşturulan kısa ömürlü bir oturum belirteci kullanır.

Ağ geçitlerini otomatik olarak kaydetmek ve otomatik olarak kaydedilen ağ geçitlerini kaldırmak için aşağıdaki izinlere sahip olmanız gerekir:

Otomatik kayıt: Direct Access gateway kaydet yönetici izninin İzin Verildi olarak ayarlanmış olması gerekir.
Otomatik olarak kaydedilen gateway'leri kaldırma: Direct Access gateway kaydet yönetici izninin İzin Verildi olarak ayarlanmış olması gerekir.

İzinler hakkında daha fazla bilgi için bkz. Varsayılan izinler ve özel roller.

Otomatik kayıt yalnızca komut satırı üzerinden desteklenir. Otomatik ağ geçidi kaydı için bir REST API şu anda mevcut değildir.

Önkoşullar

OAuth istemcileri oluşturmak ve yönetmek için kiracı yöneticisi iznine sahip bir API anahtarı.

Ağ geçidini otomatik kayıt ile kaydetme

İlk olarak, bir OAuth istemci kimliğinin yanı sıra direct-access-agent kapsayıcısında bir onay anahtarı (kısa ömürlü belirteç) oluşturmak için bir Python ortamı kurmanız gerekir. Şu komutları ayrı ayrı, bu sırayla çalıştırın:
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>
Yukarıdaki listedeki son komut için etkileşimli istemleri izleyin ve sağlandığında client_id (OAuth istemci kimliği) ile assertion bilgilerini kopyalayın. Bu ayrıntıları şimdilik bir kâğıda veya geçici bir metin dosyasına kaydedin—bunlar sürecin sonraki adımları için gereklidir.
client_id ve assertion değerlerini not ettikten sonra, aşağıdaki komutla Python ortamını temizleyin:

deactivate
OAuth istemcisinin onay yöntemini güvenilir olarak ayarlayın.

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"}]'
Bir erişim belirteci isteyin. Bu işlem ayrıca ağ geçidi tarafından kullanılan bot kullanıcı hesabının otomatik olarak oluşturulmasını da tetikler.

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"

Bilgi notu
Onaylamanın süresi dolduysa, komut dosyasını sanal ortamdan yeniden çalıştırın.
Otomatik oluşturulan bot kullanıcısını arayın.

curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <API-key>'
my-bot-client kimliğini kopyalayın.
Bir "DAG Registration" rolü oluşturun.

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"]}'
Bot kullanıcısına kiracı düzeyindeki rolleri atayın.

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" } ] } ]'
Direct Access Gateway alanını alın.

curl "https://<tenant-url>/api/v1/spaces" -H 'authorization: Bearer <API-key>'
Direct Access Gateway alan kimliğini kopyalayın.
Bot kullanıcısını Düzenleyebilir izniyle alana ekleyin.

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"}'
Mevcut onaylamanın süresi dolmuşsa yeni bir tane oluşturun. Şu komutu çalıştırın:

python3 generate_gateway_assertion.py --tenant-url <tenant-url>
Komut istemindeki gerekli adımları izleyin. OAuth istemcisi zaten oluşturulduğundan, bu API çağrısı kullanılarak JWK'nin güncellenmesi gerekir:

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>"}]'
Ağ geçidini kaydedin:

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>

Otomatik olarak kaydedilen bir ağ geçidini kaldırma

Yukarıda açıklanan otomatik, oturum belirteci tabanlı yöntem kullanılarak kaydedilmiş bir ağ geçidinin kaydını silmek için aşağıdaki adımları kullanın. Bu adımlar ayrıca bunun için oluşturulan OAuth istemcisini, bot kullanıcısını ve rolü de kaldırır.

Yukarıdaki bölümde açıklandığı gibi bir onaylama oluşturun.
Ağ geçidini silin:

dotnet ConnectorAgent.dll qcs delete_gateway --tenant_url <tenant-url> --gateway_name <gateway-name> --client-id <client-ID> --assertion <assertion>
Ağ geçidi için oluşturulan bot kullanıcı hesabını arayın.

curl "https://<tenant-url>/api/v1/users" -H 'accept: application/json' -H 'authorization: Bearer <api-key>'
Bot kimliğini kopyalayın.
Bu bot kullanıcı hesabını silin.

curl -X DELETE "https://<tenant-url>/api/v1/users/<bot-user-ID>" -H "Authorization: Bearer <api-key>"
Ağ geçidi için oluşturulan “DAG Registration” rolünü arayın.

curl "https://<tenant-url>/api/v1/roles?limit=1&filter=(name%20eq%20%22DAG%20Registration%22)" -H "Authorization: Bearer <api-key>"
Rol kimliğini kopyalayın.
Bu rolü silin.

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

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>

Beşinci aşama: Doğrudan Erişim ağ geçidi sunucusunda Qlik Data Gateway - Doğrudan Erişim hizmetini başlatın

Qlik Data Gateway - Doğrudan Erişim hizmetini başlatmak için dcaas-dg ve direct-access-agent kapsayıcılarını başlatın.

Altıncı aşama: Veri kaynağına bir bağlantı ekleyin

Bkz. Altıncı aşama: Veri kaynağına bir bağlantı ekleyin.

Ortam ayarları

Bu bölüm, veri kaynaklarınızı ağ geçidi üzerinden düzgün bir şekilde bağlamak için yapılandırmanız gerekebilecek docker-compose.qlik-data-gateway-direct-access.yml dosyasındaki belirli ortam değişkenlerini listeler.

ALLOW_SOURCES: Ana makine adları ve IP'lerin virgülle ayrılmış izin verilenler listesi. Ağ geçidi aracısının kendi sunucunuzdaki veya yerel ya da özel ağdaki başka bir ana bilgisayardaki bir şeye (örneğin localhost üzerindeki bir veritabanı, bir Docker hizmet adı veya özel IP'li bir ana bilgisayar) bağlanması gerektiğinde, bu adresi ALLOW_SOURCES alanına eklersiniz — aksi takdirde Bağlantı denemesi reddedilir.

Daha fazla bilgi

Bu sayfa size yardımcı oldu mu?

Bu sayfa veya içeriği ile ilgili bir sorun; bir yazım hatası, eksik bir adım veya teknik bir hata bulursanız lütfen bize bildirin!

Geri bildiriminizi buradan iletin