{"id":2221,"date":"2016-04-08T20:58:05","date_gmt":"2016-04-08T20:58:04","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=2221"},"modified":"2025-06-13T21:02:04","modified_gmt":"2025-06-14T04:02:04","slug":"couchbase-net-sdk-v2-2-7-w-developer-preview-of-index-management-now-available","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/es\/couchbase-net-sdk-v2-2-7-w-developer-preview-of-index-management-now-available\/","title":{"rendered":"Ya est\u00e1 disponible el SDK v2.2.7 de Couchbase.NET con la vista previa para desarrolladores de la gesti\u00f3n de \u00edndices."},"content":{"rendered":"

Ya est\u00e1 disponible el SDK v2.2.7 de Couchbase.NET con la vista previa para desarrolladores de la gesti\u00f3n de \u00edndices.<\/h2>\n

\u00a1Hoy lanzamos la versi\u00f3n 2.2.7 del SDK .NET oficial de Couchbase! Esta versi\u00f3n contiene soporte para la gesti\u00f3n de \u00edndices y a\u00f1ade la API de sub-documento que fue lanzada como una vista previa para desarrolladores en la versi\u00f3n 2.2.6, as\u00ed como una correcci\u00f3n de errores y mejoras en el futuro soporte de .NET Core.<\/p>\n

Gesti\u00f3n de \u00edndices<\/h2>\n

Los \u00cdndices Secundarios Globales (GSIs) son una pieza importante de la arquitectura de consulta N1QL en el servidor Couchbase permitiendo consultas r\u00e1pidas y de baja latencia. Puedes colocar \u00edndices en elementos JSON, expresiones N1QL y usando filtros a trav\u00e9s de una cl\u00e1usula WHERE. Para la v2.2.7 del SDK .NET hemos construido una abstracci\u00f3n sobre el servicio de indexaci\u00f3n de Couchbase Server que hace muy f\u00e1cil crear \u00edndices primarios y secundarios. Esta abstracci\u00f3n extiende y ampl\u00eda la clase BucketManager que incluye soporte para crear y gestionar Buckets de Couchbase.<\/p>\n

var configuration = new ClientConfiguration();\r\n\r\nusing (var cluster = new Cluster(configuration))\r\n{\r\n    using (var bucket = cluster.OpenBucket(\"beer-sample\"))\r\n    {\r\n        var manager = bucket.CreateManager(\"Administrator\", \"\");\r\n    }\r\n}\r\n<\/code><\/pre>\n
El BucketManager se crea abriendo un objeto Bucket fuera de una instancia Cluster y pasando la configuraci\u00f3n correcta para su entorno.<\/p>\n
Creaci\u00f3n y eliminaci\u00f3n de \u00edndices primarios<\/h3>\n
Puedes crear \u00edndices primarios con nombre y sin nombre llamando a los m\u00e9todos CreatePrimaryIndex y CreateNamedPrimaryIndex una vez que tengas la instancia de BucketManager:<\/p>\n
 \/\/create an unamed primary index on the bucket\r\n var result = manager.CreatePrimaryIndex(false);\r\n\r\n \/\/create a named primary index called \"myprimaryindex\" on the bucket\r\n var result = manager.CreateNamedPrimaryIndex(\"myprimaryindex\", false);\r\n<\/code><\/pre>\n
Tenga en cuenta que siempre est\u00e1 trabajando con el contexto del cubo que ha abierto. As\u00ed que estos \u00edndices se crear\u00e1n en el cubo \"muestra-cerveza\" que hemos abierto antes. Adem\u00e1s, ten en cuenta que ambos m\u00e9todos toman un campo booleano llamado \"defer\", de hecho, como ver\u00e1s, todos los m\u00e9todos de creaci\u00f3n contienen un par\u00e1metro \"defer\". Si \"defer\" es verdadero, el \u00edndice ser\u00e1 creado, sin embargo, no ser\u00e1 construido hasta que el m\u00e9todo BuildDeferredIndexes sea llamado. M\u00e1s sobre \u00edndices diferidos m\u00e1s adelante.<\/p>\n
Dar de baja un \u00edndice primario con o sin nombre es pr\u00e1cticamente igual que crear un \u00edndice, con la excepci\u00f3n de los nombres de los m\u00e9todos:<\/p>\n
\/\/drop the primary index for the bucket\r\nvar result = manager.DropPrimaryIndex();\r\n\r\n\/\/drop a named primary index on the bucket\r\nvar result = manager.DropNamedPrimaryIndex(\"myprimaryindex\");\r\n<\/code><\/pre>\n
Tenga en cuenta que si el \u00edndice no existe, entonces result.Success ser\u00e1 falso.<\/p>\n
Creaci\u00f3n y eliminaci\u00f3n de \u00edndices secundarios<\/h3>\n
La creaci\u00f3n y eliminaci\u00f3n de \u00edndices secundarios es similar a la de los \u00edndices primarios, con la diferencia de que tambi\u00e9n se puede indexar uno o varios campos.<\/p>\n
\/\/create a secondary index called \"myindex\" on the \"id\" and \"name\" fields.\r\nvar result = manager.CreateIndex(\"myindex\", true, \"id\", \"name\");\r\n\r\n\/\/drop the index called \"myindex\"\r\nvar result = manager.DropIndex(\"myindex\");\r\n<\/code><\/pre>\n
N\u00f3tese que en este caso estoy pasando \"true\" para que la construcci\u00f3n del \u00edndice sea diferida. Adem\u00e1s, si el \u00edndice ya existe o si no existe e intentas eliminarlo, result.Success ser\u00e1 false.<\/p>\n
Actualizaciones de la API de subdocumentos<\/h2>\n
Esta versi\u00f3n tambi\u00e9n contiene cambios internos en la API SubDocument lanzada como Developer Preview en 2.2.6. Se han a\u00f1adido dos mejoras importantes relacionadas con el rendimiento:<\/p>\n
    \n
  1. Si se ejecuta una \u00fanica operaci\u00f3n de mutaci\u00f3n o b\u00fasqueda, el SDK utilizar\u00e1 una operaci\u00f3n \u00fanica en lugar de una multioperaci\u00f3n, lo que ahorra unos pocos bytes en el cable.<\/li>\n
  2. La deserializaci\u00f3n del cuerpo de la respuesta se aplaza ahora hasta que se llame a Content<\/li>\n<\/ol>\n
    Expresiones lambda para la navegaci\u00f3n por rutas de subdocumentos<\/h3>\n
    Adem\u00e1s de estos cambios, se ha incluido otra nueva funci\u00f3n en la versi\u00f3n gracias a una contribuci\u00f3n de la iniciativa comunidad<\/a>: Navegaci\u00f3n de expresiones lambda para rutas de subdocumentos. Esta caracter\u00edstica le permite utilizar la sintaxis familiar de tipo seguro, intellisense apoyado que disfrutar de linq en lugar de simplemente pasar en las rutas de cadena.<\/p>\n
    Suponiendo que un documento que se parece a:<\/p>\n
    {\r\n  \"name\": \"21st Amendment Brewery Cafe\",\r\n  \"city\": \"San Francisco\",\r\n  \"state\": \"California\",\r\n  \"code\": \"94107\",\r\n  \"country\": \"United States\",\r\n  \"phone\": \"1-415-369-0900\",\r\n  \"website\": \"https:\/\/www.21st-amendment.com\/\",\r\n  \"type\": \"brewery\",\r\n  \"updated\": \"2010-10-24 13:54:07\",\r\n  \"description\": \"The 21st Amendment Brewery offers a variety of award winning house made brews and American grilled cuisine in a comfortable loft like setting. Join us before and after Giants baseball games in our outdoor beer garden. A great location for functions and parties in our semi-private Brewers Loft. See you soon at the 21A!\",\r\n  \"address\": [\r\n    \"563 Second Street\"\r\n  ],\r\n  \"geo\": {\r\n    \"accuracy\": \"ROOFTOP\",\r\n    \"lat\": 37.7825,\r\n    \"lon\": -122.393\r\n  }\r\n}\r\n<\/code><\/pre>\n
    A continuaci\u00f3n, recupere el valor en la ruta \"geo.accuracy\" de la siguiente manera:<\/p>\n
    var key = \"21st_amendment_brewery_cafe\";\r\nvar lookup = bucket.LookupIn(key).\r\n    Get(x => x.Geo.Accuracy).\r\n    Execute();\r\n\r\nvar value = lookup.Content(x=>x.Geo.Accuracy);\r\nAssert.AreEqual(\"ROOFTOP\", value);    \r\n<\/code><\/pre>\n
    Por supuesto, puede encadenar varios \"Gets\" para recuperar cada elemento individual del documento.<\/p>\n
    Notas de la versi\u00f3n 2.2.7<\/h2>\n
    Error<\/h3>\n