Qlik Data Gateway - Doğrudan Erişim uygulaması kurulumu | Qlik Cloud Yardımı
Ana içeriğe geç Tamamlayıcı içeriğe geç
Qlik Kaynakları
SearchUnify araması yükleniyor Ürününüzle ilgili yardıma ihtiyacınız varsa lütfen Qlik Desteği ile iletişime geçin.
Qlik Müşteri Portalı
SearchUnify araması yükleniyor Ürününüzle ilgili yardıma ihtiyacınız varsa lütfen Qlik Desteği ile iletişime geçin.
Qlik Müşteri Portalı

Qlik Data Gateway - Doğrudan Erişim uygulaması kurulumu

Son güncelleme: 30.09.2026

Qlik Data Gateway - Doğrudan Erişim kurulumunu ya bir Windows sunucusunda ya da kapsayıcılı bir ortamda yapabilirsiniz. Başarılı bir kurulum için, özel kurulum iş akışınıza yönelik önkoşullar, yükleme talimatları, sınırlamalar ve dikkat edilmesi gereken hususlar hakkında bilgi sahibi olduğunuzdan emin olun.

Kurulum iş akışları

Aşağıdaki iş akışlarından birini seçin:

Sistem önkoşulları

Yazılım gereksinimleri

Kurulum yönteminize bağlı olarak aşağıdakilerden birine bakın:

Ortak gereksinimler

Bu gereksinimler hem Windows sunucu hem de kapsayıcılı kurulumlar için geçerlidir.

Gerekli bağlantı noktaları ve protokoller

Aşağıdaki bölüm gerekli bağlantı noktalarını listelemektedir.

Giden bağlantı noktaları

HTTPS/TCP-443, <tenant-id>.<region>.qlikcloud.com ile giden iletişim için açılmalıdır.

Dahili bağlantı noktaları

Dahili veri ağ geçidi işlemleri tarafından iletişim için kullanılan bağlantı noktalarının bir listesi aşağıda verilmiştir. Bu bağlantı noktalarından herhangi bir başka bir uygulama tarafından kullanılıyorsa diğer uygulamayı yeniden yapılandırın veya kaldırın.

Genel bağlantı noktaları

  • 5050 (Bağlayıcı Aracısı REST API'si)
  • 9027 (DCAAS REST API'si)

ODBC bağlantı noktaları

  • 3005 (ODBC Bağlayıcısı REST API'si)
  • 50260 (ODBC Bağlayıcısı gRPC'si)

SAP bağlantı noktaları

  • 3015 (SAP BW Bağlayıcı REST API)
  • 50270 (SAP BW Bağlayıcı gRPC)
  • 3025 (SAP SQL Bağlayıcı REST API)
  • 50280 (SAP SQL Bağlayıcı gRPC)
  • 3035 (SAP ODP Bağlayıcı REST API)
  • 50290 (SAP ODP Bağlayıcı gRPC)

  • 3035 (SAP Package Bağlayıcı REST API)

  • 50290 (SAP Package Bağlayıcı gRPC)

REST bağlantı noktaları

  • 3055 (REST Bağlayıcısı REST API'si)
  • 50310 (REST Bağlayıcısı gRPC)

Dosya bağlantı noktaları

  • 3045 (Dosya Bağlayıcısı REST API'si)
  • 50300 (Dosya Bağlayıcısı gRPC)

WSS protokolü

Doğrudan Erişim ağ geçidi, HTTPS'ye ek olarak WSS (WebSocket Secure) protokolünü de kullanır. Bu nedenle, güvenlik duvarınızın ve proxy sunucunuzun (kullanmayı düşünüyorsanız) giden WSS bağlantılarına izin verecek şekilde ayarlandığından emin olun.

Önerilen donanım

Kurulum yönteminize bağlı olarak aşağıdakilerden birine bakın:

Sistem şifrelemesi (yalnızca Windows sunucu kurulumu)

Bkz. Sistem şifreleme.

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

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

Kurulum yönteminize bağlı olarak aşağıdakilerden birine bakın:

İkinci aşama: Yüklemek veya dağıtmak Doğrudan Erişim ağ geçidi

Kurulum yönteminize bağlı olarak aşağıdakilerden birine bakın:

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

Bu aşama Qlik Cloud kiracı URL'nizi ayarlamayı, isteğe bağlı olarak bir proxy sunucu ayarlamayı ve bir kayıt anahtarı oluşturmayı içerir. Anahtarı, Yönetim etkinlik merkezinde veri ağ geçidi anahtarı ayarlarına kopyalamanız gerekir (aşağıdaki 3. aşama). Anahtar Doğrudan Erişim ağ geçidi ile Qlik Cloud kiracısı arasında kimlik doğrulamalı bir bağlantı kurmak için kullanılır.

Bilgi notu

Qlik Anonim kiracısına (İsveç bölgesi) bağlanma işlemi desteklenmez.

Doğrudan Erişim ağ geçidi 1.7.16 sürümünden itibaren Kanada bölgesi artık desteklenmektedir. Ağ geçidi kurulum dosyasını dağıtırken Yönetim etkinlik merkezindeki dağıtım sırasında Kanada bölgesini seçin.

Direct Access gateway makinesinde, kurulum iş akışınıza bağlı olarak aşağıdakilerden birini yapın:

  • Windows sunucusu: Yönetici olarak bir Komut İstemi açın ve çalışma dizinini ConnectorAgent alt klasörüne (varsayılan bir yüklemede C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent) değiştirin.

  • Kapsayıcıya alınmış: direct-access-agent kapsayıcısının içinde bir konsol açın.

Ardından aşağıda açıklandığı gibi devam edin.

Qlik Cloud kiracıyı ayarlama

Bağlanılacak Qlik Cloud kiracısını seçin. Kiracıya bir proxy sunucusu aracılığıyla bağlanmak için ilgili parametreleri komut satırına aşağıda gösterildiği gibi ekleyin.

Proxy sunucu olmadan Qlik Cloud kiracısını ayarlama komutları:

  • Windows sunucu kurulumu

    • Söz Dizimi:connectoragent qcs set_config --tenant_url your-qlik-cloud-tenant-url

    • Örnek: connectoragent qcs set_config --tenant_url mytenant.us.qlikcloud.com

  • Konteynerleştirilmiş kurulum

    • Söz Dizimi:dotnet ConnectorAgent.dll qcs set_config --tenant_url your-qlik-cloud-tenant-url

    • Örnek: dotnet ConnectorAgent.dll qcs set_config --tenant_url mytenant.us.qlikcloud.com

Qlik Cloud kiracısını bir proxy sunucusu ile ayarlamak için komutlar:

  • Windows sunucu kurulumu

    • Söz Dizimi:connectoragent qcs set_config --tenant_url your-qlik-cloud-tenant-url --proxy_url http://host:port --proxy_username username --proxy_password password

    • Örnek: connectoragent qcs set_config --tenant_url mytenant.us.qlikcloud.com --proxy_url http://myproxy:1212 --proxy_username admin --proxy_password f56weqs@

  • Konteynerleştirilmiş kurulum

    • Söz Dizimi:dotnet ConnectorAgent.dll qcs set_config --tenant_url your-qlik-cloud-tenant-url --proxy_url http://host:port --proxy_username username --proxy_password password

    • Örnek: dotnet ConnectorAgent.dll qcs set_config --tenant_url mytenant.us.qlikcloud.com --proxy_url http://myproxy:1212 --proxy_username admin --proxy_password f56weqs@

Proxy sınırlamaları hakkında bilgi için bkz. Qlik Cloud uygulamasına proxy sunucu üzerinden bağlanma.

CA paketini ayarlama

CA paketi, Qlik Cloud kiracısının kimliğini doğrular ve böylece güvenilir bir bağlantı sağlar.

CA paketini kimin ayarlaması gerekir?

CA paketinin yalnızca aşağıdaki olmanız durumunda ayarlanması gerekir:

  • Bir Qlik Cloud Government müşterisi
  • Proxy gibi davranan ve Internet'ten alınan sertifika bilgilerini kendi CA kök sertifikalarıyla değiştiren bir güvenlik cihazı kullanan Qlik Cloud ticari müşterisi

Hangi paketi kullanmalıyım?

Müşteriler ya Qlik CA paketini kullanmalı ya da kendi CA paketlerini aşağıdaki şekilde getirmelidir:

  • Qlik CA paketle sağlar: Standart bir ortama sahip Qlik Cloud Government müşterileri tarafından kullanılmalıdır. Standart ortam, proxy gibi davranan ve Internet'ten alınan sertifika bilgilerini kendi CA kök sertifikalarıyla değiştiren bir güvenlik cihazı içermeyen ortamdır.

    Varsayılan Doğrudan Erişim ağ geçidi yüklemesinde, CA paketi dosyası aşağıdaki konumda bulunabilir:

    • Windows sunucu kurulumu: C:\Program Files\Qlik\ConnectorAgent\caBundle\qcg_ca_bundle.pem

    • Kapsayıcılı kurulum: /usr/share/Qlik/Gateway/ssl/qcg_ca_bundle.pem

    Bilgi notuCA paket dosyasını yeniden adlandırabilirsiniz ancak dosyanın .pem uzantısına sahip olduğundan emin olun (örneğin, qlikcerts.pem). Ardından aşağıda açıklanan komutları çalıştırın.
  • Müşteriler kendi CA paketle getirir: Müşteriye ait ortam, proxy işlevi gören ve İnternet'ten alınan sertifika bilgilerini kendi CA kök sertifikalar ile değiştiren bir güvenlik cihazı kullanıyorsa kullanılmalıdır. Bu sertifikalar otomatik olarak imzalanmışsa CA paketini ayarlama komutuna ek olarak CA paketine izin verme komutunu da çalıştırmanız gerekir. Bu komutların her ikisi de aşağıda açıklanmaktadır. Bu hem Qlik Cloud Government müşterileri hem de Qlik Cloud ticari müşterileri için geçerlidir.

CA paketini ayarlama komutu

CA sertifika paketini ayarlamak için aşağıdaki komutu çalıştırın:

Söz dizimi (Windows sunucu kurulumu):

connectoragent qcs set_config --ca_bundle_path path-to-ca-bundle-file

Sözdizimi (kapsayıcılı kurulum):

dotnet ConnectorAgent.dll qcs set_config --ca_bundle_path path-to-ca-bundle-file

Örnek (Windows sunucu kurulumu):

connectoragent qcs qcs set_config --ca_bundle_path c:\ca\cacerts.pem

Örnek (kapsayıcılı kurulum):

dotnet ConnectorAgent.dll qcs set_config --ca_bundle_path c:\ca\cacerts.pem

CA paketine izin verme komutu

Bazı ortamlar proxy gibi davranan ve Internet'ten alınan sertifika bilgilerini kendi CA kök sertifikalarıyla değiştiren bir güvenlik cihazı kullanır. Bu komutun yalnızca güvenlik cihazının kendisinin otomatik olarak imzalanmış bir sertifika kullanması durumunda çalıştırılması gerekir. Böyle bir durumda, aşağıdaki komutu çalıştırmazsanız CA paketine güvenilmeyebilir:

  • Windows sunucu kurulumu:

    connectoragent qcs set_config --ca_bundle_allow_invalid_certs true

  • Kapsayıcılı kurulum:

    dotnet ConnectorAgent.dll qcs set_config --ca_bundle_allow_invalid_certs true

Bilgi notuOrtamınızın bu tür bir güvenlik cihazı kullanıp kullanmadığından emin değilseniz lütfen BT yöneticinize başvurun.

Kayıt anahtarını oluşturma ve gösterme

Anahtar Doğrudan Erişim ağ geçidi ile Qlik Cloud kiracısı arasında kimlik doğrulamalı bir bağlantı kurmak için kullanılır.

Kayıt anahtarını oluşturma komutları

  • Windows sunucu kurulumu:

    connectoragent qcs generate_keys

  • Konteynerleştirilmiş kurulum:

    dotnet ConnectorAgent.dll qcs generate_keys

Kayıt anahtarını gösterme komutları

dotnet ConnectorAgent.dll qcs get_registration

  • Windows sunucu kurulumu:

    connectoragent qcs get_registration

  • Konteynerleştirilmiş kurulum:

    dotnet ConnectorAgent.dll qcs get_registration

Anahtar gösterilir.

Anahtarın tamamını yukarıdaki örnekte gösterildiği gibi kopyalayın. Sonraki aşamada anahtarı Yönetim etkinlik merkezine yapıştırmanız gerekecek.

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.

Seçenek 1: Yönetim etkinlik merkezi aracılığıyla

Uyarı notuDoğrudan Erişim ağ geçidi kaydetmek, güvenli ağ geçidi-kiracı iletişimi için Kimlik sağlayıcı (Çoklu bulut) girişini Yönetim etkinlik merkezinde otomatik olarak oluşturur. Kimlik sağlayıcı açıklaması, ilgili ağ geçidini Veri ağ geçitleri bölümünde (Yönetim etkinlik merkezinin) kolayca bulmanızı sağlayan ağ geçidi kimliğini (veren gateway_id) içerir. Ağ geçidi Kimlik sağlayıcı'yı silmek, ağ geçidinin bağlantısını kesecektir, bu nedenle bunu yalnızca ağ geçidinin artık gerekli olmadığından kesinlikle eminseniz yapmalısınız. Yanlışlıkla Kimlik sağlayıcı'yı sildiyseniz, Doğrudan Erişim ağ geçidi'yi yeniden başlatmak girişi geri yükleyecek ve ağ geçidini yeniden bağlayacaktır.

  1. 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.

  2. Oluştur araç çubuğu düğmesine tıklayın.

    Veri ağ geçidi oluştur diyalog penceresi açılır.

  3. Veri ağ geçidi için bir ad belirtin.

  4. İsteğe bağlı olarak veri ağ geçidi için bir açıklama girebilirsiniz.

  5. Veri ağ geçidi tür açılır listesinden Doğrudan Erişim'i seçin.

  6. İlişkili alan açılır listesinden bir alan seçin.

    Doğrudan Erişim ağ geçidini bir alan ile ilişkilendirirken aşağıdakilerin farkında olmalısınız:

    • Veri ağ geçitleri yalnızca paylaşılan veya yönetilen alanlarda oluşturulabilir
    • Başka bir alandan veri ağ geçidi kullanan bir alandan veri bağlantısı oluşturmak için veri ağ geçidi alanında Veri tüketebilir rolüne sahip olmanız gerekir.

    • Veri ağ geçidi oluşturmak için bir alan sahibi olmanız veya Yönetebilir rolüne sahip olmanız gerekir. Kullanıcı tabanlı abonelikler için ayrıca Profesyonel yetkisine ihtiyacınız vardır. Daha fazla bilgi için şuraya bakın: Kullanıcı yetkilendirmelerini yönetme.

    • Veri ağ geçitleri yalnızca tek bir alanla ilişkilendirilebilir.

  7. Daha önce oluşturduğunuz anahtarı Anahtar alanına yapıştırın.

  8. Oluştur'a tıklayın.

    Veri ağ geçidi Veri ağ geçitleri listesine eklenir ve etkinleştirilir.

Seçenek 2: Komut satırı kullanılarak otomatik kayıt

Ayrıca Yönetim etkinlik merkezini kullanmadan, Doğrudan Erişim ağ geçidi kaydını komut satırından otomatik olarak da yapabilirsiniz.

Talimatlar için kurulum iş akışınıza bağlı olarak aşağıdakilerden birine bakın:

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

Ardından, Qlik Data Gateway - Doğrudan Erişim hizmetini başlatmanız gerekir.

Kurulum yönteminize bağlı olarak aşağıdakilerden birine bakın:

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

Ağ geçidinizi Veri ağ geçitleri listesinde bulun ve Durum'unun "Bağlandı" olduğundan emin olun (geçerli durumu görmek için tarayıcınızı yenilemeniz gerekebilir). Bundan sonra veri kaynağınıza bir bağlantı eklemeye geçebilirsiniz.

Veri kaynağından veri yüklemenin birkaç yolu vardır: 

Mevcut veri kaynaklarının listesi, ağ geçidi bağlantılarını destekleyen veri kaynakları için yinelenen girişler içerecektir. Ağ geçidi uyumlu veri kaynakları, kaynağından adından sonra ayraçlar içinde görünen "Doğrudan Erişim ağ geçidi üzerinden" ifadesiyle tanınabilir.

Ağ geçidi uyumlu kaynak bağlantısı örneği

Ağ geçidi uyumlu kaynak bağlantısı örneği
Bilgi notuAğ geçidi uyumlu veri kaynakları için Veri bağlantısı ekle diyalog penceresinde, kullanılacak ağ geçidini seçmenize izin veren ilave bir Doğrudan Erişim ağ geçidi alanı bulunur.

Genel sınırlamalar ve dikkat edilmesi gereken noktalar

  • Doğrudan Erişim ağ geçidi yalnızca tek bir kiracıya bağlanabilir.
  • Herhangi bir nedenle Qlik uygulamasının yeniden yüklenmesi sırasında Doğrudan Erişim ağ geçidi sunucusu yeniden başlatılırsa yeniden yükleme başarısız olur. Verileri yenilemek için Qlik uygulama yeniden yüklemesini yeniden başlatın.

  • Yeniden yükleme komut dosyası sorguları 500.000 karakteri aşamaz.

    Komut dosyalarını yeniden yükleme hakkında bilgi için bkz. Kod çalıştırma.

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