转换工作区

转换工作区可帮助您将源数据库中的架构和对象转换为与目标数据库兼容的 SQL 语法。本页面简要介绍了 Database Migration Service 转换工作区：

• 转化概览可提供架构转换进度的横截面视图。

• 确定性代码和架构转换支持的对象列出了支持确定性架构转换的 Oracle 对象。

• 交互式 SQL 编辑器介绍了您可以在转换工作区编辑器中直接修改哪些对象。

• Gemini 赋能的转换功能一文介绍了如何集成生成式 AI 支持来加快架构转换流程。

• 转化映射文件部分概述了可用于替换确定性架构转化规则的自定义指令。

• 旧版转换工作区介绍了不支持交互式 SQL 编辑器的旧版工作区。

某些数据类型不支持 Oracle 迁移。如需了解详情，请参阅 数据类型的已知限制。

转换进度概览

转换工作区提供全面的概览信息，您可以在其中深入了解未解决或已解决的转换问题总数、Gemini 辅助增强功能以及转换流程的总体运行状况。

图 1. 转换工作区概览界面，您可以在其中监控转换进度、查看问题并检查生成的 PostgreSQL 代码。（点击可放大）

您可以使用此视图按类型、问题严重程度、所需操作或转化状态过滤架构中的对象。

图 2. 按状态和对象类型过滤已转换的对象。（点击可放大）

如需详细了解如何使用转化概览来检查转化结果，请参阅 处理转化工作区。

确定性代码和架构转换

当您 创建转换工作区时，Database Migration Service 会立即使用一组确定性转换规则执行初始架构转换，其中特定的 Oracle 数据类型和对象会映射到特定的 PostgreSQL 数据类型和对象。此流程支持非常特定的可用 Oracle 数据库对象子集。

确定性代码转换支持以下 Oracle 数据库对象：

支持的 Oracle 架构元素

• 限制条件
• 索引（仅限在与其表相同的架构中创建的索引）
• 具体化视图
• 对象类型（部分支持）
• 序列
• 同义词
• 表
• 查看次数

支持的 Oracle 代码元素

• 触发器（仅限表级）
• 套餐
• 函数
• 存储过程

交互式 SQL 编辑器

借助交互式 SQL 编辑器，您可以在 Database Migration Service 中直接修改转换后的 PostgreSQL 语法。您可以使用它来解决转化问题，或调整架构以更好地满足您的需求。某些对象无法在内置编辑器中修改。

可修改的 Oracle 对象

转换源数据库代码和架构后，您可以使用交互式编辑器来修改为某些类型的对象生成的 SQL。编辑器支持以下 Oracle 对象：

• 表触发器（需要权限）
• 具体化视图
• 套餐
• 函数、存储过程
• 同义词
• 查看次数
• 限制条件
• 索引
• 序列

此外，某些对象已转换，但无法在 Database Migration Service 中直接进行修改。如需修改此类对象，您需要在 应用转换的架构和代码后直接在目标数据库中执行更新。

不支持修改的对象：

• 用户定义的对象类型
• 表
• 架构

使用 Gemini 加快代码和架构转换速度

预览版 — Gemini in Database Migration Service

此功能受服务专用条款的“通用服务条款”部分中的“非正式版产品条款”的约束。 非正式版功能“按原样”提供，可能只能获得有限的支持。 如需了解详情，请参阅发布阶段说明。

Database Migration Service 将 Gemini for Google Cloud 集成到转换工作区中，可帮助您在以下方面加快并改进转换流程：

• 借助 Gemini 赋能的自动转换功能增强确定性转换结果，利用 AI 的强大功能大幅减少 PostgreSQL 代码中所需的手动调整次数。

• 通过转化助理提供代码可解释性功能：一组专用提示，可帮助您更好地了解转化逻辑、针对转化问题提出修复建议，或优化转化后的代码。

• 借助 Gemini 代码转换建议，加快应用修复程序来解决转换问题：一种机制，让 Gemini 模型可以在您修复转换问题的同时进行学习，并建议对工作区中的其他错误对象进行更改。

如需详细了解由 Gemini 提供支持的转换，请参阅以下页面：

• 在 Gemini 的协助下转换 Oracle 代码和架构

• 用于修复存在转化问题的代码对象的示例工作流

转化对应关系文件

您可以使用转化映射文件自定义转化逻辑。转换映射文件是一个文本文件，其中包含有关如何将 Oracle 对象转换为 PostgreSQL 对象的精确说明（称为转换指令）。

支持的转化指令

Database Migration Service 支持以下转换指令，用于转换映射文件：

EXPORT_SCHEMA

EXPORT_SCHEMA 是所有转化映射文件都必须包含的指令。Database Migration Service 需要此指令，以确保您的源架构转换为正确的目标架构。 请确保您的转化映射文件包含以下代码行：

EXPORT_SCHEMA 1

SCHEMA

Database Migration Service 必须能够确定哪个架构包含应根据转换指令进行修改的对象。 SCHEMA 指令会导致对转化流程进行以下调整：

• Database Migration Service 仅转换此架构。如果您需要在单个转换工作区中转换其他架构，则需要上传具有不同架构的多个文件。
• 您文件中提供的所有其他自定义指令仅适用于此特定架构中的对象。

请使用以下格式：

SCHEMA SCHEMA_NAME

其中，SCHEMA_NAME 是源数据库中您的架构的名称。

• 如果您在转化映射文件中添加此指令，所有自定义设置都将仅应用于此特定架构中包含的对象。 如果您想自定义其他架构中的对象，则需要创建多个转化映射文件，并将这些文件上传到转化工作区。
• 如果您跳过此指令，则必须为其他转换指令修改的对象提供明确的架构名称。 例如，您需要使用 "SCHEMA_NAME.SOURCE_TABLE_NAME"，而不是将 SOURCE_TABLE_NAME 用于 REPLACE_TABLES 指令。

DATA_TYPE

您可以使用此指令在 Oracle 和 PostgreSQL 语法之间显式映射任何受支持的数据类型。此指令需要一个以英文逗号分隔的映射列表。整个定义必须在单行中提供，但您可以在配置文件中包含多个 DATA_TYPE 指令。请使用以下格式：

DATA_TYPE ORACLE_DATA_TYPE1:PGSQL_DATA_TYPE1
DATA_TYPE ORACLE_DATA_TYPE2:PGSQL_DATA_TYPE2...

其中，ORACLE_DATA_TYPE 和 PGSQL_DATA_TYPE 是您在迁移中使用的相应 Oracle 和 PostgreSQL 版本支持的数据类型。如需了解支持的版本，请参阅 场景概览。

示例：

DATA_TYPE REAL:double precision,SMALLINT:integer

如需详细了解 Oracle 和 PostgreSQL 数据类型，请参阅：

• Oracle 文档中的 Oracle 数据类型。
• PostgreSQL 文档中的 PostgreSQL 数据类型。

MODIFY_TYPE

借助 MODIFY_TYPE 指令，您可以控制 Database Migration Service 将源表中的特定列转换为哪种数据类型。 此指令需要一个以英文逗号分隔的映射列表。 整个定义必须在单行中提供，但您可以在配置文件中包含多个 MODIFY_TYPE 指令。请使用以下格式：

MODIFY_TYPE SOURCE_TABLE_NAME1:COLUMN_NAME:EXPECTED_END_RESULT_DATA_TYPE
MODIFY_TYPE SOURCE_TABLE_NAME2:COLUMN_NAME:EXPECTED_END_RESULT_DATA_TYPE...

其中：

• SOURCE_TABLE_NAME 是包含要更改数据类型的列的表的名称。
  重要提示：如果您不使用 SCHEMA 指令，请务必使用完全限定的表名称：SCHEMA_NAME.SOURCE_TABLE_NAME
• COLUMN_NAME 是您要自定义转化映射的列的名称。
• EXPECTED_END_RESULT_DATA_TYPE 是您希望转换后的列使用的数据类型（PostgreSQL 数据类型）。

示例：

MODIFY_TYPE events:dates_and_times:DATETIME,users:pseudonym:TEXT

PG_INTEGER_TYPE

默认情况下，Database Migration Service 会将 NUMBER(p,s) 类型转换为 PostgreSQL DECIMAL(p,s) 类型。

您可以使用 PG_INTEGER_TYPE 指令修改此行为。将其值设置为 1，并强制将所有具有精度和标度 (NUMBER(p,s)) 的 NUMBER 类型转换为 PostgreSQL smallint、integer 或 bigint 类型（具体取决于精度位数）。

提示：如果您将此指令与 DEFAULT_NUMERIC 指令结合使用，也可以将其用于纯 NUMBER 类型。

在转化映射文件中添加以下设置：

PG_INTEGER_TYPE 1

PG_NUMERIC_TYPE

如果您想将所有具有精度和标度 (NUMBER(p,s)) 的 NUMBER 类型转换为 PostgreSQL real 或 float 类型（根据其精度位数），请将此指令设置为 1。

如果您将此指令设置为 0，NUMBER(p,s) 值将保留其确切的原始值，并使用内部 PostgreSQL 数据类型。

在转化映射文件中添加以下设置：

PG_NUMERIC_TYPE 1

DEFAULT_NUMERIC

不带精度的 NUMBER 的默认转换会因您是否还使用 PG_INTEGER_TYPE 指令而异：

• 如果您使用 PG_INTEGER 指令，则不带精度的 NUMBER 会转换为 DECIMAL 值。
• 如果您不使用 PG_INTEGER 指令，则不带精度的 NUMBER 会转换为 BIGINT 值。

您可以修改此行为，并使用 DEFAULT_NUMERIC 指令来指定应为未指定精度点的 NUMBER 类型使用的数据类型。 请使用以下格式：

DEFAULT_NUMERIC POSTGRESQL_NUMERIC_DATA_TYPE

其中，POSTGRESQL_NUMERIC_DATA_TYPE 是以下值之一：integer、smallint、bigint。

示例：

DEFAULT_NUMERIC integer

REPLACE_COLS

您可以使用 REPLACE_COLS 指令重命名转换后的架构中的列。此指令需要一个以英文逗号分隔的映射列表。 请使用以下格式：

REPLACE_COLS SOURCE_TABLE_NAME1(SOURCE1_TABLE1_COLUMN_NAME1:DESTINATION_TABLE1_COLUMN_NAME1,SOURCE_TABLE1_COLUMN_NAME2:DESTINATION_TABLE1_COLUMN_NAME2),SOURCE_TABLE_NAME2(SOURCE_TABLE2_COLUMN_NAME1:DESTINATION_TABLE2_COLUMN_NAME1,SOURCE_TABLE2_COLUMN_NAME2:DESTINATION_TABLE2_COLUMN_NAME2)...

其中：

• SOURCE_TABLE_NAME 是包含您要更改其名称的列的表的名称。
  重要提示：如果您不使用 SCHEMA 指令，请务必使用完全限定的表名称：SCHEMA_NAME.SOURCE_TABLE_NAME
• SOURCE_COLUMN_NAME 是您要更改名称的来源中的列的名称。
• DESTINATION_COLUMN_NAME 是您要在转换后的架构中使用的列的新名称。

示例：

REPLACE_COLS events(dates_and_times:event_dates),users(pseudonym:nickname)

REPLACE_TABLES

您可以使用 REPLACE_TABLES 指令重命名表或将表移至新架构。此指令需要一个以空格分隔的映射列表。如需详细了解每种使用情形的语法，请展开即可下部分。

重要提示：如果您不使用 SCHEMA 指令，请确保在引号中为源变量和目标变量使用完全限定的表名称：

• "SCHEMA_NAME.SOURCE_TABLE_NAME"
• "SCHEMA_NAME.DESTINATION_TABLE_NAME"

重命名表

如需重命名转换后的架构中的表，请使用以下格式：

REPLACE_TABLES SOURCE_TABLE_NAME1:DESTINATION_TABLE_NAME1 SOURCE_TABLE_NAME2:DESTINATION_TABLE_NAME2

其中：

• SOURCE_TABLE_NAME 是您要在转换后的架构中重命名的源表的名称。
• DESTINATION_TABLE_NAME 是您要在转换后的架构中使用的表的新名称。

示例：

REPLACE_TABLES "events:login_events" "users:platform_users"

在架构之间移动表

您可以使用此指令将表从一个架构移至另一个架构，只需将架构前缀添加到新表名称中即可。无论您如何为整个转化文件使用 SCHEMA 指令，都可以使用此机制。 例如：

REPLACE_TABLES "events:NEW_SCHEMA_NAME.login_events"
    

用于自定义数据类型的别名

当您使用转换指令来修改 Database Migration Service 转换不同数据类型的方式时（例如，使用 DATA_TYPE、 MODIFY_TYPE 或 PG_NUMERIC_TYPE 指令），可以使用别名来代替源 SQL 数据类型。

展开即可下部分，查看 Database Migration Service 支持的数据类型别名列表。

数据类型别名

别名	转换为 PostgreSQL 类型
bigint，int8	BIGINT
bool、boolean	BOOLEAN
bytea	BYTEA
char、character	CHAR
character varying、varchar	VARCHAR
date	DATE
decimal、numeric	DECIMAL
double precision、float8	DOUBLE PRECISION
real，float4	REAL
int、integer、int4	INTEGER
int2	SMALLINT
interval	INTERVAL
json	JSON
smallint	SMALLINT
text	TEXT
time	TIME
timestamp	TIMESTAMP
timestamptz	TIMESTAMPTZ
timetz	TIMETZ
uuid	UUID
XML	XML

转化对应关系文件示例

请参阅以下示例转化映射文件，该文件使用了所有受支持的架构转换指令：

EXPORT_SCHEMA 1
SCHEMA root

PG_NUMERIC_TYPE 0
PG_INTEGER_TYPE 1
DEFAULT_NUMERIC integer
DATA_TYPE NUMBER(4\,0):integer
MODIFY_TYPE events:dates_and_times:TIMESTAMP
REPLACE_COLS events(dates_and_times:event_dates),users(pseudonym:nickname)
REPLACE_TABLES events:login_events users:platform_users

使用此文件的结果如下：

• EXPORT_SCHEMA 1 是必需的指令。
• SCHEMA root 会对转化流程进行以下调整：
  • Database Migration Service 仅对 root 架构中的实体执行转换。不转换其他架构。
  • 此文件中的所有其他自定义指令仅适用于 root 架构中定义的列和数据类型。
• PG_INTEGER_TYPE 1 使 Database Migration Service 将 root 架构中的表内找到的所有 Oracle 数值数据类型转换为特定于 PostgreSQL 的类型，而不是 ANSI 可移植数值类型。
• DEFAULT_NUMERIC 会使 Database Migration Service 将没有指定精度点的 NUMBER 值转换为 PostgreSQL INTEGER 类型。 这仅适用于 root 架构中的表内找到的 NUMBER 值。
• DATA_TYPE NUMBER(4\,0):integer 导致 Database Migration Service 将特定 NUMBER(4,0) 值转换为 PostgreSQL INTEGER。
• MODIFY_TYPE 指令会导致 Database Migration Service 将 events 源表中 dates_and_times 列中的数据专门转换为 PostgreSQL DATETIME 类型，而不管实际的源列格式如何。
• REPLACE_COLS events(dates_and_times:event_dates),users(pseudonym:nickname) 使 Database Migration Service 在转换后的架构中重命名以下列：
  • 源 events 表中的 dates_and_times 列在转换后的架构中的同一表中重命名为 event_dates。
  • 源 users 表中的 pseudonym 列在转换后的架构中的同一表中重命名为 nickname。
  重命名操作仅应用于 root 架构中的 events 和 users 表。
• REPLACE_TABLES events:login_events users:platform_users 重命名转换后架构中的以下表：
  • events 表已重命名为 login_events。
  • users 表已重命名为 platform_users。
  重命名操作仅应用于 root 架构中的 events 和 users 表。

旧版转换工作区

旧版转换工作区是一种较旧且功能更有限的转换工作区。旧版转换工作区不支持 Gemini 增强型转换功能或交互式 SQL 编辑器。您只能使用它们通过 Ora2Pg 迁移工具转换源架构。

我们不建议您在迁移中使用旧版转化工作区。如果您的应用场景需要使用旧版转化工作区，请参阅 使用旧版转化工作区。

后续步骤

如需了解如何使用转换工作区，请参阅：

• 创建转换工作区

• 使用转换工作区