Primeras operaciones
Este artículo cubre las tres operaciones clave-valor que más usas con Clustron Zaris: almacenar un valor, volver a leerlo y eliminarlo. Juntas siguen un patrón simple de put, get, delete.
La misma API funciona tanto en el modo en proceso como en el distribuido, por lo que el código de aquí se ejecuta sin cambios sea cual sea el modo que use tu almacén.
Requisitos previos
Necesitas un almacén en ejecución y un cliente conectado. Si aún no tienes uno, obtén un cliente en Ejecutar en proceso o Crea tu primer almacén. Los ejemplos de abajo asumen una variable client de esos pasos.
Hacer put de un valor
Almacena un valor para una clave con PutAsync. Si la clave ya existe, su valor se sobrescribe.
await client.PutAsync("hello", "world");
Hacer get de un valor
Lee un valor con GetAsync, pasando el tipo que esperas. La llamada devuelve un resultado cuya propiedad IsSuccess te dice si la clave fue encontrada, y cuya propiedad Value contiene el valor cuando lo fue.
var result = await client.GetAsync<string>("hello");
if (result.IsSuccess)
{
Console.WriteLine(result.Value);
}
else
{
Console.WriteLine("Key not found");
}
Eliminar un valor
Elimina una clave y su valor con DeleteAsync.
await client.DeleteAsync("hello");
Manejar resultados
La mayoría de las operaciones devuelven un KvResult. Comprueba su propiedad IsSuccess para confirmar que la operación funcionó, y lee Error cuando no lo hizo. Esto te permite manejar los fallos en lugar de asumir que cada llamada tiene éxito.
var result = await client.PutAsync("key", "value");
if (!result.IsSuccess)
{
Console.WriteLine(result.Error);
}
Cosas que debes saber
Unas pocas reglas se aplican a cada operación:
- Las claves son strings.
- Los valores se serializan automáticamente.
- Todas las operaciones son asíncronas, así que haz await sobre ellas.
- La misma API funciona tanto en el modo en proceso como en el distribuido.
Próximos pasos
Para ejemplos completos y funcionales, consulta el repositorio de samples de Zaris: