JetEscrowUpdate 関数

適用対象: Windows |Windows Server

JetEscrowUpdate 関数

JetEscrowUpdate 関数は、1 つの列に対してアトミック加算操作を実行します。 この関数を使用すると、複数のセッションで競合することなく、同じレコードを同時に更新できます。

    JET_ERR JET_API JetEscrowUpdate(
      __in          JET_SESID sesid,
      __in          JET_TABLEID tableid,
      __in          JET_COLUMNID columnid,
      __in          void* pv,
      __in          unsigned long cbMax,
      __out_opt     void* pvOld,
      __in          unsigned long cbOldMax,
      __out_opt     unsigned long* pcbOldActual,
      __in          JET_GRBIT grbit
    );

パラメーター

sesid

この呼び出しに使用するセッション。

tableid

この呼び出しに使用するカーソル。

columnid

更新する列の columnid 。

pv

列の addend を含むバッファーへのポインター。

cbMax

addend を含むバッファーのサイズ。

pvOld

データベースに格納されている列の現在の値を受け取る出力バッファー (バージョン管理は無視されます)。

cbOldMax

列の現在の値を受け取る出力バッファーの最大サイズ。 現在、JET_coltypLongのみがサポートされているため、バッファーの長さは 4 バイトまたは 0 バイトである必要があります。 pvOld が NULL の場合、cbOldMax は 0 である必要があります。

pcbOldActual

出力バッファーで受信した生の値データの実際の量を受け取ります。

grbit

次のオプションの 0 個以上を指定するビットのグループ。

戻り値

この関数は、次のいずれかのリターン コードを使用して 、JET_ERR データ型を返します。 考えられる ESE エラーの詳細については、「 拡張可能ストレージ エンジン エラー 」および「 エラー処理パラメーター」を参照してください。

解説

通常、2 つのセッションでレコードを同時に更新しようとすると、セッションが完全にシリアル化されない限り、2 番目のセッションはJET_errWriteConflictエラーを受け取ります。 同じレコードを更新する 2 つのセッションをシリアル化するには、2 番目のセッションは、最初のトランザクションがトランザクションをコミットした後にトランザクションを開始する必要があります。 詳細については、「 JetBeginTransaction 」を参照してください。

同じレコード内の複数の列をエスクロー更新できます。 更新は互いに影響しません。

JetEscrowUpdate 操作のみが相互に互換性があります。 2 つの異なるセッションで更新の準備または同じレコードの削除を試みると、書き込みの競合が生成されます。

エスクロー操作はバージョン管理され、 JetRollback を使用して元に戻されます (JET_bitEscrowNoRollback指定されていない限り)。 JetEscrowUpdate は、データベースに格納されている列の生の値を返します。これは、アプリケーションがセンチネル値にヒットしたときに特別なアクションを実行する場合があるためです。 JetRetrieveColumn は 列の正しいバージョン管理されたビューを返し、同時セッションによって行われた更新は無視されます。

同じレコードの同じ列で 2 つのセッションが動作している場合、このしくみを確認できます。 列の先頭の値が 0 であるとします。

レコードのエスクロー更新を実行するのと同じトランザクション内のレコードを置き換えることはお勧めしません。 特に、レコードの更新が 1 つのJET_TABLEID で準備され、別の JET_TABLEID を使用してレコードをエスクロー更新する場合、 JetUpdate が呼び出されると、更新されたエスクローは失われます。 これは、更新中にエスクロー列が設定されていない場合でも発生します。

エスクロー更新可能列の値が 0 の場合は、特別な動作をトリガーできます。 この動作は 、JetEscrowUpdate 操作によって列の値が 0 になる場合にのみ発生します。 アクションはすぐには実行されませんが、列の値が 0 のコミットの原因となったトランザクションの後に発生することがあります。 列の値は 0 である必要があります (つまり、他のセッションで列が変更されていない場合)。 列が JET_bitColumnDeleteOnZero で作成された場合、その列を含むレコードは削除されます。 列が JET_bitColumnFinalize で作成された場合は、コールバックが発行されます。 クラッシュすると、これらのアクションが発生しない可能性がありますが、オンライン メンテナンス ( JetDefragment 関数を使用) はアクションを正しくやり直します。

必要条件

参照

JET_COLUMNID
JET_ERR
JET_GRBIT
JET_SESID
JET_TABLEID
JetBeginTransaction
JetDefragment
JetPrepareUpdate
JetRetrieveColumn
JetRollback
JetStopService
JetUpdate