手動実行

既存のオブジェクトセットに対して自動化を手動で実行できます。これは、データのバックフィルや、広くリリースする前に自動化をテストする場合に役立ちます。

手動実行では、Automate インターフェースで実行するを選択したユーザーが実行者とみなされます。自動化を手動で実行するには、ユーザーに Automate リソースに対する Compass の編集権限が必要です。

自動化を手動で実行するには、まず必要な効果を設定して新規の自動化を作成します。次に、自動化を開き、実行するタブに移動します。

自動化を手動で実行すると、その自動化に設定された効果が直ちにトリガーされます（条件によっては、任意でユーザー定義のオブジェクトセットに対して実行されます）。

例：手動実行で問題を解消する

未処理のオブジェクトが大量にあると、手動実行中にスナップショットの有効期限切れエラーが発生する場合があります。これを回避するには、関数ベースのオブジェクトセットを使用して、未処理のオブジェクトを管理可能なバッチに分けて処理します。

1. 処理が必要なオブジェクトのうち、最も古い N 個を返す関数を作成します。たとえば、oldestNObjectsWithBlankField(int count) は、最終編集タイムスタンプ順に並べたオブジェクトを、件数を制限して返します。
2. この関数を呼び出す、関数により生成されたオブジェクトセットを使用するように自動化を設定します。
3. 適切なバッチサイズで自動化を繰り返し手動実行し、毎回実行が完了するまで待ちます。
4. 未処理のオブジェクトが100,000個未満になるまで、手動実行を続けます。
5. 未処理のオブジェクトが管理可能な量になったら、通常の条件ベースの自動化で、新しいオブジェクトが到着するたびに処理できます。

実行設定

実行設定では、いくつかのパラメーターを設定できます。

• オブジェクトセットを指定：オブジェクトセット条件では、入力オブジェクトセットを指定できます。オブジェクトセットのサイズ制限については、制限のドキュメントを参照してください。このオブジェクトセットには、自動化の条件で設定されたタイプと同じタイプのオブジェクトを含める必要があります。このセット内のすべてのオブジェクトが自動化をトリガーし、新しいオブジェクトパラメーターを使用するすべての効果に渡されます。現在、3種類のオブジェクトセットがサポートされています。

  • 定義されたオブジェクトセット： 静的（手動で選択したオブジェクト）、または動的（選択したオブジェクトセットに対するフィルターで定義）。
  • 保存されたオブジェクトセット： Palantir リソースとして保存されたオブジェクトセット。
  • 関数により生成されたオブジェクトセット： 関数を選択し、固定値でパラメーターを定義します。この関数は、条件のオブジェクトセットと同じオブジェクトタイプのオブジェクトセットを返す必要があります。

• バッチサイズ： バッチサイズは、各実行に含まれるオブジェクト数を決定します。たとえば、バッチサイズが100個のオブジェクトで、定義されたオブジェクトセットに1,000個のオブジェクトがある場合、自動化は1分間隔でスケジュールされた10回の個別実行（それぞれ100個のオブジェクト）になります。オブジェクトは、非決定的なランダム順序でパーティション分割されます。

  • 自動化の条件にオブジェクトセットが含まれていない場合、バッチサイズの設定は表示されません。

• 並列処理： 並列処理では、並列で実行するバッチ数を指定します。数値を大きくすると、実行が高速になります。

• 受信者： 手動実行では、すべてのユーザーへの通知送信がサポートされています。
  
  

  手動実行がトリガーされると、実行を開始したユーザーのトークンを使用してオブジェクトセットが評価されます。これにより、実行ユーザーの権限とアクセス権に従って評価が行われます。

実行結果を監視する

手動実行後、イベント履歴で実行結果を確認できます。効果の実行を表示する際は、次の観測可能性機能を利用できます。

• フレームチャート： 関数、アクション、言語モデルにわたる実行フローを表示します。タイミングとバッチ間の関係に関する情報を使用して、並列処理を監視し、失敗を特定します。
• サービスログ： トークン使用量、ログメッセージ、エラー、トレースを確認します。