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

一貫性と分離

アクションは、オントロジーからの読み取り、ユーザー定義のロジックの適用、1個以上のオブジェクトやリンクへの編集の書き込みを行える単一のトランザクションを通じて、オントロジーに編集を適用します。

このページでは、同時実行時にアクションタイプが提供する保証と、特定のユースケースに適した分離レベルの選び方を説明します。

ACID の保証

アクションはデータベーストランザクションとして動作し、標準的な ACID 特性を提供します。

  • 原子性: アクションによるオントロジーへの編集は、すべて適用されるか、まったく適用されない単一のバッチとして適用されます。この保証は、通知や Webhook など、アクションのその他の副次的効果や、アクションの基になる関数が行う外部呼び出しなどの副次的効果には及びません。
  • 一貫性: アクションによる編集は、Value Type の制約や必須プロパティなど、オントロジーの制約を満たす場合にのみコミットされます。
  • 分離性: 同時に実行されるアクションが互いにどのように影響するかを規定します。アクションタイプで利用できる分離レベルを参照してください。
  • 永続性: アクションがコミットされると、その編集は永続的に保存されます。

アクションの完了後に開始されるアクションやクエリには、完了したアクションによって適用されたすべての編集が反映されます。 この保証は、同じアクションの実行中に行われる読み取りには適用されません。

これらの編集が読み取りに反映されるかどうかは、書き込みモードで説明するように、アクションの書き込みモードによって異なります。

書き込みの仕組み

プロパティへの書き込みと見なされるもの

アクションがプロパティに書き込むかどうかは、アクションの実装方法によって異なります。

OSDK アクションリクエスト

オントロジー SDK (OSDK) を通じてアクションを適用する場合、任意のパラメーターをアクションリクエストから省略できるのは、そのパラメーターにデフォルト値が設定されている場合のみです。 デフォルト値にオブジェクトプロパティの現在の値を使用している場合、アクションは省略されたパラメーターにそのプロパティ値を設定し、プロパティに書き戻します。

書き込みモード

アクションには2つの書き込みモードがあります。 どちらのモードでも、アクションの実行中に編集が収集され、最後に単一のアトミックなバッチとしてオントロジーにコミットされるため、ほかのアクションから部分的に適用されたアクションが見えることはありません。 2つのモードの違いは、アクション自身の読み取りに、その時点までに行った編集が反映されるかどうかです。

  • バッチ書き込み(デフォルト): アクションの実行中に編集がバッチに収集され、最後に単一のアトミックな操作としてオントロジーにコミットされます。アクション自身の読み取りには、バッチに収集された編集は反映されません。すべての読み取りは、このアクションがその時点までに収集した編集を含めず、オントロジー内のデータをそのまま返します。たとえば、アクションがオブジェクトのプロパティを更新してからそのオブジェクトを再度読み取った場合、更新後の値ではなく、元の値が返されます。
  • ステージング書き込み: アクションの読み取りに、自身が行った編集が反映されます。同じアクションの実行中に、そのアクションが編集したオブジェクトを読み取ると、編集後の値が返され、検索や集計にも編集が反映されます。ステージング書き込みは現在、TypeScript v2、Python、および AIP Logic の関数ベースのアクションタイプでサポートされています。

競合チェックの仕組み

スナップショット分離モードでは、オントロジーはオブジェクトレベルで書き込み同士の競合を検出します。 2つのアクションが同じオブジェクトに同時に書き込むと、片方のアクションが競合エラーで失敗します。 これは、アクションがそのオブジェクトの異なるプロパティに書き込む場合にも適用されます。 デフォルト値を持つパラメーターから書き込まれるプロパティも、ユーザーがアクションフォームでそれらの項目を変更しなくても、書き込みとして扱われます。 同時実行される2つのアクションが異なる分離モードを使用する場合、それぞれのアクションは自身のモードに従って競合をチェックします。

オブジェクトタイプまたは多対多のリンクタイプの元データセットを再ビルドした場合にも、競合が発生することがあります。 アクションの実行間で発生する競合は、両方のアクションが書き込むオブジェクトに限られますが、元データセットの再ビルドによって発生する競合は、より広い範囲に及びます。 再ビルド中は、アクションが書き込む特定のオブジェクトが再ビルドによって変更されない場合でも、アクションで競合が発生することがあります。 これらの競合は一時的なものであるため、通常は再ビルドの完了後にアクションを再試行すると成功します。

競合が検出されると、失敗したアクションによる編集全体が破棄されます。競合がどのように返され、再試行されるかを参照してください。

分離レベル

アクションタイプの分離レベルは、同じデータを扱うほかのアクションと並行してアクションが実行される場合に適用される保証を定めます。 分離レベルは、アクション内の各読み込みがどのバージョンのデータを参照するか、および、どのような並行変更が発生した場合に、すでに変更されたデータに基づく結果をコミットするのではなく、アクションを失敗させるか、という2つの事項を定義します。 より強いレベルでは、より多くの異常を防げますが、競合によって拒否されるアクションも増えます。より弱いレベルでは、コミットされる頻度が高くなりますが、保証は少なくなります。

アクションタイプの分離レベルは、Ontology Manager のアクションタイプの [機能] タブで設定します。 レベルは作成後に変更でき、それ以降の実行に適用されます。

バッチ書き込みを使用する新しいアクションタイプは、すべてデフォルトでスナップショット分離を使用して作成されます。 ステージング書き込みを使用するアクションタイプは、現在レガシーモードのみをサポートしています。 詳しくは、ステージング書き込みの現在の動作を参照してください。

Ontology Manager の [機能] タブで、推奨される選択肢としてスナップショット分離が選択されている分離レベルの設定。

関数ベースのアクションタイプの分離レベルを設定する場合は、元となる関数のスナップショット設定をデフォルトのままにしてください。関数の設定を変更すると、アクションと互換性がなくなり、実行が失敗する可能性があります。

  • スナップショットを無効にするは、スナップショット分離と互換性がありません。
  • スナップショットを有効にするは、Read Committed と互換性がありません。

アクションタイプで利用可能なレベルの概要を以下に示し、続くセクションで詳しく説明します。

レベル読み取り競合チェック
レガシー読み取りが単一時点の状態に基づくことは保証されません。同じアクション内でも、読み取りごとに異なる状態が読み取られる場合があります。このアクションが書き込んだオブジェクトを別のアクションが変更した場合、失敗します。
スナップショット分離すべての読み取りで、アクションの開始時に取得された1つのスナップショットを使用します。このアクションが書き込んだオブジェクトを別のアクションが変更した場合、失敗します。
Read Committed各読み取りでは、読み取り時点でコミットされている最新の値が返されます。同時に変更が行われても編集できます。両方のアクションが設定するプロパティには、最後にコミットしたアクションの値が適用されます。

レガシー

明示的な分離レベルが導入される前に作成されたアクションタイプでは、引き続き [機能] タブでレガシー分離モードを利用できます。 バッチ書き込みを使用する新しいアクションタイプのデフォルトは、代わりにスナップショット分離です。

読み込み: 通常、読み込みは単一の時点のデータを参照しますが、これは保証されません。オブジェクトストレージからのデータ取得エラーにより、アクションの実行中に基盤となるデータが更新されることがあるため、同じアクションの実行中に読み込まれたオブジェクトが、オントロジーの異なる状態を反映する場合があります。

書き込み: レガシー分離は、両方の書き込みモードをサポートしています。バッチ書き込みでは、同じアクションの実行中に後から行われる読み込みに、その実行中に先に行われた編集は含まれません。ステージング書き込みでは、後から行われる読み込みにそれらの編集が含まれます。詳しくは、書き込みの仕組みおよびステージング書き込みの現在の動作を参照してください。

競合チェック: アクションが書き込むオブジェクトを、オブジェクトが読み込まれてからアクションがコミットされるまでの間に別のアクションが変更した場合、そのアクションは競合エラーで失敗します。ただし、読み込みの一貫性は保証されないため、アクションが読み込んだだけのデータに基づく判断は、異なる時点のデータが混在するビューに基づいて行われる場合があります。

レガシー分離モードは、下位互換性のために提供されています。

新しいアクションタイプでは、スナップショット分離を使用すると、同じ競合チェックに加えて、すべての読み込みが単一の時点のデータを参照するという保証が得られます。

スナップショット分離

これは、バッチ書き込みを使用する新しいアクションタイプのデフォルトのレベルです。ステージング書き込みを使用するアクションタイプの動作については、ステージング書き込みの現在の動作を参照してください。

ソースが異なるデータを参照する場合がある

ロジックルールおよび関数ベースのアクションは、一貫した単一の時点のオントロジーを読み込みます。関数がソースを呼び出すと、ソースはアクションの特定時点のビューの外部で動作します。ソースはオントロジーやほかのシステムから読み込むことがあり、それらの読み込みでは異なる時点のデータを参照する場合があります。アクションの原子性と競合チェックは、ソースが実行する操作には適用されません。

読み込み: アクションが直接行うオントロジーの読み込みは、すべてアクションの開始時に取得された、一貫した単一の時点のビューを参照します。同じオブジェクトの読み込みや同じ検索を2回実行すると、このアクションの実行中にほかのアクションが何をコミットしたかにかかわらず、常に同じ一致データが返されます。

書き込み: アクションはバッチ書き込みを使用するため、同じアクションの実行中に後から行われる読み込みに、その実行中に先に行われた編集は含まれません。

競合チェック: アクションが書き込むオブジェクトを、オブジェクトが読み込まれてからアクションがコミットされるまでの間に別のアクションが変更した場合、そのアクションは競合エラーで失敗します。アクションは、並行して行われた変更を上書きするのではなく失敗します。このレベルでは、アクションが読み込むだけのオブジェクトは、競合による失敗の要因にはなりません。競合時の再試行については、一時的なエラー時の再試行モードを参照してください。

書き込みスキュー

競合チェックの対象は書き込まれたオブジェクトのみであるため、スナップショット分離では読み書き競合を検出しません。

2つのアクションがそれぞれ重複するデータを読み込み、その読み込みに基づいて判断し、異なるオブジェクトに書き込んで、両方ともコミットすることがあります。どちらも、相手の書き込みを参照できていればコミットしなかったはずです。

これは書き込みスキューと呼ばれます。

例: オンコールの当番体制では、常にエンジニアが1つ以上、当番に就いている必要があります。エンジニアが当番から外れることができるのは、ほかの誰かが残る場合のみであるため、アクションは現在、少なくとも2人のエンジニアが当番に就いているかを確認します。エンジニア A と B がともに当番に就いており、それぞれ自分を当番から外すアクションを同時に実行します。

  • A のアクションは、そのスナップショットから当番体制を読み込み、2人のエンジニアが当番に就いていることを確認します。A を外しても B が残るため、処理を続行します。
  • B のアクションは、自身のスナップショットから同じ状態を読み込み、2人のエンジニアが当番に就いていることを確認し、同じ理由で処理を続行します。
  • A は A.onCall = false を書き込み、B は B.onCall = false を書き込みます。2つのアクションは異なるオブジェクトに書き込んだため、書き込み同士の競合は発生せず、両方ともコミットされます。その結果、当番が誰もいなくなり、不変条件に違反します。

違反した不変条件が、いずれかのアクションが書き込んだ単一のオブジェクトではなく、アクションが読み込んだデータ(当番に就いているエンジニアの集合)に関するものであるため、スナップショット分離ではこれを検出できません。

この異常を回避するには、不変条件を単一の共有オブジェクトへの書き込みとして表現するように、ワークフローを再設計します。

たとえば、両方のアクションが onCallCount プロパティを持つ Rotation オブジェクトに書き込むようにすると、アクション同士が競合するようになります。

Read Committed

読み込み: 読み込みのたびに、その実行時点で最後にコミットされた値が返されます。固定のスナップショットはないため、同じアクション内の異なる時点で2回読み込むと、その間に別のアクションがコミットした場合、異なる状態が読み込まれることがあります。

書き込み: アクションはバッチ書き込みを使用するため、同じアクションの実行中に後で行われる読み込みには、その実行中に先に行われた編集は含まれません(書き込みの仕組みを参照)。

競合チェック: アクションの実行中に別のアクションが同じオブジェクトを変更した場合でも、編集が許可されます。両方のアクションがコミットすると、異なるプロパティへの変更は保持されます。両方のアクションが同じプロパティを設定した場合は、最後にコミットしたアクションによってその値が決まります。

例:Ticket オブジェクトに status = "open" と priority = "low" が設定されています。2つのアクションが同時に実行されます。アクション B は Read Committed を使用します。

  • アクション A が status = "in progress" と priority = "medium" を設定します。
  • アクション B は priority = "high" のみを設定します。
  • アクション A が先にコミットします。チケットは status = "in progress"、priority = "medium" になります。
  • アクション B が次にコミットし、アクション A による priority の変更を上書きします。チケットは最終的に status = "in progress" と priority = "high" になります。アクション A による status の変更とアクション B による priority の変更は、どちらも保持されます。

スナップショット分離では、両方のアクションが同じオブジェクトに書き込んだため、アクション B の競合チェックが失敗し、アクション A の編集が保持されます。

同時実行されるアクションは引き続き失敗する可能性があります

Read Committed モードが有効な場合でも、多数のアクションが同じオブジェクトに対して同時実行されると、少数のアクションの実行が競合エラーで失敗することがあります。競合エラーが返された場合は、失敗したアクションを再試行するか、ワークフローの同時実行数を減らしてください。

このレベルでは、正確性の保証が弱まる代わりに、コミットの成功率が高くなります。パラメーターとして渡された値など、アクションがすでに持っている値のみを書き込み、何を書き込むかの判断を読み込んだ内容に依存しない場合に適しています。

同時に行われた編集は上書きされる可能性があります

複数のアクションが同じプロパティを同時に設定できる場合は、Read Committed を慎重に使用してください。両方のアクションがコミットすると、後のアクションがそのプロパティの以前の値を上書きします。ほかのプロパティへの変更は保持されます。プロパティへの書き込みと見なされるものとロジックルールがデフォルト値で編集を上書きする仕組みを確認してください。

ステージング書き込みの現在の動作

ステージング書き込みを使用するアクションタイプは、現在、レガシー分離モードのみをサポートしています。

このセクションでは、ステージング書き込みが提供する保証について説明します。

読み込み: 読み込みのたびに、その実行時点で最後にコミットされた値に、そのアクション自体のステージングされた編集を加えた値が返されます。固定のスナップショットはないため、同じアクション内の異なる時点で2回読み込むと、その間に別のアクションがコミットした場合、異なる状態が読み込まれることがあります。ただし、アクション自体のステージングされた編集は、その後の読み込みに常に反映されます。

書き込み: アクションはステージング書き込みを使用するため、同じアクションの実行中に後で行われる読み込みには、その実行中に先に行われた編集が含まれます。編集は、最後にアトミックにコミットされるまで、ほかのアクションには反映されません(書き込みの仕組みを参照)。

競合チェック: アクションが書き込むオブジェクトを読み込んでからアクションがコミットするまでの間に、別のアクションがそのオブジェクトを変更すると、競合エラーで失敗します。アクションは、同時に行われた変更を上書きするのではなく失敗します。アクションが読み込むだけのオブジェクトは、競合による失敗の要因にはなりません。競合時の再試行については、一時的エラー時の再試行モードを参照してください。

この動作は、ステージング書き込みによって自分自身の書き込みを読み込める機能と、書き込み同士の競合検出を組み合わせたものですが、オントロジーからの読み込みが単一の時点の状態に基づくことは保証しません。

一時的エラー時の再試行モード

プラットフォームは、競合エラーやオブジェクトストレージからのオブジェクトの読み込み失敗など、一時的なエラーが発生した場合にアクションを自動的に再試行します。再試行のたびに、アクションに設定された分離レベルを使用してアクションが最初から再実行され、試行回数は最大5回です。現在の値を読み込むロジックは、新しい実行で利用可能なデータを使用して編集内容を再計算します。すべての試行が失敗した場合は、呼び出し元にエラーが返されます。

ただし、デフォルトでは、外部呼び出しのないアクションの実行のみが自動的に再試行されます。プラットフォームは、アクションタイプの設定と、その基盤となる関数が宣言するリソースに基づいて呼び出しを分類します。次のものは外部呼び出しと見なされます。

  • アクションタイプに設定されたライトバック Webhookの実行。
  • 基盤となる関数からの Data Connection ソースへのアクセス、または Webhook の呼び出し。
  • 基盤となる関数からの OSDK の使用(読み取り専用リクエストを含む)。これには、OSDK を使用してオントロジーにアクセスする TypeScript v2 および Python の関数ベースのアクションタイプが含まれます。
  • 基盤となる関数からの別の関数の呼び出し(データを読み込むだけの関数を含む)。
  • 独自にオントロジーの編集をコミットする別のアクションの呼び出し。

この分類は、特定の実行で宣言済みのリソースが使用されない場合でも適用されます。外部呼び出しを繰り返すと、2件目の予約の作成やオントロジーの重複編集など、すでに成功した変更が繰り返される可能性があります。

この動作は、機能タブの一時的エラー時の再試行モード設定を使用して、アクションタイプごとに調整できます。

機能タブの一時的エラー時の再試行モードのドロップダウンに表示された利用可能な選択肢。

  • 外部呼び出しのないアクションのみ(デフォルト): プラットフォームは、アクションタイプに外部システム呼び出しがない場合にのみ再試行します。
  • すべてのアクション: プラットフォームは、外部呼び出しを含むすべてのアクションを再試行します。アクションタイプの外部呼び出しが安全に繰り返せる(冪等である)ことがわかっている場合に使用します。
  • 無効: プラットフォームは自動的には再試行しません。最初の失敗時に呼び出し元にエラーが返されます。呼び出し元ですべての競合を検知して処理したい場合に使用します。

この設定によって、ほかの点では同一の2つのアクションタイプでも、競合が発生する状況での動作が異なる場合があります。一方は競合時に自動的に再試行されるため常に成功するように見えますが、もう一方は呼び出し元に競合エラーを返します。

また、自動再試行により、競合が頻繁に発生するアクションは、最終的には成功する場合でも、完了までにかかる時間が大幅に長くなることがあります。

ロジックルールを通じてマッピングされたプロパティを確認する

ロジックルールは、ユーザーがパラメーターをデフォルト値のままにしていても、パラメーターにマッピングされたすべてのプロパティに書き込みます。

チケットの例で、アクション B が status と priority の両方をマッピングしているとします。

  • アクション B は status のデフォルト値として "open" を使用します。ユーザーは priority のみを "high" に変更しますが、ルールは status にもデフォルト値の "open" を書き込みます。
  • アクション A が status = "in progress" と priority = "medium" をコミットします。
  • アクション B が status = "open" と priority = "high" をコミットします。ユーザーがその項目を変更していなくても、status のデフォルト値がアクション A の変更を上書きします。

priority のみを変更することを意図したアクションでは、priority のみに書き込むようにルールを設定します。

異なる分離モードでアクションを同時に実行する

2つのアクションが異なる分離モードを使用して同じオブジェクトを同時に編集する場合、それぞれのアクションは自身のモードに従って競合をチェックします。Read Committed のアクションによってコミットされた編集でも、スナップショット分離またはレガシー分離を使用するアクションの競合チェックが失敗する原因になることがあります。

たとえば、アクション A はスナップショット分離を使用し、status = "in progress" と priority = "medium" を設定します。アクション B は Read Committed を使用し、priority = "high" のみを設定します。アクション A の自動再試行は無効になっているとします。どちらのアクションも、いずれかがコミットする前のチケットの元の値で開始します。

  • アクション A が先にコミットする場合: アクション B も、Read Committed モードを使用しているためコミットします。最終的に、チケットは status = "in progress" と priority = "high" になります。
  • アクション B が先にコミットする場合: アクション A は競合チェックに失敗し、その編集は一切適用されません。チケットは status = "open" と priority = "high" のままになります。

分離レベルを選択する

  • 特別な理由がない限り、スナップショット分離を使用します。スナップショット分離は、個々のオブジェクトに対する読み取り・変更・書き込みのロジックを含め、ほとんどのワークフローに最適な分離レベルです。
  • 明示的な分離レベルが導入される前に作成されたアクションタイプについては、分離レベルをスナップショット分離に設定します。これにより、通常は同じ時点のデータが読み取られるものの保証はされないレガシーの動作とは異なり、実行中のすべての読み取りで同じ時点のデータが使用されることが保証されます。ただし、スナップショット分離では実行全体を通じて同じ時点のビューが使用されるため、長時間実行されるアクションが頻繁に更新されるデータを編集しようとすると、失敗する頻度が高くなる可能性があります。
  • Read Committed を検討するのは、競合による失敗が頻繁に発生し、このモードで許容される異常を理解しており、アクションによる書き込みがデータの安定した読み取りに依存しない場合のみにしてください。既存のアクションタイプをこのモードに切り替える前に、Read Committed セクションの警告を確認してください。