{"id":17073,"date":"2025-04-24T11:51:03","date_gmt":"2025-04-24T18:51:03","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=17073"},"modified":"2025-04-24T11:51:03","modified_gmt":"2025-04-24T18:51:03","slug":"ef-core-provider-for-couchbase-general-availability","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/es\/ef-core-provider-for-couchbase-general-availability\/","title":{"rendered":"Anuncio de la disponibilidad general de Couchbase EF Core Provider"},"content":{"rendered":"

En <\/span>Proveedor del n\u00facleo de Couchbase EF<\/b> es ahora <\/span>generalmente disponible<\/b><\/a>. Esta versi\u00f3n lleva la potencia de Entity Framework Core a Couchbase, permitiendo a los desarrolladores .NET trabajar con Couchbase utilizando los patrones familiares de EF Core.<\/span><\/p>\n

\u00bfQu\u00e9 es el proveedor Couchbase EF Core?<\/h2>\n

Entity Framework Core (EF Core) es un popular O\/RM que simplifica el acceso a bases de datos para aplicaciones .NET. Permite a los desarrolladores trabajar con datos utilizando objetos C# y consultas LINQ en lugar de escribir consultas de base de datos sin procesar. EF Core permite la integraci\u00f3n con varias bases de datos, proporcionando seguimiento autom\u00e1tico de cambios, transacciones y una API DbContext familiar. Se trata de una interfaz familiar que los desarrolladores pueden utilizar para ahorrar tiempo e integrarse con muchos marcos de trabajo y bibliotecas adyacentes a bases de datos.<\/span><\/p>\n

En <\/span>Proveedor del n\u00facleo de Couchbase EF<\/b> permite a los desarrolladores utilizar Entity Framework Core con <\/span>Servidor Couchbase<\/b> y <\/span>Couchbase Capell<\/b>a<\/b><\/a> (ahora disponible con un nivel gratuito perpetuo). Con este proveedor, puedes trabajar con documentos de Couchbase como si fueran entidades relacionales, usando consultas Linq, DbContext y seguimiento de cambios.<\/span><\/p>\n

Para empezar<\/h2>\n

Para instalar Couchbase EF Core Provider, a\u00f1ada el archivo <\/span>Paquete NuGet<\/span><\/a>:<\/span><\/p>\n

# .NET CLI\r\ndotnet add package Couchbase.EntityFrameworkCore\r\n\r\n# O usando Package Manager\r\nInstalar-Paquete Couchbase.EntityFrameworkCore<\/pre>\n
Ejemplo: uso de EF Core con Couchbase<\/h3>\n
A continuaci\u00f3n se muestra un ejemplo sencillo de \"carrito de la compra\" sobre c\u00f3mo configurar y utilizar la funci\u00f3n <\/span>Proveedor del n\u00facleo de Couchbase EF<\/b> con un modelo de carrito de la compra.<\/span><\/p>\n
Defina sus modelos de entidad<\/h4>\n
using Couchbase;\r\nusando Couchbase.EntityFrameworkCore;\r\nusando Couchbase.EntityFrameworkCore.Extensions;\r\nusando Microsoft.EntityFrameworkCore;\r\nusing Microsoft.Extensions.Logging;\r\nusing NLog.Extensions.Logging;\r\nusing ILoggerFactory = Microsoft.Extensions.Logging.ILoggerFactory;\r\n\r\nclase p\u00fablica Cart\r\n{\r\n    public string CartId { get; set; }\r\n    public DateTimeOffset Creado { get; set; }\r\n    public List Items { get; set; }\r\n}\r\n\r\npublic class Art\u00edculo\r\n{\r\n    public string ItemId { get; set; }\r\n    public string Nombre { get; set; }\r\n    public uint Cantidad { get; set; }\r\n    public decimal Precio { get; set; }\r\n}<\/pre>\n
Crear un DbContext para Couchbase<\/h4>\n
public clase CartContext : DbContext\r\n{\r\n    public DbSet Carros { get; set; }\r\n    public DbSet Items { get; set; }\r\n    private static readonly ILoggerFactory LoggerFactory = Microsoft.Extensions.Logging.LoggerFactory.Create(builder =>\r\n    {\r\n        builder.ClearProviders();\r\n        builder.AddNLog();\r\n    });\r\n    protected override void OnConfiguring(DbContextOptionsBuilder options)\r\n    {\r\n        options.UseCouchbase(new ClusterOptions()\r\n                WithCredentials(\"Administrador\", \"contrase\u00f1a\")\r\n                .WithConnectionString(\"couchbase:\/\/localhost\")\r\n                .WithLogging(LoggerFactory),\r\n            couchbaseDbContextOptions =>\r\n            {\r\n                couchbaseDbContextOptions.Bucket = \"Compras\";\r\n                couchbaseDbContextOptions.Scope = \"Comercio electr\u00f3nico\";\r\n            });\r\n    }\r\n\r\n    protected override void OnModelCreating(ModelBuilder modelBuilder)\r\n    {\r\n        modelBuilder.Entity().ToCouchbaseCollection(this, \"Carts\");\r\n        modelBuilder.Entity().ToCouchbaseCollection(this, \"Items\");\r\n    }\r\n}<\/pre>\n
Este arreglo asume que usted ha creado un bucket en Couchbase llamado Compras<\/em>que contiene un \u00e1mbito llamado Comercio electr\u00f3nico<\/em>que contiene colecciones Art\u00edculos<\/em> y Carros<\/em>.<\/span><\/p>\n
Adem\u00e1s, tenga en cuenta que el registro es opcional, pero es una buena idea activarlo para ayudar a identificar cualquier problema que pueda surgir.<\/span><\/p>\n
Insertar y consultar datos<\/h4>\n
await using var db = new CartContext();\r\nvar cart = nuevo Cart\r\n{\r\n    CartId = Guid.NewGuid().ToString(),\r\n    Creado = DateTimeOffset.Now,\r\n    Art\u00edculos = new List\r\n    {\r\n        new Art\u00edculo { ItemId = Guid.NewGuid().ToString(), Nombre = \"Widget\", Precio = 0.99M, Cantidad = 1},\r\n        new Art\u00edculo { ItemId = Guid.NewGuid().ToString(), Nombre = \"Foo\", Precio = 4.99M, Cantidad = 3},\r\n        new Art\u00edculo { ItemId = Guid.NewGuid().ToString(), Nombre = \"Baz\", Precio = 99.19M, Cantidad = 1}\r\n    }\r\n};\r\nawait db.AddAsync(carrito);\r\nawait db.SaveChangesAsync();\r\n\r\nvar items = await db.Items.Where(i => i.Name == \"Foo\").ToListAsync();\r\nforeach (var i in items)\r\n{\r\n    Console.WriteLine(JsonConvert.SerializeObject(i));\r\n}<\/pre>\n
Este es un ejemplo del aspecto que tendr\u00e1n los documentos en Couchbase tras la inserci\u00f3n:<\/span><\/p>\n
Key: 080c210a-34eb-45ea-b9b4-e5c6f8afa4d6\r\n{\r\n  \"CartId\": \"080c210a-34eb-45ea-b9b4-e5c6f8afa4d6\",\r\n  \"Creado\": \"2025-03-13T17:16:31.9904224-04:00\"\r\n}\r\nKey acf54397-51c4-4ad7-bf34-d0a42061b662\r\n{\r\n  \"ItemId\": \"acf54397-51c4-4ad7-bf34-d0a42061b662\",\r\n  \"CartId\": \"080c210a-34eb-45ea-b9b4-e5c6f8afa4d6\",\r\n  \"Nombre\": \"Foo\",\r\n  \"Precio\": 4.99,\r\n  \"Cantidad\": 3\r\n}\r\nKey a3f25210-97f2-4c95-ad4b-f241dde0d9c3\r\n{\r\n  \"ItemId\": \"a3f25210-97f2-4c95-ad4b-f241dde0d9c3\",\r\n  \"CartId\": \"080c210a-34eb-45ea-b9b4-e5c6f8afa4d6\",\r\n  \"Name\": \"Widget\",\r\n  \"Precio\": 0.99,\r\n  \"Cantidad\": 1\r\n}\r\n\/\/ ... etc ...<\/pre>\n
\u00bfQu\u00e9 funciona en la versi\u00f3n GA?<\/h2>\n
Toda la funcionalidad de EF Core es muy, muy grande. Ser capaz de manejar cada posible sentencia Linq, por ejemplo, es casi imposible, incluso para proveedores maduros de EF Core como SQL Server. Sin embargo, esta versi\u00f3n soporta muchas de las capacidades b\u00e1sicas de EF Core, incluyendo:<\/span><\/p>\n
\u2705 <\/span>Compatibilidad con LINQ<\/b> - Traduce las consultas LINQ a <\/span>Couchbase SQL<\/b>.
\n<\/span>\u2705 <\/span>Operaciones CRUD b\u00e1sicas<\/b> - Las operaciones de inserci\u00f3n, actualizaci\u00f3n y supresi\u00f3n funcionan como es debido.
\n<\/span>\u2705 <\/span>Seguimiento de cambios<\/b> - Se realiza un seguimiento de las entidades para una actualizaci\u00f3n eficaz.<\/span><\/p>\n
Tambi\u00e9n tenga en cuenta que el uso de m\u00e9todos Async es <\/span>obligatorio<\/b>. El SDK .NET de Couchbase es completamente as\u00edncrono. Si intentas usar un m\u00e9todo no as\u00edncrono, obtendr\u00e1s un error de ejecuci\u00f3n del tipo Couchbase EF Core Database Provider no soporta E\/S s\u00edncrona<\/code>.<\/span><\/p>\n
Limitaciones conocidas<\/h2>\n
Aunque se trata de un hito importante, <\/span>algunas funciones a\u00fan est\u00e1n en fase de desarrollo<\/b>incluyendo:<\/span><\/p>\n
\u274c <\/span>Desnormalizaci\u00f3n<\/b> - Anidamiento de colecciones dentro de documentos (por ejemplo, almacenar <\/span>Art\u00edculos<\/span> en <\/span>Carrito <\/span>como un \u00fanico documento JSON) a\u00fan no es compatible.
\n<\/span>\u274c <\/span>Carga ansiosa<\/b> - <\/span>Incluir()<\/code><\/span> pueden no funcionar como se espera.
\n<\/span>\u274c <\/span>Soporte de funciones SQL<\/b> - Algunas funciones SQL++ como <\/span>META<\/span>, <\/span>RYOW<\/span>etc., no se aplican plenamente.
\n<\/span>\u274c <\/span>Transacciones <\/b>- Esta versi\u00f3n a\u00fan no es compatible.<\/span><\/p>\n
\u00a1\u00danete a la conversaci\u00f3n!<\/h2>\n
Queremos tu opini\u00f3n Ayude a dar forma al futuro de la <\/span>Proveedor del n\u00facleo de Couchbase EF<\/b>:<\/span><\/p>\n