注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

ローカル開発でトランスフォームをプレビューする

VS Code を使用したローカル開発でトランスフォームをプレビューするには、主に2つの方法があります。

Palantir extension for Visual Studio Code を使用してプレビューする(Python のみ)

Palantir extension for Visual Studio Code は、ローカルプレビュー機能をサポートしています。インストール手順については、拡張機能のドキュメントを参照してください。拡張機能をインストールし、プレビュー用の環境が整うと、以下に示すように、プレビュータブでトランスフォームが自動的に検出されるはずです。

Visual Studio Code 用拡張機能での Python トランスフォームリポジトリのプレビュー機能。

ローカルでプレビューを実行すると、データセットの一部がマシンにストリーミングされます。詳細については、トランスフォームのプレビューに関するドキュメントを参照してください。

Java 向けの Gradle ベースのローカルプレビュー

このセクションでは、ローカル開発で Java トランスフォームをプレビューするために必要なステップを詳しく説明します。追加の背景情報については、Java のローカル開発に関するドキュメントを参照してください。トランスフォームをプレビューする方法についても確認できます。Gradle ベースのローカルプレビューは、Foundry 内でリモートでプレビューを実行します。

前提条件と制限事項

ローカルプレビューを利用するには、ローカル開発の既存の前提条件に加えて、ローカルブランチがリモートブランチを追跡している必要があるため、ローカルブランチを少なくとも1回プッシュする必要があります。以下の追加の制限事項に注意してください。

  • プレビュー URI にアクセスできるのは、プレビューを実行したユーザーのみであり、一時的に利用可能です。

データセットプレビューを実行する

プレビューを実行する前に、ローカル開発用の環境をセットアップし、リポジトリが最新のテンプレートバージョンにアップグレードされていることを確認する必要があります。

  1. ./gradlew displayTransformsList を実行すると、利用可能なすべてのトランスフォームのリストが返されます。 datasetPreview タスクを使用して、利用可能なすべてのトランスフォームを一覧表示する

  2. <transformId> をトランスフォームIDのいずれか(上のスクリーンショットの青いテキスト)に置き換えて ./gradlew datasetPreview --transformId=<transformId> を実行すると、計算済みのプレビューにアクセスできる Foundry へのリンクが返されます。 datasetPreview タスクを使用してプレビューを実行し、Foundry のリンクを取得する Foundry の計算済みデータセットプレビュー

  3. (任意)上記のコマンドに --printMode=table フラグを追加すると、プレビューへのリンクが返される代わりに、プレビューしたすべてのデータセットの先頭10行がターミナルに直接表示されます。 datasetPreview タスクを使用してプレビューを実行し、ターミナルに表示する

  4. (任意)プレビューに入力ファイルを含めるには、--inputFiles=<datasetAlias>:<path> を追加します。ここで、<datasetAlias> は選択したトランスフォーム関数の入力データセットのいずれか、<path> はその入力データセット内のファイルパスです。 入力ファイルの引数を使用してデータセットのファイルを含める

  5. (任意)プレビューに出力ファイルを含めるには、--outputFiles=<datasetAlias>:<path> を追加します。ここで、<datasetAlias> は選択したトランスフォーム関数の出力データセットのいずれか、<path> はその出力データセット内のファイルパスです。 出力ファイルの引数を使用してデータセットのファイルを含める