{"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\/es\/asp-net-crud-nosql-part-2\/","title":{"rendered":"ASP.NET Core CRUD con NoSQL: Parte 2"},"content":{"rendered":"

CRUD significa Crear, Leer, Actualizar y Eliminar. En la parte 2, veremos R para Read, y construiremos un endpoint ASP.NET Core para leer datos de Couchbase usando SQL.<\/span><\/p>\n

Aseg\u00farese de leer <\/span>parte 1 de esta serie<\/span><\/a>que cubre la instalaci\u00f3n y configuraci\u00f3n de su proyecto ASP.NET Core \"wishlist\".<\/span><\/p>\n

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

Couchbase es \u00fanica entre las bases de datos NoSQL en el sentido de que admite un <\/span>implementaci\u00f3n completa de SQL<\/span><\/a> (llamado SQL++, de soltera N1QL) para consultar datos JSON.<\/span><\/p>\n

SQL++ no es un lenguaje \"tipo SQL\" diluido. Con SQL++, dispone de <\/span>Se une a<\/span><\/a>, <\/span>CTEs\/WITH<\/span><\/a>, <\/span>ACTUALIZACI\u00d3N<\/span><\/a>, <\/span>INSERTAR<\/span><\/a>, <\/span>BORRAR<\/span><\/a>, <\/span>FUSIONAR<\/span><\/a>, <\/span>agregaci\u00f3n\/GROUP BY<\/span><\/a>, <\/span>INICIO\/COMPROMISO\/RETROCESO<\/span><\/a>y mucho m\u00e1s.<\/span><\/p>\n

Adem\u00e1s (el \"++\"), tambi\u00e9n dispone de funciones para tratar datos JSON, como <\/span>FALTA<\/span><\/a>, <\/span>NEST<\/span><\/a>, <\/span>Funciones ARRAY_*<\/span><\/a>, <\/span>Funciones OBJECT_*<\/span><\/a>y mucho m\u00e1s.<\/span><\/p>\n

Para esta sencilla aplicaci\u00f3n CRUD, utilizaremos un SQL++ <\/span>SELECCIONE<\/span> consulta (e \u00edndice) para devolver <\/span>todos<\/b> art\u00edculos de mi lista de deseos.<\/span><\/p>\n

Escribir su primera consulta SQL<\/b><\/h2>\n

En primer lugar, vamos a intentar escribir una consulta SQL++ para obtener todos los elementos de la lista de deseos en la carpeta <\/span>Workbench de consulta Capella<\/span><\/a>.<\/span><\/p>\n

Para empezar, int\u00e9ntalo:<\/span><\/p>\n

SELECT * FROM demo._default.wishlist;<\/pre>\n
Al hacerlo, deber\u00eda aparecer un mensaje de error. Algo como:<\/span><\/p>\n
`no index available on keyspace default:demo._default.wishlist that matches your query. Use CREATE PRIMARY INDEX` ...<\/pre>\n
Este es el comportamiento esperado. (La mayor\u00eda) de las consultas SQL++ en Couchbase no se ejecutar\u00e1n a menos que haya al menos un \u00edndice disponible para ellas.<\/span><\/p>\n
No hay problema. Cree un sencillo <\/span>\u00cdNDICE PRIMARIO<\/span><\/a> con un comando como este:<\/span><\/p>\n
CREATE PRIMARY INDEX `ix_wishlist` ON `demo`.`_default`.`wishlist`<\/pre>\n
Por lo general, los \u00edndices primarios no est\u00e1n pensados para ser utilizados en un entorno de producci\u00f3n t\u00edpico, pero son muy \u00fatiles para un entorno de desarrollo, ya que garantizan que <\/span>cualquier<\/b> La consulta SQL++ se ejecutar\u00e1 en la colecci\u00f3n indexada (aunque no ser\u00e1 tan eficiente como una colecci\u00f3n indexada correctamente). Una vez que empiece a crear consultas SQL++ m\u00e1s complejas, puede utilizar la funci\u00f3n <\/span>Bot\u00f3n \"Aconsejar\" en el Query Workbench<\/span><\/a> para obtener sugerencias de \u00edndices m\u00e1s eficientes para crear (y usted debe evitar el uso de <\/span>SELECCIONAR *<\/span> siempre que puedas \ud83d\ude06).<\/span><\/p>\n
Despu\u00e9s de crear el \u00edndice, vuelva a intentar lo anterior <\/span>SELECCIONE<\/span> y los resultados ser\u00e1n los siguientes:<\/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
Ya casi est\u00e1. Trate de imaginar esta matriz de objetos que se serializa a un C# <\/span>Lista<\/span><\/em>. No funcionar\u00eda del todo, porque los objetos est\u00e1n anidados con el nombre de la colecci\u00f3n. As\u00ed que me he acostumbrado a poner alias a las colecciones, as\u00ed:<\/span><\/p>\n
SELECT w.* FROM demo._default.wishlist w;<\/pre>\n
Lo que produce el 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
Se ve bien, pero todav\u00eda falta algo. \u00bfD\u00f3nde est\u00e1n esos GUIDs que usamos para las claves de los documentos? Couchbase no los almacena como datos; los almacena como <\/span>metadatos<\/b>. SQL++ proporciona la <\/span>META()<\/span><\/em> para consultar metadatos. Utilice <\/span>META().id<\/span><\/em> as\u00ed:<\/span><\/p>\n
SELECT META(w).id, w.* FROM demo._default.wishlist w;<\/pre>\n
Y que finalmente nos da un 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
Esto se serializar\u00e1 muy bien en <\/span>WishlistItem<\/span><\/em> utilizando la clase creada en la parte 1.<\/span><\/p>\n
Uso de SQL++ en ASP.NET Core<\/b><\/h2>\n
Pongamos esa consulta SQL++ que acabamos de escribir en un endpoint ASP.NET Core.<\/span><\/p>\n
En GiftsController<\/em>cree un endpoint llamado GetAll<\/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 ejecutar SQL++, necesitamos obtener un objeto de tipo <\/span>Grupo<\/span>. SQL++ se ejecuta a nivel de cluster (no de bucket, ni de scope, ni de colecci\u00f3n, ya que puede necesitar <\/span>\u00daNASE A<\/span>\/<\/span>UNI\u00d3N<\/span> entre ellos). Podr\u00edamos volver atr\u00e1s y a\u00f1adir <\/span>ClusterProvider<\/span><\/a> como par\u00e1metro del constructor. Si este endpoint fuera a funcionar s\u00f3lo con SQL++, ser\u00eda una buena idea. Sin embargo, sigamos con lo que creamos en la parte 1. Tenemos un objeto de tipo <\/span>BucketProvider<\/span><\/em>. A partir de ese objeto, se puede obtener un objeto de tipo <\/span>Grupo<\/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>grupo<\/span> es la forma en que ASP.NET Core interactuar\u00e1 con un cl\u00faster Couchbase de diversas maneras. Por ahora, estamos interesados en su <\/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
Aseg\u00farese de que dispone de lo siguiente <\/span>utilizando<\/span> en la parte superior de su 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
Una cosa m\u00e1s a tener en cuenta. Cuando se ejecuta SQL++, hay una serie de <\/span>opciones de coherencia (escaneado)<\/span><\/a>. El valor por defecto es <\/span>ConsistenciaEscaneo.NotBounded<\/span><\/em>. Esta configuraci\u00f3n significa que el motor de consulta <\/span>no<\/b> esperar a que los \u00edndices terminen de actualizarse antes de devolver los resultados. Esta es la opci\u00f3n m\u00e1s eficaz. Sin embargo, en algunas situaciones, querr\u00e1s una mayor consistencia en los \u00edndices. Couchbase proporciona <\/span>SolicitarPlus<\/span><\/em> y <\/span>AtPlus<\/span><\/em>.<\/span><\/p>\n
Pruebe el punto final de ASP.NET Core<\/b><\/h2>\n
Desde Visual Studio, Ctrl+F5<\/strong> iniciar\u00e1 la aplicaci\u00f3n. Deber\u00edas ver una p\u00e1gina OpenAPI \/ Swagger en tu navegador.<\/span><\/p>\n
\"ASP.NET<\/p>\n
(Ignorar Previsi\u00f3n meteorol\u00f3gica<\/em>que viene con la plantilla de Visual Studio).<\/span><\/p>\n
Haga clic en el punto final para probarlo. No hay par\u00e1metros que especificar, as\u00ed que simplemente haga clic en Ejecute<\/strong>.<\/span><\/p>\n
\"Testing<\/p>\n
Ahora tiene la \"R\" de CRUD en su lugar.<\/span><\/p>\n
\u00bfY ahora qu\u00e9?<\/b><\/h2>\n
El proyecto ASP.NET Core est\u00e1 conectado a Couchbase Capella, y est\u00e1 leyendo datos a trav\u00e9s de SQL++.<\/span><\/p>\n
En la pr\u00f3xima entrada del blog, crearemos otro punto final de \"lectura\". En lugar de SQL++, veremos otra forma m\u00e1s r\u00e1pida de acceder a los datos y leerlos.<\/span><\/p>\n
Mientras tanto, deber\u00edas:<\/span><\/p>\n