メイン コンテンツをスキップする 補完的コンテンツへスキップ

Qlik Data Gateway - 直接アクセス のアップグレード

このセクションでは、各 Direct Access ゲートウェイ バージョンの新機能を列挙し、インストールをアップグレードする方法を説明します。

Qlik Data Gateway - 直接アクセス バージョン履歴

バージョン

リリース日

顕著な変更

サポート終了日

1.6.4 2024 年 3 月 7 日
  • このバージョンでは、管理コンソール にある Direct Access gateway ログ ファイルを表示する機能と、必要に応じてそれらのファイルを Qlik サポートと共有する機能を導入しています。通常の状況下では、ログ ファイルを表示する必要はありませんが、失敗が繰り返されたり、その他の問題が発生したりした場合に、ログ ファイルは原因を特定する助けになります。

    参照先:ログ ファイルの表示とダウンロード

  • 組織全体で複数のマシンに Direct Access gateway をインストールする必要がある場合、お客様は Direct Access gateway をサイレントにインストールできるようになりました。

    参照先:サイレントなインストール Direct Access gateway

  • リロード セッションの有効期限が切れると、DirectAccess-1012 エラーが発生する場合があります。現在、Direct Access gateway は、Qlik Cloud をより頻繁にピン留めすることにより、リロード セッションの有効性を維持するように努めます。

Direct Access gateway 1.6.4 では、次の問題が解決されています。

  • Direct Access gateway を新しくインストールするときに、configuration.properties ファイル内の EXTEND_FIRST_REQUEST_TIMEOUT パラメーター名が FIRST_REQUEST_TIME_EXTENSION と誤って呼ばれる場合があります。

  • 複数のリロードが同一のリロード ID を共有すると、QCS 内のリロード ポッドは最大数に達します。

次のメジャー バージョンがリリースされる時期の決定
1.6.3 2024 年 1 月 30 日

Direct Access gateway 1.6.3 には、次の機能強化およびバグ修正が含まれています。

  • データ損失の防止

    以前のバージョンでは、データ損失の可能性を防ぐために、Direct Access gateway はリロード中にデータ ソースに自動的に再接続しませんでした。このバージョンから、Direct Access gateway は必要に応じてデータ ソースに自動的に再接続するようになりました。データ損失を防ぐため、再接続する前に完了したリロードの概要が確認されます。データ損失が検出された場合、リロードは失敗します。

  • リロード セッションのタイムアウト

    まれに、リロード セッションが無期限に存続する場合があります。このような事態を防ぐために、このバージョンではリロード セッションに 3 時間のタイムアウトを導入しています。

  • ロード リクエストのタイムアウトの延長

    リロードが次のエラーで失敗する場合がありました。

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

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

    この問題を軽減するために、EXTEND_FIRST_REQUEST_TIMEOUT パラメーター (ロード要求のタイムアウトを延長するため) が configuration.properties ファイルに追加されました。既定は「0」になっています。このようなエラーが頻繁に発生する場合は、タイムアウトを 5 ~ 10 分に設定してみてください。

  • 詳細な接続エラー メッセージのサポート

    Direct Access gateway コネクタ経由で ODBC ベースを使用する場合に、詳細な接続エラー メッセージを表示するためのサポートが追加されました。ユーザーは、コネクタの [詳細] 設定の ShowErrorDetailMessage パラメータを「true」に設定して、ODBC ドライバーから返される完全なエラーを確認できるようになりました。詳細なエラー メッセージがデータ ロード エディターに表示されます。

    情報メモエラー メッセージ全体は、使用しているデータ ソースによって提供されます。Qlik がエラー メッセージに情報を追加することや、編集することはありません。
  • 同じリロード ID での複数のリロードの処理

    このバージョンからは、同じリロード ID を持つ複数のリロードを区別するためにエンジン セッション ID が使用されます。これにより、潜在的な競合が回避され、リロードが次のエラーで失敗する可能性があります。

    Connector error: data loading error (DirectAccess-4008

次のメジャー バージョンがリリースされる時期の決定
1.6.2 2024 年 1 月 9 日

Direct Access gateway 1.6.2 では、プロセス分離モードで動作中にコネクタ エージェントがクラッシュする問題が解決されています。

警告メモ プロセス分離モードで Direct Access gateway 1.6.1 を使用しているお客様は、このバージョンにアップグレードすることを強くお勧めします。
次のメジャー バージョンがリリースされる時期の決定
1.6.1 2023 年 12 月 12 日

Direct Access gateway 1.6.1 では、いくつかの重要な機能と拡張機能が導入され、全体的な安定性とパフォーマンスが向上しています。

  • コネクタ プロセスの分離が Direct Access gateway に追加されました。これはオプトイン機能であり、既定ではオフになっています。プロセス分離 ゲートウェイ サーバー オペレーティング システムに直接アクセスできる管理者は、コネクタ タイプごとにリロードに使用できるプロセスの数を制御できます。リロードを複数のコネクタ プロセスに分散すると、各コネクタ プロセスで同時に実行されるリロードの数が減り、分離レベルが高まります。これにより、コネクタのクラッシュが発生した場合の Direct Access gateway 全体の安定性が向上します。

    参照先:リロード中のコネクタのクラッシュを軽減する

  • このバージョンでは、SAP BW (Direct Access gateway 経由) コネクタ用の BEX_ONE_CHUNK アプリケーション パラメーターが導入されています。Qlik Cloud から SAP BW に直接 (つまり、Direct Access gateway 経由ではなく) アクセスする場合、パフォーマンスを最適化するために、結果セットは SAP バックエンドでチャンクに分割され、別のスレッドとして読み取られます。ただし、Direct Access gateway 経由で SAP BW にアクセスする場合、結果セットをチャンクに分割しても実質的なメリットはありません。逆に、データ転送中に追加の一時テーブルを作成する必要があるため、SAP の共有メモリがより多く消費されます。SAP コネクタのバイナリ フォルダーにある appsettings.json ファイルで BEX_ONE_CHUNK:false を設定することで、チャンキングを開始できます (通常は必須ではありません)。

  • SAP BW (Direct Access gateway 経由) および SAP SQL (Direct Access gateway 経由) コネクタのログについて、ログ ファイル名の拡張子の前に _port サフィックスが追加され、同じポートでリッスンしているコネクタの新しいインスタンスからのイベントを区別するために、コネクタのログファイルに ProcessID=### メッセージが追加されました。

  • リロード中の再接続メカニズムが改善され、Direct Access gateway はリロードを開始したポッドに接続する必要がなくなりました (以前のケースと同様)。今後は、リロードを開始したポッドへの接続を繰り返し試行する (リロード失敗の原因となることが多かった) のではなく、最初に使用可能なポッドに接続します。

Direct Access gateway 1.6.0 では、次の問題が解決されています。

  • 異なるデータ ソースからリロードが実行されると、一方のデータ ソースからのプロセスが、もう一方のデータ ソースのログに誤って表示されていました。

  • Direct Access gateway のインストール時に、configuration.properties ファイルがコピーされませんでした。

  • Qlik Cloud リソースのスケーリングにより、DirectAccess-1006 エラーが発生する場合がありました。Direct Access gateway 経由で実行されるアプリケーションのリロード中に発生する、特定の Qlik Cloud リソース スケーリング シナリオの処理を改善するための機能強化が行われました。

  • ODBC (Direct Access gateway 経由) コネクタ経由で Snowflake に接続すると失敗していました。

  • [Limit Results] (結果を制限) オプションを有効にしてデータ ロード エディター (DLE) でアプリケーション スクリプトをデバッグすると、次のエラーが発生して失敗することがありました。

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

次のメジャー バージョンがリリースされる時期の決定
1.5.3 2023 年 9 月 23 日
  • ODBC (Direct Access gateway 経由) コネクタ: 大きなテーブルのリロードをキャンセルすると、コネクタがクラッシュすることがありました。この問題に対する改善が実施されました。
  • Microsoft SQL Server (Direct Access gateway 経由) コネクタ: 古いバージョンの Windows Server でホストされている SQL Server への接続を確立しようとすると、TLS 互換性の問題により接続が失敗し、次のエラーが返されていました。

    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.

    SQL Server ドライバーを更新し、問題は修正されました。

  • SAP SQL (Direct Access gateway 経由) コネクタ: テーブルをプレビューしようとすると、次のエラーが発生する場合がありました。

    Exception of Type System.OutOfMemoryException

  • SAP SQL (Direct Access gateway 経由) コネクタ: テーブルをプレビューしようとすると、数分後に次のエラーが発生してタイムアウトになる場合がありました。

    Request could not be completed.

  • SAP SQL (Direct Access gateway 経由) コネクタおよび SAP BW (Direct Access gateway 経由) コネクタ: 複数の同時リクエストのトラブルシューティングに役立つ診断情報をログに追加しました。

2024 年 6 月 12 日

1.5.2 2023 年 9 月 19 日
  • 新しい ODBC (Direct Access gateway 経由) (英語のみ) コネクタのサポートを提供します。

  • 管理コンソール の [バージョン] 列には、RepAgent (サブコンポーネントの 1 つ) のバージョンではなく、Direct Access gateway バージョンが表示されるようになりました。
  • Direct Access gateway をアップグレードすると、ODBC コネクタの詳細なログ設定 (ログ ファイルの保持や最大サイズなど) が既定にリセットされます。
  • まれに、ODBC コネクタがクラッシュし、Direct Access gateway エージェントにより再起動できないことがありました。
  • 接続に失敗した場合、または SQL クエリが有効でない場合に、実際のエラーの原因ではなく、一般的な「オフセットと長さが範囲外でした...」というエラーが返されていました。
  • 最初のゲートウェイ クエリ後に遅延または処理が発生した 3 GB を超えるアプリの場合、まれにハブのリロードが「DirectAccess-4008」エラーで失敗することがありました。関連する問題の特定を支援するために、ログが追加されました。

2024 年 6 月 12 日

1.4.2 2023 年 7 月 13 日

解決した問題:

  • C:\ProgramData\Qlik\Gateway\configuration.properties ファイルの ODBC_LOG_LEVEL 値を変更しても影響はありません。

  • アクティブな直接アクセス ゲートウェイ接続が数分間使用されなかった場合、リロードは次のエラーにより失敗します。

    Connector error: Invalid load request (DirectAccess-1006)

    この問題は、セッションがまだ生きている場合はタイムアウトしないことで解決されました。

  • MySQL および PostgreSQL から多数の列を含むテーブルをロードすると、次のエラーが発生し失敗する場合がありました。

    System.InvalidOperationException: Failed to HPACK encode the headers

  • ユーザーが直接アクセス ゲートウェイを含む管理スペースに対する権限を持っていない場合、次の不明瞭なエラーが表示される場合がありました。

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

    エラー メッセージが改善され、問題の説明がより正確になりました。

  • 過剰なメモリ消費により、複数回のリロードに失敗する場合がありました。

2024 年 2 月 19 日
1.4.1 2023年6月20日

機能と機能強化:

Direct Access gateway は定期的にヘルスチェックを実行します。このバージョン以降、5 分間応答がない場合、ヘルス チェックによって Direct Access gateway サービスが再起動されます。

解決した問題:

  • すぐにメタデータを返し、数分後に最初のデータ チャンクのみを返すクエリでリロードを開始すると、次のエラーが発生する場合があります。

    Connector error: data loading error (DirectAccess-4008)

  • 特定のシナリオにおいて、リロードが中断されたときに Direct Access gatewayQlik Cloud に再接続しません。

  • まれに、リロード中に次のエラーが発生します。

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

  • SQL Server に接続するときに、パスワードの特殊文字が正しくエンコードされず、次のエラーが発生します。

    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.

  • クエリがデータを返している間にユーザー インターフェイスからロード アクティビティを中止すると、ODBC コネクタがクラッシュする場合があります。

  • 大きな負荷に関連するまれなシナリオにおいて、次のエラーによりリロードが失敗する場合があります。

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

2024 年 2 月 19 日
1.4.0 2023 年 6 月 15 日

Qlik Cloud テナントを認証するのに必要な CA 証明書を更新しました。

2024 年 2 月 19 日
1.3.2 2023 年 5 月 30 日

このバージョンにより、次の問題が解決されました。

Qlik Data Gateway - 直接アクセス 1.3.1 では、特定のシナリオにおいて CPU が過剰に使用される傾向があります。バージョン 1.3.2 ではこの問題を解決しており、他の変更はありません。CPU 関連の障害を防ぐため、すべての顧客が直ちにバージョン 1.3.2 へアップグレードすることが推奨されます。

2023 年 9 月 15 日
1.3.1 2023 年 5 月 9 日

このバージョンには Qlik Cloud Government の CA バンドルが含まれており、いくつかの問題が解決されています。

CA バンドルは Qlik Cloud テナントの ID を認証し、信頼できる接続であることを保証します。

以前の Direct Access gateway バージョンでは、Qlik Cloud Government 顧客用 CA バンドル ファイルは、必要に応じて Qlik から提供されていました。このバージョンから、CA バンドル ファイルはインストールに含まれるようになりました。

既定のセットアップでは、CA バンドル ファイルは次の場所にインストールされます。 C:\Program Files\Qlik\ConnectorAgent\caBundle]qcg_ca_bundle.pem

  • プロキシ接続に使用される HTTP クライアントがリダイレクトに従うというセキュリティの脆弱性が確認されました。
  • Direct Access gateway エージェントは、次のエラーを発生してクラッシュする場合があります。

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

  • ログ初期化中に例外が発生し、Direct Access gateway がハングして再起動する場合があります。
  • 不必要なタイムアウトを防ぐために、リロード セッションの処理が改善されました。
  • 管理コンソール にある Direct Access gateway [バージョン] 列は、誤ったバージョンを表示します。
  • ユーザーがタスクを停止するか、クォータ制限に達した後でも、エージェントはゲートウェイにデータを送信し続けます。
  • データ ゲートウェイのエンドツーエンド暗号化は既定では有効でなく、ランタイム フラグによって制御されていました。
2023 年 9 月 15 日
1.3.0 2023 年 2 月 16 日

このバージョンにより、次の問題が解決されました。

  • Qlik データ ゲートウェイ - 直接アクセスのバージョン 1.2 は、デジタル署名に問題があるためインストールが防止されるおそれがあります。
  • アップグレード中に構成ファイルが上書きされ、変更内容が失われます
2023 年 9 月 15 日
1.2.0 2023 年 1 月 24 日

機能と機能強化:

  • SAP BW および SAP SQL ソースに対するサポートを追加しました。これらのソースへの接続設定方法については、SAP NetWeaver (英語のみ) を参照してください。

解決した問題:

  • Qlik Data Gateway - 直接アクセス サービスの安定性と回復性が向上し、サービスを手動で再起動する必要がなくなりました
  • 既定の Direct Access gateway インストールおよび構成パラメーターの上書きのサポート
2023 年 5 月 16 日。
1.1.1 2022 年 11 月 15 日

機能と機能強化:

  • Windows Server 2022 のサポートを追加

解決した問題:

  • セットアップ中のカスタム パスの選択に関連する安定性の問題を解決
2023 年 4 月 24 日

1.1.0

2022 年 10 月 18 日

機能と機能強化:

  • Oracle Wallet のサポート
  • Google BigQuery のサポート
  • エラー メッセージの改善

解決した問題:

  • ドライバーがクラッシュした後のシステムの回復可能性の向上
  • Qlik Data Gateway - 直接アクセス サービスがときどき予期せず停止する

2023 年 4 月 24 日

1.0.0

2022 年 8 月 23 日

初回リリース

2023 年 4 月 24 日

アップグレード手順

Direct Access gateway をアップグレードするには、セットアップ ファイルを再ダウンロードして、Direct Access gateway マシンでセットアップを実行します。

次の方法を使用して、インストールされている Qlik Data Gateway - 直接アクセス のバージョンを確認できます。

  • 管理コンソール の [データ ゲートウェイ] に移動し、[バージョン] 列を確認します。
  • インストールされているコンピューターの Windows 設定の [アプリと機能] ページに移動します。

     

    Qlik データ ゲートウェイのバージョン番号 - Direct Access

このページは役に立ちましたか?

このページまたはコンテンツに、タイポ、ステップの省略、技術的エラーなどの問題が見つかった場合は、お知らせください。改善に役立たせていただきます。