uygulamasını yükseltmeQlik Data Gateway - Doğrudan Erişim

Yeni özellikler ve geliştirmeler

Direct Access gateway 1.6.5 aşağıdaki özellikleri ve iyileştirmeleri sunar:

• SAP ODP bağlayıcısı desteği

  Bu sürüm, Doğrudan Erişim ağ geçidi aracılığıyla bir SAP ODP kaynağına erişim olanağı sunar. Bunu kolaylaştırmak için SAP ODP bağlayıcısına yeni bir Veri ağ geçidi alanı eklendi. Yeni alan, müşterilerin SAP ODP kaynaklarına erişmek için kullanılacak ağ geçidini seçmesine izin verir.

  Ayrıca bkz.: SAP ODP Bağlayıcısı (yalnızca İngilizce)

• Genişletilmiş kayıt tutma özellikleri

  Bu sürüm, Qlik Desteğinin belirli ağ geçidi bileşenleriyle ilgili sorunları gidermek için kullanabileceği yeni bir kaydedici sunar.

• Yeni bölge desteği

  Japonya artık Qlik Cloud kiracı bölgesi olarak desteklenmektedir.

• Performans iyileştirmesi

  Şifrelenmiş oturumlar için iyileştirilmiş bellek atamaları.

Çözülen sorunlar

Direct Access gateway 1.6.5 sürümünde aşağıdaki sorunlar çözüldü:

• Güvenlik açığı

  ODBC bağlayıcısıyla çalışırken parolalar, DCAAS günlüğüne yazılacaktır.

• İşlem izolasyonu performansı

  Ağır yük altında işlemlerin başlaması uzun sürer.

• Yanlış yükleme yolu

  Kullanıcı kurulum sihirbazında farklı bir klasör seçmiş olsa bile Doğrudan Erişim ağ geçidi yüklerken Qlik her zaman kök klasör olarak ayarlanır.

Yeni özellikler ve geliştirmeler

• Yönetim Konsolu kaynağından günlük dosyalarını görüntüleme ve indirme desteği

  Bu sürüm, Yönetim Konsolu içinde Doğrudan Erişim ağ geçidi günlük dosyalarını görüntüleme ve gerekirse bunları Qlik Desteği ile paylaşma yeteneği sunmaktadır. Normal koşullar altında, günlük dosyalarını görüntülemeye gerek yoktur ancak tekrarlayan hatalar veya başka sorunlar yaşıyorsanız günlük dosyaları genellikle sebebi belirlemenize yardımcı olur.

  Ayrıca bkz. Günlük dosyalarının görüntülenmesi ve indirilmesi

• Doğrudan Erişim ağ geçidi uygulamasını sessiz bir şekilde yükleme desteği

  Müşteriler Doğrudan Erişim ağ geçidi uygulamasını sessiz bir şekilde yükleyebilir. Bu da, Doğrudan Erişim ağ geçidi uygulamasını kuruluşunuzda birkaç makineye yüklemeniz gerekiyorsa faydalı olacaktır.

  Ayrıca bkz. Doğrudan Erişim ağ geçidi uygulamasını sessiz bir şekilde yükleme

• İyileştirilmiş oturum devamlılığı

  Bir yeniden yükleme oturumunun süresi dolduğunda genellikle DirectAccess-1012 hatası oluşur. Şimdi Doğrudan Erişim ağ geçidi, Qlik Cloud öğesine daha sık ping göndererek yeniden yükleme oturumunu aktif tutmayı deneyecektir.

Çözülen sorunlar

Direct Access gateway 1.6.4 sürümünde aşağıdaki sorunlar çözüldü:

• configuration.properties dosyasında yanlış parametre adı

  Doğrudan Erişim ağ geçidi uygulamasını yeni yüklerken configuration.properties dosyasındaki EXTEND_FIRST_REQUEST_TIMEOUT parametre adına yanlışlıkla FIRST_REQUEST_TIME_EXTENSION deniyordu.

• Yeniden yükleme bölmesi kullanılabilirliği

  Birden fazla yeniden yükleme aynı yeniden yükleme kimliğini paylaştığında QCS'deki yeniden yükleme bölmelerinin sayısı maksimum düzeye ulaşacaktır.

Doğrudan Erişim ağ geçidi 1.6.3 aşağıdaki iyileştirmeleri ve hata düzeltmelerini içerir:

• Veri kaybını önleme

  Direct Access gateway, önceki sürümlerde potansiyel veri kaybını önlemek için yeniden yükleme sırasında veri kaynağına otomatik olarak yeniden bağlanmadı. Bu sürümden Direct Access gateway artık gerektiğinde veri kaynağına otomatik olarak yeniden bağlanacaktır. Veri kaybını önlemek için tamamlanan yeniden yükleme özeti, yeniden bağlanmadan önce doğrulanacaktır. Veri kaybı algılanırsa yeniden yükleme başarısız olacaktır.

• Yeniden yükleme oturumları için zaman aşımı

  Nadir durumlarda yeniden yükleme oturumu süresiz olarak aktif kalır. Bu tür durumları önlemek için bu sürümde, yeniden yükleme oturumlarında üç saatlik zaman aşımı kullanıma sunulmaktadır.

• Yeniden yükleme istekleri için zaman aşımı uzantısı

  Yeniden yüklemeler bazen başarısız olarak aşağıdaki hataları verebilir:

  Connector error: The session does not exist (DirectAccess-1509)

  Connector error: The stream session expired for the load data request (DirectAccess-1012)

  Bu sorunu ortadan kaldırmak için bir EXTEND_FIRST_REQUEST_TIMEOUT parametresi (yükleme isteği zaman aşımını uzatmak için) configuration.properties dosyasına eklendi. Varsayılan "0"dır. Bu hatalarla sık sık karşılaşan müşteriler zaman aşımını 5-10 dakika olarak ayarlamalıdır.

• Ayrıntılı bağlantı hatası mesajları için destek

  Direct Access gateway aracılığıyla ODBC tabanlı bağlayıcılar kullanırken ayrıntılı bağlantı hata mesajlarını görüntülemek için ek destek. Müşteriler artık ODBC sürücüsü tarafından döndürülen tam hatayı görmek için Gelişmiş bağlayıcı ayarlarında ShowErrorDetailMessage parametresini "true" olarak ayarlayabilir. Ayrıntılı hata mesajı, Veri yükleme düzenleyicisinde gösterilecektir.

  Bilgi notuHata mesajının tamamı, kullandığınız veri kaynağı tarafından sağlanır. Qlik, hata mesajına ek bilgi ilave etmek veya hata mesajını herhangi bir şekilde düzenlemez.

• Aynı yeniden yükleme kimliğine sahip birden fazla yeniden yüklemeyi işleme

  Bu sürümde altyapı oturumu kimliği, aynı yeniden yükleme kimliğiyle birden fazla yeniden yüklemeyi birbirinden ayırt etmek için kullanılacaktır. Bu, potansiyel çakışmaları önleyerek aşağıdaki yeniden yüklemelerin başarısız olup aşağıdaki hatayı vermesini önleyecektir:

  Connector error: data loading error (DirectAccess-4008

Doğrudan Erişim ağ geçidi 1.6.2, işlem izolasyonu modunda çalışırken Bağlayıcı Aracısının bazen çökmesine neden olacak bir sorunu çözer.

Yeni özellikler ve iyileştirmeler

Direct Access gateway 1.6.1 birkaç önemli özellik ve geliştirme sunarak genel kararlılığı ve performansı artırır.

• Yeniden yüklemeleri birden fazla bağlayıcı sürecine yayma desteği

  Bağlayıcı işlem izolasyonu Direct Access gateway'e eklenmiştir. Bu isteğe bağlı bir özelliktir, yani varsayılan olarak kapalıdır. İşlem izolasyonu, ağ geçidi sunucu işletim sistemine doğrudan erişimi olan yöneticilerin bağlayıcı türü başına yeniden yüklemeler için kaç işlemin bulunduğunu kontrol etmesine izin verir. Yeniden yüklemeleri birden fazla bağlayıcı işlemine dağıtmak, her bir bağlayıcı işleminde eş zamanlı olarak gerçekleşen yeniden yüklemelerin sayısını azaltarak izolasyon düzeyini artırır. Daha sonra bu, bağlayıcı çökmelerinin gerçekleştiği durumlarda genel Doğrudan Erişim ağ geçidi kararlılığı artırabilir.

  Ayrıca bkz.: Yeniden yükleme sırasında bağlayıcı çökmelerini ortadan kaldırma

• SAP BW (Direct Access gateway aracılığıyla) bağlayıcısıyla çalışırken yığınlamayı devre dışı bırakma yeteneği eklendi

  Bu sürümde SAP BW (Direct Access gateway aracılığıyla) bağlayıcısı için BEX_ONE_CHUNK uygulama parametresi kullanıma sunuluyor. Performansı optimize etmek için SAP BW'ye doğrudan Qlik Cloud'dan (Direct access gateway aracılığıyla değil) erişirken sonuç seti, SAP arka ucunda yığınlara ayrılır ve ayrı iş parçacıkları olarak okunur. Ancak SAP BW'ye Direct Access gateway aracılığıyla erişirken sonuç setini yığınlara ayırmanın gerçek bir avantajı yoktur. Bunun aksine, veri aktarımı süresi boyunca ek bir TEMP tablosunun oluşturulmasını gerektirdiğinden, SAP'deki paylaşılan belleğin daha fazlasını tüketir. SAP bağlayıcı ikili klasöründeki appsettings.json dosyasında BEX_ONE_CHUNK:false ayarlayarak yığınlamaya başlamak mümkündür (ancak genellikle zorunlu değildir).

• SAP BW (Direct Access gateway aracılığıyla) ve SAP SQL (Direct Access gateway aracılığıyla) bağlayıcıları için tanılama iyileştirmeleri

  SAP BW (Direct Access gateway aracılığıyla) ve SAP SQL (Direct Access gateway aracılığıyla) bağlayıcı günlükleri için aynı bağlantı noktasında yeni bağlayıcı dinleme örneklerinden olayları ayırt etmek üzere günlük dosyası ad uzantısından önce _port son eki eklendi ve bağlayıcının günlük dosyalarına ProcessID=### mesajı eklendi.

• Yeniden bağlantı iyileştirmeleri

  Yeniden yükleme sırasında yeniden bağlantı mekanizması, Direct Access gateway'in artık yeniden yüklemeyi başlatan bölmeye bağlanması gerekmeyecek (daha önce gerekiyordu) şekilde iyileştirilmiştir. Şimdi yeniden yüklemeyi başlatan bölmeye tekrar tekrar bağlanmaya çalışmak yerine (bu genellikle yeniden yükleme hatalarıyla sonuçlanıyordu) artık ilk kullanılabilir bölmeye bağlanacak.

Çözülen sorunlar

Direct Access gateway 1.6.0 sürümünde aşağıdaki sorunlar çözüldü:

• Direct Access gateway aracılığıyla ODBC bağlayıcı günlüğü:

  Yeniden yüklemeler farklı veri kaynaklarından gerçekleştirildiğinde bir veri kaynağından süreçler yanlışlıkla diğer veri kaynağının günlüğünde görünür.

• Kurulumda eksik dosya

  configuration.properties dosyası, Direct Access gateway yüklenirken kopyalanmayacaktır.

• Qlik Cloud kaynak ölçeklendirmesi sırasında yeniden yükleme hatası

  Qlik Cloud kaynak ölçeklendirmesi zaman zaman DirectAccess-1006 hatasıyla sonuçlanır. Direct Access gateway aracılığıyla yapılan uygulama yeniden yüklemeleri sırasında oluşan belirli Qlik Cloud kaynak ölçeklendirme senaryolarını daha iyi ele almak için bir geliştirme yapıldı.

• Snowflake bağlantı hatası

  ODBC (Direct Access gateway aracılığıyla) bağlayıcısı aracılığıyla Snowflake'e bağlanma başarısız olur.

• DLE'de hata ayıklama uygulaması komut dosyası hatası

  Sonuçları Sınırla seçeneği etkinken Veri Yükleme Düzenleyicisi'nde (DLE) uygulama komut dosyalarının hatalarını ayıklamak bazen aşağıdaki hataya neden olabilir:

  Connector error: Invalid load request (DirectAccess-1006).

Çözülen sorunlar:

• ODBC (Direct Access gateway üzerinden) bağlayıcısı: Büyük tabloların yeniden yüklenmesi iptal edilirken bazen bağlayıcı çöküyordu. Bunun önüne geçmeye yardımcı olması için bir iyileştirme yapıldı.

• Microsoft SQL Server (Direct Access gateway üzerinden) bağlayıcısı: Eski Windows Server sürümlerinde barındırılan bir SQL Server ile bağlantı kurmaya çalışırken, TLS uyumluluk sorunu nedeniyle bağlantı başarısız oluyor ve aşağıdaki hata döndürülüyordu:

  Please check the values for Username‚ Password‚ Host and other properties. Description: Client unable to establish connection - ERROR [08001] [Qlik][SqlServer] Problem establishing connection to the server.

  Sorunu düzeltmek için SQL Server sürücüsü güncelleştirildi.

• SAP SQL (Direct Access gateway üzerinden) bağlayıcısı: Bir tablonun ön izlemesini görüntülemeye çalışırken bazen aşağıdaki hata ortaya çıkıyordu:

  Exception of Type System.OutOfMemoryException

• SAP SQL (Direct Access gateway üzerinden) bağlayıcısı: Bir tablonun ön izlemesini görüntülemeye çalışırken bazen birkaç dakika sonra aşağıdaki hatayla birlikte zaman aşımına uğruyordu:

  Request could not be completed.

• SAP SQL (Direct Access gateway üzerinden) ve SAP BW (Direct Access gateway üzerinden) bağlayıcıları: Birden fazla eş zamanlı isteğin sorunlarını gidermeye yardımcı olmak için günlüklere tanılama bilgileri eklendi.

Yeni özellikler ve geliştirmeler:

• Yeni ODBC (Direct Access gateway üzerinden) (yalnızca İngilizce) bağlayıcısı için destek sunar.

• Yönetim Konsolu bölümündeki sürüm sütunu artık RepAgent (alt bileşenlerinden biri) sürümü yerine Doğrudan Erişim ağ geçidi sürümünü gösterecektir.

Çözülen sorunlar:

• Doğrudan Erişim ağ geçidi yükseltmesi, gelişmiş ODBC Bağlayıcısı günlük kaydı ayarlarını (günlük dosyası saklama ve maksimum boyut gibi) varsayılana sıfırlar.
• Nadir durumlarda, ODBC bağlayıcısı çökebilir ve Doğrudan Erişim ağ geçidi aracısı tarafından yeniden başlatılamaz.
• Bir bağlantı başarısız olduğunda veya SQL sorgusu geçerli olmadığında, gerçek hata nedeni yerine genel bir "Değer ve uzunluk sınırların dışındaydı..." hatası döndürülüyordu.
• Nadir senaryolarda, hub yeniden yüklemeleri, ilk ağ geçidi sorgusundan sonra uzun gecikmeler veya işlemler yaşayan 3 GB'den büyük uygulamalar için "DirectAccess-4008" hatasıyla başarısız oluyordu. İlgili sorunların tespit edilmesine yardımcı olmak için ek günlük kaydı eklenmiştir.

Çözülen sorunlar:

• C:\ProgramData\Qlik\Gateway\configuration.properties dosyasında ODBC_LOG_LEVEL değerinin değiştirilmesinin hiçbir etkisi olmayacaktır.

• Etkin bir Doğrudan Erişim ağ geçidi bağlantısı birkaç dakika boyunca kullanılmazsa yeniden yükleme aşağıdaki hata nedeniyle başarısız olur:

  Connector error: Invalid load request (DirectAccess-1006)

  Oturum hâlâ aktifse zaman aşımına uğramayarak sorun çözüldü.

• MySQL ve PostgreSQL'den çok sayıda sütun içeren tabloların yüklenmesi bazen aşağıdaki hata nedeniyle başarısız oluyordu:

  System.InvalidOperationException: Failed to HPACK encode the headers

• Kullanıcıların Doğrudan Erişim ağ geçidini içeren bir Yönetilen Alan üzerinde ayrıcalıkları olmadığında, aşağıdaki belirsiz hata gösterilirdi:

  Requested endpoint could not be provisioned due to failure to acquire a load slot: Object reference not set to an instance of an object.

  Hata mesajı, sorunun daha doğru bir açıklaması eklenerek iyileştirildi.

• Çoklu yeniden yükleme denemeleri bazen aşırı bellek tüketimi nedeniyle başarısız oluyordu.

Özellikler ve geliştirmeler:

Doğrudan Erişim ağ geçidi sağlığını periyodik olarak denetler. Bu sürümden başlayarak, Doğrudan Erişim ağ geçidi servisi beş dakika yanıt vermezse sağlık denetimi servisi yeniden başlatılacaktır.

Çözülen sorunlar:

• Meta verileri hemen döndüren ancak yalnızca ilk veri öbeğini birkaç dakika sonra döndüren sorguya sahip bir yeniden yüklemeyi başlatırken, bazen aşağıdaki hata oluşabilir:

  Connector error: data loading error (DirectAccess-4008)

• Belli senaryolarda, bir yeniden yükleme kesildiğinde Doğrudan Erişim ağ geçidi Qlik Cloud öğesine yeniden bağlanmayabilir.

• Nadir durumlarda, yeniden yüklemeler esnasında aşağıdaki hata ile karşılaşılabilir:

  No connection could be made because the target machine actively refused it.

• SQL Server'a bağlanırken, parolalardaki özel karakterler doğru şekilde kodlanmayarak aşağıdaki hataya neden olabilir:

  Command test connection returned non-success: Error message: Please check the values for Username‚ Password‚ Host and other properties. Description: Access credentials are not valid for this connection.

• Sorgu veri döndürürken kullanıcı arayüzünden yükleme etkinliğini durdurduğunda ODBC bağlayıcısı bazen kilitlenebilir.

• Ağır yüklerle ilgili nadir senaryolarda, yeniden yükleme işlemleri bazen aşağıdaki hatalarla başarısız olabilir:

  Connector error: Unknown reason:. Index was outside the bounds of the array. (DirectAccess-1500)

Qlik Cloud kiracısının kimlik doğrulaması için gereken CA sertifikaları güncellendi.

Bu sürüm aşağıdaki sorunu çözer:

Qlik Data Gateway - Doğrudan Erişim 1.3.1 belirli senaryolarda aşırı CPU kullanımına yol açabilir. Sürüm 1.3.2 bu sorunu çözer ancak başka bir değişiklik içermez. CPU ile ilgili hataları önlemek için tüm müşterilerin derhal 1.3.2 sürümüne yükseltme yapmalarını öneriyoruz.

Bu sürüm Qlik Cloud Government için CA paketini içerir ve çeşitli sorunları çözer.

Qlik Cloud Government için CA paketi dosyası

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

Önceki Doğrudan Erişim ağ geçidi sürümlerinde, ihtiyaç olması halinde CA paket dosyası Qlik Cloud Government müşterileri için Qlik tarafından sağlanırdı. Bu sürümden itibaren CA paket dosyası yüklemeye dahildir.

Varsayılan kurulumda, CA paketi dosyası aşağıdaki konuma yüklenmiştir: C:\Program Files\Qlik\ConnectorAgent\caBundle]qcg_ca_bundle.pem

Çözülen sorunlar

• Proxy bağlantısı için kullanılan HTTP istemcisinin bir yeniden yönlendirmeyi takip etmesine neden olan bir güvenlik açığı belirlendi.

• Doğrudan Erişim ağ geçidi aracı bazen aşağıdaki hatayı vererek kilitlenir:

  Unable to write data to the transport connection: An established connection was aborted by the software in your host machine

• Kayıt başlatma sırasında bazen bir istisna oluşabilir. Bu da Doğrudan Erişim ağ geçidi öğesinin yeniden başlatma sırasında beklemesine neden olur.
• Gereksiz zaman aşımlarını önlemek için yeniden yükleme oturumu işleme iyileştirildi.
• Yönetim Konsolu içindeki Doğrudan Erişim ağ geçidi Sürüm sütunu, yanlış sütunu gösterir.
• Aracı, kullanıcı görevi durdurduktan veya kota sınırına ulaşıldıktan sonra ağ geçidine veri göndermeye devam eder.
• Veri Ağ Geçidi için uçtan uca şifreleme varsayılan olarak etkin değildi, ayrıca çalışma zamanı bayrakları tarafından kontrol edilirdi.

Bu sürüm, aşağıdaki sorunları çözer:

• Qlik Data Gateway'in 1.2 versiyonu - Dijital imzasıyla ilgili bir sorun nedeniyle Doğrudan Erişim'in yüklenmesi engellenebilir.
• Yapılandırma dosyaları güncelleme sırasında üzerine yazılıyor ve bu, değişikliklerin kaybolmasına neden oluyordu

Özellikler ve geliştirmeler:

• SAP BW ve SAP SQL kaynakları için destek eklendi. Bu kaynaklara yönelik bağlantı ayarlama hakkında bilgi için bk. SAP NetWeaver (yalnızca İngilizce).

Çözülen sorunlar:

• Qlik Data Gateway - Doğrudan Erişim hizmetinde kararlılık ve kurtarılabilirlik iyileştirmeleri yapıldı, hizmetin manuel olarak yeniden başlatılması gerekmiyor
• Varsayılan Doğrudan Erişim ağ geçidi yüklemesi ve yapılandırma parametreleri üzerine yazma desteği

Özellikler ve geliştirmeler:

• Windows Server 2022 desteği eklendi

Çözülen sorunlar:

• Kurulum sırasında özel bir yol seçmeyle ilgili olası bir kararlılık sorunu çözüldü

1.1.0

18 Ekim 2022

Özellikler ve geliştirmeler:

• Oracle Wallets için destek
• Google BigQuery için destek
• Geliştirilmiş hata mesajları

Çözülen sorunlar:

• Sürücü kilitlenmelerinden sonra daha iyi sistem kurtarılabilirliği
• Qlik Data Gateway - Doğrudan Erişim hizmeti bazen beklenmeyen şekilde çalışmayı durduruyor