注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
アクションは、オントロジーからの読み取り、ユーザー定義のロジックの適用、1個以上のオブジェクトやリンクへの編集の書き込みを行える単一のトランザクションを通じて、オントロジーに編集を適用します。
このページでは、同時実行時にアクションタイプが提供する保証と、特定のユースケースに適した分離レベルの選び方を説明します。
アクションはデータベーストランザクションとして動作し、標準的な ACID 特性を提供します。
アクションの完了後に開始されるアクションやクエリには、完了したアクションによって適用されたすべての編集が反映されます。 この保証は、同じアクションの実行中に行われる読み取りには適用されません。
これらの編集が読み取りに反映されるかどうかは、書き込みモードで説明するように、アクションの書き込みモードによって異なります。
アクションがプロパティに書き込むかどうかは、アクションの実装方法によって異なります。
オントロジー SDK (OSDK) を通じてアクションを適用する場合、任意のパラメーターをアクションリクエストから省略できるのは、そのパラメーターにデフォルト値が設定されている場合のみです。 デフォルト値にオブジェクトプロパティの現在の値を使用している場合、アクションは省略されたパラメーターにそのプロパティ値を設定し、プロパティに書き戻します。
アクションには2つの書き込みモードがあります。 どちらのモードでも、アクションの実行中に編集が収集され、最後に単一のアトミックなバッチとしてオントロジーにコミットされるため、ほかのアクションから部分的に適用されたアクションが見えることはありません。 2つのモードの違いは、アクション自身の読み取りに、その時点までに行った編集が反映されるかどうかです。
スナップショット分離モードでは、オントロジーはオブジェクトレベルで書き込み同士の競合を検出します。 2つのアクションが同じオブジェクトに同時に書き込むと、片方のアクションが競合エラーで失敗します。 これは、アクションがそのオブジェクトの異なるプロパティに書き込む場合にも適用されます。 デフォルト値を持つパラメーターから書き込まれるプロパティも、ユーザーがアクションフォームでそれらの項目を変更しなくても、書き込みとして扱われます。 同時実行される2つのアクションが異なる分離モードを使用する場合、それぞれのアクションは自身のモードに従って競合をチェックします。
オブジェクトタイプまたは多対多のリンクタイプの元データセットを再ビルドした場合にも、競合が発生することがあります。 アクションの実行間で発生する競合は、両方のアクションが書き込むオブジェクトに限られますが、元データセットの再ビルドによって発生する競合は、より広い範囲に及びます。 再ビルド中は、アクションが書き込む特定のオブジェクトが再ビルドによって変更されない場合でも、アクションで競合が発生することがあります。 これらの競合は一時的なものであるため、通常は再ビルドの完了後にアクションを再試行すると成功します。
競合が検出されると、失敗したアクションによる編集全体が破棄されます。競合がどのように返され、再試行されるかを参照してください。
アクションタイプの分離レベルは、同じデータを扱うほかのアクションと並行してアクションが実行される場合に適用される保証を定めます。 分離レベルは、アクション内の各読み込みがどのバージョンのデータを参照するか、および、どのような並行変更が発生した場合に、すでに変更されたデータに基づく結果をコミットするのではなく、アクションを失敗させるか、という2つの事項を定義します。 より強いレベルでは、より多くの異常を防げますが、競合によって拒否されるアクションも増えます。より弱いレベルでは、コミットされる頻度が高くなりますが、保証は少なくなります。
アクションタイプの分離レベルは、Ontology Manager のアクションタイプの [機能] タブで設定します。 レベルは作成後に変更でき、それ以降の実行に適用されます。
バッチ書き込みを使用する新しいアクションタイプは、すべてデフォルトでスナップショット分離を使用して作成されます。 ステージング書き込みを使用するアクションタイプは、現在レガシーモードのみをサポートしています。 詳しくは、ステージング書き込みの現在の動作を参照してください。
![Ontology Manager の [機能] タブで、推奨される選択肢としてスナップショット分離が選択されている分離レベルの設定。](/docs/resources/foundry/action-types/actions-isolation-levels.png)
関数ベースのアクションタイプの分離レベルを設定する場合は、元となる関数のスナップショット設定をデフォルトのままにしてください。関数の設定を変更すると、アクションと互換性がなくなり、実行が失敗する可能性があります。
アクションタイプで利用可能なレベルの概要を以下に示し、続くセクションで詳しく説明します。
| レベル | 読み取り | 競合チェック |
|---|---|---|
| レガシー | 読み取りが単一時点の状態に基づくことは保証されません。同じアクション内でも、読み取りごとに異なる状態が読み取られる場合があります。 | このアクションが書き込んだオブジェクトを別のアクションが変更した場合、失敗します。 |
| スナップショット分離 | すべての読み取りで、アクションの開始時に取得された1つのスナップショットを使用します。 | このアクションが書き込んだオブジェクトを別のアクションが変更した場合、失敗します。 |
| Read Committed | 各読み取りでは、読み取り時点でコミットされている最新の値が返されます。 | 同時に変更が行われても編集できます。両方のアクションが設定するプロパティには、最後にコミットしたアクションの値が適用されます。 |
明示的な分離レベルが導入される前に作成されたアクションタイプでは、引き続き [機能] タブでレガシー分離モードを利用できます。 バッチ書き込みを使用する新しいアクションタイプのデフォルトは、代わりにスナップショット分離です。
読み込み: 通常、読み込みは単一の時点のデータを参照しますが、これは保証されません。オブジェクトストレージからのデータ取得エラーにより、アクションの実行中に基盤となるデータが更新されることがあるため、同じアクションの実行中に読み込まれたオブジェクトが、オントロジーの異なる状態を反映する場合があります。
書き込み: レガシー分離は、両方の書き込みモードをサポートしています。バッチ書き込みでは、同じアクションの実行中に後から行われる読み込みに、その実行中に先に行われた編集は含まれません。ステージング書き込みでは、後から行われる読み込みにそれらの編集が含まれます。詳しくは、書き込みの仕組みおよびステージング書き込みの現在の動作を参照してください。
競合チェック: アクションが書き込むオブジェクトを、オブジェクトが読み込まれてからアクションがコミットされるまでの間に別のアクションが変更した場合、そのアクションは競合エラーで失敗します。ただし、読み込みの一貫性は保証されないため、アクションが読み込んだだけのデータに基づく判断は、異なる時点のデータが混在するビューに基づいて行われる場合があります。
レガシー分離モードは、下位互換性のために提供されています。
新しいアクションタイプでは、スナップショット分離を使用すると、同じ競合チェックに加えて、すべての読み込みが単一の時点のデータを参照するという保証が得られます。
これは、バッチ書き込みを使用する新しいアクションタイプのデフォルトのレベルです。ステージング書き込みを使用するアクションタイプの動作については、ステージング書き込みの現在の動作を参照してください。
ロジックルールおよび関数ベースのアクションは、一貫した単一の時点のオントロジーを読み込みます。関数がソースを呼び出すと、ソースはアクションの特定時点のビューの外部で動作します。ソースはオントロジーやほかのシステムから読み込むことがあり、それらの読み込みでは異なる時点のデータを参照する場合があります。アクションの原子性と競合チェックは、ソースが実行する操作には適用されません。
読み込み: アクションが直接行うオントロジーの読み込みは、すべてアクションの開始時に取得された、一貫した単一の時点のビューを参照します。同じオブジェクトの読み込みや同じ検索を2回実行すると、このアクションの実行中にほかのアクションが何をコミットしたかにかかわらず、常に同じ一致データが返されます。
書き込み: アクションはバッチ書き込みを使用するため、同じアクションの実行中に後から行われる読み込みに、その実行中に先に行われた編集は含まれません。
競合チェック: アクションが書き込むオブジェクトを、オブジェクトが読み込まれてからアクションがコミットされるまでの間に別のアクションが変更した場合、そのアクションは競合エラーで失敗します。アクションは、並行して行われた変更を上書きするのではなく失敗します。このレベルでは、アクションが読み込むだけのオブジェクトは、競合による失敗の要因にはなりません。競合時の再試行については、一時的なエラー時の再試行モードを参照してください。
競合チェックの対象は書き込まれたオブジェクトのみであるため、スナップショット分離では読み書き競合を検出しません。
2つのアクションがそれぞれ重複するデータを読み込み、その読み込みに基づいて判断し、異なるオブジェクトに書き込んで、両方ともコミットすることがあります。どちらも、相手の書き込みを参照できていればコミットしなかったはずです。
これは書き込みスキューと呼ばれます。
例: オンコールの当番体制では、常にエンジニアが1つ以上、当番に就いている必要があります。エンジニアが当番から外れることができるのは、ほかの誰かが残る場合のみであるため、アクションは現在、少なくとも2人のエンジニアが当番に就いているかを確認します。エンジニア A と B がともに当番に就いており、それぞれ自分を当番から外すアクションを同時に実行します。
A.onCall = false を書き込み、B は B.onCall = false を書き込みます。2つのアクションは異なるオブジェクトに書き込んだため、書き込み同士の競合は発生せず、両方ともコミットされます。その結果、当番が誰もいなくなり、不変条件に違反します。違反した不変条件が、いずれかのアクションが書き込んだ単一のオブジェクトではなく、アクションが読み込んだデータ(当番に就いているエンジニアの集合)に関するものであるため、スナップショット分離ではこれを検出できません。
この異常を回避するには、不変条件を単一の共有オブジェクトへの書き込みとして表現するように、ワークフローを再設計します。
たとえば、両方のアクションが onCallCount プロパティを持つ Rotation オブジェクトに書き込むようにすると、アクション同士が競合するようになります。
読み込み: 読み込みのたびに、その実行時点で最後にコミットされた値が返されます。固定のスナップショットはないため、同じアクション内の異なる時点で2回読み込むと、その間に別のアクションがコミットした場合、異なる状態が読み込まれることがあります。
書き込み: アクションはバッチ書き込みを使用するため、同じアクションの実行中に後で行われる読み込みには、その実行中に先に行われた編集は含まれません(書き込みの仕組みを参照)。
競合チェック: アクションの実行中に別のアクションが同じオブジェクトを変更した場合でも、編集が許可されます。両方のアクションがコミットすると、異なるプロパティへの変更は保持されます。両方のアクションが同じプロパティを設定した場合は、最後にコミットしたアクションによってその値が決まります。
例:Ticket オブジェクトに status = "open" と priority = "low" が設定されています。2つのアクションが同時に実行されます。アクション B は Read Committed を使用します。
status = "in progress" と priority = "medium" を設定します。priority = "high" のみを設定します。status = "in progress"、priority = "medium" になります。priority の変更を上書きします。チケットは最終的に status = "in progress" と priority = "high" になります。アクション A による status の変更とアクション B による priority の変更は、どちらも保持されます。スナップショット分離では、両方のアクションが同じオブジェクトに書き込んだため、アクション B の競合チェックが失敗し、アクション A の編集が保持されます。
Read Committed モードが有効な場合でも、多数のアクションが同じオブジェクトに対して同時実行されると、少数のアクションの実行が競合エラーで失敗することがあります。競合エラーが返された場合は、失敗したアクションを再試行するか、ワークフローの同時実行数を減らしてください。
このレベルでは、正確性の保証が弱まる代わりに、コミットの成功率が高くなります。パラメーターとして渡された値など、アクションがすでに持っている値のみを書き込み、何を書き込むかの判断を読み込んだ内容に依存しない場合に適しています。
複数のアクションが同じプロパティを同時に設定できる場合は、Read Committed を慎重に使用してください。両方のアクションがコミットすると、後のアクションがそのプロパティの以前の値を上書きします。ほかのプロパティへの変更は保持されます。プロパティへの書き込みと見なされるものとロジックルールがデフォルト値で編集を上書きする仕組みを確認してください。
ステージング書き込みを使用するアクションタイプは、現在、レガシー分離モードのみをサポートしています。
このセクションでは、ステージング書き込みが提供する保証について説明します。
読み込み: 読み込みのたびに、その実行時点で最後にコミットされた値に、そのアクション自体のステージングされた編集を加えた値が返されます。固定のスナップショットはないため、同じアクション内の異なる時点で2回読み込むと、その間に別のアクションがコミットした場合、異なる状態が読み込まれることがあります。ただし、アクション自体のステージングされた編集は、その後の読み込みに常に反映されます。
書き込み: アクションはステージング書き込みを使用するため、同じアクションの実行中に後で行われる読み込みには、その実行中に先に行われた編集が含まれます。編集は、最後にアトミックにコミットされるまで、ほかのアクションには反映されません(書き込みの仕組みを参照)。
競合チェック: アクションが書き込むオブジェクトを読み込んでからアクションがコミットするまでの間に、別のアクションがそのオブジェクトを変更すると、競合エラーで失敗します。アクションは、同時に行われた変更を上書きするのではなく失敗します。アクションが読み込むだけのオブジェクトは、競合による失敗の要因にはなりません。競合時の再試行については、一時的エラー時の再試行モードを参照してください。
この動作は、ステージング書き込みによって自分自身の書き込みを読み込める機能と、書き込み同士の競合検出を組み合わせたものですが、オントロジーからの読み込みが単一の時点の状態に基づくことは保証しません。
プラットフォームは、競合エラーやオブジェクトストレージからのオブジェクトの読み込み失敗など、一時的なエラーが発生した場合にアクションを自動的に再試行します。再試行のたびに、アクションに設定された分離レベルを使用してアクションが最初から再実行され、試行回数は最大5回です。現在の値を読み込むロジックは、新しい実行で利用可能なデータを使用して編集内容を再計算します。すべての試行が失敗した場合は、呼び出し元にエラーが返されます。
ただし、デフォルトでは、外部呼び出しのないアクションの実行のみが自動的に再試行されます。プラットフォームは、アクションタイプの設定と、その基盤となる関数が宣言するリソースに基づいて呼び出しを分類します。次のものは外部呼び出しと見なされます。
この分類は、特定の実行で宣言済みのリソースが使用されない場合でも適用されます。外部呼び出しを繰り返すと、2件目の予約の作成やオントロジーの重複編集など、すでに成功した変更が繰り返される可能性があります。
この動作は、機能タブの一時的エラー時の再試行モード設定を使用して、アクションタイプごとに調整できます。

この設定によって、ほかの点では同一の2つのアクションタイプでも、競合が発生する状況での動作が異なる場合があります。一方は競合時に自動的に再試行されるため常に成功するように見えますが、もう一方は呼び出し元に競合エラーを返します。
また、自動再試行により、競合が頻繁に発生するアクションは、最終的には成功する場合でも、完了までにかかる時間が大幅に長くなることがあります。
ロジックルールは、ユーザーがパラメーターをデフォルト値のままにしていても、パラメーターにマッピングされたすべてのプロパティに書き込みます。
チケットの例で、アクション B が status と priority の両方をマッピングしているとします。
status のデフォルト値として "open" を使用します。ユーザーは priority のみを "high" に変更しますが、ルールは status にもデフォルト値の "open" を書き込みます。status = "in progress" と priority = "medium" をコミットします。status = "open" と priority = "high" をコミットします。ユーザーがその項目を変更していなくても、status のデフォルト値がアクション A の変更を上書きします。priority のみを変更することを意図したアクションでは、priority のみに書き込むようにルールを設定します。
2つのアクションが異なる分離モードを使用して同じオブジェクトを同時に編集する場合、それぞれのアクションは自身のモードに従って競合をチェックします。Read Committed のアクションによってコミットされた編集でも、スナップショット分離またはレガシー分離を使用するアクションの競合チェックが失敗する原因になることがあります。
たとえば、アクション A はスナップショット分離を使用し、status = "in progress" と priority = "medium" を設定します。アクション B は Read Committed を使用し、priority = "high" のみを設定します。アクション A の自動再試行は無効になっているとします。どちらのアクションも、いずれかがコミットする前のチケットの元の値で開始します。
status = "in progress" と priority = "high" になります。status = "open" と priority = "high" のままになります。