使用NodeJS连接Databricks SQL端点遇TypeError问题求助

这个错误的核心原因是你尝试调用waitUntilReady()的对象（通常是Session实例）为undefined，说明连接或Session创建环节失败了，以下是具体排查和解决步骤：

1. 检查代码结构与必填参数 #

确保你的代码严格遵循官方示例的结构，尤其注意以下容易遗漏的参数：

const { DBSQLClient } = require('@databricks/sql');

const client = new DBSQLClient();

async function run() {
  try {
    // 重点：必须包含path参数，值来自SQL端点Connection Details
    const connection = await client.connect({
      host: 'dbc-xxxx.cloud.databricks.com', // 不要带https://前缀
      path: '/sql/1.0/endpoints/你的端点ID',
      token: '你的访问令牌'
    });

    const session = await connection.createSession();
    await session.waitUntilReady(); // 只有session创建成功才不会报错

    const operation = await session.executeStatement('SELECT 1');
    const result = await operation.fetchAll();
    console.log(result);

    // 别忘了资源清理
    await operation.close();
    await session.close();
    await connection.close();
    await client.close();
  } catch (error) {
    console.error('执行出错:', error);
  }
}

run();

常见错误点：

• 遗漏path参数：SQL端点的连接必须指定该路径，否则连接会失败，导致connection.createSession()返回undefined
• 主机名带https://前缀：正确格式应为纯域名，不要加协议头

2. 排查依赖与Node.js版本兼容性 #

• 卸载现有依赖后重新安装最新稳定版：

  npm uninstall @databricks/sql
  npm install @databricks/sql@latest
  

• 确认Node.js版本为14.x及以上，推荐使用16.x或18.x LTS版本（运行node -v查看），避免版本不兼容导致的隐性问题

3. 验证访问令牌权限 #

确保你的访问令牌对应的账号拥有SQL Warehouses User角色，或者具备访问目标SQL端点的权限：

• 登录Databricks控制台，进入Admin Console > Users，检查对应账号的角色权限
• 确认该账号能在Databricks UI中正常访问目标SQL端点

4. 增加错误捕获定位问题 #

在代码中添加更细致的日志，捕获连接和Session创建阶段的错误，便于定位具体原因：

try {
  const connection = await client.connect(/* 配置参数 */);
  console.log('连接已建立');
  
  const session = await connection.createSession();
  console.log('Session创建成功');
  
  await session.waitUntilReady();
  // 后续执行逻辑
} catch (err) {
  console.error('初始化失败详情:', err);
}

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