{"id":12874,"date":"2022-03-14T10:23:48","date_gmt":"2022-03-14T17:23:48","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=12874"},"modified":"2025-06-13T19:26:33","modified_gmt":"2025-06-14T02:26:33","slug":"reuse-sql-queries-between-server-mobile-app-databases","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/es\/reuse-sql-queries-between-server-mobile-app-databases\/","title":{"rendered":"Reutilizaci\u00f3n de consultas SQL entre bases de datos de servidores y aplicaciones m\u00f3viles"},"content":{"rendered":"

Como todos sabemos, el c\u00f3digo es caro de mantener: cuanto m\u00e1s complejo es el c\u00f3digo, mayor es el coste de su mantenimiento. Por eso, desde el principio de los tiempos, los desarrolladores de software han trabajado muy duro para lograr el objetivo de <\/span>reutilizaci\u00f3n del c\u00f3digo<\/b>.<\/span><\/p>\n

Couchbase Mobile 3.0 introdujo soporte para consultas SQL++. Como desarrollador, lo primero que se me ocurri\u00f3 fue compartir las consultas utilizadas en proyectos dirigidos tanto a aplicaciones de Couchbase Server como de Couchbase Mobile.\u00a0<\/span><\/p>\n

\u00bfEs una buena idea? Exploremos esa cuesti\u00f3n utilizando datos de muestra y una aplicaci\u00f3n m\u00f3vil de prueba de concepto.<\/span><\/p>\n

Datos de la muestra<\/span><\/h4>\n

Todo el c\u00f3digo de este art\u00edculo est\u00e1 disponible en <\/span>GitHub<\/span><\/a>. Ver el <\/span>L\u00c9AME<\/span><\/i><\/a> para obtener informaci\u00f3n sobre c\u00f3mo configurar los proyectos en su ordenador.<\/span><\/p>\n

Los datos de la muestra proceden del <\/span>OpenStreetMap<\/span><\/a> y tiene licencia bajo la <\/span>Open Data Commons Licencia de base de datos abierta (ODbL)<\/span><\/a> por la Fundaci\u00f3n OpenStreetMap.<\/span><\/p>\n

El conjunto de datos contiene todas las tiendas que venden helados en Estados Unidos. A continuaci\u00f3n se muestra un documento JSON de ejemplo:<\/span><\/p>\n

{\r\n \"type\": \"Feature\",\r\n \"id\": \"node\/472242349\",\r\n \"properties\": {\r\n \"addrCity\": \"Austin\",\r\n \"addrHousenumber\": \"4477\",\r\n \"addrPostcode\": \"78745\",\r\n \"addrState\": \"TX\",\r\n \"addrStreet\": \"South Lamar Boulevard\",\r\n \"addrUnit\": \"#790\",\r\n \"amenity\": \"ice_cream\",\r\n \"cuisine\": \"ice_cream\",\r\n \"name\": \"Amy's Ice Creams\",\r\n \"phone\": \"+1-512-891-0573\",\r\n \"id\": \"node\/472242349\"\r\n},\r\n  \"geometry\": {\r\n   \"type\": \"Point\",\r\n   \"coordinates\": [\r\n    -97.7998856,\r\n    30.230688\r\n  ]\r\n }\r\n}<\/pre>\n
Como puede ver, se trata de un conjunto de datos vers\u00e1til para realizar pruebas porque tiene propiedades incrustadas en los documentos.<\/span><\/p>\n
Ejemplo de aplicaci\u00f3n m\u00f3vil<\/span><\/h4>\n
En ejemplo de aplicaci\u00f3n m\u00f3vil<\/a> se escribi\u00f3 en <\/span>SwiftUI<\/span><\/a> con <\/span>Combine<\/span><\/a> y es una aplicaci\u00f3n para iOS\/macOS que muestra las distintas tiendas que venden helados en Estados Unidos. La aplicaci\u00f3n incluye un <\/span>base de datos preconstruida<\/span><\/a> con los mismos documentos JSON ya importados en ella para mayor comodidad. Esta aplicaci\u00f3n m\u00f3vil utiliza la \u00faltima versi\u00f3n del <\/span>SDK de Couchbase Lite<\/span><\/a>. Puedes abrir el proyecto en XCode desde el archivo del proyecto en la carpeta src para seguir el proceso.<\/span><\/p>\n
Una simple comparaci\u00f3n de consultas<\/span><\/h4>\n
Para empezar nuestras pruebas, podemos escribir una consulta sencilla, para Couchbase Server, que muestre todas las direcciones de las helader\u00edas y las ordene por el nombre de la tienda:<\/span><\/p>\n
SELECT id, properties.addrCity, properties.addrHousenumber, properties.addrPostcode, \r\nproperties.addrStreet, properties.addrState, properties.name \r\nFROM icecream \r\nWHERE properties.addrCity <> \"\" \r\nAND type = \"Feature\" \r\nORDER BY properties.name<\/pre>\n
Esta consulta tiene un filtro que s\u00f3lo devuelve los documentos en los que el objeto de la propiedad <\/span>direcci\u00f3nCiudad <\/span><\/i>tiene un valor y donde el documento <\/span>tipo<\/span><\/i> es igual a <\/span>Caracter\u00edstica<\/span><\/i>. Si se pregunta por qu\u00e9 tenemos la <\/span>direcci\u00f3nCiudad<\/span><\/i> filtro, se debe a que en este conjunto de datos hay datos sucios o documentos sin nombre o falta informaci\u00f3n. Utilizando un <\/span>tipo<\/span><\/i> es com\u00fan en las aplicaciones m\u00f3viles para filtrar diferentes tipos de documentos.<\/span><\/p>\n
Podemos utilizar el <\/span>Editor de consultas<\/b> del servidor Couchbase<\/span> Consola web<\/b><\/a> para ejecutar esta consulta. Cuando lo ejecut\u00e9 en mi Macbook Pro M1 Max personal, el resultado lleg\u00f3 en 38,4 ms. Esta consulta utiliza el <\/span>adv_properties_addrCity_type<\/span><\/i> que puede ver haciendo clic en el icono <\/span>Asesor de \u00edndices<\/b> bot\u00f3n.<\/span><\/p>\n
Portar la consulta a Couchbase Lite<\/span><\/h4>\n
Veamos ahora esta misma consulta ejecut\u00e1ndose en nuestra aplicaci\u00f3n m\u00f3vil. Para ver la aplicaci\u00f3n m\u00f3vil, puedes usar XCode para abrir el archivo <\/span>IceCreamLocator.xcodeproj<\/span><\/i> situado en la carpeta <\/span>src <\/span><\/i>carpeta. Una vez abierta en Xcode, busque la carpeta <\/span>IceCreamLocationRepository<\/span><\/i><\/a> swift en la carpeta <\/span>Shared\\Data<\/span><\/i> carpeta.\u00a0<\/span><\/p>\n
En <\/span>init <\/span><\/i>activa el registro detallado de la base de datos para inspeccionar la informaci\u00f3n de la consulta. Usando el registro detallado, puedes revisar lo que est\u00e1 pasando dentro de Couchbase Lite, incluyendo el rendimiento de la consulta.<\/span><\/p>\n
Revisemos la consulta simple de Couchbase Server y veamos c\u00f3mo funciona en Swift con el nuevo SQL++ Query API. La funci\u00f3n para la consulta simple se llama <\/span>getListByTypeNombreOrdenCiudad<\/span><\/i><\/a>y el c\u00f3digo se muestra a continuaci\u00f3n:<\/span><\/p>\n
  func getListByTypeCityOrderName() -> Void {\r\n      do {\r\n        if let query = try _db?.createQuery(\"SELECT id, \r\nproperties.addrCity, properties.addrHousenumber, properties.addrPostcode, properties.addrStreet, \r\nproperties.addrState, properties.name FROM _ WHERE properties.addrCity <> \\\"\\\" AND \r\ntype = \\\"Feature\\\" ORDER BY properties.name\") {\r\n            var results: [IceCreamLocation] = []\r\n            let explain = try query.explain()\r\n            print (\"**EXPLAIN** \\(explain)\")\r\n            for result in try query.execute() {\r\n                if let data = result.toJSON().data(using: .utf8){\r\n                   let location = try \r\nJSONDecoder().decode(IceCreamLocation.self, from: data)\r\n                   results.append(location)\r\n             }\r\n           }\r\n           self.iceCreamLocationList.send(results)\r\n           self.iceCreamLocationList.send(completion: .finished)\r\n         }\r\n     } catch {\r\n         print(\"**Error**: \\(error)\")\r\n         self.iceCreamLocationList.send(completion: .failure(DbError.unknown))\r\n     }\r\n}<\/pre>\n
Hay varias formas de hacer una consulta SQL++ en Swift. En este ejemplo, usamos la base de datos <\/span>createQuery<\/span><\/i><\/a> para crear la consulta. En Couchbase Lite, estoy usando el car\u00e1cter de subrayado (_) como nombre de la base de datos antes de la funci\u00f3n <\/span>DESDE <\/span><\/i>sentencia. Cambiar el nombre de la base de datos es uno de los cambios esperados para reutilizar las sentencias SQL++. Adem\u00e1s, para escapar de las comillas en la sentencia <\/span>DONDE <\/span><\/i>tuve que a\u00f1adir el car\u00e1cter de escape de cadena Swift (<\/span>\\<\/span><\/i>) antes de cada comilla.\u00a0<\/span><\/p>\n
Para probar esta consulta en ejecuci\u00f3n, puede abrir el archivo <\/span>IceCreamListViewModel<\/span><\/i><\/a> que se encuentra en el archivo <\/span>VerModelos <\/span><\/i>carpeta. Localice la carpeta <\/span>init <\/span><\/i>y descomente la primera l\u00ednea de ejemplo situada en la parte inferior de la funci\u00f3n que llama a la funci\u00f3n <\/span>getListByTypeNombreOrdenCiudad<\/span><\/i> de la funci\u00f3n <\/span>_repositorio <\/span><\/i>variable:<\/span><\/p>\n
 \/\/first example\r\n_repository.getListByTypeCityOrderName()<\/pre>\n
Ahora puedes utilizar Xcode para ejecutar la aplicaci\u00f3n en un simulador de iOS o en una aplicaci\u00f3n de macOS. A continuaci\u00f3n, abra la aplicaci\u00f3n <\/span>Consola de depuraci\u00f3n <\/b>en Xcode haciendo clic en el bot\u00f3n <\/span>Mostrar depuraci\u00f3n <\/b>en la esquina inferior derecha del editor de Xcode, como se muestra a continuaci\u00f3n.<\/span><\/p>\n
\"\"<\/p>\n
El registro detallado mostrar\u00e1 una gran cantidad de informaci\u00f3n de registro. Para ayudarle a encontrar la informaci\u00f3n correcta en los registros, utilice el cuadro de filtro situado debajo de la consola. Por ejemplo, introduzca el texto \"<\/span>Informaci\u00f3n de consulta<\/span><\/i>\" y luego pulsa la tecla intro de tu teclado para ver informaci\u00f3n sobre la consulta. La consola de depuraci\u00f3n filtrar\u00e1 los datos que devuelve Couchbase Lite.<\/span><\/p>\n
La inspecci\u00f3n de los registros le mostrar\u00e1 el <\/span>Informaci\u00f3n de consulta<\/span><\/i> y el n\u00famero de documentos encontrados por la consulta, cu\u00e1ntos bytes y cu\u00e1nto tiempo tard\u00f3 la consulta. Recuerda que los n\u00fameros que est\u00e1s viendo proceden de un simulador, no de un dispositivo real. Para ajustar el rendimiento de las aplicaciones m\u00f3viles, debes utilizar las herramientas de Apple con un dispositivo real.<\/span><\/p>\n
La velocidad a la que se ejecuta esta consulta es impresionante. A\u00fan m\u00e1s impresionante, todav\u00eda no se ha creado ning\u00fan \u00edndice, as\u00ed que esta consulta se ejecuta sin \u00edndice y hace un escaneo de tabla, lo que significa que tiene que mirar en la base de datos cada documento para ver si cumple los requisitos de la consulta. Couchbase Lite no requiere \u00edndices y har\u00e1 escaneos de tabla si es necesario, mientras que Couchbase Server s\u00ed requiere \u00edndices porque los escaneos de tabla pueden matar el rendimiento de todo el cluster.\u00a0<\/span><\/p>\n
En varios casos, a\u00f1adir \u00edndices puede mejorar significativamente el rendimiento de las consultas, as\u00ed que dejemos de ejecutar la aplicaci\u00f3n, a\u00f1adamos el \u00edndice adecuado y volvamos a comprobar el rendimiento.<\/span><\/p>\n
Abra el <\/span>IceCreamLocationRepository<\/span><\/i> y localice el <\/span>createIceCreamIndexes<\/span><\/i><\/a> funci\u00f3n. Descomente el primer bloque de c\u00f3digo para crear el primer \u00edndice de consulta:<\/span><\/p>\n
   let simpleIndex = ValueIndexConfiguration([\"properties.name\", \"properties.addrCity\", \"type\"])\r\n   try _db?.createIndex(simpleIndex, name: \"idx_location_type_city_name\")<\/pre>\n
\u00bfC\u00f3mo comprobamos si la consulta ha utilizado el \u00edndice que hemos creado? En la ventana <\/span>getListByTypeNombreOrdenCiudad<\/span><\/i> ver\u00e1s dos l\u00edneas que imprimen los resultados de la funci\u00f3n explain en la consola:<\/span><\/p>\n
let explain = try query.explain()\r\nprint (\"**EXPLAIN** \\(explain)\")<\/pre>\n
La consulta <\/span>explique<\/span><\/a> ejecutar\u00e1 el equivalente de la funci\u00f3n SQLite <\/span>EXPLICAR EL PLAN DE CONSULTA<\/span><\/i> y almacenar los resultados en una cadena que se env\u00eda a la consola mediante la funci\u00f3n print. Puede filtrar por <\/span>TABLA DE EXPLORACI\u00d3N <\/span><\/i>en tu consola de depuraci\u00f3n para encontrar los resultados. Cuando revises los resultados, aseg\u00farate de eliminar el filtro anterior de la ventana de la consola. Ahora vuelve a ejecutar la aplicaci\u00f3n y mira los registros para comprobar el cambio en el rendimiento.<\/span><\/p>\n
\"\"<\/p>\n
Deber\u00eda ver el <\/span>USO DEL \u00cdNDICE <\/span><\/i>con el nombre del \u00edndice creado, lo que indica que la consulta utiliza el \u00edndice adecuado. Ten en cuenta que aunque los \u00edndices pueden ayudar a las consultas, tambi\u00e9n pueden ralentizar la inserci\u00f3n y actualizaci\u00f3n de documentos. Puedes encontrar m\u00e1s informaci\u00f3n sobre indexaci\u00f3n en el manual de Couchbase Lite <\/span>documentaci\u00f3n<\/span><\/a>.<\/span><\/p>\n
Otra comparaci\u00f3n de consultas<\/span><\/h4>\n
En nuestra segunda comparaci\u00f3n, filtramos los resultados s\u00f3lo para mostrar las helader\u00edas del Estado de Georgia, ordenadas por Ciudad y Estado:<\/span><\/p>\n
SELECT id, properties.addrCity, properties.addHousenumber, properties.addrPostcode, \r\nproperties.addrStreet, properties.addrState, properties.name \r\nFROM icecream \r\nWHERE\r\nproperties.addrCity IS NOT NULL \r\nAND properties.addrState = 'GA'\r\nAND type = \"Feature\" \r\nORDER BY properties.name<\/pre>\n
Esta consulta devuelve 15 documentos y utiliza una consulta diferente, ya que utilizamos la funci\u00f3n <\/span>properties.addrState <\/span><\/i>y <\/span>propiedades.direcci\u00f3nCiudad<\/span><\/i> atributos en nuestro <\/span>DONDE <\/span><\/i>cl\u00e1usula.\u00a0<\/span><\/p>\n
Tenga en cuenta que hemos cambiado la forma de comprobar el <\/span>propiedades.direcci\u00f3nCiudad<\/span><\/i> y utilizar el atributo <\/span>IS NOT NULL<\/span><\/i> ahora. Esto demuestra la flexibilidad del lenguaje SQL++ y c\u00f3mo los desarrolladores pueden utilizar diferentes sintaxis para obtener los mismos resultados.<\/span><\/p>\n
\"\"<\/p>\n
Ahora, volvamos a nuestra aplicaci\u00f3n m\u00f3vil para ver las diferencias. La funci\u00f3n para nuestra segunda consulta se llama <\/span>getListByStateGeorgia<\/span><\/i><\/a>y el c\u00f3digo se muestra a continuaci\u00f3n:<\/span><\/p>\n
    func getListByStateGeorgia() -> Void {\r\n        do {\r\n           if let query = try _db?.createQuery(\"SELECT id, properties.addrCity, \r\nproperties.addrHousenumber, properties.addrPostcode, properties.addrStreet, \r\nproperties.addrState, properties.name FROM _ WHERE properties.addrCity NOT NULL AND \r\nproperties.addrState = \\\"GA\\\" AND type=\\\"Feature\\\" ORDER BY properties.name\") {\r\n               var results: [IceCreamLocation] = []\r\n               let explain = try query.explain()\r\n               print (\"**EXPLAIN** \\(explain)\")\r\n               for result in try query.execute() {\r\n                   if let data = result.toJSON().data(using: .utf8){\r\n                      let location = try \r\nJSONDecoder().decode(IceCreamLocation.self, from: data)\r\n                      results.append(location)\r\n                 }\r\n              }\r\n              self.iceCreamLocationList.send(results)\r\n              self.iceCreamLocationList.send(completion: .finished)\r\n          }\r\n        } catch {\r\n            print(\"**Error**: \\(error)\")\r\n            self.iceCreamLocationList.send(completion: .failure(DbError.unknown))\r\n     }\r\n   }<\/pre>\n
Para probar esta nueva consulta, puede abrir el archivo <\/span>IceCreamListViewModel<\/span><\/i>. Localice el <\/span>init<\/span><\/i><\/a> y comentar la primera l\u00ednea de ejemplo situada al final de la funci\u00f3n que llama a la funci\u00f3n <\/span>getListByTypeNombreOrdenCiudad <\/span><\/i>de la funci\u00f3n <\/span>_repositorio<\/span><\/i> y descomenta la l\u00ednea que llama a nuestra nueva funci\u00f3n:<\/span><\/p>\n
\/\/first example\r\n\/\/_repository.getListByTypeCityOrderName()\r\n\r\n\/\/second example\r\n_repository.getListByStateGeorgia()<\/pre>\n
Puedes depurar la aplicaci\u00f3n usando Xcode y comprobar el \u00e1rea de depuraci\u00f3n. Muestra los mismos 15 documentos que fueron devueltos por la consulta ejecutada en Couchbase Server, pero volvemos a hacer un escaneo de tabla que no es el comportamiento que queremos-cambiamos la consulta, pero no creamos ning\u00fan \u00edndice nuevo todav\u00eda.<\/span><\/p>\n
\"\"<\/p>\n
Para solucionarlo, podemos volver a la funci\u00f3n <\/span>IceCreamLocationRepository<\/span><\/i><\/a> y localice el <\/span>createIceCreamIndexes<\/span><\/i><\/a> funci\u00f3n. Descomente el segundo bloque de c\u00f3digo para crear el segundo \u00edndice de consulta:<\/span><\/p>\n
        let secondIndex = \r\nValueIndexConfiguration([\"properties.name\",\"properties.addrCity\", \"type\", \"properties.addrState\"])\r\n        try _db?.createIndex(secondIndex, name: \"idx_location_type_city_state_name\")<\/pre>\n
\"\"<\/p>\n
Descubrimos que pod\u00edamos reutilizar el c\u00f3digo en estas dos consultas m\u00e1s sencillas, pero tuvimos que a\u00f1adir los \u00edndices para evitar los escaneos de tabla.<\/span><\/p>\n
Capturas con reutilizaci\u00f3n de consultas<\/span><\/h4>\n
Couchbase Server y Couchbase Mobile no usan el mismo almacenamiento o motor de consultas. Por lo tanto, es posible que te encuentres con consultas de Couchbase Server que necesiten ligeras modificaciones para ser optimizadas para Couchbase Mobile.<\/span><\/p>\n
Para obtener m\u00e1s informaci\u00f3n sobre Couchbase Server, consulte la documentaci\u00f3n de la p\u00e1gina <\/span>Optimizador basado en costes<\/span><\/a> que utiliza el motor de consultas. El portal Couchbase Developer tambi\u00e9n tiene un buen art\u00edculo sobre c\u00f3mo mejorar <\/span>rendimiento de la consulta<\/span><\/a> en Couchbase Server que pueden explicar por qu\u00e9 algunas consultas se escriben de una manera espec\u00edfica.\u00a0<\/span><\/p>\n
Recomiendo leer la documentaci\u00f3n de Couchbase Mobile sobre resoluci\u00f3n de problemas <\/span>consultas<\/span><\/a> ya que me ha ayudado a escribir consultas optimizadas y explica mejor la salida del plan de consultas de SQLite.<\/span><\/p>\n
Resumen<\/span><\/h4>\n
Como se muestra en nuestros ejemplos de c\u00f3digo con la versi\u00f3n 3.0 de Couchbase Mobile, es posible reutilizar c\u00f3digo SQL++ entre Server y Mobile. Sin embargo, es posible que tengas que modificar las consultas y los \u00edndices para obtener un rendimiento \u00f3ptimo. Por ello, recomiendo encarecidamente leer la excelente documentaci\u00f3n de <\/span>SQL++ para m\u00f3viles - Diferencias con SQL++ para servidor<\/span><\/a> y <\/span>Cadenas de consulta SQL<\/span><\/a>. Contiene informaci\u00f3n valiosa sobre los cambios que podr\u00eda tener que hacer en sus consultas para utilizarlas en sus aplicaciones m\u00f3viles.<\/span><\/p>\n
Estos son algunos de los principales recursos a los que se hace referencia en este art\u00edculo:<\/span><\/p>\n