# データとリロード

QV2QS は 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 は次のステップを実行します:

1. QVW ファイルを一時的なアプリとして Qlik Cloud にアップロードします。
2. 変換されたアプリのロード スクリプトの先頭に `Binary [<appId>];` ステートメントと `Exit Script;` ステートメントを追加します。
3. アップロードされた QVW からデータをロードするアプリをビルドします (`--reload` が指定されている場合はリロード)。
4. Qlik Cloud から一時的にアップロードされたアプリの削除。
5. Qlik Cloud アプリで元のロード スクリプトを復元し、Binary および Exit スクリプト ステートメントを削除します。

クリーンアップ後、Qlik Cloud アプリにはロードされたデータが含まれますが、ロード スクリプトは一時アプリを参照しなくなります。

アップロード ステップには、Qlik Cloud のファイル サイズ制限が適用されます。大容量の QVW ファイルは、テナントのサブスクリプション ティアのアップロード制限を超える場合があります。アップロードに失敗した場合は、大規模アプリのサポートが有効になっているスペースにアプリを展開するか、`--binaryAppId` 引数を使用して Qlik Cloud に既にある既存のアプリを参照してください。テナントのリソース制限の詳細については、[Qlik Cloud リソース制限](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/known-limitations/qlik-cloud-resource-limits.htm)を参照してください。

### 失敗時のクリーンアップ

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 レイヤーのみを更新する必要がある場合に役立ちます。詳細については、[既存のアプリの再利用](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/reusing-an-existing-app.htm)を参照してください。

## 詳細を見る

* [既存のアプリの再利用](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/reusing-an-existing-app.htm)
* [QVF エクスポート](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/qvf-export.htm)
* [引数リファレンス](https://help.qlik.com/ja-JP/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)