Hoy lanzamos la versión 2.3.9 del SDK .NET de Couchbase. En esta versión tenemos una mezcla de nuevas características y correcciones de errores; incluyendo API de estructura de datos, autenticación a nivel de clúster y soporte de consultas a nivel de clúster. También, 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ñadimos funciones de bajo riesgo en versiones de mantenimiento con estabilidad de interfaz no comprometida para que usted, como desarrollador, pueda acceder fácilmente a las nuevas funciones. Las funciones mencionadas aquí no están comprometidas, pero deberían serlo en la próxima versión dot-minor. Consulte aquí para obtener información sobre la interfaz en el SDK de .NET.
API de estructura de datos
Muchos desarrolladores utilizan estructuras de datos comunes como conjuntos y listas en sus aplicaciones y necesitan almacenarlas y recuperarlas regularmente. Hemos añadido estructuras JSON respaldadas por Couchbase para facilitar este proceso en el que los cambios de estado se persisten automáticamente en el servidor.
Los tipos de datos para los que hemos añadido soporte son.
- Establecer
- Lista
- Diccionario
- Cola
Próximamente se ofrecerá una introducción más completa de la nueva API de estructura de datos en otro blog.
Autenticación a nivel de clúster
Hasta ahora, la autenticación se gestionaba en el SDK a nivel de cubo. Esto significaba que la contraseña del bucket era suministrada cuando se ejecutaba el método GetBucket contra el bucket. Con la introducción de Cluster Level Queries y formas más avanzadas de seguridad en futuras versiones de Couchbase Server, se necesita un mecanismo mejorado.
La autenticación a nivel de clúster permite configurar la autenticación para cada cubo directamente en el objeto de clúster, donde se almacena en caché y se reutiliza de forma eficiente. A continuación se muestra un ejemplo de configuración de las credenciales al crear el objeto de clúster.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
var credenciales = nuevo ClusterCredentials { ClusterUsername = "Administrador", ClusterPassword = "secreto", BucketCredentials = nuevo Diccionario<cadena, cadena> { { "asegurado", "contraseña" } // bucketName, bucketPassword } }; var grupo = nuevo Grupo(); grupo.Autentificar(credenciales); var cubo = grupo.OpenBucket("asegurado"); // observa que no se ha pasado ninguna contraseña, ya que se utiliza desde las credenciales |
Recuerde que el Cluster debe ser un objeto de larga duración, normalmente configurado cuando su aplicación se inicia por primera vez y ClusterHelper es una buena forma de gestionar el tiempo de vida de tu objeto cluster.
Consulta a nivel de clúster
Cuando se envía una consulta N1QL, depende de los nodos de consulta del cluster interpretar la sentencia y ejecutar la consulta. No es necesario que se ejecute en el contexto de un bucket concreto, ya que la sentencia de consulta incluye el nombre del bucket. Para facilitar esta tarea, hemos copiado las API Query y QueryAsync en la interfaz ICluster, de modo que ahora es posible ejecutar consultas N1QL directamente con el objeto Cluster. A continuación se muestra un ejemplo de uso de la nueva API de consulta a nivel de clúster:
|
1 2 3 4 5 6 7 |
var config = nuevo ClientConfiguration { Servidores = nuevo Lista<Uri> {nuevo Uri("http://127.0.0.1")} }; var grupo = nuevo Grupo(config); var resultado = grupo.Consulta<Persona>("SELECT * FROM `default` WHERE type = 'person';"); |
Actualización del FTS
Hemos estado trabajando en mejorar el soporte para el próximo FTS (Full Text Search) y consolidar las implementaciones a través de los diferentes SDKs. Se han corregido una serie de errores para asegurar que el SDK tiene soporte completo para cuando la característica se GA en Couchbase Server 4.6.
Notas de publicación
- [NCBC-958] - Proporcionar comprobaciones sanas para los tamaños máximo y mínimo de la piscina.
- [NCBC-1209] - Garantizar que el CAS se transfiere a las operaciones de subdocumentación
- [NCBC-1211] - Error Bootstrapping Using .Net Core on Linux Due To Socket Keep Alives
- [NCBC-1213] - No se puede enviar la consulta FTS compuesta
- [NCBC-1214] - BooleanQuery sólo debería requerir una subconsulta, no una de cada tipo
- [NCBC-1216] - PhraseQuery y DocId Query lanzan una excepción durante la Exportación
- [NCBC-1225] - PoolConfigurationTests no coincide con los valores mínimo y máximo
- [NCBC-1128] - Refactorizar FTS ISearchQueryResult para que tenga paridad con Java SDK
- [NCBC-1141] - Cuando Id no está presente en doc fail-fast
- [NCBC-1210] - Actualización de proyectos NetStandard a Common.Logging Core y Portable 3.4-Alpha2
- [NCBC-1218] - Corregir pruebas rotas que afectan a CI
- [NCBC-1219] - Mejorar o corregir las pruebas unitarias
- [NCBC-1220] - Actualizar SearchClient para usar CouchbaseHttpClient
- [NCBC-1222] - Pruebas unitarias Fixup
- [NCBC-854] - Uniones cruzadas N1QL
- [NCBC-1060] - Incluir soporte de infraestructura de datos
- [NCBC-1062] - Añadir interfaz de autenticador a nivel de clúster
- [NCBC-1223] - Añadir constantes MediaType para ser utilizados en lugar de cadenas en línea
- [NCBC-1194] - Bucket.Exists() devuelve False para un documento que SÍ existe cuando se utilizan caracteres suecos (al menos) en el ID del documento
- [NCBC-1215] - Añadir archivo nuspec para generar objetivos Net45 y NetStandard1.5
- [NCBC-1217] - Establecer AllowUnsafe a false en el proyecto Couchbase.NetStandard
- [NCBC-1221] - Hacer que OpenBucket lance una excepción de autenticación cuando no se proporciona la credencial
- [NCBC-1224] - Añadir métodos de estructura de datos de nivel IBucket
Cómo conseguirlo
Como siempre, el SDK .NET de Couchbase está disponible en/por:
