对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。

加载数据定义语言文件

您可以通过从关系系统提交模式文件来创建项目。 创建项目是迁移过程的第一步。 使用模式文件创建项目时,您可以:

  • 从关系系统中导出数据定义语言 (DDL) 文件。

  • 将 DDL 文件导入 Relational Migrator。

  • 选择要迁移的数据库、模式和表。

Relational Migrator 仅解析与表、键和索引相关的声明。任何其他非 DDL 声明都将被忽略。

以下工作台工具均已提供用于导出表 DDL 文件的文档:

  • Oracle SQL Developer

  • SQL 服务器 Management Studio

  • MySQL Workbench

  • pgAdmin

当考虑网络连接或关系数据库权限时,可以使用 DDL 文件创建项目。

虽然您可以从 DDL文件创建项目并映射模式,但Relational Migrator仍会连接到关系数据库来运行迁移作业。

在最终完成项目创建之前,您可以选择初始映射。 这些选项包括从推荐的 MongoDB 模式开始,该模式由 Relational Migrator 根据您的关系数据库自动建议。

要从模式文件创建项目,必须从源关系系统中导出模式文件。 按照以下说明从关系系统生成 DDL 文件。

  1. 打开Oracle SQL Developer 。

  2. 在主菜单中,选择Tools ,然后选择Database Export 。

  3. 选择数据库连接。

  4. 取消选中Export Data 。

  5. 在Specify Data页面上,单击Lookup并选择要包含的表。

  1. 单击 Relational Migrator 主屏幕右上角的New Project 。

  2. 单击 Import .SQL file 按钮。

  3. 选择数据库类型。 Relational Migrator 目前支持从以下数据库类型进行迁移:

    • MySQL

    • Oracle

    • PostgreSQL

    • SQL 服务器

  4. 选择或拖放 DDL 声明文件,然后单击Import 。

  5. 在Select tables屏幕中,指示要迁移的表,然后单击Next 。

    以下标签页说明了选择要迁移的表的不同方法:

    1. 展开树以查看数据库、模式和表。

    2. 使用复选标记选择项目:

      • 数据库中的所有表:单击数据库的复选标记。

      • 一个模式中的所有表:展开数据库,然后单击模式的复选标记。

      • 模式中的特定表:展开数据库和模式,然后单独选择表。

      • 特定表名称:使用 Filter 栏在 Relational Schema 列表上方。

  6. 为collection名称选择Global casing选项。

    此选项会影响从关系数据库中的表创建的collection的名称:

    • Keep Original:保留关系数据库表名称中使用的原始大小写。

    • Override with Global Casing:使用全局大小写约定覆盖原始表名称。

      • camelCase

      • TitleCase

      • kebab-case

      • snake_case

      • UPPER_SNAKE_CASE

  7. 为您的 MongoDB 模式选择Initial mappings选项。

    • Start with a MongoDB schema that matches your relational schema

      使用每个表的新文档映射规则创建初始项目。此选项显示导入的关系表,这些关系表按数据库和模式分组,并按字母顺序列出。每个集合都表示为 top-level集合。您可以在每个表中查看相应的集合名称。对于集合名称, Relational Migrator会对原始表名称应用全局大小写。
    • Start with a recommended MongoDB schema

      Relational Migrator 会为建议的 MongoDB 模式创建映射规则。 选择此选项时,会出现一个表格,其中显示导入的关系表。 Relational Migrator 会建议哪些表应表示为top-level或embedded集合。 您可以使用复选框修改哪些表映射到collection或嵌入。
    • Start with an empty MongoDB schema

      创建没有映射规则的初始项目。

    注意

    无论您在启动项目时选择哪个选项,您都可以随时灵活地手动添加、删除或修改映射规则。 这样,您就可以根据工作负载的特定要求自定义 MongoDB 模式。

  8. 输入项目名称。

  9. 单击 Done(连接)。