Snowflake中调用JavaScript存储过程出现XMLHttpRequest未定义错误

问题场景 #

用户知道Snowflake的JavaScript存储过程基于JS语法开发，就参考了网上常见的浏览器端调用API的教程代码，尝试写逻辑调用外部接口，最终写出的存储过程代码如下：

create or replace procedure myschema.stproc1()
    returns string
    language javascript
    as
    $$
        // 创建请求变量，实例化XMLHttpRequest对象
        var request = new XMLHttpRequest();
        
        // 以GET方式向目标URL发起异步连接
        request.open('GET', 'https://myappi.application.com/external/api/rest/v2/rooms/?includeCancelled=true&includePastReservations=true&limit=500', true);
        
        request.onload = function () {
          // 此处编写解析返回JSON数据的逻辑
        }
        
        // 发送请求
        request.send();
    $$
    ;

调用存储过程的时候直接触发报错：

JavaScript执行错误：未捕获的ReferenceError：STPROC1中 var request = new XMLHttpRequest(); 语句的第22位未定义XMLHttpRequest，堆栈跟踪：STPROC1第3行
因为用户本身对JavaScript的运行环境差异、Snowflake存储过程的内置能力都不熟悉，暂时定位不到报错的根本原因。

报错核心原因 #

XMLHttpRequest 是仅存在于浏览器运行环境的内置前端API，Snowflake存储过程跑在独立的服务端JS沙箱里，根本没有内置这个对象，直接写new XMLHttpRequest()实例化，当然会报“这个东西没定义”的错误。
你参考的教程是给浏览器端写代码的，和Snowflake沙箱的运行规则完全不搭——沙箱出于安全隔离的设计，不会把浏览器专属的DOM操作、网络请求类API开放给存储过程用，照搬写法肯定跑不通。

实际解决方法 #

• 第一步先把网络访问的授权配好：存储过程要访问外部API，必须提前在Snowflake侧配好网络规则、对应的安全集成，把目标API的域名加到白名单里，允许Snowflake的出口流量访问这个地址，不然就算代码写得全对，也会被安全策略拦下来。
• 第二步把原来用的浏览器请求逻辑，换成Snowflake沙箱内置的网络请求能力，这类原生对象不用额外引包，在存储过程里直接就能调。
• 改写后可运行的参考代码：

-- 前置要求：已完成目标API域名的网络白名单、安全集成配置
create or replace procedure myschema.stproc1()
    returns string
    language javascript
    as
    $$
        // 使用Snowflake沙箱原生的HttpRequest对象发起请求
        var targetUrl = "https://myappi.application.com/external/api/rest/v2/rooms/?includeCancelled=true&includePastReservations=true&limit=500";
        var httpRequest = snowflake.createHttpRequest();
        httpRequest.setMethod('GET');
        httpRequest.setUrl(targetUrl);
        // 按照目标API要求配置请求头，比如鉴权信息、内容格式标识等
        httpRequest.addHeader('Content-Type', 'application/json');

        // 发送请求并获取返回结果
        var response = httpRequest.send();
        var statusCode = response.getStatusCode();
        var responseBody = response.getBody();

        // 后续可自行扩展响应解析、数据写入Snowflake表等逻辑
        return "请求已完成，状态码：" + statusCode + "，响应内容大小：" + responseBody.length + " 字符";
    $$
    ;

容易踩的坑 #

• 别把所有依赖浏览器环境的JS代码直接往存储过程里搬，比如操作网页DOM、调浏览器专属功能的代码，在沙箱里全是跑不通的，两者运行环境差得非常多。
• 外部API的密钥、鉴权信息最好存在Snowflake的加密Secrets组件里，别直接硬编码在存储过程代码里，不小心把凭证漏出去得不偿失。
• Snowflake内置的HTTP请求有默认的超时时间，如果外部API响应很慢，记得在请求配置里手动调大超时参数，不然容易触发请求超时的错误。

内容的提问来源于stack exchange，提问作者Julaayi