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

公開済みの関数を管理する

公開後は、すべての種類の関数を Ontology Manager で表示および管理できます。

関数を検索する

関数を検索するには、Ontology Manager に移動し、関数タブを選択します。 関数名、説明、API名、RID をはじめとする、関数のほとんどのメタデータで検索できます。

Ontology Manager で関数を検索する

関数の概要ページ

Ontology Manager で関数を選択すると、入力、出力、使用履歴、および成功と失敗の回数や実行時間の P95 を含む関数メトリクスを表示できます。

Ontology Manager で関数の概要を表示する

関数の設定ページ

一部の種類の関数では、タイムアウトやメモリー上限などのリソースを設定できます。 関数が設定オプションに対応している場合は、設定タブで表示および編集できます。 このタブがない場合、その関数は設定オプションに対応していません。

設定のオーバーライドは、関数のバージョンごとに適用されます。関数の公開に使用するアプリケーションによっては、新しいバージョンにデフォルトの設定が適用され、設定のオーバーライドを再適用する必要がある場合があります。

たとえば、次の画像のように TypeScript 関数のタイムアウトを設定できます。

Ontology Manager で関数のランタイム設定を管理する

設定の継承

関数には、新しいバージョンを公開するときに設定のオーバーライドを継承する機能が標準で備わっています。設定は、セマンティックバージョニングの仕様に従って、以前の安定バージョンから継承されます。安定版ではないバージョンを公開する場合は、以前のバージョンが安定版リリースかどうかにかかわらず、そのバージョンから設定が継承されます。

設定を継承するには、リポジトリに更新済みのテンプレート設定が含まれている必要があります。非表示の templateConfiguration.json ファイルで、リポジトリのバージョンを確認できます。

  • TypeScript v1 関数のリポジトリでは、parentTemplateVersion >= 3.512.0 が必要です
  • Python 関数のリポジトリでは、parentTemplateVersion >= 0.423.0 が必要です

一貫性のあるスナップショット

関数ベースのアクションでは、スナップショットの動作はアクションタイプの分離レベルと関数のスナップショット設定によって決まります。

一貫性のあるスナップショットには、次の特性があります。

  • データの一貫性: スナップショットを使用しない場合、リクエスト間で基になるデータが変更されると、関数内で順に実行されるオントロジークエリが異なるバージョンのデータを返す可能性があります。スナップショットを使用すると、データベーストランザクションのスナップショット分離と同様に、関数はオントロジーの一貫したビューに対して動作します。
  • パフォーマンスの向上: すべてのオントロジーリクエストで同じスナップショットを再利用すると、オントロジーの読み取りパフォーマンスが大幅に向上します。スナップショット分離モードを使用する関数ベースのアクションタイプにも、この利点があります。

スナップショットの設定

高度なユースケースでスナップショットを明示的に管理する必要がある場合は、関数の設定ページで次のオプションを使用してスナップショットの動作を設定できます。

  • デフォルト(推奨): スナップショット関連のエラーが発生しない限り、このオプションを選択したままにします。
  • スナップショットを無効にする: 実行中のクエリごとに最新のデータが必要な場合や、長時間実行されるワークロードによってスナップショットエラーが発生している場合に使用します。Read Committed 分離モードを使用するアクションタイプでは、スナップショットが無効になります。
  • スナップショットを有効にする: すべての読み取りで特定の時点の一貫したビューが必要で、読み取りパフォーマンスを向上させたい場合に、実行中にデータが更新されなくても関数に支障がなければ使用します。ほとんどのユースケースでは推奨しません。

デフォルトでは、ソースを持つ関数はスナップショットを使用せず、ライブデータに対して実行されます。関数は書き込みや外部システムの呼び出しを実行できるため、スナップショットの強制は推奨しません。

適用される制限

関数の実行時にリソースを過剰に消費しないよう、いくつかの制限が設けられています。

時間制限

関数の実行開始から終了までの経過時間は、デフォルトで 60秒に制限されています。この制限は、関数の設定ページで変更できます。

ライブプレビューで実行する場合、関数の設定ページで変更していても、関数は最大 280秒実行できます。

Automate を通じて実行される関数は、標準の実行時間制限を超えて、最大 4時間非同期で実行されます。

TypeScript v1 関数には、さらに 30秒の CPU 時間制限があり、これは設定できません。関数がこのしきい値を超える原因は、多くの場合、非効率なデータ読み込みロジックです。CPU タイムアウトを回避するためのヒントについては、パフォーマンスの最適化のセクションを参照してください。

メモリー上限

メモリー上限は、TypeScript v1、TypeScript v2、Python 関数で異なります。

TypeScript v1

関数実行時のメモリー使用量は 128メガバイトに制限されています。この上限に達することはまれで、多くの場合、メモリー上限に達する前に時間制限やオブジェクトの読み込み上限に達します。

デプロイ済みの Python 関数

デプロイ済みの Python 関数では、デフォルトのメモリー使用量は 2ギガバイトです。現在、デプロイ済みの Python 関数では、関数の設定ページでメモリー使用量を設定できません。

サーバーレスの Python 関数および TypeScript v2 関数

サーバーレス関数では、デフォルトのメモリー使用量は 1024メビバイトです。関数の設定ページで 512メビバイトから 5120メビバイトの範囲に設定できます。

マルチスレッド

TypeScript v1 では、関数は単一のスレッドで実行されるため、同時に実行できる計算は1つだけです。ただし、オブジェクトセットやリンクの読み込みは並列化できます。詳細については、パフォーマンスの最適化を参照してください。

TypeScript v2 関数および Python 関数では、組み込みの Node.js worker_threads ライブラリと Python threading ライブラリを使用してマルチスレッドを利用できます。

TypeScript v1 のオブジェクトセットの制限

オブジェクトセットを使用する場合、次の条件では .all() または .allAsync() を呼び出すとエラーがスローされます。

  • オブジェクトセットから 100,000個を超えるオブジェクトを一度に読み込む場合。一般に、数万個のオブジェクトを読み込むだけでも、時間制限やメモリー上限に達します。この上限に達するユースケースでは、集計を使用して概要データを取得するか、並べ替えと制限を使用してオブジェクトのサブセットを取得することを検討してください。
  • 3回を超える関連検索を一度に使用する場合。

一部の集計演算とバケット化操作には制限があります。詳細については、集計のセクションを参照してください。