@google-cloud/spannerlib-node-linux-x64

中文文档
0.2.0发布于 2026/08/20Apache-2.0TypeScriptESM + CJS近 30 天下载 7133

Cloud Spanner craverlib的内部节点-API包装器. 这是一个面向Google Cloud Spanner 节点驱动程序的内部软件包,可能会在不事先通知的情况下引入突破更改.

中文使用文档
文档目录6 节
  1. 先决条件
  2. 安装和大楼
  3. 使用量
  4. 建筑
  5. 组件互动
  6. 组件交互和内存管理

用于 Spanner 共享库的节点- API 包装器

注意点: 这是一个供Google Cloud Spanner驱动软件包(如高端节点.js Spanner驱动软件)使用的内部库. 它不是供终端客户直接使用的,可以在不事先通知的情况下进行中断更改.

先决条件

  • 节点.js >= 20.0.0
  • 去编译器( 去构建基础共享库, 如果不是预建的话)
  • C++工具链(GCC/Clang或MSVC)

安装和大楼

要建立本土的加词并汇编发展的驱动程序,运行:

npm install

关于3层编译管道(Go Link、C++节点-gyp桥和双重出版无害环境管理/CJS)的全面建筑分解,参见 Build And RELASE.md (中文(简体) ) 文档.

使用量

const { Pool, Connection } = require('spannerlib-node');

async function run() {
    const pool = await Pool.create(connectionString);
    
    const conn = await pool.createConnection();
    const rows = await conn.executeSql('SELECT 1');
    
    while (await rows.next()) {
        // process rows
    }
    
    await rows.close();
    await conn.close();
    await pool.close();
}

建筑

包装包括:

  1. src/cpp/addon.cc: C++ 键 处理线程边界和V8和C之间的类型转换的节点-API桥.
  2. src/ffi/utils.ts: 帮助者功能,可以同步地使用承诺来引用本地方法.
  3. src/lib/: JavaScript 类(Pool, (中文(简体) ), Connection, (中文(简体) ), Rows),提供了干净的面向对象的界面.

组件互动

包裹通过低层本土桥执行呼叫(addon.cc) (中文(简体) ). 介绍用户的班级(Pool, (中文(简体) ), Connection, (中文(简体) ), Rows)在 lib 文件夹映射执行请求输入Protobuf有效载荷,并通过同步调度器传送到桥上 utils.ts。每个成功执行返回在单通州登记处内跟踪的内存ID控件(spannerlib.ts将本地垃圾收集触发器连接起来.

组件交互和内存管理

当 JavaScript 对象( 如 Pool 或者说 Connection)是创建的,它持有一个ID来引用一个被绑定的Go对象的内存. 这个 spannerLib 单通维持一个 FinalizationRegistry。这个注册允许节点.js在JavaScript对象收集垃圾时监听 。 当 GC 发生时, 注册会自动触发本地层的清理呼叫以释放相应的 Go 对象, 防止本地内存泄露, 即使开发者忘记调用 .close() 当然.

版本与发布记录

@google-cloud/spannerlib-node-linux-x64 共发布 2 个版本,首次发布于 2026/08/19;过去 12 个月发布了 2 个版本。

版本发布日期距今
0.2.0latest2026/08/202 个月前
0.1.02026/08/192 个月前

关于 @google-cloud/spannerlib-node-linux-x64 的常见问题

@google-cloud/spannerlib-node-linux-x64 是什么?

Cloud Spanner craverlib的内部节点-API包装器. 这是一个面向Google Cloud Spanner 节点驱动程序的内部软件包,可能会在不事先通知的情况下引入突破更改.

如何安装 @google-cloud/spannerlib-node-linux-x64?

在项目目录运行 npm install @google-cloud/spannerlib-node-linux-x64,或使用 pnpm add / yarn add / bun add。

@google-cloud/spannerlib-node-linux-x64 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@google-cloud/spannerlib-node-linux-x64 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@google-cloud/spannerlib-node-linux-x64 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@google-cloud/spannerlib-node-linux-x64 可以商用吗?

@google-cloud/spannerlib-node-linux-x64 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@google-cloud/spannerlib-node-linux-x64 的下载量有多少?

根据 npm 官方下载统计,@google-cloud/spannerlib-node-linux-x64 在 2026/10/17 – 2026/11/15 这 30 天内被下载 7,133 次,日均约 238 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@google-cloud/spannerlib-node-linux-x64 还在维护吗?

最新版本 0.2.0 发布于 2026/08/20(2 个月前);至今共发布 2 个版本,其中过去 12 个月发布了 2 个;首次发布于 2026/08/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。