# @google-cloud/spannerlib-node-linux-x64 中文文档

规范地址：https://npmcn.com/package/%40google-cloud/spannerlib-node-linux-x64/

版本：0\.2\.0
npm 元数据更新时间：2026-08-20T07:35:14.056Z
中文译文更新时间：2026-11-17T03:48:31.385Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40google-cloud/spannerlib-node-linux-x64
原文对照：https://npmcn.com/package/%40google-cloud/spannerlib-node-linux-x64/?lang=original
项目主页：https://github.com/googleapis/go-sql-spanner#readme
源码仓库：https://github.com/googleapis/go-sql-spanner

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：76.8 MB，39 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：2 个
- 首次发布：2026-08-19T13:16:31.374Z
- 最新版本发布：2026-08-20T07:35:13.833Z
- 近 30 天下载量：7133（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

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

## 安装

```sh
npm install @google-cloud/spannerlib-node-linux-x64
```

也可以使用：`pnpm add @google-cloud/spannerlib-node-linux-x64`、`yarn add @google-cloud/spannerlib-node-linux-x64`、`bun add @google-cloud/spannerlib-node-linux-x64`

## README

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

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

## 先决条件

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

## 安装和大楼

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

```bash
npm install
```

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

## 使用量

```javascript
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 是什么？

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 和提交记录判断。

