创建Hologres数据源

前提条件

• 已购买Hologres实例并创建数据库。操作详情请参见购买Hologres、创建数据库。

  说明

  建议购买Hologres实例时，地域与创建Hologres数据源的DataWorks工作空间地域一致，如果地域不一致就只能创建为跨地域的数据源，此类数据源无法在DataWorks的数据开发（DataStudio）模块绑定，即无法在DataWorks的数据开发、运维中心页面中执行对应计算任务，仅可进行数据同步任务。

• 已购买所需的资源组并完成资源组配置。

  数据源创建完成后，可用于数据同步、Hologres计算任务开发与调度、生成API提供数据服务等场景。新版通用型资源组（推荐）仅一个资源组即可满足上述所有场景的应用；旧版独享资源组需根据使用场景（用于数据集成、调度或数据服务）选择相应类型资源组购买。请提前准备好相应资源组并完成资源组配置，确保创建数据源时可与资源组网络连通。资源组相关操作请参见资源组管理。

  说明

  Hologres实例仅支持使用新版资源组及旧版独享资源组。

• 已创建或加入目标工作空间。

  您需在目标工作空间中，将Hologres实例创建为该工作空间的数据源，用于后续在该工作空间进行开发操作。同时，需将购买的DataWorks资源组绑定至该工作空间，确保数据源与资源组网络连通。创建工作空间，详情请参见创建并管理工作空间。

  说明

  同一个Hologres实例可在多个DataWorks工作空间中被创建为数据源。

使用限制

• 仅当Hologres实例和DataWorks工作空间同地域、同阿里云主账号，且基于此实例创建的数据源未开启SSL认证，该数据源才可用于数据开发和调度。

  重要

  若访问Hologres实例时需要加密传输，则您可在创建数据源时开启SSL认证，但开启认证后，该数据源将无法用于数据开发和调度。

• 跨账号创建的数据源（即将其他阿里云账号的Hologres实例创建为当前账号下的数据源），仅支持通过RAM角色的方式访问对应Hologres实例，并且该数据源不能用于数据开发和调度。

• 仅支持使用新版资源组及旧版独享资源组运行Hologres相关任务。详情请参见新增和使用新版通用型资源组、使用旧版资源组。

操作前准备：权限说明与配置

1. DataWorks侧权限配置。

   创建数据源之前，请确保操作的阿里云账号有DataWorks数据源的新建权限。满足下列条件之一即可：

   • 操作账号是阿里云主账号。

   • 操作账号是RAM账号或RAM角色，且拥有AliyunDataWorksFullAccess权限。详情请参见为RAM用户授权、为RAM角色授权。

   • 操作账号是RAM账号或RAM角色，且拥有DataWorks工作空间的项目所有者、运维或空间管理员角色，详情请参见添加空间成员并管理成员角色权限。

   说明

   若操作账号（即当前登录账号）为RAM账号，则创建数据源时，平台会根据您选择的默认访问身份，判断该账号是否还需具备其他权限，具体如下：

   • 若数据源的默认访问身份设置为执行者，则无需再添加额外的权限。

   • 若数据源的默认访问身份设置为阿里云主账号、阿里云RAM角色（非操作角色）、阿里云RAM子账号（非操作账号），则当前操作账号需具备AdministratorAccess权限。

2. Hologres侧权限配置。

   在数据源创建完成后，需要使用数据源配置的访问身份来访问对应的Hologres实例，因此，您需确保访问身份对应的阿里云账号有Hologres实例的操作权限。Hologres权限说明详情级授权指导请参见Hologres权限模型概述。

3. （可选）跨账号场景下的权限配置。（单击展开查看详情）

   跨阿里云账号创建Hologres数据源时，仅支持通过RAM角色访问的方式访问对应的Hologres实例，且需要对对应的RAM角色配置以下权限策略。

   • 跨账号创建数据源场景示例：

     本文示例使用主账号A登录DataWorks，通过主账号B的Hologres实例创建Hologres数据源，实现数据源的跨账号创建。

     • 主账号A：开通了DataWorks，需访问主账号B下的Hologres。

     • 主账号B：已开通Hologres实例并创建了Hologres数据库。

   • 账号B的RAM角色要求及权限配置

     1. 账号B需创建一个RAM角色并授权该角色可访问指定Hologres实例。同时，RAM角色需添加账号A为信任的云账号，即允许账号A使用此RAM角色。详情请参见RAM角色授权模式。

     2. 修改RAM角色的权限策略，授权给账号A，后续账号A可使用此RAM角色来访问Hologres。详情请参见修改RAM角色的信任策略。

        策略内容如下。

        {
            "Version": "1",
            "Statement": [
                {
                    "Action": [
                        "sts:AssumeRole",
                        "hologram:GetInstance",
                        "hologram:ListInstances",
                        "hologram:ListWarehouses"
                    ],
                    "Effect": "Allow",
                    "Principal": {
                        "Service": [
                            "账号A的阿里云账号ID@engine.dataworks.aliyuncs.com"
                        ]
                    }
                }
            ]
        }

创建数据源

1. 进入数据源页面。

   1. 登录DataWorks控制台，切换至目标地域后，单击左侧导航栏的管理中心，在下拉框中选择对应工作空间后单击进入管理中心。

   2. 进入工作空间管理中心页面后，单击左侧导航栏的数据源 > 数据源列表，进入数据源页面。

2. 单击新增数据源，选择Hologres。在数据源配置页面中配置数据源参数。

3. 配置基础信息。

   您可根据界面提示配置数据源的名称等基础信息，核心配置参数如下表所示。

   说明

   标准模式工作空间，需分别创建开发环境数据源和生产环境数据源。工作空间模式，详情请参见必读：简单模式和标准模式的区别。

   

   参数	说明
   数据源名称	定义数据源在DataWorks的名称，名称必须唯一。
   认证方式	新建数据源时无需配置，默认支持通过阿里云账号及阿里云RAM角色身份进行认证。 说明 历史创建的存量数据源支持使用AccessID及AccessKey的认证方式，这类数据源建议后续修改认证方式为阿里云账号及阿里云RAM角色。
   所属云账号	指定当前创建的数据源对应的Hologres实例属于当前阿里云主账号还是其他阿里云主账号。 当前阿里云主账号：添加当前阿里云主账号下的Hologres实例作为当前工作空间的数据源。 其他阿里云主账号：添加其他阿里云主账号下的Hologres实例作为当前工作空间的数据源。 说明 此方式即可实现跨账号创建数据源，数据源创建完成后仅支持通过RAM角色访问的方式执行。
   地域	Hologres实例所在地域。 说明 若选择的地域与当前工作空间地域不一致，则创建数据源后，此类数据源无法在DataWorks的数据开发（DataStudio）模块绑定，即不支持在数据开发（DataStudio）、运维中心使用，仅可用于数据集成模块进行数据同步。
   Hologres实例及访问身份配置	所属云账户不同时，Hologres实例及访问身份的配置参数不同。 所属账号：当前阿里云主账号 Hologres实例、数据库名称：在下拉框中选择待添加为数据源的Hologres实例，并填写已创建的Hologres数据库名称。您可以登录Hologres控制台，在实例列表页面进入实例详情页，查看对应信息。 默认访问身份：用于指定后续使用什么账号访问Hologres。 开发环境：默认使用当前的执行者（即当前的登录账号）访问Hologres。 例如在数据开发页面中创建并调试Hologres引擎任务时，即使用当前登录数据开发页面的阿里云账号访问对应的Hologres。 生产环境：您可以在下拉框中选择使用主账号或RAM账号/RAM角色访问Hologres。 说明 RAM角色相关操作请参见（进阶）RAM角色登录并使用DataWorks。 下拉框中可选的访问身份类型与当前操作创建Hologres数据源的账号有关，详情可见界面提示。 例如在运维中心周期性调度Hologres任务时，即使用此处配置的访问身份访问对应的Hologres。 所属账号：其他阿里云主账号 说明 此场景为创建跨账号的Hologres实例为数据源，数据源创建完成后，仅支持通过RAM角色的方式访问对应Hologres。并且该类数据源不能用于数据开发和调度。 对方阿里云主账号UID、对方RAM角色：填写跨账号的阿里云账号UID和RAM角色。后续即使用此阿里云账号下的RAM角色访问对应Hologres。 对方Hologres实例、对方数据库名称：填写已创建的Hologres实例ID、Hologres数据库名称。您可以登录Hologres控制台，在实例列表页面进入实例详情页，查看对应信息。
   认证选项与SSL加密模式	选择访问Hologres实例时，是否需要加密传输。 若认证选项选择SSL认证，则需先确保对应Hologres实例已开启传输加密，否则后续连接访问Hologres实例会报错。 重要 开启SSL认证的数据源无法用于数据开发和调度。

4. 测试资源组连通性。

   根据使用场景不同，资源组分为数据集成（用于数据同步）、数据调度（用于任务调度）、数据服务（用于数据服务任务）这些类型。各类资源组的详细介绍请参见DataWorks资源组概述。

   您需根据数据源后续的用途，在对应资源组类型页签下，测试所需资源组的连通性。若资源组与数据源无法连通，则相应数据源任务将无法正常执行。

后续操作

为保障您的开发过程更加顺畅，建议先阅读DataWorks On Hologres使用说明，了解在DataWorks使用Hologres的开发流程、相关费用、环境准备、权限控制等内容。

数据源创建完成后，您可根据需要执行如下操作：

• 计算任务开发与调度：

  DataWorks的数据开发与运维中心模块，为您提供Hologres任务的开发与调度能力，若您需要基于该Hologres数据源进行Hologres任务开发，或周期性调度Hologres相关任务，需先进入数据开发（DataStudio）页面，将创建的数据源绑定至数据开发（DataStudio）。

  说明

  仅当Hologres实例和DataWorks工作空间同地域、同账号时，基于该项目创建的数据源才可绑定至数据开发（DataStudio）。

• 进行数据同步：

  DataWorks的数据集成模块为您提供读取和写入数据至Hologres的能力，您可将其他数据源的数据同步至当前Hologres数据源，或将当前Hologres数据源的数据同步至其他数据源。同时，可根据需要选择离线同步、实时同步、同步解决方案等场景执行相关数据同步操作。

• 增删改查数据源：进入数据源管理页面执行编辑、删除等管理操作。