{"id":15566,"date":"2024-04-05T09:33:32","date_gmt":"2024-04-05T16:33:32","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=15566"},"modified":"2025-07-08T09:15:58","modified_gmt":"2025-07-08T16:15:58","slug":"improved-debuggability-for-sql-user-defined-functions","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/es\/improved-debuggability-for-sql-user-defined-functions\/","title":{"rendered":"Mejora de la depuraci\u00f3n de funciones SQL++ definidas por el usuario"},"content":{"rendered":"

Funciones definidas por el usuario (UDF)<\/a> son una caracter\u00edstica muy \u00fatil soportada en SQL++.\u00a0<\/span>Couchbase 7.6 introduce mejoras que permiten una mayor depuraci\u00f3n y visibilidad en la ejecuci\u00f3n de UDF.<\/span><\/p>\n

Este blog explorar\u00e1 dos nuevas caracter\u00edsticas de Couchbase 7.6 en el mundo de las UDFs.<\/span><\/p>\n

    \n
  1. \n
      \n
    1. Perfilado de sentencias SQL++ ejecutadas en UDFs JavaScript<\/span><\/li>\n
    2. EXPLAIN FUNCTION para acceder a planes de consulta de sentencias SQL++ dentro de UDFs<\/span><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n

      Los ejemplos de este post requieren el conjunto de datos de muestras de viajes<\/a> a instalar.<\/span><\/p>\n

      Creaci\u00f3n de perfiles de SQL++ ejecutado en UDF de JavaScript<\/h2>\n

      El perfilado de consultas es una caracter\u00edstica de depuraci\u00f3n que ofrece SQL++.<\/span><\/p>\n

      Cuando se activa la creaci\u00f3n de perfiles para la ejecuci\u00f3n de una sentencia, el resultado de la petici\u00f3n incluye un \u00e1rbol de ejecuci\u00f3n detallado con el tiempo y las m\u00e9tricas de cada paso de la ejecuci\u00f3n de la sentencia. Adem\u00e1s de la informaci\u00f3n de perfiles que se devuelve en los resultados de la sentencia, tambi\u00e9n se puede acceder a ella para la petici\u00f3n en el archivo sistema:solicitudes_activas<\/em> y sistema:solicitudes_realizadas<\/em> espacios de claves del sistema.<\/span><\/p>\n

      He aqu\u00ed un post que profundiza en el perfilado de las peticiones<\/a>.<\/span><\/p>\n

      En Couchbase 7.0, se incluy\u00f3 la creaci\u00f3n de perfiles para subconsultas, incluida la creaci\u00f3n de perfiles de subconsultas de UDFs en l\u00ednea<\/em>.<\/span><\/p>\n

      Sin embargo, con las nuevas caracter\u00edsticas de Couchbase 7.6, la creaci\u00f3n de perfiles se ampli\u00f3 a las sentencias SQL++ dentro de UDF de JavaScript<\/em>.<\/span><\/p>\n

      En versiones anteriores, para perfilar sentencias dentro de una UDF JavaScript, el usuario deb\u00eda abrir la definici\u00f3n de la funci\u00f3n, ejecutar individualmente cada sentencia dentro de la UDF y recopilar sus perfiles. Este paso adicional ya no ser\u00e1 necesario en la versi\u00f3n 7.6.0.<\/span><\/p>\n

      Ahora, cuando se habilita la creaci\u00f3n de perfiles, si la sentencia contiene la ejecuci\u00f3n de una UDF JavaScript, tambi\u00e9n se recopilar\u00e1n los perfiles de todas las sentencias SQL++ ejecutadas en la UDF. Y esta informaci\u00f3n de perfiles relacionada con UDF estar\u00e1 disponible en la salida de la petici\u00f3n, sistema:solicitudes_activas<\/em> y sistema:solicitudes_realizadas<\/em> del sistema.<\/span><\/p>\n

      Ejemplo 1:<\/span><\/h3>\n

      Crear una UDF JavaScript js1<\/em> en una biblioteca mundial lib1<\/em>\u00a0a trav\u00e9s del punto final REST o de la interfaz de usuario.<\/span><\/p>\n

      function js1() {\r\n\r\n\u00a0\u00a0\u00a0\u00a0var query = SELECT * FROM default:`travel-sample`.inventory.airline LIMIT 1;\r\n\r\n\u00a0\u00a0\u00a0\u00a0var res = [];\r\n\u00a0\u00a0\u00a0\u00a0for (const row of query) {\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0res.push(row);\r\n\u00a0\u00a0\u00a0}\r\n\u00a0\u00a0\u00a0\u00a0query.close()\r\n\r\n\u00a0\u00a0\u00a0\u00a0return res;\r\n}<\/pre>\n
      Crear la funci\u00f3n SQL++ correspondiente:<\/span><\/p>\n
      CREATE FUNCTION js1() LANGUAGE JAVASCRIPT AS \"js1\" AT \"lib1\";<\/pre>\n
       Ejecuta la UDF con el perfil activado:<\/span><\/p>\n
      EXECUTE FUNCTION js1();\r\n<\/pre>\n
      En el <\/span>perfil<\/b> de la respuesta devuelta, el campo <\/span>executionTimings<\/b> contiene un campo <\/span>~declaracionesudf<\/b>.<\/span><\/p>\n
      ~declaracionesudf<\/b>\u00a0es una matriz de informaci\u00f3n de perfiles que contiene una entrada por cada sentencia SQL++ dentro de la UDF JavaScript.<\/span><\/p>\n
      Cada entrada dentro del <\/span>~declaracionesudf<\/b> contiene:<\/span><\/p>\n
        \n
      1. \n