本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。
本文介绍如何使用数据传输服务DTS(Data Transmission Service),将RDS MySQL同步至Elasticsearch。
前提条件
- 已创建目标Elasticsearch实例,详情请参见创建阿里云Elasticsearch实例。 
- 目标Elasticsearch实例的存储空间须大于源RDS MySQL实例占用的存储空间。 
注意事项
| 类型 | 说明 | 
| 源库限制 | 
 | 
| 其他限制 | 
 | 
| 特殊情况 | 
 | 
费用说明
| 同步类型 | 链路配置费用 | 
| 库表结构同步和全量数据同步 | 不收费。 | 
| 增量数据同步 | 收费,详情请参见计费概述。 | 
支持同步的SQL操作
| 操作类型 | SQL操作语句 | 
| DML | INSERT、UPDATE、DELETE 说明  不支持同步使用UPDATE语句移除字段的操作。 | 
数据库账号的权限要求
| 数据库 | 所需权限 | 创建及授权方式 | 
| 源RDS MySQL实例 | 待同步对象的读权限。 | |
| 目标Elasticsearch实例 | Elasticsearch实例创建时设置的登录名(默认为elastic)和登录密码。 | |
若您使用的源库账号不是通过RDS MySQL控制台创建且授权,您需确保该账号具备REPLICATION CLIENT、REPLICATION SLAVE、SHOW VIEW和SELECT权限。
数据类型映射关系
由于MySQL和Elasticsearch实例支持的数据类型不同,数据类型无法一一对应。所以DTS在进行结构初始化时,会根据目标库支持的数据类型进行类型映射,详情请参见结构初始化涉及的数据类型映射关系。
术语及概念对应关系
| Elasticsearch | 关系型数据库 | 
| 索引(index) | 数据库(Database) | 
| 文档类型(type) | 表(Table) | 
| 文档(document) | 一行数据(Row) | 
| 字段(field) | 一列数据(Column) | 
| 映射(mapping) | 数据库的组织和结构(Schema) | 
操作步骤
- 进入目标地域的同步任务列表页面(二选一)。 - 通过DTS控制台进入- 登录数据传输服务DTS控制台。 
- 在左侧导航栏,单击数据同步。 
- 在页面左上角,选择同步实例所属地域。 
 - 通过DMS控制台进入说明- 实际操作可能会因DMS的模式和布局不同,而有所差异。更多信息,请参见极简模式控制台和自定义DMS界面布局与样式。 - 登录DMS数据管理服务。 
- 在顶部菜单栏中,选择。 
- 在同步任务右侧,选择同步实例所属地域。 
 
- 单击创建任务,进入任务配置页面。 
- 配置源库及目标库信息。 - 类别 - 配置 - 说明 - 无 - 任务名称 - DTS会自动生成一个任务名称,建议配置具有业务意义的名称(无唯一性要求),便于后续识别。 - 源库信息 - 选择已有连接信息 - 若您需要使用已录入系统(新建或保存)的数据库实例,请在下拉列表中选择所需的数据库实例,下方的数据库信息将自动进行配置。 说明- DMS控制台的配置项为选择DMS数据库实例。 
- 若您未将数据库实例录入到系统,或无需使用已录入系统的数据库实例,则需要手动配置下方的数据库信息。 
 - 数据库类型 - 选择MySQL。 - 接入方式 - 选择云实例。 - 实例地区 - 选择源RDS MySQL实例所属地域。 - 是否跨阿里云账号 - 本示例为同一阿里云账号间的同步,选择不跨账号。 - RDS实例ID - 选择源RDS MySQL实例ID。 - 数据库账号 - 填入源RDS MySQL实例的数据库账号,权限要求请参见数据库账号的权限要求。 - 数据库密码 - 填入该数据库账号对应的密码。 - 连接方式 - 根据需求选择非加密连接或SSL安全连接。如果设置为SSL安全连接,您需要提前开启RDS MySQL实例的SSL加密功能,详情请参见使用云端证书快速开启SSL链路加密。 - 目标库信息 - 选择已有连接信息 - 若您需要使用已录入系统(新建或保存)的数据库实例,请在下拉列表中选择所需的数据库实例,下方的数据库信息将自动进行配置。 说明- DMS控制台的配置项为选择DMS数据库实例。 
- 若您未将数据库实例录入到系统,或无需使用已录入系统的数据库实例,则需要手动配置下方的数据库信息。 
 - 数据库类型 - 选择Elasticsearch。 - 接入方式 - 选择云实例。 - 实例地区 - 选择目标Elasticsearch实例所属地域。 - 类型 - 请根据实际情况,选择集群版或Serverless。 - 实例ID - 选择目标Elasticsearch实例ID。 - 数据库账号 - 填入连接Elasticsearch实例的账号,即创建Elasticsearch时填入的登录名,默认账号为elastic。 - 数据库密码 - 填入该数据库账号对应的密码。 - 连接方式 - 请根据实际情况,选择HTTP或HTTPS。 
- 配置完成后,在页面下方单击测试连接以进行下一步。 说明- 请确保DTS服务的IP地址段能够被自动或手动添加至源库和目标库的安全设置中,以允许DTS服务器的访问。更多信息,请参见添加DTS服务器的IP地址段。 
- 若源库或目标库为自建数据库(接入方式不是云实例),则还需要在弹出的DTS服务器访问授权对话框单击测试连接。 
 
- 配置任务对象。 - 在对象配置页面,配置待同步的对象。 - 配置 - 说明 - 同步类型 - 固定选中增量同步。默认情况下,您还需要同时选中库表结构同步和全量同步。预检查完成后,DTS会将源实例中待同步对象的全量数据在目标集群中初始化,作为后续增量同步数据的基线数据。 - 目标已存在表的处理模式 - 预检查并报错拦截:检查目标数据库中是否有同名的表。如果目标数据库中没有同名的表,则通过该检查项目;如果目标数据库中有同名的表,则在预检查阶段提示错误,数据同步任务不会被启动。 说明- 如果目标库中同名的表不方便删除或重命名,您可以更改该表在目标库中的名称,请参见库表列名映射。 
- 忽略报错并继续执行:跳过目标数据库中是否有同名表的检查项。 警告- 选择为忽略报错并继续执行,可能导致数据不一致,给业务带来风险,例如: - 表结构一致的情况下,如在目标库遇到与源库主键或唯一键的值相同的记录: - 全量期间,DTS会保留目标集群中的该条记录,即源库中的该条记录不会同步至目标数据库中。 
- 增量期间,DTS不会保留目标集群中的该条记录,即源库中的该条记录会覆盖至目标数据库中。 
 
- 表结构不一致的情况下,可能会导致无法初始化数据、只能同步部分列的数据或同步失败,请谨慎操作。 
 
 - 索引名称 - 选择为表名,在目标Elasticsearch实例中创建的索引名称和表名一致。 
- 选择为库名_表名,在目标Elasticsearch实例中创建的索引名称则由库名、下划线(_)和表名按顺序拼接而成。 
 说明- 索引名称映射配置会在所有表中生效。 - 目标库对象名称大小写策略 - 您可以配置目标实例中同步对象的库名、表名和列名的英文大小写策略。默认情况下选择DTS默认策略,您也可以选择与源库、目标库默认策略保持一致。更多信息,请参见目标库对象名称大小写策略。 - 源库对象 - 在源库对象框中单击待同步对象,然后单击  将其移动至已选择对象框。说明 将其移动至已选择对象框。说明- 同步对象选择的粒度为库、表。若选择的同步对象为表,其他对象(如视图、触发器、存储过程)不会被同步至目标库。 - 已选择对象 - 如果您需要修改同步后的字段名称,可在已选择对象区域框中,右键单击对应的表名,设置该表在目标Elasticsearch实例中的索引名称、Type名称等信息,然后单击确定。更多信息,请参见库表列名单个映射。 说明- 您可以设置SQL过滤条件,过滤待同步的数据,只有满足过滤条件的数据才会被同步到目标实例,详情请参见通过SQL条件过滤任务数据。 
- 单击下一步高级配置,进行高级参数配置。 - 配置 - 说明 - 选择调度该任务的专属集群 - DTS默认将任务调度到共享集群上,您无需选择。若您希望任务更加稳定,可以购买专属集群来运行DTS同步任务。更多信息,请参见什么是DTS专属集群。 - 源库、目标库无法连接后的重试时间 - 在同步任务启动后,若源库或目标库连接失败则DTS会报错,并会立即进行持续的重试连接,默认持续重试时间为720分钟,您也可以在取值范围(10~1440分钟)内自定义重试时间,建议设置30分钟以上。如果DTS在设置的重试时间内重新连接上源库、目标库,同步任务将自动恢复。否则,同步任务将会失败。 说明- 针对同源或者同目标的多个DTS实例,如DTS实例A和DTS实例B,设置网络重试时间时A设置30分钟,B设置60分钟,则重试时间以低的30分钟为准。 
- 由于连接重试期间,DTS将收取任务运行费用,建议您根据业务需要自定义重试时间,或者在源和目标库实例释放后尽快释放DTS实例。 
 - 源库、目标库出现其他问题后的重试时间 - 在同步任务启动后,若源库或目标库出现非连接性的其他问题(如DDL或DML执行异常),则DTS会报错并会立即进行持续的重试操作,默认持续重试时间为10分钟,您也可以在取值范围(1~1440分钟)内自定义重试时间,建议设置10分钟以上。如果DTS在设置的重试时间内相关操作执行成功,同步任务将自动恢复。否则,同步任务将会失败。 重要- 源库、目标库出现其他问题后的重试时间的值需要小于源库、目标库无法连接后的重试时间的值。 - 是否限制全量同步速率 - 在全量同步阶段,DTS将占用源库和目标库一定的读写资源,可能会导致数据库的负载上升。您可以根据实际情况,选择是否对全量同步任务进行限速设置(设置每秒查询源库的速率QPS、每秒全量迁移的行数RPS和每秒全量迁移的数据量(MB)BPS),以缓解目标库的压力。 说明- 仅当同步类型选择了全量同步,才有此配置项。 
- 您也可以在同步实例运行后,调整全量同步的速率。 
 - 是否限制增量同步速率 - 您也可以根据实际情况,选择是否对增量同步任务进行限速设置(设置每秒增量同步的行数RPS和每秒增量同步的数据量(MB)BPS),以缓解目标库的压力。 - 分片配置 - 根据目标Elasticsearch中索引的最大分片配置,设置索引的主分片和副本分片的数量。 - 字符串Index - 同步至目标Elasticsearch实例中的字符串编入索引的方式。 - analyzed:先分析字符串,再编入索引。您还需要选择具体的分析器,分析器的类型及作用,请参见分析器。 
- not analyzed:不分析,直接使用原始值编入索引。 
- no:不编入索引。 
 - 时区 - DATETIME或TIMESTAMP的时间类型同步至目标Elasticsearch实例时,您可以选择所带时区。 说明- 若目标实例中此类时间类型数据无需带有时区,您需要预先在目标实例中设置该时间类型数据的文档类型(type)。 - DOCID取值 - 您无需配置。DOCID默认为表的主键,如表中无主键,则DOCID为Elasticsearch自动生成的ID列。 - 环境标签 - 您可以根据实际情况,选择用于标识实例的环境标签。本示例无需选择。 - 配置ETL功能 - 选择是否配置ETL功能。关于ETL的更多信息,请参见什么是ETL。 - 是:配置ETL功能,并在文本框中填写数据处理语句,详情请参见在DTS迁移或同步任务中配置ETL。 
- 否:不配置ETL功能。 
 - 是否去除正反向任务的心跳表 SQL - 根据业务需求选择是否在DTS实例运行时,在源库中写入心跳SQL信息。 - 是:不在源库中写入心跳SQL信息,DTS实例可能会显示有延迟。 
- 否:在源库中写入心跳SQL信息,可能会影响源库的物理备份和克隆等功能。 
 - 监控告警 - 是否设置告警,当同步失败或延迟超过阈值后,将通知告警联系人。 - 不设置:不设置告警。 
- 设置:设置告警,您还需要设置告警阈值和告警联系人。更多信息,请参见在配置任务过程中配置监控告警。 
 
- 上述配置完成后,单击页面下方的下一步配置库表字段,设置待同步的表在目标Elasticsearch的_routing策略和_id取值。 - 类型 - 说明 - 是否设置_routing - 设置_routing可以将文档路由存储在目标Elasticsearch实例的指定分片上,请参见_routing。 - 选择为是,您可以自定义列进行路由。 
- 选择为否,则用_id进行路由。 
 说明- 创建的目标Elasticsearch实例为7.x版本时,您必须选择为否。 - _routing列 - 选择用来进行路由的列。 说明- 仅当是否设置_routing选择为是时,需要设置此参数。 - _id取值 - 选择用来做文档ID的列。 
 
- 保存任务并进行预检查。 - 若您需要查看调用API接口配置该实例时的参数信息,请将鼠标光标移动至下一步保存任务并预检查按钮上,然后单击气泡中的预览OpenAPI参数。 
- 若您无需查看或已完成查看API参数,请单击页面下方的下一步保存任务并预检查。 
 说明- 在同步作业正式启动之前,会先进行预检查。只有预检查通过后,才能成功启动同步作业。 
- 如果预检查失败,请单击失败检查项后的查看详情,并根据提示修复后重新进行预检查。 
- 如果预检查产生警告: - 对于不可以忽略的检查项,请单击失败检查项后的查看详情,并根据提示修复后重新进行预检查。 
- 对于可以忽略无需修复的检查项,您可以依次单击点击确认告警详情、确认屏蔽、确定、重新进行预检查,跳过告警检查项重新进行预检查。如果选择屏蔽告警检查项,可能会导致数据不一致等问题,给业务带来风险。 
 
 
- 购买实例。 - 预检查通过率显示为100%时,单击下一步购买。 
- 在购买页面,选择数据同步实例的计费方式、链路规格,详细说明请参见下表。 - 类别 - 参数 - 说明 - 信息配置 - 计费方式 - 预付费(包年包月):在新建实例时支付费用。适合长期需求,价格比按量付费更实惠,且购买时长越长,折扣越多。 
- 后付费(按量付费):按小时扣费。适合短期需求,用完可立即释放实例,节省费用。 
 - 资源组配置 - 实例所属的资源组,默认为default resource group。更多信息,请参见什么是资源管理。 - 链路规格 - DTS为您提供了不同性能的同步规格,同步链路规格的不同会影响同步速率,您可以根据业务场景进行选择。更多信息,请参见数据同步链路规格说明。 - 订购时长 - 在预付费模式下,选择包年包月实例的时长和数量,包月可选择1~9个月,包年可选择1年、2年、3年和5年。 说明- 该选项仅在付费类型为预付费时出现。 
- 配置完成后,阅读并勾选《数据传输(按量付费)服务条款》。 
- 单击购买并启动,并在弹出的确认对话框,单击确定。 - 您可在数据同步界面查看具体任务进度。