{"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\/pt\/ef-core-provider-for-couchbase-general-availability\/","title":{"rendered":"Anunciando a disponibilidade geral do provedor principal do Couchbase EF"},"content":{"rendered":"

O <\/span>Provedor principal do Couchbase EF<\/b> agora \u00e9 <\/span>geralmente dispon\u00edvel<\/b><\/a>. Esta vers\u00e3o traz o poder do Entity Framework Core para o Couchbase, permitindo que os desenvolvedores de .NET trabalhem com o Couchbase usando padr\u00f5es familiares do EF Core.<\/span><\/p>\n

O que \u00e9 o provedor Couchbase EF Core?<\/h2>\n

O Entity Framework Core (EF Core) \u00e9 um popular O\/RM que simplifica o acesso ao banco de dados para aplicativos .NET. Ele permite que os desenvolvedores trabalhem com dados usando objetos C# e consultas LINQ em vez de escrever consultas brutas ao banco de dados. O EF Core permite a integra\u00e7\u00e3o com v\u00e1rios bancos de dados, fornecendo rastreamento autom\u00e1tico de altera\u00e7\u00f5es, transa\u00e7\u00f5es e uma API DbContext familiar. \u00c9 uma interface familiar que os desenvolvedores podem usar para economizar tempo e se integrar a muitas estruturas e bibliotecas adjacentes a bancos de dados.<\/span><\/p>\n

O <\/span>Provedor principal do Couchbase EF<\/b> permite que os desenvolvedores usem o Entity Framework Core com <\/span>Servidor Couchbase<\/b> e <\/span>Couchbase Capell<\/b>a<\/b><\/a> (agora dispon\u00edvel com um n\u00edvel gratuito perp\u00e9tuo). Com esse provedor, voc\u00ea pode trabalhar com documentos do Couchbase como se fossem entidades relacionais, usando consultas Linq, DbContext e controle de altera\u00e7\u00f5es.<\/span><\/p>\n

Primeiros passos<\/h2>\n

Para instalar o provedor do Couchbase EF Core, adicione o arquivo <\/span>Pacote NuGet<\/span><\/a>:<\/span><\/p>\n

# .NET CLI\r\ndotnet add package Couchbase.EntityFrameworkCore\r\n\r\n# Ou usando o Package Manager\r\nInstalar o pacote Couchbase.EntityFrameworkCore<\/pre>\n
Exemplo: usando o EF Core com o Couchbase<\/h3>\n
Aqui est\u00e1 um exemplo simples de \"carrinho de compras\" de como configurar e usar o <\/span>Provedor principal do Couchbase EF<\/b> com um modelo de carrinho de compras.<\/span><\/p>\n
Definir seus modelos de entidade<\/h4>\n
usando Couchbase;\r\nusing Couchbase.EntityFrameworkCore;\r\nusing Couchbase.EntityFrameworkCore.Extensions; using Couchbase.EntityFrameworkCore;\r\nusing Microsoft.EntityFrameworkCore; using Microsoft.EntityFrameworkCore;\r\nusing Microsoft.Extensions.Logging;\r\nusing NLog.Extensions.Logging;\r\nusing ILoggerFactory = Microsoft.Extensions.Logging.ILoggerFactory;\r\n\r\npublic class Cart\r\n{\r\n    public string CartId { get; set; }\r\n    public DateTimeOffset Created { get; set; }\r\n    public List Items { get; set; }\r\n}\r\n\r\npublic class Item\r\n{\r\n    public string ItemId { get; set; }\r\n    public string Name { get; set; }\r\n    public uint Quantity { get; set; }\r\n    public decimal Price { get; set; }\r\n}<\/pre>\n
Criar um DbContext para o Couchbase<\/h4>\n
classe p\u00fablica CartContext : DbContext\r\n{\r\n    public DbSet Carts { 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(\"Administrator\", \"password\")\r\n                .WithConnectionString(\"couchbase:\/\/localhost\")\r\n                .WithLogging(LoggerFactory),\r\n            couchbaseDbContextOptions =>\r\n            {\r\n                couchbaseDbContextOptions.Bucket = \"Shopping\";\r\n                couchbaseDbContextOptions.Scope = \"Ecommerce\";\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
Esse arranjo pressup\u00f5e que voc\u00ea tenha criado um bucket no Couchbase chamado Compras<\/em>que cont\u00e9m um escopo chamado Com\u00e9rcio eletr\u00f4nico<\/em>que cont\u00e9m cole\u00e7\u00f5es Itens<\/em> e Carrinhos<\/em>.<\/span><\/p>\n
Observe tamb\u00e9m que o registro em log \u00e9 opcional, mas \u00e9 uma boa ideia ativ\u00e1-lo para ajudar a identificar quaisquer problemas que possam surgir.<\/span><\/p>\n
Inserir e consultar dados<\/h4>\n
aguardar usando var db = new CartContext();\r\nvar cart = new Cart\r\n{\r\n    CartId = Guid.NewGuid().ToString(),\r\n    Created = DateTimeOffset.Now,\r\n    Items = new List\r\n    {\r\n        new Item { ItemId = Guid.NewGuid().ToString(), Name = \"Widget\", Price = 0.99M, Quantity = 1},\r\n        new Item { ItemId = Guid.NewGuid().ToString(), Name = \"Foo\", Price = 4.99M, Quantity = 3},\r\n        novo Item { ItemId = Guid.NewGuid().ToString(), Name = \"Baz\", Price = 99.19M, Quantity = 1}\r\n    }\r\n};\r\naguarde db.AddAsync(carrinho);\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
Veja um exemplo de como os documentos no Couchbase ficar\u00e3o ap\u00f3s a inser\u00e7\u00e3o:<\/span><\/p>\n
Key: 080c210a-34eb-45ea-b9b4-e5c6f8afa4d6\r\n{\r\n  \"CartId\": \"080c210a-34eb-45ea-b9b4-e5c6f8afa4d6\",\r\n  \"Created\": \"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  \"Name\" (Nome): \"Foo\",\r\n  \"Price\": 4.99,\r\n  \"Quantity\" (Quantidade): 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\" (Nome): \"Widget\",\r\n  \"Price\": 0.99,\r\n  \"Quantity\" (Quantidade): 1\r\n}\r\n\/\/ ... etc ...<\/pre>\n
O que funciona na vers\u00e3o GA?<\/h2>\n
Toda a funcionalidade do EF Core \u00e9 muito, muito grande. Ser capaz de lidar com todas as instru\u00e7\u00f5es Linq poss\u00edveis, por exemplo, \u00e9 quase imposs\u00edvel, mesmo para provedores maduros do EF Core, como o SQL Server. Entretanto, essa vers\u00e3o oferece suporte a muitos recursos essenciais do EF Core, incluindo:<\/span><\/p>\n
\u2705 <\/span>Suporte a LINQ<\/b> - Traduz as consultas LINQ para <\/span>Couchbase SQL++<\/b>.
\n<\/span>\u2705 <\/span>Opera\u00e7\u00f5es b\u00e1sicas de CRUD<\/b> - Inserir, atualizar e excluir funcionam como esperado.
\n<\/span>\u2705 <\/span>Controle de altera\u00e7\u00f5es<\/b> - As entidades s\u00e3o rastreadas para atualiza\u00e7\u00f5es eficientes.<\/span><\/p>\n
Observe tamb\u00e9m que o uso de m\u00e9todos Async \u00e9 <\/span>necess\u00e1rio<\/b>. O SDK .NET do Couchbase \u00e9 totalmente ass\u00edncrono. Se voc\u00ea tentar usar um m\u00e9todo n\u00e3o ass\u00edncrono, receber\u00e1 um erro de tempo de execu\u00e7\u00e3o do tipo O provedor de banco de dados principal do Couchbase EF n\u00e3o oferece suporte a E\/S s\u00edncrona<\/code>.<\/span><\/p>\n
Limita\u00e7\u00f5es conhecidas<\/h2>\n
Embora esse seja um marco significativo, <\/span>Alguns recursos ainda est\u00e3o em andamento<\/b>incluindo:<\/span><\/p>\n
\u274c <\/span>Desnormaliza\u00e7\u00e3o<\/b> - Aninhamento de cole\u00e7\u00f5es dentro de documentos (por exemplo, armazenamento de <\/span>Itens<\/span> dentro <\/span>Carrinho <\/span>como um \u00fanico documento JSON) ainda n\u00e3o \u00e9 compat\u00edvel.
\n<\/span>\u274c <\/span>Carregamento ansioso<\/b> - <\/span>.Include()<\/code><\/span> podem n\u00e3o funcionar como esperado.
\n<\/span>\u274c <\/span>Suporte \u00e0 fun\u00e7\u00e3o SQL++<\/b> - Algumas fun\u00e7\u00f5es do SQL++, como <\/span>META<\/span>, <\/span>RYOW<\/span>etc., n\u00e3o est\u00e3o totalmente implementados.
\n<\/span>\u274c <\/span>Transa\u00e7\u00f5es <\/b>- Ainda n\u00e3o \u00e9 compat\u00edvel com esta vers\u00e3o.<\/span><\/p>\n
Participe da conversa!<\/h2>\n
Queremos seu feedback! Ajude a moldar o futuro do <\/span>Provedor principal do Couchbase EF<\/b>:<\/span><\/p>\n