Qlik Data Gateway - 直接アクセス のアップグレードとアンインストール

新機能と機能強化

ODBC (Direct Access gateway 経由) コネクタの機能強化

新たに公開された構成設定

以前は構成ファイルを手動で編集して設定する必要があった以下の設定が、 [<gateway-name> のゲートウェイ設定] ダイアログから設定できるようになりました。

• 特定の DSN のみを許可する

• 特定のドライバーのみを許可する

• カスタム データ タイプのマッピング

テーブル名の区切り文字のサポート

一部のデータ ソースでは、大文字または特殊文字を含むテーブル名をロード スクリプト内で区切る必要があります。区切らないと、エラーが発生します。新しい [テーブル名を区切る] オプションにより、データのロード時またはプレビュー時に、ロード スクリプトに区切り文字を手動で追加する必要がなくなります。

詳細については、「ODBC (Direct Access gateway 経由) 接続の作成 (英語のみ)」を参照してください。

ODBC ソース使用時に詳細なエラー メッセージを取得するためのパラメーターを公開

セキュリティ上の懸念から、ODBC ドライバーによって返される既定のエラー メッセージには最小限の情報しか含まれていません。ただし、特定のシナリオでは、特定の問題をトラブルシューティングするために、さらなる情報が必要になる場合があります。以前は、コネクタ ダイアログの [詳細設定] セクションに ShowErrorDetailMessage プロパティを追加し、それを True に設定する必要がありました。今後は、 [ゲートウェイ設定] ダイアログで [詳細なエラー メッセージを表示] チェック ボックスを選択できます。

詳細については、「詳細なエラー メッセージを表示」を参照してください。

ゲートウェイ サービスを再起動せずにプロセス分離設定を変更可能に

以前のバージョンでは、リロード中にプロセス数を増やすなど、プロセス分離設定への変更にはゲートウェイ サービスの再起動が必要でした。これらの設定への変更は、ゲートウェイ サービスを再起動することなく適用されるようになりました。

ログの改善

• AGENT_LOG_LEVEL=DEBUG および AGENT_LOG_OPTIONS が設定されていない場合に、過剰なログ出力を削減しました。

• ファイル コネクタのリロードのコネクタ エージェントログに、AppId=dummyDocId ではなく実際の AppId が表示されるようになりました。

非同期コマンドのサポート強化

非同期コマンドのサポートにより、Direct Access gateway では一度に 1 つのコマンドではなく複数のコマンド (リクエスト) が同時に処理されるようになり、効率が向上しました。以前は、Qlik Cloud 上の送信先コマンドポッドがリクエストを処理できない場合、Direct Access gateway は失敗することなく同じポッドにリクエストを送信し続けていました。その結果、10 回試行した後にコマンドが失敗し、根本的な原因ではなく汎用的なエラーが表示されていました。

Qlik テレメトリ

すべてのコネクタ エージェント コマンド応答 (HTTP POST 経由) に、UserAgent ヘッダーが追加されました。これにより、Qlik テレメトリにおける Direct access gateway の使用状況のタグ付けが向上します。

ヘッダー形式:

qlik-direct-access-gateway/version

例:

qlik-direct-access-gateway/1.7.10

解決した問題

セキュリティ

• HKCU\Software\Classes\WOW6432Node を使用した COM ハイジャックにより、WIX インストーラーで任意のコードが実行される可能性があります。この修正により、インストーラーを実行する前にレジストリキーが検証されます。

• Qlik Data Gateway とともにインストールされる zlib のバージョンには、既知の脆弱性があります。この問題は、既知の脆弱性がないバージョンにアップグレードすることで解決されました。

SAP BW コネクタの障害

選択スクリプトで Infoprovider 入力パラメーターがコメントアウトされ、条件フィルターとして使用されている場合、SAP BW コネクタは失敗します。

新機能と機能強化

ODBC (Direct Access gateway 経由) コネクタの新しい「列名を区切る」オプション

一部のデータ ソースでは、大文字または特殊文字を含む列名をロード スクリプト内で区切る必要があります。区切らないと、エラーが発生します。新しい [列名を区切る] オプションにより、データのロード時またはプレビュー時に、ロード スクリプトに区切り文字を手動で追加する必要がなくなります。

詳細については、「ODBC (Direct Access gateway 経由) 接続の作成 (英語のみ)」を参照してください。

Direct Access gateway マシンに保存されるメトリクス データのクォータ設定のサポート

メトリクス コレクターに新しい localDataRetentionDatabaseSizeInMb プロパティが追加されました。これにより、ゲートウェイ マシンに保存されるメトリクス データの合計サイズ (MB 単位) のクォータを設定できます。クォータが超過しないように、古いデータは削除されます。

メトリクス コレクターは、JSON ファイルでローカルに構成することも、パブリック API 経由で構成することもできます。

詳細については、「メトリクス コレクター」を参照してください。

解決したセキュリティの問題

• Node.js ランタイムは、バージョン 20.19.5 に既知の脆弱性があったため、バージョン 22.x にアップグレードされました。

• libcurl.dll は、バージョン 8.7.0 に既知の脆弱性があったため、バージョン 8.16.0 にアップグレードされました。

新機能と機能強化

Google BigQuery でのアプリケーションのデフォルト認証情報 OAuth メカニズムのサポート

このバージョンでは、Google BigQuery (Direct Access gateway 経由) コネクタを使用する際に、アプリケーションのデフォルト認証情報 OAuth メカニズムがサポートされるようになりました。

詳細については、「Google BigQuery 接続の作成 (英語のみ)」を参照してください。

プロセス分離によるメタデータ コマンドのサポート

[プロセス分離] 構成プロパティに、 [すべて] と [メタデータ] の 2 つの新しいオプションが追加されました。[すべて] オプションでは、リロード コマンドとメタデータ コマンドの両方に対してプロセス分離を有効にできます。一方、[メタデータ] オプションでは、メタデータ コマンドに対してのみプロセス分離を有効にできます。これは、マルチスレッドをサポートしない ODBC ドライバーを使用しているが、メタデータ コマンドを並行して実行したい場合 (主にプレビュー目的で) などに便利です。

新しいオプションは、設定 UI またはパブリック API を介してサポートされます。

関連記事: プロセス分離

ブラジル (br) およびフランス (fr) リージョンのサポート

ブラジル (br) およびフランス (fr) の Qlik Cloud テナント リージョンで Direct Access gateway を使用できるようになりました。

メトリクス コレクター

一般的な顧客の環境では、毎日多数のデータリロードが Direct Access gateway を介して Qlik Cloud Analytics に渡されます。これらのリロードによって影響を受けるリソースの消費と使用率をログに記録して監視する機能は、顧客がそれに応じてリロードを計画するのに役立ちます。

新しいメトリクス コレクター (Direct Access gateway マシンのバックグラウンドで実行) は、Direct Access gateway、コネクタ、オペレーティング システムによるリソース使用率の基本的なログ記録と監視を提供します。メトリクス コレクターは、JSON ファイルでローカルに構成することも、パブリック API 経由で構成することもできます。

詳細については、「メトリクス コレクター」を参照してください。

解決した問題

ゲートウェイから切断された後、次のエラーが発生してリロードが断続的に失敗していました。

Requested endpoint could not be provisioned due to failure to acquire a load slot: The load slot request could not be decrypted. The load slot request could not be decrypted (DirectAccess-1707)

新機能と機能強化

更新された Databricks OAuth 認証オプションのサポート

Databricks コネクタに、新たに次の 2 種類の認証方式が追加されました。これらは Direct Access gateway でもサポートされます。

• Databricks OAuth サービス プリンシパル

• Databricks OAuth ユーザー アカウント

これらはいずれも一般的な OAuth 2.0 フローを使用しており、Databricks 管理アカウントと Microsoft Entra ID 管理アカウントの両方でサポートされています。

詳細については、「Databricks 接続の作成 (英語のみ)」を参照してください。

プロセス分離によって設定されたデフォルトの開始ポートのオーバーライド

プロセス分離が有効になっている場合、Direct Access gateway がすべての分離されたコネクタ プロセスとのプロセス間通信に使用するデフォルトの開始ポート (49152) をオーバーライドできるようになりました。これは、デフォルトポートが別のプロセスによって使用されている場合に役立ちます。ポートをオーバーライドするには、configuration.properties ファイルを編集するか、Public API を介して、DATA_PORT_RANGE_START プロパティを目的のポートに設定します。

解決した問題

Direct Access gateway 1.7.8 では次の問題が解決されました。

• SAP SQL コネクタ: UTCL データ要素を含むテーブルのロード時のエラー

  テーブルに UTCL データ要素が含まれている場合、ロード中に次のエラーが発生していました。

  Status (StatusCode="InvalidArgument", Detail="Input string was not in a correct format.

• チャンク回復使用時の断続的なリロード失敗

  次のエラーにより、リロードが断続的に失敗していました。

  Object reference not set to an instance of an object. (DirectAccess-1513))

• SAP BW コネクタ: データ抽出の問題

  WHERE 句で 2 つの値を使用して SAP BW InfoProvider/ADSO からデータを抽出すると、0 行が返されていました。

• gRPC 接続失敗により発生する Direct Access-1510 エラー

  まれに gRPC 接続が失敗し、Direct Access-1510 エラーが発生していました。この問題を軽減するため、次の改善が実装されました。

  • gRPC 接続にポートが使用可能であることを確認するための gRPC 呼び出しを追加しました

  • コネクタによって接続が拒否された場合、gRPC チャネルが再作成されるようになりました

新機能と機能強化

SAP Report Connector のサポート

このバージョンから、Qlik Data Gateway - 直接アクセス を介して SAP Report Connector にアクセスできるようになりました。

SAP Report Connector の使用 (英語のみ)

Qlik Cloud Government DoD で Direct Access gateway をサポート

このバージョンでは、Qlik Cloud Government DoD で Direct Access gateway の使用をサポートします。

DNS 解決による遅延の緩和

このバージョンから、サービス間通信は localhost の代わりに IPv4 ループバック アドレス (127.0.0.1) を使用して実行されるようになりました。これにより、DNS 解決に起因する待ち時間が効果的に解消されるはずです。

コネクタ起動パラメータの設定

コネクタ起動のタイムアウト値と試行回数を増やせるようになりました。これは、かなりの数のリロードを同時に行う場合に便利です。これらのパラメーターを増やすと、Direct Access gateway は、失敗して終了し、再起動を必要とする前に、より多くの時間と追加の試行回数でコネクタを実行するようになる。

コネクタの起動設定

ロード スロットの非同期リクエスト

このバージョンでは、ロード スロットを非同期にリクエストするオプションが導入されています。リロード データ WebSocket を Qlik Cloud に作成する際に、Direct Access gateway への一時的なコマンド パイプの混雑を緩和するため、ロード スロットを非同期で要求します。これは、かなりの数のリロードを同時に行う場合に便利です。

ロード スロットの非同期リクエスト

インストール ログの新しい場所

インストール ログ ファイルは、他の Direct Access gateway ログ ファイルの場所と同じく <Direct Access gateway installation folder>\data\logs に配置されます。

以前のバージョンでは、インストール ログ ファイルは C:¥Users¥AppData¥Local¥Temp に配置されていました。このフォルダに残っているログは、アップグレード中に新しい場所にコピーされます。

解決した問題

Direct Access gateway 1.7.7 では以下の問題が解決されました。

• ODBC (Direct Access gateway 経由) コネクタのカスタム型マッピングを定義する際の列サイズの減少をサポート。

  ODBC (Direct Access gateway 経由) コネクタのカスタム型マッピングを定義する際に、ドライバーによって報告される列サイズを小さくするサポートを追加しました。以前のバージョンでは、列のサイズを大きくすることしかできませんでした。

• コマンド タイムアウト

  デフォルトの pong タイムアウトである 45 秒を超える長時間コマンドを実行すると、コマンド パイプが切断されました。この問題は、Qlik Cloud Service Connection Broker が Direct Access gateway Connector Agent にコマンドを中継している間にタイムアウトが発生しないようにすることで解決しました。

• 設定 UI - 保存ボタンが無効

  MAX_PROCESSES_COUNT 値が無効なため、[保存] ボタンが無効になりました。この問題は、フィールドに有効な値を自動的に入力することで解決しました。

• 設定 UI - デフォルト値と初期値の不一致

  • [同時リロード プロセス数] フィールドの初期値が、以下のコネクタで UI に表示されるデフォルト値と異なっていました: ODBC、SAP BW、SAP SQL、SAP ODP、および REST。

  • ファイル コネクタのプロセス分離モード フィールドの初期値が、UI に表示されるデフォルト値と異なっていました。

• Microsoft SQL Server の NTLM 認証モードが動作しない問題

  Microsoft SQL Server の NTLM 認証モードが、Direct Access gateway 1.7.6 を使用すると機能しなくなりました。

• 高負荷時のリロードの失敗

  高負荷をかけると、次のようなエラーでリロードに失敗することがありました。

  Connector error: The gRPC connection to the connector failed. ... (DirectAccess-1510)

  この問題は、リトライ機構を追加することで解決されました。

• 特定のシナリオにおける断続的なリロードの失敗

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

  • DirectAccess-4002: この問題は、AGENT_DATA_PING_SKIP_THRESHOLD_SECONDS プロパティのデフォルト値を 60 秒から 15 秒に減らすことで解決しました。

  • DirectAccess-2208: この問題は、リトライ機構を追加することで解決されました。

ファイル (Direct Access gateway 経由) コネクタ: 特定のスペースへのファイル システムのアクセス制限

ファイル (Direct Access gateway 経由) コネクタを使用する場合、ファイル システムまたはネットワーク ドライブへのアクセスを特定のスペースに制限できるようになりました。各パスを Qlik Cloud テナント内のスペースとペアリングすると、指定されたパスには、 [データ消費可能] 以上のロールを持つスペース メンバーだけがアクセスできるようになります。スペースが設定されていない場合、指定されたパスはすべてのスペースからアクセスできるようになります。

新しい構成は、パブリック API 経由で行うことも、ゲートウェイ サーバーの構成ファイルで直接行うこともできます。

パブリック API

ファイル (Direct Access gateway 経由) コネクタ (英語のみ)

ゲートウェイの再起動なしで変更を適用できる機能のサポート

このバージョンから、ファイル (Direct Access gateway 経由) および REST (Direct Access gateway 経由) コネクタの許可されたパス/URL を更新するときに、変更を適用するために Direct Access gateway サービスを再起動する必要がなくなりました。これは、次の ODBC (Direct Access gateway 経由) プロパティを変更する場合にもあてはまります。

• 許可されたドライバー

• 許可された DSN

• カスタム型マッピング

Oracle (Direct Access gateway 経由) コネクタ: Oracle TNS Names 接続メソッドのサポート

このバージョンでは、TNS 名を使用した Oracle へのアクセスがサポートされています。

Oracle 接続の作成 (英語のみ)

ファイル (Direct Access gateway 経由) コネクタ: プロセス分離が既定で有効化

Direct Access gateway をクリーンインストールする場合、プロセス分離が既定で有効になり、 [同時リロードプロセス数] が 10 に設定されます。

プロセス分離

REST (Direct Access gateway 経由) コネクタを使用した localhost への接続の許可

REST (Direct Access gateway 経由) コネクタを localhost に接続できるようになりました。これにより、connector-agent/ ステータス エンドポイントを使用してエージェント上のアクティブなロード数を決定するなど、ローカル (ゲートウェイ サーバーに対して) REST エンドポイントの使用が可能になります。

これは、ローカル URL (http://localhost:5050/status など) を restconnector_allowed_urls.txt ファイルに追加するときに、パブリック API を使用して構成することもできます。

REST (Direct Access gateway 経由) コネクタを使用した localhost への接続の許可

パブリック API

パブリック API を使用して「データのロード」リクエストを非同期で実行する機能のサポート

エージェントで「データのロード」リクエストを非同期で実行すると、クラウド サービスがエージェントからの応答を待つ時間が大幅に短縮されます。

この機能は、Direct Access gateway 1.7.5 で導入されたもので、OPTIONAL_CAPABILITIES パラメーターを使用することで公開 API から利用できるようになりました。

パブリック API

高負荷シナリオにおけるプロセス分離の強化

ゲートウェイの負荷が高く、リソースが限られている場合に、次の問題を防ぐための機能強化が行われました。

• プロセス分離が有効な場合のコネクタ ポートの競合

• コネクタ プロセスの開始を試みる頻度が高すぎる

解決した問題

Direct Access gateway 1.7.6 では次の問題が解決されました。

• Oracle (Direct Access gateway 経由) または ODBC (Direct Access gateway 経由) コネクタ: 冗長なメタデータ呼び出し

  Oracle (Direct Access gateway 経由) または ODBC (Direct Access gateway 経由) コネクタを使用する場合、ゲートウェイが選択されていないと、コネクタ プロパティの一部によって冗長なメタデータ呼び出しが行われます。

• ゲートウェイ メトリクスの取得時間が長すぎることによるパフォーマンスの低下

  リロード リクエストごとに、ゲートウェイ メトリクスが取得されます。メトリクスの取得にかかる時間 (約 200 ミリ秒) は、リロード時間に影響します。この問題は、ロード リクエストごとにメトリクスを取得するのではなく、15 秒ごとにメトリクスを取得することで解決されました。

• AWS Athena (Direct Access gateway 経由) コネクタ: 日本語文字を含むテーブル名または列名をリロードしようとすると、リロードに失敗する

  AWS Athena (Direct Access gateway 経由) コネクタを使用している場合、日本語の文字を含むテーブル名または列名をリロードしようとすると、次のエラーが発生していました。

  Unable to show the preview column data. User does not have permission to access data, or column data type is not supported.

• Google BigQuery (Direct Access gateway 経由) コネクタ: データ マネージャーを使用したデータ追加の失敗

  Google BigQuery (Direct Access gateway 経由) コネクタを使用している場合、データ マネージャーを使用してデータを追加しようとすると、「データの追加に失敗しました」というエラーが発生していました。

• LocalSystem アカウントで Direct Access gateway をインストールする際のパスワードの明確化

  Direct Access gateway インストーラーの [パスワード] 項目により、LocalSystem ユーザー アカウントで Direct Access gateway をインストールするときに常にパスワードが必要であると一部のユーザーに誤解されていました。この問題を解決するために、インストーラーに次の説明文が追加されました。

  A password is only required if you are not using the default local system account.

メタデータのプレビュー呼び出しにロギング コンテキストを追加しました。

リロード失敗のトラブルシューティングを支援するため、メタデータ プレビュー呼び出しのログに以下の項目が追加されました: requestguidsessionid および datasourceid。

MongoDB (Direct Access gateway 経由) および Google BigQuery (Direct Access gateway 経由) コネクタに [ユーザー定義の資格情報] のサポートを追加しました。

MongoDB (Direct Access gateway 経由) および Google BigQuery (Direct Access gateway 経由) コネクタに [ユーザー定義の資格情報] の項目が追加され、対応する非 Direct Access gateway コネクタと整合されました。

[ユーザー定義の資格情報] を選択すると、ユーザーが接続にアクセスしようとする際、テーブルを選択したりデータをロードしたりする前に、資格情報を入力する必要があります。これらの資格情報は接続ではなく、ユーザーに属します。ユーザー定義の資格情報を保存して、同じコネクタ タイプの複数の接続で使用できます。

ロード データ要求での AsyncCommand のサポート

エージェントでロード データ要求を非同期で実行すると、クラウド サービスがエージェントからの応答を待つ時間が大幅に短縮されます。

ロード データの要求を非同期で実行

Direct Access gateway サービスを再起動することなく、AGENT_LOG_OPTIONS プロパティの変更をサポート

Direct Access gateway サービスを再起動することなく、AGENT_LOG_OPTIONS プロパティを変更できます。このプロパティは、Qlik サポートから要求があった場合のみ変更されます。

解決した問題

Direct Access gateway 1.7.5 では以下の問題が解決されました。

• 有効な操作に対して返されるエラー

  コネクタ エージェントが、有効なロードおよびイベント コールに対して「500」エラーを返すことがありました。

• 設定 API:

  • REST および FILE コネクタの「最大処理数」プロパティが更新され、2～100 の値に対応するようになりました。

  • AGENT_LOG_OPTIONS プロパティにデフォルト値が追加されました。

  • DCaaS のログ レベル値が更新されました

• キープ アライブ イベント:

  • キープ アライブ イベントが暗号化されないことがある

  • エージェント上のセッションがアクティブでなくなると、クラウド リソースを解放するための不正な応答が送信されることがありました。

セットアップ時に既定の Windows サービス アカウントを上書きするためのサポート

以前の Direct Access gateway バージョンでは、Windows のサービス アカウントを変更できるのはインストール後のみであり、対話形式でのみ (各 Direct Access gateway マシン上で) 可能でした。Direct Access gateway 1.7.4 では、既定以外の Windows サービス アカウントで Direct Access gateway をインストールする機能が導入されました。セットアップ ウィザードを使用する場合、およびサイレント インストールを実行する場合に、このオプションを使用できます。

詳細については、「ステージ 2: データ ソースを保護するファイアウォールの背後にあるサーバーに Direct Access gateway をインストールする」を参照してください

Windows Server 2025 のサポート

Direct Access gateway バージョン 1.7.0 以降は、Windows Server 2025 へのインストールが認証されています。

解決した問題

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

• セキュリティ強化

  ファイル (Direct Access gateway 経由) コネクタを使用する場合、すべてのファイル操作は 「NT AUTHORITY\SYSTEM」 Windows サービス アカウントで実行されていました。セットアップ中に既定の Windows サービス アカウントを上書きする機能を追加することで、この問題は解決されました。

• Google BigQuery（Direct Access gateway経由）コネクタ: 特定の範囲外の TIMESTAMP データの処理中のエラーの発生

  1400 ～ 9999 (年) の範囲外の TIMESTAMP データを処理すると、次のエラーが発生していました。

  The data contains unsupported data type or row content. Invalid row status.

• アップグレード後にカスタム Windows サービス アカウントが維持されない

  アップグレード後、指定された Direct Access gateway サービス アカウントが既定のローカル アカウント (LocalSystem) に戻されていました。

• リロード エラー

  リロード中に、keepAlive イベント (Qlik Cloud からゲートウェイに送信される) の暗号化に関連する問題により、次のエラーが発生する場合がありました。

  Internal error. (Connector error: Reload web socket was aborted due to a failure (DirectAccess-1103))

トラブルシューティングの改善

• Direct Access gateway マシンのメトリクス (コア、ディスク スペース、メモリ、CPU など) がリモート ログに伝播され、トラブルシューティングに役立つようになりました。
• SAP コネクタのログを除いて、すべてのログのログ メッセージのタイムスタンプは UTC 形式になります。
• ファイル (Direct Access gateway 経由) コネクタのログ名に、プロセス ID ではなくポート番号が含まれるようになりました。
• ファイル (Direct Access gateway 経由) コネクタのログ メッセージに [プロセス ID] 列が含まれるようになりました。

ODBC (Direct Access gateway 経由) コネクタの強化

ODBC (Direct Access gateway 経由) コネクタを使用する場合、ANSI ODBC ドライバー (サポートされていません) は、コネクタに表示される ODBC ドライバーのリストから除外されるようになりました。

解決した問題

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

• REST (Direct Access gateway 経由) コネクタ: リロードの失敗

  大規模なデータ構造のリロードが次のエラーで失敗する場合がありました。

  Received message exceeds the maximum configured message size.

• REST (Direct Access gateway 経由) コネクタ: 過度に制限的な URL 許可リスト

  末尾にスラッシュがない URL は誤ってブロックされ、末尾にスラッシュがある同じ URL は許可されていました。

• ODBC (Direct Access gateway 経由) コネクタ: 過剰なメモリ消費

  ロード スクリプトで複数の SELECT を使用すると、ソース システムの VRAM メモリが解放されず、リロードごとに増加し続けます。

• MySQL (Direct Access gateway 経由) コネクタ: データ型の問題

  MySQL (Direct Access gateway 経由) コネクタを使用して「int(9) unsigned」データ型のテーブルをロードすると、その列のデータは -1 として返されていました。

• SAP SQL (Direct Access gateway 経由) コネクタ: MixedMode が動作しない

  MixedMode 接続文字列プロパティが期待通りに動作しませんでした。

• SQL タイプのデータ ソース: ロード スクリプトの問題

  SQL タイプのデータ ソースに接続すると、ロード スクリプト内の「TableName」がロード スクリプトの先頭ではなく、テーブル定義の途中に誤って配置される場合がありました。

• Databricks (Direct Access gateway 経由) コネクタ: セキュリティ強化

  Databricks (Direct Access gateway 経由) コネクタ経由でロードされたデータは、通信と転送中のデータに常に SSL を使用するようになりました。SSL を有効または無効にする以前のオプションは削除されました。

• セキュリティ強化

  Qlik Cloud Administration アクティビティ センターから顧客がホストするログを返すロギング コマンド ペイロードでは、エンドツーエンドの暗号化は相互に強制されませんでした。

チャンク回復再開しきい値の設定

チャンクの回復期間のしきい値 (分単位) を設定できるようになりました。回復期間のしきい値に達した時点でリロードが再開されない場合、適切なメッセージが表示されて失敗します。

このオプションは、長時間の回復後に、3 時間の制限を超える可能性があるリロードに役立ちます。たとえば、データベースからデータを取得するのに 90 分かかり、リロードが開始されるとすぐにチャンクの 1 つが破損したとします。この場合、すべてのチャンクがキャッシュに保存され、キャッシュから送信されます。このようなシナリオでは、リロード プロセス全体 (キャッシュへの保存と実際のリロード) が完了するまでに 3 時間かかる可能性があります。

「チャンク回復期間のしきい値の設定」も参照してください。

解決した問題

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

• REST (Direct Access gateway 経由) コネクタの構成の不足

  Direct Access gateway 1.7.1 の configuration.properties ファイルに REST_MAX_PROCESS_COUNT パラメーターがありませんでした。

• Direct Access gateway プロセスの自動再起動が期待どおりに動作しない

  Direct Access gateway プロセスがクラッシュまたは終了した場合に、自動的に再起動されないことがありました。

• チャンク回復キャッシュフォルダーが誤った場所に作成される

  configuration.properties ファイルの OVERRIDE_CHUNKS_CACHE_DIR 設定が空の場合、チャンク回復キャッシュ フォルダーが C:\ProgramData\Qlik\Gateway\tmp (既定のフォルダー) ではなく、[install folder]\ConnectorAgent フォルダーに作成されていました。

• チャンク回復モードでのリロードの失敗

  チャンク回復モードで作業しているときに、DirectAccess-4021 エラーでリロードに失敗することがありました。この問題は、EODAck が EODAck タイムアウトの少し後にエージェントに到着したことが原因でした。この問題は、EODAck のタイムアウトをわずかに増やすことで解決しました。

• ファイル (Direct Access gateway 経由) コネクタのログ レベルの問題

  ファイル (Direct Access gateway 経由) コネクタの DEBUG ログ レベルは無視されます。

• [Direct Access gateway install folder]\data\logs\reloads フォルダーの内容が削除されない

  古い JSON ファイルが、 [Direct Access gateway install folder]\data\logs\reloads フォルダーから削除されませんでした。多数のログが蓄積されると、時間の経過とともにディスク容量が大幅に消費される可能性があります。さらに、このフォルダー (何千ものログ ファイルが含まれている可能性がある) をバックアップすることも困難でした。

• セキュリティ強化

  この改善により、Pod IP やゲートウェイ ID などの機密データを含む、Qlik Cloud と Direct Access gateway 間で送信されるイベントとメッセージに暗号化の追加レイヤーが追加されます。

新機能と機能強化:

• REST コネクタ

  新しいREST (Direct Access gateway 経由) コネクタにより、Direct Access gateway 経由でプライベート REST API エンドポイントへの安全なアクセスが提供され、データを Qlik Sense アプリに直接ストリーミングできるようになります。

  詳細については、「REST データ ソース (英語のみ)」を参照してください。

  情報メモ

  REST (Direct Access gateway 経由) コネクタは、4 つのフェーズに分けて Qlik Cloud リージョンに段階的に展開され、フェーズ 4 は 2 月 17 日までに完了する予定です。

  • フェーズ 1: JP (日本)、UK (英国)
  • フェーズ 2: DE (ドイツ)、SG (シンガポール)、AP (アジア太平洋)、IN (インド)

  • フェーズ 3: US (米国)、Qlik Cloud Government

  • フェーズ 4: EU (欧州連合)
    

• 既定のチャンク キャッシュ ディレクトリをオーバーライドする

  各リロード操作について、Direct Access gateway はデータチャンクをメモリにキャッシュし、それらをディスクにオフロードできます (キャッシュに割り当てられたサイズを超えた場合)。システム ドライブに十分なディスク容量がない場合は、既定のチャンク キャッシュ ディレク トリ (C:\ProgramData\Qlik\Gateway\tmp) ディレクトリをオーバーライドできます。

  詳細については、「既定のチャンク キャッシュ ディレクトリをオーバーライドする」を参照してください。

• ODBC (Direct Access gateway 経由) コネクタを使用するときに取得される既定のテーブル数をオーバーライドする

  既定では、選択対象として 10,000 個のテーブルが取得されますが、非常に大きなデータベースで作業する場合はこれでは不十分な場合があります。このバージョンでは、Direct Access gateway configuration.propertiesファイルのODBC_TABLES_LIMIT_FOR_GENERICODBC プロパティを増やすことにより、既定をオーバーライドする機能が導入されています。

  詳細については、「アンロードするテーブルの最大数」を参照してください。

• Google BigQuery (via Direct Access gateway) Connector を使用した複数カタログのサポート

  Google BigQuery (via Direct Access gateway) Connector は、単一の接続で複数のカタログ (Google BigQuery プロジェクトに相当) にアクセスできるようになりました。

  詳細については、「Google BigQuery 接続の作成 (英語のみ)」を参照してください。

• Databricks (via Direct Access gateway) Connector を使用した Unity カタログのサポート

  Databricks (via Direct Access gateway) Connector は、Databricks の Unity Catalog のデータへのアクセスをサポートするようになりました。

  詳細については、「Databricks 接続の作成 (英語のみ)」を参照してください。

• ODBC (Direct Access gateway 経由) コネクタ使用時に ODBC ドライバーによって発生するデータエラーを軽減する

  ベンダーの ODBC ドライバーによるソース データ型の取り扱いの問題により、リロード中にエラーが発生したり、正しくないデータが Qlik Cloud にロードされたりする場合があります。このような場合、Qlik Cloud データ型またはその仕様 (スケールや精度など) をオーバーライドできます。

  詳細については、「ODBC (Direct Access gateway 経由) コネクタを使用するときに、既定の Qlik Cloud データ型をオーバーライドする」を参照してください。

• コネクタの開始、終了、再起動イベントのログ イベントの再配置

  Direct Access gateway 1.7.1以降では、コネクタの開始、終了、再起動イベントは Direct Access gateway (DirectAccessAgent) ログ ファイルに書き込まれます。以前のバージョンでは、コネクタ エージェント ログ (connector-agent_logs_<date>) ログ ファイルに書き込まれていました。

解決した問題

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

• 特定のシナリオにおいて、RELOAD_CACHE_MEMORY_MB オプション (問題発生時にリロード用にデータをキャッシュする) を有効にすると、リロードのパフォーマンスに影響が出る場合がありました。

• RELOAD_CACHE_MEMORY_MB オプションを有効にすると、アクセスが拒否されたかファイルが見つからなかったことを示す次のエラーが発生し、リロードに失敗する場合がありました。

  (Connector error: data loading error (DirectAccess-4008) (DirectAccess-4001))

• 特定のシナリオにおいて、主にコネクタに必要なポートが利用できない場合に、プロセス分離が有効になっていてもコネクタがクラッシュし続ける場合がありました。

• リロードが正常に完了した後でも、Direct Access gateway がデータソースへの再接続を試みる場合がありました。

• コネクタ エージェントがメモリにロードされた後にディスクからチャンクを読み取ろうとすると、「Could not find file」エラーが発生する場合がありました。

• SAP BW コネクタを使用すると、次のエラーが発生する場合がありました。

  Error when parsing '0TCT_C03': The given key 'CHABASNM' was not present in the dictionary.

  この問題は、CHABASNM メタデータ フィールドのない古いトランスポートに対するサポートを追加することで修正されました。

• configuration.properties ファイルに重複したエントリが含まれている場合、Direct Access gateway サービスを開始できない場合がありました。

• Azure Active Directory 認証方法を使用して、Azure SQL Database (Direct_Access gateway 経由) データ ソースに接続しようとするときに、 [接続をテスト] の操作が次のエラーで失敗する場合がありました。

  Communication link failure - ERROR [08S01] [Qlik][SqlServer] Connection broken unexpectedly

• Direct Access gateway が Qlik Cloud から切断されたときに、再接続までに最大 10 分かかる場合がありました。その間、リロードは開始されませんでした。この時間は 45 秒に短縮されました。

  Direct Access gateway の再接続に 45 秒よりも大幅に長い時間がかかる場合は、「Direct Access gateway を Qlik Cloud に強制的に再接続させる」の説明に従って、強制的に再接続できます。

新機能と機能強化:

• ファイル コネクタ

  新しいファイル (Direct Access gateway 経由) コネクタにより、Direct Access gateway を介した安全なファイル システムのアクセスが提供され、Qlik Sense アプリに直接データをストリームできるようになります。

  詳細については、「ファイル (Direct Access gateway 経由) (英語のみ)」を参照してください。

• 非同期コマンドによるパフォーマンス向上のサポート

  非同期コマンドのサポートにより、Direct Access gateway では一度に 1 つのコマンドではなく複数のコマンドが同時に処理されるようになり、効率が向上します。

   

解決した問題

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

• Snowflake コネクタ

  特殊文字を含むデータをロードすると、「SQL コンパイル エラー」が発生して失敗します。

• サイレント インストール

  Direct Access gateway をサイレント インストールすると、前提条件となるソフトウェアを修復するための対話型プロンプトが表示されます。

• Oracle (Direct Access gateway 経由) コネクタのパフォーマンス

  Oracle (Direct Access gateway 経由) コネクタを使用してデータをロードすると、ODBC ドライバーを直接使用する場合よりも大幅に遅くなります。

• ODBC (Direct Access gateway 経由) コネクタのクラッシュ

  SQL Server Simba ドライバーのバグにより、ODBC (Direct Access gateway 経由) コネクタがクラッシュすることがありました。

• 断続的なリロードの失敗

  複数のアプリのリロードが断続的に失敗し、次のエラー (抜粋) が表示されることがありました。

  Connector Datagateway Space:SQLCLUSTER01 not found (Requested endpoint could not be provisioned due to failure to acquire a load slot: The response body of the connector load info request was empty.

新機能と機能強化:

• プロセス分離が既定でオンになりました。

  以前のバージョンでは、プロセス分離モードは既定でオフになっていました。Direct Access gateway 1.6.9 以降では既定でオンになりますが、クリーン インストールの場合のみとなります。アップグレードする場合、既存のプロセス分離構成は保持されます (アップグレード前の状態に応じてオフまたはオン)。

  プロセス分離の詳細については、「プロセス分離」を参照してください。

• configuration.properties ファイルの削除

  ユーザーが誤って間違った configuration.properties ファイルを変更するのを防ぐため、configuration.properties テンプレート ファイルは Direct Access gateway インストール フォルダーから削除されました。現在は、C:\ProgramData\Qlik\Gateway に存在する configuration.properties ファイルは 1 つのみになりました。

解決した問題

Direct Access gateway 1.6.9 では、チャンク回復機能に関する次の問題が解決されています。

• リロード後にチャンクが削除されない

  処理されたチャンクが、リロード後にディスクから削除されない場合がありました。

• クラッシュ後にチャンクが削除されない

  Direct Access gateway クラッシュ後、処理済みのチャンクがディスクから削除されない場合がありました。

• メモリ消費量が多い

  保存されたチャンクのリロード中に、メモリ消費量が多くなる場合がありました。

チャンク回復機能の詳細については、「キャッシュ データ チャンク用メモリ」を参照してください。

新機能と機能強化:

• データ チャンク回復メカニズム

  このバージョンでは、欠落または破損したデータ チャンクの送信のサポートが導入されました。リロードされたデータ チャンクのメモリ サイズを制御するために、configuration.properties ファイルに新しいプロパティ が追加されました: RELOAD_CACHE_MEMORY_MB

  チャンク回復機能の詳細については、「キャッシュ データ チャンク用メモリ」を参照してください。

• .NET 6.0.x は不要になりました

  このバージョンから、Direct Access gateway の実行に .NET 6.0.x は不要になりました。Direct Access gateway をインストールする前に、新規のお客様は .NET 4.8 (インストールに必要) と .NET 8.0 および ASP.NET Core Runtime (Direct Access gateway での作業用) のみをインストールしてください。

  Direct Access gateway の前提条件の詳細については、「システムの前提条件」を参照してください

• 依存プロセスのバッチ操作の改善

  このバージョンから、依存プロセスは順番にではなく並行してチェックされるようになり、実行時にプロセス リストが変更されることによる例外を回避できます。

  プロセス分離の詳細については、「プロセス分離」を参照してください。

• トラブルシューティングの改善

  ログ内のリソース使用量の警告に、より多くのコンテキスト (「プロセス ID」や「コミット サイズ」など) が追加されました。

解決した問題

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

• 誤解を招くエラー メッセージ

  ゲートウェイの再起動 (手動またはクラッシュによる) の後、コネクタ エージェント (ConnectorAgent.exe) が初期化される前に要求が送信される場合があります。このような場合、エラー メッセージは誤解を招いていました。現在は、ゲートウェイが切断されたことを示すエラー メッセージが表示されます。

• 切断によるリロードの失敗

  最初のロード後に Direct Access gateway が切断されると、次のエラーが発生して後続のリロードが失敗することがありました。

  Requested endpoint could not be provisioned due to failure to acquire a load slot: Command getReloadSlot error for reload

  ポッドのシャットダウンによるリロードの失敗

  Analytics エンジンは、以前のセッションからの接続をキャッシュし、シャットダウンを要求されたポッドにリクエストを送信することがありました。これにより、次のエラーが発生してリロードが失敗していました。

  Connector error: data loading error (DirectAccess-4008)

• Direct Access gateway サービスの再起動後にリロードが停止する

  特定のシナリオでは、コネクタ エージェントはリロード中に切断された後、再接続を試行せず、次のエラーが発生していました。

  Reload web socket was aborted due to a failure (DirectAccess-1103)

• Amazon Redshift コネクタ: SELECT テーブルに重複した列が入力される

  Datashare で作成されたデータベースから参照された外部スキーマにテーブルが存在する場合、DLE/データ マネージャーのプレビューに重複した列が表示されていました。

新機能と機能強化:

• プロセス分離の作業時におけるポート割り当てのサポート

  以前は、既定のポート番号と範囲設定を使用する場合、 [同時リロード プロセスの最大数] の値を 10 より大きく設定することはできませんでした。このバージョンから、ポートは自動的に割り当てられるようになり、同時リロード プロセスの数を 10 より大きく設定できるようになりました。

• SAP SQL (Direct Access gateway 経由) コネクタを使用する場合のメタデータ ページングの強化

  この強化により、10,000 個以上のテーブルが取得される場合、タイムアウトを防ぐために、テーブルは 10,000 個のバッチで取得されます。

解決した問題

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

• プロセス分離の使用時に期限切れのリロードが解放されない

  プロセス分離の使用時に、期限切れのリロードでコネクタ プロセスが解放されませんでした。

• アプリをキャンセルしても Amazon Redshift セッションが実行され続ける

  実行中の QCS アプリがキャンセルされた場合でも、Amazon Redshift セッションはクエリが完了するまで実行され続けました。

• 解決されたセキュリティの脆弱性

  • Direct Access gateway コネクタはすべてのサービスを 0.0.0.0 にバインドし、ローカル マシン上のすべての IP アドレスからの接続を許可するため、サーバーがあらゆるネットワークに公開される可能性がありました。
  • Direct Access gateway は、ユーザーの一時ファイル パス内の存在しない動的に生成されたディレクトリから MPR.dll をロードしようとしていました。予想される場所に MPR.dll が存在しないため、攻撃者がこのパスに悪意のある DLL を配置して、インストーラーがそれをロードして実行する可能性がありました。

• Direct Access gateway サービスの再起動後にリロードが停止する

  非選択クエリとストアド プロシージャの使用時に、Direct Access gateway サービスを再起動した後、リロードが数時間ハングしていました。

• データのプレビューとリロードの問題

  ODBC (Direct Access gateway 経由) コネクタを使用して Microsoft Fabric にアクセスすると、データのプレビューとリロードの問題が発生することがありました。

• ORDER BY 句の追加時のエラー

  ORDER BY 句を追加すると、ODBC (Direct Access gateway 経由) コネクタと SQL Anywhere 17 の使用時にエラーが発生していました。

新機能と機能強化:

Direct Access gateway 1.6.6 では、次の機能と拡張機能が導入されています。

• Direct Access gateway 経由の ServiceNow へのアクセスのサポート

  このバージョンでは、ServiceNow (Direct Access gateway 経由) コネクタのサポートが導入されており、顧客は厳密に送信され、暗号化され、相互認証された接続を介して、ファイアウォールで保護された ServiceNow データ ソースに安全にアクセスできるようになります。

• 次の Direct Access gateway コネクタを使用する場合の新しい認証方法のサポート:

  • Azure Synapse Analytics: Azure OAuth および Azure Active Directory
  • Azure SQLデータベース: Azure OAuth および Azure Active Directory
  • Snowflake: OAuth
  • Databricks: Azure OAuth
  • MongoDB: SCRAM-SHA-256 および LDAP

• ODBC コネクタを使用する場合のメタデータ ページングの強化

  この強化により、10,000 個以上のテーブルが取得される場合、タイムアウトを防ぐために、テーブルは 10,000 個のバッチで取得されます。

• .NET 8.x の要件

  このバージョンから、顧客は Direct Access gateway を使用するために .NET 6 と .NET 8.x の両方をインストールする必要があります。インストールまたはアップグレード中に、まだインストールされていない場合は、セットアップによって自動的にインストールされます。

• サポート性の向上

  トラブルシューティングを支援するために、Direct Access gateway リクエストの継続時間を測定する追加のログが追加されました。

解決した問題

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

• Direct Access gateway と Qlik Cloud の間の接続が 30 秒以上アイドル状態だった場合、リロード操作が次のエラーで失敗することがありました: 無効なオブジェクト名 '#<TempTableName>' (Direct Access gateway 一時テーブルが使用できないことを示します)。

  この問題を解決するために、新しいロード リクエストのタイムアウトの設定が追加されました。新しいパラメータは、ODBC コネクタのリロード セッション期間を設定し、デフォルト値は 20 秒です。

• リロードをキャンセルすると、ODBC プロセスの作成と終了のループが発生する場合がありました。
• Direct Access gateway と Qlik Cloud Services の間の接続が、明らかな原因もなく突然終了することがありました。

• Direct Access gateway 接続の再試行間隔は継続的に増加しますが、自動的にリセットされることはありません。再試行間隔をリセットするには、Direct Access gateway サービスを再起動することが唯一の方法です。

• 間違った構文を使用して Oracle からストアド プロシージャを呼び出すと、リロード操作が情報エラーですぐに終了せず、数時間ハングします。

新機能と機能強化:

Direct Access gateway 1.6.5 では、次の機能と拡張機能が導入されています。

• SAP ODP コネクタのサポート

  このバージョンでは、Direct Access gateway 経由で SAP ODP ソースにアクセスする機能が導入されています。これに対応するために、新しい [データ ゲートウェイ] 項目が SAP ODP コネクタに追加されました。新しい項目により、顧客は SAP ODP ソースへのアクセスに使用するゲートウェイを選択できます。

  関連項目: SAP ODP コネクタ (英語のみ)

• 拡張されたログ機能

  このバージョンでは、Qlik サポートが特定のゲートウェイコンポーネントの問題をトラブルシューティングするための新しいロガーが導入されています。

• 新たにサポートされたリージョン

  Qlik Cloud テナント リージョンとして、日本がサポートされるようになりました。

• パフォーマンスの向上

  暗号化されたセッションのメモリ割り当てが改善されました。

解決した問題

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

• セキュリティの脆弱性

  ODBC コネクタを使用する場合、シークレットは DCAAS ログに書き込まれます。

• プロセス分離のパフォーマンス

  負荷が高いと、プロセスの開始に時間がかかります。

• 誤ったインストール パス

  Direct Access gateway をインストールすると、ユーザーがセットアップ ウィザードで別のフォルダーを選択した場合でも、常に Qlik がルート フォルダーとして設定されます。

新機能と機能強化:

• 管理 アクティビティ センターからのログ ファイルの表示とダウンロードに対するサポート

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

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

• Direct Access gateway をサイレントにインストールするためのサポート

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

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

• 改善されたセッションの連続性

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

解決した問題

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

• configuration.properties ファイル内の不正なパラメーター名

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

• リロード ポッドの可用性

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

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)

  この問題を軽減するために、ロード リクエストのタイムアウト パラメーター (ロード リクエストのタイムアウトを延長するため) が Direct Access gateway 設定に追加されました。

  このようなエラーが頻繁に発生する場合は、値を 5 ～ 10 分に設定してみてください。

  詳細な手順については、「ロード リクエストのタイムアウト」を参照してください。

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

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

  情報メモエラー メッセージ全体は、使用しているデータ ソースによって提供されます。Qlik がエラー メッセージに情報を追加することや、編集することはありません。

• 同じリロード ID での複数のリロードの処理

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

  Connector error: data loading error (DirectAccess-4008

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

新機能と改善点

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

• 複数のコネクタ プロセスにまたがるリロードの分散をサポート

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

  プロセス分離の詳細については、「プロセス分離」を参照してください。

• SAP BW (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 経由) コネクタの診断の改善

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

• 再接続の改善

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

解決した問題

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

• Direct Access gateway コネクタ ログ経由の ODBC

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

• セットアップにファイルがない

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

• Qlik Cloud リソースのスケーリング中のリロード エラー

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

• Snowflake の接続障害

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

• DLE でのアプリケーション スクリプトのデバッグ エラー

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

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

解決した問題:

• 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 経由) コネクタ: 複数の同時リクエストのトラブルシューティングに役立つ診断情報をログに追加しました。

新機能と機能強化:

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

• 管理 アクティビティ センターの [バージョン] 列には、RepAgent (サブコンポーネントの 1 つ) のバージョンではなく、Direct Access gateway バージョンが表示されるようになりました。

解決した問題:

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

解決した問題:

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

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

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

機能と機能強化:

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

解決した問題:

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

  Connector error: data loading error (DirectAccess-4008)

• 特定のシナリオにおいて、リロードが中断されたときに Direct Access gateway が Qlik 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)

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

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

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

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

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 [バージョン] 列は、誤ったバージョンを表示します。
• ユーザーがタスクを停止するか、クォータ制限に達した後でも、エージェントはゲートウェイにデータを送信し続けます。
• データ ゲートウェイのエンドツーエンド暗号化は既定では有効でなく、ランタイム フラグによって制御されていました。

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

• Qlik Data Gateway - Direct Access のバージョン 1.2 は、デジタル署名に問題があるためインストールが防止されるおそれがあります。
• アップグレード中に構成ファイルが上書きされ、変更内容が失われます

機能と機能強化:

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

解決した問題:

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

機能と機能強化:

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

解決した問題:

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

1.1.0

2022 年 10 月 18 日

機能と機能強化:

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

解決した問題:

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