ItemRequestOptions.SessionToken Propiedad

Definición

Espacio de nombres:

Microsoft.Azure.Cosmos

Ensamblado:

Microsoft.Azure.Cosmos.Client.dll

Paquete:

Microsoft.Azure.Cosmos v3.39.0

Source:

ItemRequestOptions.cs

Obtiene o establece el token para su uso con la coherencia de sesión en el servicio Azure Cosmos DB.

public string SessionToken { get; set; }

member this.SessionToken : string with get, set

Public Property SessionToken As String

Valor de propiedad

String

Token para su uso con coherencia de sesión.

Comentarios

Una de las para ConsistencyLevel Azure Cosmos DB es Session. De hecho, este es el nivel predeterminado que se aplica a las cuentas.

Al trabajar con coherencia de sesión, a cada nueva solicitud de escritura en Azure Cosmos DB se le asigna un nuevo SessionToken. DocumentClient usará este token internamente con cada solicitud de lectura y consulta para asegurarse de que se mantiene el nivel de coherencia establecido.

En algunos escenarios, debe administrar esta sesión usted mismo; Considere la posibilidad de usar una aplicación web con varios nodos, cada nodo tendrá su propia instancia de Microsoft.Azure.Cosmos.DocumentClient Si desea que estos nodos participen en la misma sesión (para poder leer sus propias escrituras de forma coherente en todos los niveles web), tendrá que enviar sessionToken desde ItemResponse<T> la acción de escritura en un nodo al nivel de cliente, usar una cookie o algún otro mecanismo y hacer que el token vuelva al nivel web para las lecturas posteriores. Si usa un equilibrador de carga round robin que no mantiene la afinidad de sesión entre las solicitudes, como Azure Load Balancer, la lectura podría llegar a un nodo diferente a la solicitud de escritura, donde se creó la sesión.

Si SessionToken de Azure Cosmos DB no fluye tal y como se describió anteriormente, podría acabar con resultados de lectura incoherentes durante un período de tiempo.