{"id":12963,"date":"2022-04-04T08:00:22","date_gmt":"2022-04-04T15:00:22","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=12963"},"modified":"2025-06-13T20:56:47","modified_gmt":"2025-06-14T03:56:47","slug":"asp-net-core-crud-with-nosql-part-1","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/pt\/asp-net-core-crud-with-nosql-part-1\/","title":{"rendered":"CRUD do ASP.NET Core com NoSQL - Parte 1"},"content":{"rendered":"

Vamos criar um aplicativo ASP.NET Core CRUD com NoSQL.<\/span><\/p>\n

Criarei uma API HTTP CRUD b\u00e1sica (CRUD \u00e9 Create, Read, Update, Delete). Essa API estar\u00e1 operando em uma lista de desejos de presentes: todos os itens que eu quero que voc\u00ea compre para mim no meu anivers\u00e1rio. N\u00e3o criarei uma interface de usu\u00e1rio, mas voc\u00ea pode usar essa API com a estrutura do lado do cliente de sua escolha (como React ou Blazor, etc.).<\/span><\/p>\n

Esta primeira postagem incluir\u00e1 toda a configura\u00e7\u00e3o do projeto ASP.NET Core NoSQL e o banco de dados de configura\u00e7\u00e3o. As pr\u00f3ximas postagens criar\u00e3o os pontos de extremidade CRUD reais.<\/span><\/p>\n

Ferramentas de desenvolvedor de que voc\u00ea precisar\u00e1<\/h4>\n

Estou usando o Visual Studio 2022 (Enterprise), mas voc\u00ea deve ser capaz de acompanhar o processo com o JetBrains Rider, VSCode ou qualquer outro programa que use normalmente. (Se precisar de ajuda, ficarei feliz em ajudar!)<\/span><\/p>\n

Tamb\u00e9m estou usando <\/span>Couchbase Capella<\/span><\/a>que \u00e9 a oferta de DBaaS (banco de dados como servi\u00e7o) do Couchbase.<\/span><\/p>\n

J\u00e1 me inscrevi em uma conta de avalia\u00e7\u00e3o. Voc\u00ea tamb\u00e9m pode, v\u00e1 para: <\/span>https:\/\/cloud.couchbase.com\/sign-up<\/span><\/a><\/p>\n

O <\/span>amostra de viagem<\/em> j\u00e1 est\u00e1 carregado quando voc\u00ea implanta o cluster de avalia\u00e7\u00e3o. Mas estou usando o <\/span>outro balde que criei<\/span><\/a> chamado demonstra\u00e7\u00e3o<\/em>.<\/span><\/p>\n

\"Configure<\/a><\/p>\n

Dentro desse balde, h\u00e1 um <\/span>Padr\u00e3o<\/span><\/i> portanto, vou us\u00e1-lo. E dentro desse escopo, criei um <\/span>Lista de desejos<\/span><\/i>\u00a0cole\u00e7\u00e3o. (<\/span>Saiba mais sobre escopos e cole\u00e7\u00f5es no Capella<\/span><\/a>)<\/span><\/p>\n

\"Configure<\/a><\/p>\n

Credenciais CRUD<\/h4>\n

Voc\u00ea tamb\u00e9m precisar\u00e1 <\/span>criar credenciais de banco de dados<\/span><\/a> com acesso de leitura\/grava\u00e7\u00e3o a tudo no <\/span>demonstra\u00e7\u00e3o<\/span><\/i>\u00a0balde.<\/span><\/p>\n

\"Configure<\/a><\/p>\n

Finalmente, <\/span>colocar o endere\u00e7o IP na lista de permiss\u00f5es<\/span><\/a> a partir do qual voc\u00ea compilar\u00e1 e executar\u00e1 seu aplicativo, para que possa se conectar.<\/span><\/p>\n

\"Configure<\/a><\/p>\n

Iniciar um aplicativo ASP.NET Core<\/h4>\n

No Visual Studio, selecione <\/span>File\u2192New \u2192Project\u2192ASP.NET Core Web API<\/b>. Eu o chamei de <\/span>Tutorial do AspNetCore<\/span><\/i>.<\/span><\/p>\n

\"Setting<\/a><\/p>\n

Estou usando o .NET 6 e todos os outros padr\u00f5es est\u00e3o corretos (observe que o OpenAPI, tamb\u00e9m conhecido como Swagger, est\u00e1 ativado).<\/span><\/p>\n

\"Default<\/a><\/p>\n

Esse processo cria um site shell b\u00e1sico.<\/span><\/p>\n

Em seguida, vamos usar o NuGet para adicionar o Couchbase .NET SDK (<\/span>CouchbaseNetClient<\/span><\/i>).<\/span><\/p>\n

\"Couchbase<\/a><\/p>\n

Notas sobre o SDK do .NET<\/b><\/h5>\n

O SDK do Couchbase .NET permite que nos conectemos a um cluster do Couchbase. O Couchbase \u00e9 um banco de dados distribu\u00eddo, portanto, normalmente, h\u00e1 v\u00e1rios servidores (chamados de \"n\u00f3s\") em um grupo (chamado de \"cluster\") que atuam juntos. Um cluster tem um ou mais \"buckets\", que, como voc\u00ea viu anteriormente, cont\u00e9m escopos, que cont\u00eam cole\u00e7\u00f5es, que, por sua vez, cont\u00eam documentos.<\/span><\/p>\n

Os dados em um bucket s\u00e3o distribu\u00eddos entre os n\u00f3s do cluster, mas s\u00e3o tratados como uma \u00fanica entidade l\u00f3gica pelo SDK.<\/span><\/p>\n

Em uma cole\u00e7\u00e3o, cada <\/span>documento<\/span><\/a> tem uma \"chave\" exclusiva e um \"valor\" JSON.<\/span><\/p>\n

Na vers\u00e3o de teste do Capella, haver\u00e1 apenas um \u00fanico n\u00f3. No entanto, isso n\u00e3o afeta seu c\u00f3digo: quando os n\u00f3s s\u00e3o adicionados, o SDK \u00e9 inteligente o suficiente para encontr\u00e1-los por conta pr\u00f3pria.<\/span><\/p>\n

Na produ\u00e7\u00e3o, voc\u00ea normalmente ter\u00e1 pelo menos tr\u00eas n\u00f3s<\/span><\/a>possivelmente alguns buckets e quantos escopos e cole\u00e7\u00f5es forem necess\u00e1rios (dentro do razo\u00e1vel).<\/span><\/p>\n

Inje\u00e7\u00e3o de depend\u00eancia<\/h4>\n

Tamb\u00e9m vou adicionar o <\/span>Couchbase.Extensions.DependencyInjection<\/span><\/i> pacote NuGet. Isso fornecer\u00e1 m\u00e9todos de extens\u00e3o para adicionar facilmente os recursos do Couchbase \u00e0 inje\u00e7\u00e3o de depend\u00eancia integrada do ASP.NET Core.<\/span><\/p>\n

(Esse pacote facilita o uso do Couchbase com o ASP.NET Core, mas \u00e9 opcional).<\/span><\/p>\n

Conectar o ASP.NET Core ao Couchbase Capella<\/h4>\n

Vamos escrever algum c\u00f3digo no aplicativo ASP.NET para nos conectarmos ao cluster do Capella.<\/span><\/p>\n

Em <\/span>Program.cs<\/span><\/i>Use o m\u00e9todo de extens\u00e3o nos servi\u00e7os:<\/span><\/p>\n

builder.Services.AddCouchbase(x =>\r\n{\r\n\u00a0 \u00a0 x.ConnectionString = \"couchbases:\/\/\" + \"<< Capella connection string >>\";\r\n\u00a0 \u00a0 x.UserName = \"svc-wishlist\";\r\n\u00a0 \u00a0 x.Password = \"TOP-secret-123!\";\r\n\u00a0 \u00a0 x.HttpIgnoreRemoteCertificateMismatch = true;\r\n\u00a0 \u00a0 x.KvIgnoreRemoteCertificateNameMismatch = true;\r\n});<\/pre>\n
(Neste exemplo, estou codificando as informa\u00e7\u00f5es de conex\u00e3o, mas voc\u00ea tamb\u00e9m pode usar a configura\u00e7\u00e3o em <\/span>Configura\u00e7\u00f5es do aplicativo.json<\/span><\/i> em vez disso).<\/span><\/p>\n
Mais uma etapa: quando o aplicativo for interrompido, preciso que ele libere todos os recursos do Couchbase que o .NET estiver usando.<\/span><\/p>\n
Voc\u00ea pode registrar o c\u00f3digo a ser executado em eventos de tempo de vida, como <\/span>ApplicationStopped<\/span><\/i>.<\/span><\/p>\n
app.Lifetime.ApplicationStopped.Register(() =>\r\n{\r\n  app.Services.GetService<ICouchbaseLifetimeService>()?.Close();\r\n});<\/pre>\n
Agora, o sistema de inje\u00e7\u00e3o de depend\u00eancia do ASP.NET Core injetar\u00e1 automaticamente os objetos do Couchbase quando quisermos.<\/span><\/p>\n
Modelagem de dados<\/h4>\n
Antes de escrevermos mais c\u00f3digo, vamos pensar no modelo de dados. Ser\u00e1 um modelo muito simples: apenas o nome de um item para a lista de desejos.<\/span><\/p>\n
Em um banco de dados de documentos NoSQL, cada parte dos dados tem uma chave e um valor JSON. A chave pode ser apenas um GUID para nossos prop\u00f3sitos (voc\u00ea tamb\u00e9m pode criar uma chave mais significativa, se quiser). Cada item da lista de desejos tem um \"<\/span>nome<\/span>\", portanto, haver\u00e1 um nome<\/em> campo.<\/span><\/p>\n
Criarei uma classe C# para representar um item:<\/span><\/p>\n
public class WishlistItem\r\n{\r\n\u00a0 \u00a0 public Guid? Id { get; set; }\r\n\u00a0 \u00a0 public string Name { get; set; }\r\n}<\/pre>\n
Um modelo realmente simples, mas como o Couchbase n\u00e3o exige um esquema predefinido, adicionar mais campos pode ser t\u00e3o f\u00e1cil quanto adicion\u00e1-los aqui mesmo na classe C#.<\/span><\/p>\n
Vamos \"preparar\" o banco de dados com alguns itens da lista de desejos.<\/span><\/p>\n
Navegue at\u00e9 a cole\u00e7\u00e3o da lista de desejos no Couchbase Capella e adicione alguns documentos.<\/span><\/p>\n
O primeiro documento ter\u00e1 uma chave \"<\/span>3ca6e87e-c3a6-4637-989d-33cbca5002b5<\/span><\/i>\", e darei a ele o nome de \"<\/span>Camiseta Skyline Chili<\/span><\/i>“. <\/span><\/p>\n
O segundo documento ter\u00e1 uma chave \"<\/span>31c9cc33-8dfe-440c-bd1b-bb038939d2e0<\/span><\/i>\", darei a ele o nome de \"<\/span>Joey Votto Jersey<\/span><\/i>“.<\/span><\/p>\n
\"Viewing<\/a><\/p>\n
Voc\u00ea pode adicionar outros documentos, se desejar, mas, no final, criaremos um aplicativo em que os documentos ser\u00e3o adicionados\/alterados por meio do aplicativo ASP.NET Core.<\/span><\/p>\n
Controlador para a\u00e7\u00f5es CRUD NoSQL<\/h4>\n
Em seguida, crie um controlador ASP.NET para minhas opera\u00e7\u00f5es CRUD. Eu o chamo de <\/span>GiftsController<\/span><\/i>.<\/span><\/p>\n
No construtor, especifique um <\/span>IBucketProvider<\/span><\/i> par\u00e2metro. Esse \u00e9 um objeto que pode ser usado para obter um Bucket do Couchbase <\/span>Inje\u00e7\u00e3o de depend\u00eancia<\/span><\/i> m\u00f3dulo. Eu o usarei para obter um <\/span>Balde<\/span><\/i> para o objeto <\/span>demonstra\u00e7\u00e3o<\/span><\/i>\u00a0balde.<\/span><\/p>\n
public class GiftsController : Controller\r\n{\r\n\u00a0 \u00a0 private readonly IBucketProvider _bucketProvider;\r\n\r\n\u00a0 \u00a0 public GiftsController(IBucketProvider bucketProvider)\r\n\u00a0 \u00a0 {\r\n\u00a0 \u00a0 \u00a0 \u00a0 _bucketProvider = bucketProvider;\r\n\u00a0 \u00a0 }\r\n\r\n\u00a0 \u00a0 \/\/ ...\r\n}<\/pre>\n
Voc\u00ea pode executar o aplicativo neste momento, apenas para verificar se a conex\u00e3o funciona. Ainda n\u00e3o haver\u00e1 nenhum ponto de extremidade (exceto o <\/span>Previs\u00e3o do tempo<\/span><\/i> exemplo que a Microsoft colocou como exemplo).<\/span><\/p>\n
O que vem a seguir?<\/h4>\n
Agora temos um projeto ASP.NET Core, conectado ao Couchbase Capella. Na pr\u00f3xima postagem do blog, abordaremos a cria\u00e7\u00e3o dos endpoints CRUD reais.<\/span><\/p>\n
Enquanto isso, voc\u00ea pode:<\/span><\/p>\n