{"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\/pt\/improved-debuggability-for-sql-user-defined-functions\/","title":{"rendered":"Melhor capacidade de depura\u00e7\u00e3o para fun\u00e7\u00f5es definidas pelo usu\u00e1rio do SQL++"},"content":{"rendered":"

Fun\u00e7\u00f5es definidas pelo usu\u00e1rio (UDFs)<\/a> s\u00e3o um recurso muito \u00fatil suportado no SQL++.\u00a0<\/span>O Couchbase 7.6 apresenta aprimoramentos que permitem maior capacidade de depura\u00e7\u00e3o e visibilidade da execu\u00e7\u00e3o de UDFs.<\/span><\/p>\n

Este blog explorar\u00e1 dois novos recursos do Couchbase 7.6 no mundo das UDFs.<\/span><\/p>\n

    \n
  1. \n
      \n
    1. Cria\u00e7\u00e3o de perfil para instru\u00e7\u00f5es SQL++ executadas em UDFs JavaScript<\/span><\/li>\n
    2. EXPLAIN FUNCTION para acessar planos de consulta de instru\u00e7\u00f5es SQL++ em UDFs<\/span><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n

      Os exemplos nesta postagem requerem o conjunto de dados de amostra de viagens<\/a> a ser instalado.<\/span><\/p>\n

      Cria\u00e7\u00e3o de perfil do SQL++ executado em UDFs JavaScript<\/h2>\n

      A cria\u00e7\u00e3o de perfil de consulta \u00e9 um recurso de depura\u00e7\u00e3o que o SQL++ oferece.<\/span><\/p>\n

      Quando a cria\u00e7\u00e3o de perfil est\u00e1 ativada para a execu\u00e7\u00e3o de uma instru\u00e7\u00e3o, o resultado da solicita\u00e7\u00e3o inclui uma \u00e1rvore de execu\u00e7\u00e3o detalhada com o tempo e as m\u00e9tricas de cada etapa da execu\u00e7\u00e3o da instru\u00e7\u00e3o. Al\u00e9m de as informa\u00e7\u00f5es de cria\u00e7\u00e3o de perfil serem retornadas nos resultados da instru\u00e7\u00e3o, elas tamb\u00e9m podem ser acessadas para a solicita\u00e7\u00e3o na fun\u00e7\u00e3o system:active_requests<\/em> e system:completed_requests<\/em> espa\u00e7os de chaves do sistema.<\/span><\/p>\n

      Aqui est\u00e1 uma postagem que aprofunda-se na cria\u00e7\u00e3o de perfis de solicita\u00e7\u00e3o<\/a>.<\/span><\/p>\n

      No Couchbase 7.0, a cria\u00e7\u00e3o de perfil foi inclu\u00edda para subconsultas, incluindo a cria\u00e7\u00e3o de perfil de subconsultas de UDFs em linha<\/em>.<\/span><\/p>\n

      No entanto, com os novos recursos do Couchbase 7.6, a cria\u00e7\u00e3o de perfil foi estendida para instru\u00e7\u00f5es SQL++ dentro de UDFs de JavaScript<\/em>.<\/span><\/p>\n

      Nas vers\u00f5es anteriores, para criar perfis de instru\u00e7\u00f5es em um UDF JavaScript, o usu\u00e1rio precisava abrir a defini\u00e7\u00e3o da fun\u00e7\u00e3o, executar individualmente cada instru\u00e7\u00e3o no UDF e coletar seus perfis. Essa etapa adicional n\u00e3o ser\u00e1 mais necess\u00e1ria na vers\u00e3o 7.6.0!<\/span><\/p>\n

      Agora, quando a cria\u00e7\u00e3o de perfil estiver ativada, se a instru\u00e7\u00e3o contiver a execu\u00e7\u00e3o do UDF JavaScript, os perfis de todas as instru\u00e7\u00f5es SQL++ executadas no UDF tamb\u00e9m ser\u00e3o coletados. E essas informa\u00e7\u00f5es de cria\u00e7\u00e3o de perfil relacionadas ao UDF estar\u00e3o dispon\u00edveis na sa\u00edda da solicita\u00e7\u00e3o, system:active_requests<\/em> e system:completed_requests<\/em> espa\u00e7os de chaves do sistema tamb\u00e9m.<\/span><\/p>\n

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

      Criar um UDF JavaScript js1<\/em> em uma biblioteca global lib1<\/em>\u00a0por meio do ponto de extremidade REST ou da interface do usu\u00e1rio.<\/span><\/p>\n

      fun\u00e7\u00e3o js1() {\r\n\r\n    var query = SELECT * FROM default:`travel-sample`.inventory.airline LIMIT 1;\r\n\r\n    var res = [];\r\n    for (const row of query) {\r\n        res.push(row);\r\n   }\r\n    query.close()\r\n\r\n    return res;\r\n}<\/pre>\n
      Crie a fun\u00e7\u00e3o SQL++ correspondente:<\/span><\/p>\n
      CREATE FUNCTION js1() LANGUAGE JAVASCRIPT AS \"js1\" AT \"lib1\";<\/pre>\n
       Execute o UDF com a cria\u00e7\u00e3o de perfil ativada:<\/span><\/p>\n
      EXECUTE FUNCTION js1();\r\n<\/pre>\n
      No <\/span>perfil<\/b> da resposta retornada, a se\u00e7\u00e3o <\/span>executionTimings<\/b> A subse\u00e7\u00e3o cont\u00e9m um campo <\/span>~udfStatements<\/b>.<\/span><\/p>\n
      ~udfStatements<\/b>\u00a0\u00e9 uma matriz de informa\u00e7\u00f5es de cria\u00e7\u00e3o de perfil que cont\u00e9m uma entrada para cada instru\u00e7\u00e3o SQL++ dentro do UDF JavaScript.<\/span><\/p>\n
      Cada entrada no <\/span>~udfStatements<\/b> A se\u00e7\u00e3o cont\u00e9m:<\/span><\/p>\n
        \n
      1. \n