Hoy lanzamos la versión 2.3.10 del SDK .NET de Couchbase. Se trata de una versión de mantenimiento con correcciones de errores y mejoras que incluyen la API de Estructuras de Datos y la API FTS. En caso de que te lo hayas perdido, tenemos una Developer Preview de soporte .NET Core aquí.
Novedades y cambios
Seguimos el versionado semántico, lo que significa que incrementamos el número de punto menor cuando añadimos características. A veces añadimos funciones de bajo riesgo en versiones de mantenimiento con estabilidad de interfaz no comprometida para que los desarrolladores puedan acceder fácilmente a las nuevas funciones. Las funcionalidades añadidas en una versión de mantenimiento no están comprometidas y están abiertas a cambios, pero deberían convertirse en comprometidas en la siguiente versión dot-minor.
Véase aquí para obtener información sobre la interfaz en el SDK de .NET.
Actualización de la API de estructuras de datos
Cuando introdujimos la API de Estructuras de Datos en la versión 2.3.9 añadimos soporte para listas, mapas y diccionarios. En esta versión también añadimos soporte para Colas. Esto te permite usar un documento JSON almacenado en Couchbase para mantener una cola FIFO ordenada, con todo el control de concurrencia normal que esperarías de una cola en memoria. Un ejemplo de como usar una cola esta debajo:
|
1 2 3 4 5 6 |
cubo.QueuePush("mi_cola", nuevo Persona("Jerry")); cubo.QueuePush("mi_cola", nuevo Persona("Rodney")); var talla = cubo.TamañoCola("mi_cola"); // 2 var persona = cubo.QueuePop("mi_cola"); // Jerry |
Además, como parte del refinamiento de la API de Estructuras de Datos no comprometidas, hemos actualizado algunos nombres de métodos para que sean consistentes en todos los SDKs de Couchbase. Los cambios son los siguientes:
| Antiguo | Nuevo |
|---|---|
| ListPush | ListAppend |
| ListShift | ListPrepend |
| ListDelete | ListRemove |
| SetExists | EstablecerContiene |
Clasificación de los resultados del FTS
Una mejora de las capacidades FTS (Full-Text Search) de Couchbase Server 4.6 es permitir al usuario aplicar sus propias preferencias de ordenación en el servidor antes de devolver el resultado. Para ello se utiliza la función Ordenar en ISearchParams antes de enviar una búsqueda. Puede haber uno o varios campos de ordenación, y los campos precedidos de un guión indican un orden descendente.
|
1 2 3 |
var searchParams = nuevo Parámetros de búsqueda(); searchParams.Ordenar("nombre", "-edad"); |
Los criterios de ordenación del ejemplo anterior indican que se ordene por nombre en orden ascendente y luego por edad en orden descendente.
A la espera de los índices N1QL
El SDK le permite, como desarrollador, crear índices N1QL mediante programación. Sin embargo, los índices se crean de forma asíncrona en el servidor y ejecutar consultas contra índices incompletos es una mala idea. Como parte de esta versión hemos introducido una forma para que el SDK observe y espere a que uno o más índices pasen al estado 'online' antes de continuar. A continuación se muestra un ejemplo de cómo crear un índice y esperar a que esté en línea:
|
1 2 3 4 5 6 7 |
// Crear índice llamado "cuentas" en las columnas "account_id" y "account_name" bucketManager.CrearN1qlIndex("cuentas", falso, "account_id", "nombre_cuenta"); // Esperar a que el índice se marque como 'online', con un tiempo de espera de 30 segundos var nombresdeíndice = nuevo Lista { "cuentas" }; bucketManager.WatchN1qlIndexes(nombresdeíndice, TimeSpan.DesdeSegundos(30)); |
Notas de publicación
- [NCBC-1104] - Cuando el certificado SSL no está configurado correctamente se lanza una System.ArgumentException.
- [NCBC-1232] - El cliente NET no puede volver a prepararse automáticamente cuando se elimina un índice
- [NCBC-1233] - 2.3.9 el ensamblado no tiene un nombre fuerte y no tiene un publicKeyToken
- [NCBC-1236] - DotMemory referencia no resuelta de IntegrationTests
- [NCBC-1079] - streaming JSON parser para N1QL
- [NCBC-1204] - debe utilizar la interfaz para la propiedad Buckets
- [NCBC-1237] - parámetro "sort" personalizado para FTS
- [NCBC-1227] - QueuePush, QueuePop y QueueSize a IBucket
- [NCBC-1036] - Crear un artículo sobre cómo aprovisionar un clúster mediante programación con un ejemplo de código
- [NCBC-1101] - WatchIndexes para la gestión de índices
Cómo conseguirlo
Como siempre, el SDK .NET de Couchbase está disponible en/por:
