通过创建MongoDB数据源能够实现Dataphin读取MongoDB的业务数据或向MongoDB写入数据。本文为您介绍如何创建MongoDB数据源。
前提条件
若您需在Dataphin中创建基于阿里云产品的数据源,创建数据源前,需确保Dataphin的IP已添加至数据库白名单(或安全组)中,使数据源与Dataphin网络互通。具体操作,请参见数据源白名单配置。
背景信息
MongoDB是一款开源的文档型数据库,它以动态的模式存储类似JSON的BSON文档,能够处理大量的非结构化数据。其特点包括灵活的数据模型、高效的索引机制、支持数据复制和分片,以及易于使用的API。MongoDB适用于需要快速迭代和存储多样化数据格式的应用场景。
如果您使用的是MongoDB,在引入MongoDB的业务数据至Dataphin中或将Dataphin数据导出至MongoDB的场景中,您需要先完成MongoDB数据源的创建。更多阿里云MongoDB信息,请参见云数据库MongoDB-什么是云数据库MongoDB版。
权限说明
仅支持拥有新建数据源权限点的自定义全局角色和超级管理员、数据源管理员、板块架构师、项目管理员系统角色创建数据源。
操作步骤
在Dataphin首页的顶部菜单栏中,选择管理中心 > 数据源管理。
在数据源页面,单击+新建数据源。
在新建数据源对话框的NoSQL区域,选择MongoDB。
如果您最近使用过MongoDB,也可以在最近使用区域选择MongoDB。同时,您也可以在搜索框中,输入MongoDB的关键词,快速筛选。
在新建MongoDB数据源对话框中,配置连接数据源参数。
配置数据源的基本信息。
参数
描述
数据源名称
命名规则如下:
只能包含中文、英文字母大小写、数字、下划线(_)或短划线(-)。
长度不能超过64字符。
数据源编码
配置数据源编码后,您可以在Flink_SQL任务中通过
数据源编码.表名称
或数据源编码.schema.表名称
的格式引用数据源中的表;如果需要根据所处环境自动访问对应环境的数据源,请通过${数据源编码}.table
或${数据源编码}.schema.table
的变量格式访问。更多信息,请参见Flink_SQL任务开发方式。重要目前仅支持MySQL、Hologres、MaxCompute数据源。
数据源编码配置成功后不支持修改。
版本
支持MongoDB3.2和MongoDB3.4+版本。
数据源描述
对数据源的简单描述。不超过128字符。
数据源配置
选择需要配置的数据源:
如果业务数据源区分生产数据源和开发数据源,则选择生产+开发数据源。
如果业务数据源不区分生产数据源和开发数据源,则选择生产数据源。
标签
您可根据标签给数据源进行分类打标,如何创建标签,请参见管理数据源标签。
配置数据源与Dataphin的连接参数。
当上述步骤中选择了生产+开发数据源,则配置页面如下图所示。如果上述步骤中您选择了生产数据源,则仅展示生产数据源的配置页面。
说明通常情况下,生产数据源和开发数据源需配置为非同一个数据源,以实现开发数据源与生产数据源的环境隔离,降低开发数据源对生产数据源的影响。但Dataphin也支持配置成同一个数据源,即相同参数值。
参数
描述
JDBC URL
支持多副本模式,可配置多个地址。连接地址格式为
mongodb://host1:port1;host2:port2...
。说明JDBC URL地址支持携带authSource参数。
以阿里云MongoDB为例,您可以在MongoDB控制台的实例基本信息页面,查看连接地址和端口信息。
登录方式
支持用户名登录和匿名登录。
用户名、密码
登录方式为用户名登录时,需填写登录MongoDB实例的用户名和密码。
单击测试连接,测试数据源是否可以和Dataphin进行正常的连通。
完成数据源的上述信息配置后,您可以单击操作列的测试连接针对公共调度集群或已经在Dataphin注册且正常使用的自定义集群进行连接测试。公共调度集群为系统默认选中,不支持取消选中。自定义集群下不存在资源组时,不支持进行连接测试,需先创建资源组后再进行测试连接。
所选集群只用于测试与当前数据源的网络连通,不用于后续相关任务的运行。
测试连接时长通常在2分钟内,若超时,您可以单击图标查看具体原因并重试。
无论测试结果为连接失败、连接成功或成功有风险,系统都将为您记录最终结果的生成时间。
测试结果为连接失败时,您可以单击图标查看具体失败原因。
测试结果为成功有风险时,代表应用集群连接成功、调度集群连接失败,当前数据源无法用于数据开发和集成。您可以单击图标查看日志信息。
说明仅公共调度集群的测试结果包含成功有风险、连接成功、连接失败三种连接状态;在Dataphin注册的自定义集群的测试结果仅包含连接成功、连接失败两种连接状态。
请确保至少存在一个集群可以与数据源连通,否则不支持保存数据源信息。
重要如果连接测试失败,您可以根据网络连通常见问题进行排查。详细内容,请参见网络连通解决方案。
测试成功后,单击确定,完成MongoDB数据源的创建。