データとリロード
最終更新日時: 2026/10/14QV2QS は QlikView UI を変換し、Auto-binary オプションを使用して変換されたアプリにデータを自動的にロードできます。ウィザードまたはコマンドラインで Reload および Auto-binary を有効にすると、QV2QS がデータ転送を自動的に処理します。Auto-binary を使用しない場合、データを入力するには、変換されたアプリを別途リロードする必要があります。
QV2QS は、QlikView UI メタデータ (PRJ XML) を Qlik Sense JSON に変換し、Qlik Cloud テナント上に直接アプリを構築します。変換プロセスでは、シート レイアウト、ビジュアライゼーション オブジェクト、数式、スタイリングを処理します。リロードを行わない場合、ビルド ステップの完了後に生成される Qlik Sense アプリにはデータが含まれません。
変換されたアプリにデータを入力するには、アプリをリロードする必要があります。これには、3つのアプローチがあります。
- 自動バイナリ ロード — QV2QS は元の QVW ファイルを Qlik Cloud にアップロードし、ビルド中に
Binaryステートメントを使用してデータをロードします。このアプローチは、変換直後にデータを含む動作するアプリを確認するための最も速い方法です。詳細については、以下の自動バイナリ ロードを参照してください。 - 手動リロード — Qlik Cloud でデータ接続が既に作成されており、QVD ファイルまたはデータ ソースにアクセスできる場合は、ロード スクリプトを調整した後にアプリをリロードできます。QV2QS は基本的なロード スクリプト パスの正規化を適用しますが、接続名とデータ ソース パスは手動での更新が必要になる場合があります。
- トリガーされたリロード — 展開の一環としてリロードをトリガーするには、
--reloadフラグを使用します。リロードは、ロード スクリプトをそのまま実行します。ロード スクリプトで参照されているデータ接続およびデータ ソースが Qlik Cloud 環境ですでに利用可能である場合にのみ、リロードは成功します。
2 つのフラグが、異なるステージでデータを制御します。--noData フラグはビルドステップ中にデータをスキップするため、リロードを待たずにアプリ構造をテストできます。--exportQvfNoData フラグは、ビルドの完了後にデータを含めずに QVF をエクスポートし、共有用のより小さいファイルを生成します。これらのフラグは、単独で、または組み合わせて使用できます。
自動バイナリ ロード
自動バイナリ ロードは、元の QVW ファイルを Qlik Cloud にアップロードし、Binary ステートメントを使用して変換されたアプリにデータをロードし、その後アップロードされたファイルを削除します。変換されたアプリは、手動でのデータ接続構成を必要とせずに、元の QlikView と同じデータを受信します。
自動バイナリ ロードを有効にするには、コマンド ラインで --autoBinary を使用するか、ユーザー インターフェイスで Auto-binary を有効にします。
自動バイナリ ロードが有効になっている場合、QV2QS は次のステップを実行します:
- QVW ファイルを一時的なアプリとして Qlik Cloud にアップロードします。
- 変換されたアプリのロード スクリプトの先頭に
Binary [<appId>];ステートメントとExit Script;ステートメントを追加します。 - アップロードされた QVW からデータをロードするアプリをビルドします (
--reloadが指定されている場合はリロード)。 - Qlik Cloud から一時的にアップロードされたアプリの削除。
- Qlik Cloud アプリで元のロード スクリプトを復元し、Binary および Exit スクリプト ステートメントを削除します。
クリーンアップ後、Qlik Cloud アプリにはロードされたデータが含まれますが、ロード スクリプトは一時アプリを参照しなくなります。
アップロード ステップには、Qlik Cloud のファイル サイズ制限が適用されます。大容量の QVW ファイルは、テナントのサブスクリプション ティアのアップロード制限を超える場合があります。アップロードに失敗した場合は、大規模アプリのサポートが有効になっているスペースにアプリを展開するか、--binaryAppId 引数を使用して Qlik Cloud に既にある既存のアプリを参照してください。テナントのリソース制限の詳細については、Qlik Cloud リソース制限を参照してください。
失敗時のクリーンアップ
QVWファイルがアップロードされた後にビルドまたはリロードステップが失敗した場合、QV2QSは終了する前に自動的にクリーンアップを試みます。クリーンアップには、Qlik Cloud から一時的にアップロードされたアプリを削除すること、およびローカルとクラウド アプリの両方で元のロード スクリプトを復元することが含まれます。
クリーンアップ自体が失敗した場合 (例えば、ネットワークの中断などにより)、一時的なアプリが Qlik Cloud テナントに残る可能性があります。孤立した一時アプリには、QV2QS_Binary_YYYYMMDD_HHMMSS という名前が付けられます (例: QV2QS_Binary_20260219_143025)。ターゲットスペースでこのパターンに一致するアプリを確認し、手動で削除してください。ビルドディレクトリ内のローカルの script.qvs ファイルには、一時的な Binary ステートメントが含まれている場合もあります。変換を再実行して再生成してください。
自動バイナリ ロードには、--reload フラグと --qvw パスが必要です。いずれかの要件が満たされていない場合、QV2QS はコマンドを拒否し、終了コード 1 で終了します。
ローカルマシン上の元のQVWファイルが変更または削除されることはありません。データ ロードの完了後、Qlik Cloud 内の一時コピーのみが削除されます。
セクション アクセスを使用するアプリでは、自動バイナリ ロードはサポートされていません。Qlik Cloud のリロード エンジンは、ソース QVW ファイル内のセクション アクセス テーブルに対して認証できません。QV2QS がソース アプリでセクション アクセスを検出すると、バイナリのアップロードおよびリロードのステップはスキップされ、警告がログに記録されます。アプリはデータなしでデプロイされます。データをロードするには、Qlik Cloud データ接続を作成して手動でロード スクリプトを更新するか、ソース QVW のコピーからセクション アクセスを削除して --autoBinary で再実行します。
--preserveTargetAppScript が --reload と組み合わされている場合、リロードでは変換されたスクリプトではなく、対象アプリ内の既存のロード スクリプトが実行されます。これは、ターゲット アプリにすでに機能している Qlik Cloud データ接続があり、UI レイヤーのみを更新する必要がある場合に役立ちます。詳細については、既存のアプリの再利用を参照してください。