# @drizzle-adapter/pg-core 中文文档

规范地址：https://npmcn.com/package/%40drizzle-adapter/pg-core/

版本：1\.1\.1
npm 元数据更新时间：2026-03-25T23:49:26.554Z
中文译文更新时间：2026-11-12T20:15:47.894Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40drizzle-adapter/pg-core
原文对照：https://npmcn.com/package/%40drizzle-adapter/pg-core/?lang=original

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

- 包体积（解压后）：12.6 kB，13 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2024-12-03T05:40:21.069Z
- 最新版本发布：2026-03-25T23:49:26.424Z
- 近 30 天下载量：20342（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 1 个）

## 中文简介

Drizzle适配器生态系统共享PostgreSQL功能.

## 安装

```sh
npm install @drizzle-adapter/pg-core
```

也可以使用：`pnpm add @drizzle-adapter/pg-core`、`yarn add @drizzle-adapter/pg-core`、`bun add @drizzle-adapter/pg-core`

## README

# @ 细雨适应器/ pg- core

Drizzle适配器生态系统共享PostgreSQL功能.

## 概览

这个 `@drizzle-adapter/pg-core` 软件包提供PostgreSQL共享功能,由PostgreSQL兼容适配器在Drizzle适配器生态系统中使用. 此软件包是一个内部依赖:

-   [@ 细雨- 适应器/ 节点- 张贴](https://npmcn.com/package/%40drizzle-adapter/node-postgres)
-   [@ 细雨适应器/ postgres-js](https://npmcn.com/package/%40drizzle-adapter/postgres-js)
-   [@ rizzle- adapter/ neon- http](https://npmcn.com/package/%40drizzle-adapter/neon-http)
-   [@ 细雨适应器/ pglite](https://npmcn.com/package/%40drizzle-adapter/pglite)

## 目的

这个软件包将 PostgreSQL 特定功能标准化,跨越不同的 PostgreSQL 兼容适配器:

-   常见的 PostgreSQL 数据类型定义
-   共享 PostgreSQL 查询建筑逻辑
-   统一 PostgreSQL 错误处理
-   通用 PostreSQL 函数

## 安装

```bash
# This package is typically not installed directly but as a dependency of PostgreSQL adapters
pnpm install @drizzle-adapter/pg-core
```

## 适用于适配器开发者

如果您正在为 Drizzle 适应器生态系统开发一个新的 PostgreSQL 兼容适配器, 您应该使用这个软件包来确保与其他 PostgreSQL 适配器的一致性 :

```typescript
import { PostgresDrizzleDataTypes } from '@drizzle-adapter/pg-core';

export class YourPostgresAdapter implements DrizzleAdapterInterface {
  public getDataTypes(): PostgresDrizzleDataTypes {
    return new PostgresDrizzleDataTypes();
  }
  
  // ... rest of your adapter implementation
}
```

### 数据类型

该软件包提供了标准化的PostgreSQL数据类型定义:

```typescript
const dataTypes = new PostgresDrizzleDataTypes();

const table = dataTypes.dbTable('example', {
  // Numeric types
  id: dataTypes.dbSerial('id').primaryKey(),
  count: dataTypes.dbInteger('count'),
  price: dataTypes.dbDecimal('price', { precision: 10, scale: 2 }),
  
  // String types
  name: dataTypes.dbText('name'),
  description: dataTypes.dbText('description'),
  
  // Date/Time types
  createdAt: dataTypes.dbTimestampTz('created_at').defaultNow(),
  updatedAt: dataTypes.dbTimestampTz('updated_at').onUpdateNow(),
  
  // PostgreSQL-specific types
  tags: dataTypes.dbArray('tags', { type: 'text' }),
  metadata: dataTypes.dbJsonb('metadata'),
  searchVector: dataTypes.dbTsVector('search_vector'),
  status: dataTypes.dbEnum('status', ['active', 'inactive']),
  point: dataTypes.dbPoint('location'),
  range: dataTypes.dbRange('valid_period', { type: 'timestamp' })
});
```

### 处理错误

该包为 PostgreSQL 特定错误提供统一错误处理:

```typescript
import { handlePostgresError } from '@drizzle-adapter/pg-core';

try {
  // Your database operation
} catch (error) {
  throw handlePostgresError(error);
}
```

### 查询大楼

该套件包括用于构建 PostgreSQL 特定查询的公用事业:

```typescript
import { 
  buildInsertQuery,
  buildUpdateQuery,
  buildDeleteQuery,
  buildSelectQuery,
  buildFullTextSearchQuery
} from '@drizzle-adapter/pg-core';

// Build INSERT query
const insertQuery = buildInsertQuery(table, data);

// Build UPDATE query with JSONB operations
const updateQuery = buildUpdateQuery(table, {
  metadata: sql`${table.metadata} || '{"key": "value"}'::jsonb`
});

// Build DELETE query with conditions
const deleteQuery = buildDeleteQuery(table, conditions);

// Build SELECT query with joins
const selectQuery = buildSelectQuery({
  table,
  joins: [...],
  conditions: [...],
  orderBy: [...]
});

// Build full-text search query
const searchQuery = buildFullTextSearchQuery({
  table,
  columns: ['title', 'content'],
  searchTerm: 'search term',
  language: 'english'
});
```

### 类型映射

软件包处理 PostgreSQL 特定类型映射 :

```typescript
import { mapPostgresType } from '@drizzle-adapter/pg-core';

// Map JavaScript types to PostgreSQL types
const pgType = mapPostgresType(value);

// Map PostgreSQL types to JavaScript types
const jsValue = mapToJavaScript(pgValue, pgType);

// Handle array types
const arrayType = mapArrayType(elementType);

// Handle range types
const rangeType = mapRangeType(boundType);
```

### PostgreSQL 特定特性

```typescript
import { 
  createTsVector,
  createGinIndex,
  handleArrayOperations,
  handleJsonbOperations
} from '@drizzle-adapter/pg-core';

// Create tsvector column
const tsVectorSQL = createTsVector(['title', 'content'], 'english');

// Create GIN index for full-text search
const indexSQL = createGinIndex('posts_search_idx', 'posts', 'search_vector');

// Handle array operations
const arrayCondition = handleArrayOperations(column, operator, values);

// Handle JSONB operations
const jsonbCondition = handleJsonbOperations(column, path, value);
```

## 捐款

这个软件包作为Drizzle适配器生态系统的一部分得以维护. 如果你愿意贡献:

1.  叉子存储器
2.  创建您的特性分支( E)`git checkout -b feature/amazing-feature`(中文(简体) )
3.  提交更改( E)`git commit -m 'Add some amazing feature'`(中文(简体) )
4.  推向分行(`git push origin feature/amazing-feature`(中文(简体) )
5.  打开拉请求

## 相关软件包

-   [@ 细雨适应器/ 核心](https://npmcn.com/package/%40drizzle-adapter/core) - 核心接口和类型
-   [@ 细雨- 适应器/ 节点- 张贴](https://npmcn.com/package/%40drizzle-adapter/node-postgres) - 使用节点起子的PostgreSQL适配器
-   [@ 细雨适应器/ postgres-js](https://npmcn.com/package/%40drizzle-adapter/postgres-js) - 使用postgres.js的PostgreSQL适配器
-   [@ rizzle- adapter/ neon- http](https://npmcn.com/package/%40drizzle-adapter/neon-http) - 无霓虹服务器的PostgreSQL适配器
-   [@ 细雨适应器/ pglite](https://npmcn.com/package/%40drizzle-adapter/pglite) - 轻型PostgreSQL适配器

## 常见问题

### @drizzle-adapter/pg-core 是什么？

Drizzle适配器生态系统共享PostgreSQL功能\.

### 如何安装 @drizzle-adapter/pg-core？

在项目目录运行 npm install @drizzle-adapter/pg-core，或使用 pnpm add / yarn add / bun add。

### @drizzle-adapter/pg-core 支持 TypeScript 吗？

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

### @drizzle-adapter/pg-core 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @drizzle-adapter/pg-core 可以商用吗？

@drizzle-adapter/pg-core 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @drizzle-adapter/pg-core 的下载量有多少？

根据 npm 官方下载统计，@drizzle-adapter/pg-core 在 2026/10/13 – 2026/11/11 这 30 天内被下载 20,342 次，日均约 678 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @drizzle-adapter/pg-core 还在维护吗？

最新版本 1\.1\.1 发布于 2026/03/26（7 个月前）；至今共发布 12 个版本，其中过去 12 个月发布了 1 个；首次发布于 2024/12/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。