# @exogee/graphweaver-mikroorm 中文文档

规范地址：https://npmcn.com/package/%40exogee/graphweaver-mikroorm/

版本：2\.24\.1
npm 元数据更新时间：2026-09-22T01:54:44.704Z
中文译文更新时间：2026-11-14T04:30:46.953Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40exogee/graphweaver-mikroorm
原文对照：https://npmcn.com/package/%40exogee/graphweaver-mikroorm/?lang=original
项目主页：https://github.com/exogee-technology/graphweaver#readme
源码仓库：https://github.com/exogee-technology/graphweaver

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

- 包体积（解压后）：377 kB，113 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：10 个
- peer 依赖：graphql 16，@mikro-orm/core 6，@mikro-orm/knex 6，@mikro-orm/mssql 6，@mikro-orm/mysql 6，@mikro-orm/sqlite 6，@mikro-orm/postgresql 6
- 首次发布：2022-11-18T03:43:19.501Z
- 最新版本发布：2026-09-22T01:54:44.354Z
- 近 30 天下载量：3168（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：167（近 12 个月 12 个）

## 中文简介

@ exogee/ graphweaver 的 MikroORM 后端

## 安装

```sh
npm install @exogee/graphweaver-mikroorm
```

也可以使用：`pnpm add @exogee/graphweaver-mikroorm`、`yarn add @exogee/graphweaver-mikroorm`、`bun add @exogee/graphweaver-mikroorm`

## README

# `@exogee/graphweaver-mikroorm`

MikroORM Graphweaver 的适配软件包

## 文档

综合文献和使用实例可见于我们 [Docs 站点](https://graphweaver.com/docs)它包含安装指令,详细的API文档,以及帮助您开始Graphweaver的指南.

## 图形织物 CLI `graphweaver`

Graphweaver 命令行接口( CLI) 工具允许您在命令行外壳中使用命令设置和管理 Graphweaver 。 检查 `graphweaver` npm 软件包 [在这里.](https://www.npmjs.com/package/graphweaver)

## 环境变量

要配置单个数据库,可以使用env vars。 有两个选择:

1.  指定一个包含连接细节的 JSON 对象的 AWS 机密管理器 ARN

```shell
DATABASE_SECRET_ARN='<AWS SECRET ARN>'
```

2.  将所有参数指定为单独的 Env vars

```shell
DATABASE_HOST='localhost'
DATABASE_NAME='no_acls'
DATABASE_PORT='5432'
DATABASE_USERNAME='postgres'
DATABASE_PASSWORD='postgres'
```

如果您有多个数据库连接到图织器, 那么您需要通过自己代码中的配置设置 .

```typescript
const connection = {
    connectionManagerId: 'postgresql',
    entities,
    driver: PostgreSqlDriver,
    mikroOrmConfig: {
        host: process.env.DATABASE_HOST || 'localhost',
        dbName: process.env.DATABASE_NAME || 'no_acls',
        port: process.env.DATABASE_PORT ? Number(process.env.DATABASE_PORT) : 5432,
        user: process.env.DATABASE_USERNAME || 'postgres',
        password: process.env.DATABASE_PASSWORD || 'postgres',
    }
}
@Entity('Tag', {
    provider: new MikroBackendProvider(OrmTag, connection),
})
```

您也可以通过不同的 ARN 每个连接 :

```typescript
const connection = {
    connectionManagerId: 'postgresql',
    entities,
    driver: PostgreSqlDriver,
    secretArn: process.env.DATABASE_ONE_SECRET_ARN
}
@Entity('Tag', {
    provider: new MikroBackendProvider(OrmTag, connection),
})
```

最后,您也可以将一个功能传递给 MikroOrmConfig 选项, Graphweaver 将等待结果。 例如:

```typescript
export const postgresqlConnection: ConnectionOptions = {
    connectionManagerId: 'postgresql',
    mikroOrmConfig: async () => {
        if (!config) {
            logger.info('Resolving new connection config');
            const credentials = await postgresqlCredentials();
            config = {
                entities: [LinkDataEntity, SubmissionDataEntity, UploadDataEntity, VisitDataEntity],
                driver: PostgreSqlDriver,
                ...credentials,
            };
        } else {
            logger.info('Returning pre-cached connection config');
        }

        return config;
    },
};
```

## 常见问题

### @exogee/graphweaver-mikroorm 是什么？

@ exogee/ graphweaver 的 MikroORM 后端

### 如何安装 @exogee/graphweaver-mikroorm？

在项目目录运行 npm install @exogee/graphweaver-mikroorm，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：graphql（16）、@mikro-orm/core（6）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @exogee/graphweaver-mikroorm 支持 TypeScript 吗？

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

### @exogee/graphweaver-mikroorm 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @exogee/graphweaver-mikroorm 可以商用吗？

@exogee/graphweaver-mikroorm 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @exogee/graphweaver-mikroorm 的下载量有多少？

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

### @exogee/graphweaver-mikroorm 还在维护吗？

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