StoredProcedureRequestOptions.SessionToken プロパティ

定義

名前空間:

Azure.Cosmos

アセンブリ:

Azure.Cosmos.dll

パッケージ:

Azure.Cosmos v4.0.0-preview3

Azure Cosmos DB サービスのセッション整合性で使用するトークンを取得または設定します。

public string SessionToken { get; set; }

member this.SessionToken : string with get, set

Public Property SessionToken As String

プロパティ値

String

セッション整合性で使用するトークン。

注釈

ConsistencyLevel Azure Cosmos DB の 1 つはセッションです。 実際、これはアカウントに適用される既定のレベルです。

セッションの整合性を使用すると、Azure Cosmos DB に対する新しい書き込み要求ごとに、新しい SessionToken が割り当てられます。 DocumentClient は、このトークンを読み取り/クエリ要求ごとに内部的に使用して、セットの整合性レベルが維持されるようにします。

シナリオによっては、このセッションを自分で管理する必要があります。複数のノードを持つ Web アプリケーションを考えてみましょう。各ノードにはクライアントの独自のインスタンスがあります。これらのノードを同じセッションに参加させたい場合 (Web 層間で一貫して独自の書き込みを読み取ることができるようにする場合)、1 つのノードの書き込みアクションの応答からクライアント層に SessionToken を送信する必要があります。 クッキーまたはその他のメカニズムを使用し、そのトークンが後続の読み取りのために Web 層に戻されるようにします。 Azure Load Balancer のように、要求間でセッション アフィニティを保持しないラウンドロビン ロード バランサーを使っている場合、読み取りが、セッションが作成された書き込み要求に対するものとは異なるノードに到達する可能性があります。

前に説明したように Azure Cosmos DB SessionToken をフローさせないと、一定の期間、一貫性のない読み取り結果が発生する可能性があります。