Active Preview

Active Preview は、トランスフォームの開発中にすばやくフィードバックを得られる機能です。Active Preview では、変更を保存するたびにプレビューが自動的に更新されるため、コードの記述や更新中に結果やエラーをすぐに確認できます。

Active Preview を有効にすると、保存するたびにトランスフォームが再実行されます。これにより、次のような動作になります。

• プレビューパネルには、常に最新の中間結果またはエラーが表示されます。
• 変更のたびに新しいプレビューを手動で実行する必要はありません。
• 処理を高速化するためにキャッシュが広範に使用されるため、通常のプレビューよりもすばやく結果を確認できます。

Active Preview のキャッシュ

Active Preview は、キャッシュを使用してプレビューを高速化します。キャッシュの対象には次のものが含まれます。

• プロジェクトのリソースとコンテキスト
• プロジェクトとその依存関係に関する情報
• ネットワークチェックとセットアップファイルの内容
• データセットのインメモリーキャッシュ

Active Preview を使用するタイミング

Active Preview は、次のワークフローに最適です。

• 処理コストの高いコード定義フィルターを使用したプレビュー： コード定義フィルターの結果がキャッシュされるため、以降のプレビューが高速になります。
• 反復的な開発： トランスフォームのロジックを頻繁に変更しながら影響を評価します。
• プレビューのセットアップに時間がかかるトランスフォーム： 追加のキャッシュによって待ち時間を短縮します。

Active Preview を有効にする

プレビューを開始したら、Active Preview をオンに切り替えます。

有効にすると、同じワークスペースで開始するプレビューはすべて Active Preview セッションとして起動します。Active Preview を終了するには、現在のセッションを中止するか、オプションをオフに切り替えます。

ベストプラクティスと考慮事項

• Active Preview の実行中はトランスフォームの名前や場所を変更しないでください： これらの設定を編集する必要がある場合は、Active Preview セッションを中止して変更を行い、その後再起動します。
• キャッシュとプロジェクトの更新： キャッシュが広範に使用されるため、プロジェクト内のほかの箇所での変更（参照など）がプレビューにすぐに反映されない場合があります。更新をすぐに確認する必要がある場合は、Active Preview を停止して再起動します。
• 自動保存は自動的に無効になります： Active Preview の実行中は、作業内容を手動で保存したときにのみプレビューが実行されます。Active Preview を終了すると、自動保存が再び有効になります。

• 外部リクエストに注意してください： 保存するたびに新しいプレビューが実行されます。トランスフォームが外部 API にリクエストを送信する場合、それらのエンドポイントへのトラフィックが通常よりも増える可能性があります。
• 一度に実行するプレビューは1つだけにしてください： Active Preview の実行中は、別のプレビューを開始したり、デバッグモードを使用したりすることはできません。切り替える必要がある場合は、先に Active Preview を無効にします。
• setup.py の編集：setup.py ファイルを変更する必要がある場合は、最適な結果を得るために、Active Preview セッションの実行中ではないときに変更します。