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

Contour のロジックを Pipeline Builder にエクスポートする

Foundry では、複雑な Contour 分析を行い、その基礎となるロジックを Pipeline Builder にエクスポートすることができます。Contour は、探索的な分析や特定の問題の解決には最適なツールですが、プロダクション・パイプラインのメンテナンスには向いていません。ユーザーのユースケースで分析ロジックが頻繁に変更されない場合は、パイプラインの柔軟性とメンテナンス設定のために Pipeline Builder にエクスポートすることをお勧めします。

以下のガイドでは、Contour 分析をエクスポートする際の検討事項や、Pipeline Builder にロジックを簡単にエクスポートする方法について説明しています。

Contour から Pipeline Builder へのツールは、エクスポート後もロジックが同じであることを保証できません。厳密なロジックに依存するセンシティブなユースケースに対しては、独自の検証を行うことをお勧めします。

検討事項

Contour のロジックを Pipeline Builder にエクスポートする前に、以下の利点、未サポートの機能、および予想される破壊的変更を確認してください。

利点

Pipeline Builder は、ほとんどのユースケースでのパイプライン構築とメンテナンスのための推奨される Foundry ツールです。安定したパイプラインを扱い始め、下流のアプリケーションやユーザーが一貫したスキーマに依存するようになると、パイプラインのメンテナンスとパフォーマンスに関して、Pipeline Builder がはるかに柔軟で設定可能なツールであることがわかるでしょう。以下のようなさまざまなプロダクション品質のユーティリティにアクセスできます。

  • ブランチとプルリクエストを使用した簡単な共同作業。
  • セキュアで一貫したスキーマ。
  • 幅広いタイプセーフな関数。
  • カスタムで強力な計算プロファイル。
  • 同じデータを再構築することなく、インクリメンタルな変換モード。

未サポートの機能

現在、SPLIT 関数やピボット変換には対応していません。ピボットボード内の集計は期待通りに動作します。

上記の未サポートの設定に加えて、他の関数がさまざまな理由でサポートされていない場合があります。このような場合、コンバーターはエラーを返し、失敗の説明を行います。未サポートのロジックを Pipeline Builder に移動したい場合は、変換が成功するまで未サポートのボードを削除してください。次に、Pipeline Builder グラフ の適切な場所にロジックを追加します。

破壊的変更

Contour のロジックを Pipeline Builder に変換する際に、以下の破壊的変更が発生する可能性があります。

  • Contour の非常に柔軟な型システムは、Pipeline Builder で使用される強い型付けと一致しない場合があります。ほとんどの場合、変換は型エラーを修正するメッセージで失敗します。一部のエッジケースでは、Pipeline Builder がスキーマの異なる出力型を選択することがあります。
  • Contour の一部のパラメーターは、Pipeline Builder のパラメーターに変換できません。これが発生した場合、コンバーターは空のパラメーターを作成し、ユーザーが記入できるようにします。
  • タイムゾーンは、Pipeline Builder では Contour とは異なる方法で扱われることがあります。分析を変換した後、タイムゾーンの動作を確認してください。

Contour 分析を Pipeline Builder に変換する

以下の手順に従って、Contour 分析を Pipeline Builder に変換します。

  1. Foundry で Contour 分析に移動します。

  2. 分析の一番下までスクロールし、Convert to Pipeline Builder を選択します。

    分析ページの下部にある Convert to Pipeline Builder ボタンを選択する

  3. 表示されるダイアログで、新しいパイプラインの保存先フォルダーを選択し、Save を選択します。

    Pipeline Builder 内のパイプラインの保存先フォルダーを選択するよう求めるダイアログ

  4. Pipeline Builder で、プレビュー および ビルド を行います。

トラブルシューティング

分析の変換に失敗する

ほとんどの場合、分析の変換が失敗したときに明確なエラーが表示されます。これは、その動作が既知の不足であることを意味します。これがユーザーのユースケースで解決が重要である場合は、Palantir サポートに連絡して、この問題が対処できるかどうか確認してください。

明確なエラーメッセージのスクリーンショット

エラーが既知または予想されない場合、変換に失敗した操作タイプが原因である可能性が高いことを示す努力目標のメッセージが表示されます。また、Pipeline Builder は Contour よりも強力なタイプチェックがあるため(おそらくエラーの根本原因)、その情報も提示されます。

不明瞭なエラーメッセージのスクリーンショット