本文将为您介绍如何将实时数仓(Hologres)实例绑定至DataWorks工作空间。

前提条件

  1. 使用DataStudio前,请确保已经成功开通Hologres实例,详情请参见购买Hologres
  2. 实例创建成功后会默认生成一个名叫postgres的数据库,仅供管理用途,实际业务需要您新建一个数据库。

新建工作空间绑定Hologres实例

若您在此之前并未开通DataWorks工作空间,可以按照以下步骤来绑定实例。

  1. 进入DataWorks管控台

    使用阿里云账号进入DataWorks管控台,选择与实例同一个region,单击左侧菜单栏工作空间列表进行新建工作空间。

    工作空间列表
  2. 新建工作空间

    在工作空间列表页面单击创建工作空间,输入工作空间名称,模式选择可根据项目情况选择,生产、开发环境隔离选择表示标准模式,选择表示简单模式(详情请参见必读:简单模式和标准模式的区别)。单击提交

    创建工作空间
  3. 绑定计算引擎

    单击Hologres所在行的立即绑定,进入绑定Hologres数据库界面。

    绑定计算引擎
  4. 计算引擎绑定配置

    填写实例信息,当前标准版的工作空间分开发环境和生产环境,以保证数据的安全性。单击绑定并进入下一步,最后在环境初始化页签单击完成即可成功绑定Hologres数据库。

    绑定计算引擎
    环境 配置项 说明
    资源显示名 自定义名称。
    生产环境 Hologres实例 下拉框可选。
    Hologres数据库 需要绑定的数据库名称,实例创建后有一个名为postgres的默认DB(仅供管理用途),实际业务使用请前往Hologres管理控制台新建Database。
    调度访问身份 DataWorks中的Hologres任务被提交调度后,作为在Hologres引擎内执行代码的身份(账号),有如下两种身份。
    • 阿里云主账号:阿里云账号。
    • 阿里云子账号:阿里云RAM用户。
    账号详情请参见账号概述
    开发环境 Hologres实例 下拉框可选。
    Hologres数据库 需要绑定的数据库,建议绑定开发环境的数据库。
    页面访问身份 任务执行者。
  5. 进入DataStudio

    单击前往DataStudio进行数据开发即可跳转至DataStudio。

选择已有工作空间绑定Hologres实例

若您已有DataWorks项目空间,可将实例绑定至该工作空间。具体操作步骤如下。

说明 工作空间和开通的Hologres实例必须在同一region才能成功绑定。
  1. 进入工作空间
    DataWorks管控台,单击工作空间列表工作空间列表
  2. 工作空间配置

    在工作空间列表,鼠标悬停至相应工作空间后的更多图标,单击工作空间配置,进入工作空间配置页面,在计算引擎信息选择Hologres,并单击绑定HologresDB进行实例的绑定。

    工作空间配置
  3. 绑定Hologres实例
    根据下图指引配置引擎信息。Hologres参数说明如下。
    参数 描述 相关文档
    实例显示名称 定义当前计算引擎在DataWorks中作为引擎实例的显示名称,该名称必须唯一。
    环境说明
    • 标准模式的工作空间:区分开发环境生产环境,您需分别配置相应环境的信息。不同环境的配置可以不同。
      • 开发环境:通常用于测试任务执行。例如,数据开发(DataStudio)模块。
      • 生产环境:通常用于任务自动调度。例如,生产运维中心。
    • 简单模式的工作空间:不区分环境,环境的配置信息同生产环境
    必读:简单模式和标准模式的区别
    访问身份
    • 生产环境
      DataWorks任务提交调度后,作为在Hologres引擎内执行代码的身份(账号)。阿里云主账号默认具备该身份,您也可选择为指定阿里云子账号(即RAM用户)赋予该身份。选择使用哪类账号执行任务,将影响后续的数据安全与权限控制。
      说明 生产环境的访问身份,需拥有该环境下项目或引擎的最大权限,若将RAM用户设置为执行代码的账号,需授权该RAM用户Hologres实例的相关操作权限。
    • 开发环境

      用于在DataWorks任务开发界面运行任务、执行开发环境冒烟测试时的身份(账号)。默认为任务执行者

    授权RAM用户相关权限
    引擎信息 为当前DataWorks工作空间绑定的Hologres引擎实例和数据库信息。选择实例后将自动展示该实例的服务器和端口信息。
    • 标准模式工作空间下,为实现开发生产隔离,建议为这两个环境分别绑定不同的计算引擎实例及数据库。
    • Hologres实例创建后,自动生成一个名为postgres的数据库,仅用于管理。实际业务使用请创建新的数据库。
    创建数据库
  4. 进入DataStudio

    绑定Hologres实例后,返回工作空间列表页面,单击数据开发,即可进入DataStudio。

常见问题

  • 绑定Hologres实例按钮为灰色
    • 问题现象:绑定Hologres实例时,绑定HologresDB按钮为灰色。
    • 可能原因:
      • 当前账号不是所登录DataWorks项目空间的管理员。
      • 当前DataWorks绑定的计算引擎实例数量已达当前版本的上限。
    • 解决方法:
      • 联系DataWorks项目空间的管理员,将当前账号设置为项目管理员,即可添加Hologres实例。
      • 给DataWorks项目空间的管理员授予Hologres实例权限,再使用DataWorks项目的管理员添加Hologres实例。
      • 解绑已绑定到DataWorks的计算引擎实例或升级DataWorks版本,不同DataWorks版本支持绑定的计算引擎实例数量请参见各版本功能支持详情
  • 测试连通性不通过
    • 问题现象:绑定Hologres实例时,测试连通性提示不通过。
    • 可能原因:填写的绑定信息有误或者当前账号无Hologres实例权限。
    • 解决方法:
      • 实例显示名称可能在DataWorks里面有重复,可以更换一个显示名称。
      • 检查数据库名是否填写正确。
      • 检查填写的信息是否有空格,如果有空格,请删除空格。
      • 检查当前账号授予Hologres实例权限,再使用DataWorks项目的管理员添加Hologres实例。