Orleans Grain Persistence ETag Guidance
Los mantenedores suelen responder en 1 día
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 1/5
- Tiempo estimado
- 1-3 horas
- Aptitud para principiantes
- 45/100
- Tipo de issue
- Documentación
- Claridad
- Bien especificado
- Estado de actividad
- Estancado
- Área
- documentation
Línea de trabajo
Comienza en docs/orleans/grains/grain-persistence/index.md y lee la sección alrededor de “Write state.” Añade la sección solicitada “ETag and Optimistic Concurrency” con la advertencia y la tabla de comportamientos, conservando la sección requerida Document Details. La tarea estará terminada cuando la página explique claramente el comportamiento de ETag y la guía solicitada aparezca después de “Write state.”
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Describe the issue or suggestion
Page: Grain persistence
Add a new section titled "ETag and Optimistic Concurrency" after the "Write state" section, with a warning and do's/don'ts table:
Understanding ETag behavior is essential when working with grain persistence, especially in reentrant grains or when state may be modified externally. Mishandling ETags can lead to data loss or InconsistentStateException errors. Some providers leave this as null if they don't use Etags. This is why thorough testing of providers is required.
The ETag property provides optimistic concurrency control. When you call WriteStateAsync() or ClearStateAsync(), the storage provider compares the grain's current ETag with the value in storage. If they don't match (indicating another write occurred), the operation fails with an InconsistentStateException.
Behaviors:
ReadStateAsync(): Updates both State and ETag from storage
WriteStateAsync(): Fails if ETag doesn't match storage; updates ETag on success
ClearStateAsync(): Fails if ETag doesn't match storage; resets ETag to null on success
Setting ETag = null before write/clear operations bypasses version checking
Document Details
⚠ Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.
- ID: 4a124b90-917f-0167-176b-f123193300d2
- Version Independent ID: 8b9bcb0f-4a4a-8beb-eef3-9992f63c2f23
- Platform ID: af443b67-9a4f-e58c-e82f-055d30008b23
- Content: Grain persistence - .NET
- Content Source: docs/orleans/grains/grain-persistence/index.md
- Service: dotnet-orleans
- GitHub Login: @meaghanlewis
- Microsoft Alias: mosagie
- Lenguaje dominante
- Sin datos de lenguaje
- Estrellas
- 4.8k
- Forks
- 6.1k
- Merge medio
- 22 h 46 min
- PR fusionados (30 d)
- 296
Preparar el entorno
Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.
- Sin Dockerfile ni archivo de Docker Compose
- Tiene una plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de dotnet/docs
-
ExamenAbiertodotnet-csharp/svc lang-reference/subsvc needs-more-info
Dificultad 2/5 1-3 horas Aptitud para principiantes 66/100
dotnet/docs#56845 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
Update the .NET Framework 3.5 on Windows 11 FAQ to mention Windows 11 26H2Posiblemente ocupada @BillWagner la tomó hace 3 días. Abierto:pushpin: seQUESTered dotnet/svc
Dificultad 1/5 Menos de una hora Aptitud para principiantes 78/100
dotnet/docs#56791 · 1 reacción · 2 asignados ·
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 86/100
Los mantenedores suelen responder en 1 día
-
Improve description of `limitations of extensions`Posiblemente ocupada @Manish-1kumar la tomó hace 11 días. Abiertoadvanced-concepts/subsvc dotnet-csharp/svc
Dificultad 1/5 1-3 horas Aptitud para principiantes 84/100
dotnet/docs#56626 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
Document unit-test / theory-data impact of .NET 11 double→decimal conversionPosiblemente ocupada @SkyDevLab la tomó hace 22 días. Abierto:watch: Not Triaged dotnet-fundamentals/svc
Dificultad 1/5 1-3 horas Aptitud para principiantes 88/100
Los mantenedores suelen responder en 1 día
Todos los issues de dotnet/docs
Issues similares
-
README says the land/sea mask must match the XS grid; the demo mask does not, and Step 4 worksAbiertodocumentation
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
buckai-observatory/Automated-Cloud-Removal-and-Seamless-Satellite-Image-Mosaicking-Pipeline#52 ·
Los mantenedores suelen responder en 1 día
-
documentation
Dificultad 1/5 1-3 horas Aptitud para principiantes 84/100
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 1-3 horas Aptitud para principiantes 82/100
run-llama/llama_index#24163 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 82/100
btclib-org/btclib#3090 ·
Los mantenedores suelen responder en 1 día
-
Translate the READMEAbiertodocumentation good first issue
Dificultad 2/5 1-3 horas Aptitud para principiantes 84/100
asasemahmed/openboard#68 ·
Los mantenedores suelen responder en 1 día