{"id":13087,"date":"2022-04-18T11:02:34","date_gmt":"2022-04-18T18:02:34","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=13087"},"modified":"2025-06-13T20:56:46","modified_gmt":"2025-06-14T03:56:46","slug":"asp-net-crud-nosql-part-2","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/pt\/asp-net-crud-nosql-part-2\/","title":{"rendered":"CRUD do ASP.NET Core com NoSQL: Parte 2"},"content":{"rendered":"

CRUD significa Create (criar), Read (ler), Update (atualizar) e Delete (excluir). Na parte 2, veremos o R para leitura e criaremos um ponto de extremidade do ASP.NET Core para ler dados do Couchbase usando SQL.<\/span><\/p>\n

Certifique-se de ler <\/span>Parte 1 desta s\u00e9rie<\/span><\/a>que abrange a instala\u00e7\u00e3o e a configura\u00e7\u00e3o de seu projeto ASP.NET Core \"wishlist\".<\/span><\/p>\n

SQL++ para ler<\/b><\/h2>\n

O Couchbase \u00e9 \u00fanico entre os bancos de dados NoSQL, pois oferece suporte a um <\/span>implementa\u00e7\u00e3o completa de SQL<\/span><\/a> (chamado SQL++, tamb\u00e9m conhecido como N1QL) para consultar dados JSON.<\/span><\/p>\n

O SQL++ n\u00e3o \u00e9 uma linguagem \"semelhante ao SQL\" dilu\u00edda. Com o SQL++, voc\u00ea tem <\/span>JOINs<\/span><\/a>, <\/span>CTEs\/com<\/span><\/a>, <\/span>ATUALIZA\u00c7\u00c3O<\/span><\/a>, <\/span>INSERIR<\/span><\/a>, <\/span>DELETE<\/span><\/a>, <\/span>MERGE<\/span><\/a>, <\/span>agrega\u00e7\u00e3o\/GROUP BY<\/span><\/a>, <\/span>BEGIN\/COMMIT\/ROLLBACK<\/span><\/a>e muito mais.<\/span><\/p>\n

Al\u00e9m disso (o \"++\"), voc\u00ea tamb\u00e9m tem recursos para lidar com dados JSON, como <\/span>FALTANDO<\/span><\/a>, <\/span>NEST<\/span><\/a>, <\/span>Fun\u00e7\u00f5es ARRAY_*<\/span><\/a>, <\/span>Fun\u00e7\u00f5es OBJECT_*<\/span><\/a>e muito mais.<\/span><\/p>\n

Para este aplicativo CRUD simples, usaremos um aplicativo SQL++ <\/span>SELECIONAR<\/span> consulta (e \u00edndice) para retornar <\/span>todos<\/b> itens da minha lista de desejos.<\/span><\/p>\n

Escrevendo sua primeira consulta SQL++<\/b><\/h2>\n

Primeiro, vamos tentar escrever uma consulta SQL++ para obter todos os itens da lista de desejos diretamente no <\/span>Capella Query Workbench<\/span><\/a>.<\/span><\/p>\n

Para come\u00e7ar, tente:<\/span><\/p>\n

SELECT * FROM demo._default.wishlist;<\/pre>\n
Ao fazer isso, voc\u00ea dever\u00e1 receber uma mensagem de erro. Algo como:<\/span><\/p>\n
`no index available on keyspace default:demo._default.wishlist that matches your query. Use CREATE PRIMARY INDEX` ...<\/pre>\n
Esse \u00e9 o comportamento esperado. (A maioria das) consultas SQL++ no Couchbase n\u00e3o ser\u00e1 executada a menos que haja pelo menos um \u00edndice dispon\u00edvel para elas.<\/span><\/p>\n
N\u00e3o tem problema. Crie um <\/span>\u00cdNDICE PRIM\u00c1RIO<\/span><\/a> com um comando como este:<\/span><\/p>\n
CREATE PRIMARY INDEX `ix_wishlist` ON `demo`.`_default`.`wishlist`<\/pre>\n
Em geral, os \u00edndices prim\u00e1rios n\u00e3o devem ser usados em um ambiente de produ\u00e7\u00e3o t\u00edpico, mas s\u00e3o muito \u00fateis em um ambiente de desenvolvimento, pois garantem que <\/span>qualquer<\/b> A consulta SQL++ ser\u00e1 executada na cole\u00e7\u00e3o indexada (embora n\u00e3o seja t\u00e3o eficiente quanto uma cole\u00e7\u00e3o indexada corretamente). Quando voc\u00ea come\u00e7ar a criar consultas SQL++ mais complexas, poder\u00e1 usar a fun\u00e7\u00e3o <\/span>Bot\u00e3o \"Advise\" (Aconselhar) no Query Workbench<\/span><\/a> para obter sugest\u00f5es de \u00edndices mais eficientes a serem criados (e voc\u00ea deve evitar usar <\/span>SELECT *<\/span> sempre que puder \ud83d\ude06).<\/span><\/p>\n
Depois de criar o \u00edndice, tente novamente o procedimento acima <\/span>SELECIONAR<\/span> novamente, e os resultados dever\u00e3o ter a seguinte apar\u00eancia:<\/span><\/p>\n
[\r\n\u00a0 {\r\n\u00a0 \u00a0 \"wishlist\": {\r\n\u00a0 \u00a0 \u00a0 \"name\": \"Skyline Chili T-Shirt\"\r\n\u00a0 \u00a0 }\r\n\u00a0 },\r\n\u00a0 {\r\n\u00a0 \u00a0 \"wishlist\": {\r\n\u00a0 \u00a0 \u00a0 \"name\": \"Joey Votto jersey\"\r\n\u00a0 \u00a0 }\r\n\u00a0 }\r\n]<\/pre>\n
Quase l\u00e1. Tente imaginar essa matriz de objetos sendo serializada em um C# <\/span>Lista<\/span><\/em>. Isso n\u00e3o funcionaria muito bem, porque os objetos s\u00e3o aninhados com o nome da cole\u00e7\u00e3o. Por isso, adquiri o h\u00e1bito de colocar aliases nas cole\u00e7\u00f5es, assim:<\/span><\/p>\n
SELECT w.* FROM demo._default.wishlist w;<\/pre>\n
O que produz o resultado:<\/span><\/p>\n
[\r\n\u00a0 {\r\n\u00a0 \u00a0 \"name\": \"Skyline Chili T-Shirt\"\r\n\u00a0 },\r\n\u00a0 {\r\n\u00a0 \u00a0 \"name\": \"Joey Votto jersey\"\r\n\u00a0 }\r\n]<\/pre>\n
Parece bom, mas ainda est\u00e1 faltando alguma coisa. Onde est\u00e3o os GUIDs que usamos para as chaves do documento? O Couchbase n\u00e3o os armazena como dados; ele os armazena como <\/span>metadados<\/b>. O SQL++ fornece o <\/span>META()<\/span><\/em> para consultar metadados. Usar <\/span>META().id<\/span><\/em> assim:<\/span><\/p>\n
SELECT META(w).id, w.* FROM demo._default.wishlist w;<\/pre>\n
E isso finalmente nos d\u00e1 um resultado de:<\/span><\/p>\n
[\r\n\u00a0 {\r\n\u00a0 \u00a0 \"id\": \"2dab198b-1836-4409-9bdf-17275a2b2462\",\r\n\u00a0 \u00a0 \"name\": \"Skyline Chili T-Shirt\"\r\n\u00a0 },\r\n\u00a0 {\r\n\u00a0 \u00a0 \"id\": \"31c9cc33-8dfe-440c-bd1b-bb038939d2e0\",\r\n\u00a0 \u00a0 \"name\": \"Joey Votto jersey\"\r\n\u00a0 }\r\n]<\/pre>\n
Isso ser\u00e1 serializado de forma adequada em <\/span>Item da lista de desejos<\/span><\/em> usando a classe criada na parte 1.<\/span><\/p>\n
Usando o SQL++ no ASP.NET Core<\/b><\/h2>\n
Vamos colocar a consulta SQL++ que acabamos de escrever em um endpoint ASP.NET Core.<\/span><\/p>\n
Em GiftsController<\/em>crie um ponto de extremidade chamado Obter tudo<\/em>:<\/span><\/p>\n
[HttpGet]\r\n[Route(\"api\/getall\")]\r\npublic async Task<IActionResult> GetAll()\r\n{\r\n\r\n}<\/pre>\n
Para executar o SQL++, precisamos obter um objeto do tipo <\/span>Aglomerado<\/span>. O SQL++ \u00e9 executado no n\u00edvel do cluster (e n\u00e3o do bucket, do escopo ou da cole\u00e7\u00e3o, pois pode ser necess\u00e1rio <\/span>JUNTAR<\/span>\/<\/span>UNI\u00c3O<\/span> entre eles). Poder\u00edamos voltar e adicionar <\/span>Provedor de cluster<\/span><\/a> como um par\u00e2metro do construtor. Se esse endpoint fosse funcionar apenas com o SQL++, seria uma boa ideia. No entanto, vamos nos ater ao que criamos na parte 1. Temos um objeto do tipo <\/span>Provedor de balde<\/span><\/em>. A partir desse objeto, voc\u00ea pode obter um objeto do tipo <\/span>Aglomerado<\/span>:<\/span><\/p>\n
[HttpGet]\r\n[Route(\"api\/getall\")]\r\npublic async Task<IActionResult> GetAll()\r\n{\r\n  var bucket = await _bucketProvider.GetBucketAsync(\"demo\");\r\n  var cluster = bucket.Cluster;\r\n\r\n  \/\/ ... snip ...\r\n}<\/pre>\n
A <\/span>agrupamento<\/span> \u00e9 como o ASP.NET Core interagir\u00e1 com um cluster do Couchbase de v\u00e1rias maneiras. Por enquanto, estamos interessados em seu objeto <\/span>QueryAsync<\/span><\/em> m\u00e9todo:<\/span><\/p>\n
[HttpGet]\r\n[Route(\"api\/getall\")]\r\npublic async Task<IActionResult> GetAll()\r\n{\r\n  var bucket = await _bucketProvider.GetBucketAsync(\"demo\");\r\n  var cluster = bucket.Cluster;\r\n\r\n  var result = await cluster.QueryAsync<WishlistItem>(\r\n    \"SELECT META(w).id, w.* FROM demo._default.wishlist w;\"\r\n  );\r\n\r\n  return Ok(result);\r\n}<\/pre>\n
Certifique-se de que voc\u00ea tenha o seguinte <\/span>usando<\/span> na parte superior de seu GiftsController.cs<\/em> file:<\/span><\/p>\n
using AspNetCoreTutorial.Models;\r\nusing Microsoft.AspNetCore.Mvc;\r\nusing Couchbase;\r\nusing Couchbase.Query;\r\nusing Couchbase.Extensions.DependencyInjection;<\/pre>\n
Mais um aspecto a ser observado. Ao executar o SQL++, h\u00e1 uma s\u00e9rie de <\/span>Op\u00e7\u00f5es de consist\u00eancia (digitaliza\u00e7\u00e3o)<\/span><\/a>. O padr\u00e3o \u00e9 <\/span>ScanConsistency.NotBounded<\/span><\/em>. Essa configura\u00e7\u00e3o significa que o mecanismo de consulta <\/span>n\u00e3o<\/b> esperar que os \u00edndices terminem de ser atualizados antes de retornar os resultados. Essa \u00e9 a op\u00e7\u00e3o de melhor desempenho. Entretanto, em algumas situa\u00e7\u00f5es, voc\u00ea desejar\u00e1 uma consist\u00eancia de \u00edndice mais forte. O Couchbase fornece <\/span>RequestPlus<\/span><\/em> e <\/span>AtPlus<\/span><\/em>.<\/span><\/p>\n
Experimente o ponto de extremidade do ASP.NET Core<\/b><\/h2>\n
No Visual Studio, Ctrl+F5<\/strong> iniciar\u00e1 o aplicativo. Voc\u00ea dever\u00e1 ver uma p\u00e1gina OpenAPI \/ Swagger no navegador.<\/span><\/p>\n
\"ASP.NET<\/p>\n
(Ignorar Previs\u00e3o do tempo<\/em>que veio com o modelo do Visual Studio).<\/span><\/p>\n
Clique no endpoint para experiment\u00e1-lo. N\u00e3o h\u00e1 par\u00e2metros a serem especificados, portanto, basta clicar em Executar<\/strong>.<\/span><\/p>\n
\"Testing<\/p>\n
Agora voc\u00ea tem o \"R\" de CRUD no lugar.<\/span><\/p>\n
O que vem a seguir?<\/b><\/h2>\n
O projeto ASP.NET Core est\u00e1 conectado ao Couchbase Capella e est\u00e1 lendo dados via SQL++.<\/span><\/p>\n
Na pr\u00f3xima postagem do blog, criaremos outro endpoint de \"leitura\". Em vez de SQL++, analisaremos outra maneira mais r\u00e1pida de acessar e ler dados.<\/span><\/p>\n
Nesse meio tempo, voc\u00ea deve:<\/span><\/p>\n