连接DWS数仓集群常用方法介绍

举报
Reus` 发表于 2025/01/07 11:18:36 2025/01/07
【摘要】 详细介绍DWS集群连接地址获取方式，客户端工具Data Studio、DataArts Studio以及Linux和Windows下的gsql连接DWS集群，以及第三方工具Navicat和DBeaver连接DWS集群的方法。

连接DWS数仓集群常用方法介绍

1. 前言

适用版本：【830.100（及以上/以下）】
详细介绍DWS集群连接地址获取方式，客户端工具Data Studio、DataArts Studio以及Linux和Windows下的gsql连接DWS集群，以及第三方工具Navicat和DBeaver连接DWS集群的方法。

2. 连接前准备

GaussDB(DWS)支持不同方式连接集群，不同连接方式的连接地址也不同。支持查看并获取华为云平台环境的内网连接地址、互联网环境的公网连接地址和JDBC连接字符串。
获取集群连接地址有以下两种方式：

2.1 在连接客户端页面获取集群连接地址

  1. 登录GaussDB(DWS)管理控制台。
  2. 在左侧导航栏中，选择“管理 > 连接客户端”。
  3. 在“数据仓库连接信息”区域，选择一个可用的集群名称，只能选择状态为“可用”的集群。


查看并获取集群的连接信息：
“公网IP ”
“弹性负载均衡地址”
“JDBC连接字符串（内网）”
“JDBC连接字符串（公网）”
“ODBC连接字符串”

说明：

(1). 如果创建集群时没有自动绑定弹性IP，“公网IP”显示为空。如果您想使用公网访问地址（由弹性IP和数据库端口组成）从互联网访问集群，可以单击“绑定弹性IP”为集群绑定弹性IP。
(2). 如果创建集群时绑定了弹性IP，如果您不想使用公网访问地址访问集群，可以单击“解绑弹性IP”为集群解绑弹性IP。弹性IP解绑后，“公网IP”显示为空。
EIP应用场景：绑定到弹性云服务器上，实现弹性云服务器连接公网的目的。
(3). 如果创建集群时没有绑定弹性负载均衡，“弹性负载均衡地址”显示为空，可以单击“绑定弹性负载均衡”进行绑定，解决CN单点故障。
ELB应用场景：对于业务量访问较大的业务，可以通过ELB设置相应的分配策略，将访问量均匀的分到多个后端服务器处理。例如大型门户网站，移动应用市场等。
(4). 如果集群绑定了弹性负载均衡，为保证集群高可用，请优先使用弹性负载均衡地址连接集群。
(5). 如果集群开启了IPv6双栈网络功能，则内网IP既有IPv4，也有IPv6，您可根据需要选择IPv4或IPv6进行DWS集群的连接。

2.2 在“集群详情”页面获取集群连接地址

  1. 在集群列表中，单击指定集群的名称，打开“集群详情”页面。


2. 在“连接信息”区域，用户可以查看并获取集群的连接地址信息，包括内网地址、公网地址等。

2.3 设置安全组

  1. GaussDB(DWS)集群的安全组规则需要确保GaussDB(DWS)能接收来自客户端的网络访问，请确认GaussDB(DWS)集群的安全组中存在符合如下要求的规则，如果不存在，请在GaussDB(DWS)集群的安全组中添加相应的规则。
    方向：入方向。

协议： 必须包含TCP。例如，TCP、全部。
端口： 设置为GaussDB(DWS)集群提供服务的数据库端口。例如，“8000”。
源地址： 设置的IP地址需要包含GaussDB(DWS)客户端主机的IP地址。例如，“192.168.0.10/32”。

  1. 若使用到弹性云服务器ECS，请确认弹性云服务器的安全组中存在符合如下要求的规则，如果不存在，请在弹性云服务器的安全组中添加相应的规则：
    方向：出方向。

协议： 必须包含TCP。例如TCP、全部。
端口： 需要包含GaussDB(DWS)集群提供服务的数据库端口，例如，设置为“1-65535”或者具体的GaussDB(DWS)数据库端口。
目的地址： 设置的IP地址需要包含所要连接的GaussDB(DWS)集群的连接地址。

2.4 下载JDBC或ODBC驱动

JDBC或ODBC驱动程序用于连接GaussDB(DWS)集群，用户可以在管理控制台下载GaussDB(DWS)提供的JDBC或ODBC驱动程序，也可以使用开源的JDBC或ODBC驱动程序。
1.登录GaussDB(DWS)管理控制台。
2.在左侧导航栏中，单击“连接客户端”。

3. 在“下载驱动程序”区域，选择一个驱动下载。

2.4.1 JDBC驱动


选择“DWS JDBC Driver”，然后单击“下载”可以下载与现有集群版本匹配的JDBC驱动。驱动包名为“dws_8.1.x_jdbc_driver.zip”，解压后有两个JDBC的驱动jar包，分别为“gsjdbc4.jar”和“gsjdbc200.jar”，优先选择“gsjdbc200.jar”。

  • gsjdbc4.jar：与PostgreSQL保持兼容，其中类名、类结构与PostgreSQL驱动完全一致，曾经运行于PostgreSQL的应用程序可以直接移植到当前系统中使用。
  • gsjdbc200.jar：如果同一JVM进程内需要同时访问PostgreSQL及GaussDB(DWS)请使用该驱动包。该包主类名为“com.huawei.gauss200.jdbc.Driver”（即将“org.postgresql”替换为“com.huawei.gauss200.jdbc”） ，数据库连接的URL前缀为“jdbc:gaussdb”，其余与gsjdbc4.jar相同。

如果同时拥有不同版本的集群，单击“下载”时会下载与集群最低版本相对应的JDBC驱动。如果当前没有集群，单击“下载”时将下载到低版本的JDBC驱动。GaussDB(DWS)集群可向下兼容低版本的JDBC驱动。单击“历史版本”可根据集群版本下载相应版本的JDBC驱动，建议按集群版本进行下载。
使用JDBC连接 https://support.huaweicloud.com/mgtg-dws/dws_01_0077.html

2.4.2 ODBC驱动

选择相应的版本，然后单击“下载”可以下载与集群版本匹配的ODBC驱动。如果同时拥有不同版本的集群，单击“下载”时会下载与集群最低版本相对应的ODBC驱动。如果当前没有集群，单击“下载”时将下载到低版本的ODBC驱动。GaussDB(DWS)集群可向下兼容低版本的ODBC驱动。
单击“历史版本”可根据操作系统和集群版本下载相应版本的ODBC驱动，建议按集群版本进行下载。
使用ODBC连接 https://support.huaweicloud.com/mgtg-dws/dws_01_0086.html

3. 使用客户端工具连接集群

3.1 使用Data Studio连接到集群数据库

  1. GaussDB(DWS)提供了基于Windows平台的Data Studio图形界面客户端，该工具依赖JDK，JDK下载地址：(https://www.oracle.com/java/technologies/downloads/#java8)
  2. 登录GaussDB(DWS)管理控制台。
    3 .选择“管理 > 连接客户端”。
  3. 在“下载客户端和驱动”页面，下载“Data Studio图形界面客户端”。
    请根据操作系统类型，选择“Windows x86”或“Windows x64”，再单击“下载”，可以下载与现有集群版本匹配的Data Studio工具。
    如果同时拥有不同版本的集群，单击“下载”时会下载与集群最低版本相对应的Data Studio工具。如果当前没有集群，单击“下载”时将下载到低版本的Data Studio工具。GaussDB(DWS)集群可向下兼容低版本的Data Studio工具。
    单击“历史版本”可根据集群版本下载相应版本的Data Studio工具，建议按集群版本下载配套的工具。
    图1 下载客户端

    如果同时拥有不同版本的集群，系统会弹出对话框，提示您选择“集群版本”然后下载与集群版本相对应的客户端。在“集群 > 专属集群”页面的集群列表中，单击指定集群的名称，再选择“集群详情”页签，可查看集群版本。
  4. 解压下载的客户端软件包（32位或64位）到需要安装的路径。
  5. 打开安装目录，双击Data Studio.exe，启动Data Studio客户端，如图所示。
  6. 在主菜单中选择 “文件 > 新建连接” ，如图所示。
  7. 在弹出的“新建/选择数据库连接”页面中，如下图所示，输入连接参数。
  8. 单击“确定”建立数据库连接。
    登录成功后，将弹出“最近登录活动”提示框，表示Data Studio已经连接到数据库。用户即可在Data Studio界面的“SQL终端”窗口中执行SQL语句。

3.2 DataArts Studio连接GaussDB(DWS)集群

创建数据连接

  1. 登录DataArts Studio管理控制台。
  2. 在DataArts Studio控制台首页，选择对应工作空间的“管理中心”模块，进入管理中心页面。
  3. 在管理中心页面，单击“数据连接”，进入数据连接页面并单击“创建数据连接”。
  4. 单击“创建数据连接”，在弹出的页面中，选择“数据连接类型”为“数据仓库服务（DWS）”，
    **数据连接名称：**数据连接的名称，只能包含字母、数字、下划线和中划线，且长度不超过100个字符。
    **适用组件：**选择此连接适用的组件。勾选组件后，才能在相应组件内使用本连接。

    SSL加密：
    开关打开，即只能通过SSL方式进行通信。
    开关关闭，SSL通道加密和证书认证两种方式均可进行通信。
    手动： 选择连接模式。
    DWS集群名： 输入集群名称
    KMS密钥： 通过KMS加解密数据源认证信息，选择KMS中的任一默认密钥或自定义密钥即可。
    绑定Agent： DWS为非全托管服务，DataArts Studio无法直接与非全托管服务进行连接。CDM集群提供了DataArts Studio与非全托管服务通信的代理，所以创建DWS的数据连接时，请选择一个CDM集群。如果没有可用的CDM集群，请先进行创建。
    用户名： 数据库的用户名，创建DWS集群时指定的用户名。
    密码： 数据库的访问密码，创建DWS集群时指定的密码。
  5. 单击“测试”，测试数据连接的连通性。如果无法连通，数据连接将无法创建。
  6. 测试通过后，单击“确定”，创建数据连接。

3.3 Linux gsql客户端连接集群

  1. 在Linux命令窗口，执行以下命令下载Linux gsql客户端：
    wget https://obs.cn-north-1.myhuaweicloud.com/dws/download/dws_client_8.1.x_redhat_x64.zip
  2. 执行以下命令解压客户端工具。
    cd <客户端存放路径>
    unzip dws_client_8.1.x_redhat_x64.zip
    其中：

<客户端存放路径>：请替换为实际的客户端存放路径。
dws_client_8.1.x_redhat_x64.zip：“RedHat x64”对应的客户端工具包名称，请替换为实际下载的包名。
3. 执行以下命令配置客户端。
source gsql_env.sh
提示以下信息表示客户端已配置成功。
All things done.
4. 执行以下命令，使用gsql客户端连接GaussDB(DWS)集群中的数据库。
gsql -d <数据库名称> -h <集群地址> -U <数据库用户> -p <数据库端口> -W <集群密码> -r
参数说明如下：
“数据库名称”： 输入所要连接的数据库名称。首次使用客户端连接集群时，请指定为集群的默认数据库“gaussdb”。
“集群地址”： 请参见获取GaussDB(DWS)集群连接地址进行获取。如果通过公网地址连接，请指定为集群“公网访问地址”或“公网访问域名”，如果通过内网地址连接，请指定为集群“内网访问地址”或“内网访问域名”。如果通过弹性负载均衡连接，请指定为“弹性负载均衡地址”。
“数据库用户”： 输入集群数据库的用户名。首次使用客户端连接集群时，请指定为创建集群时设置的默认管理员用户，例如“dbadmin”。
“数据库端口”： 输入创建集群时设置的“数据库端口”。
例如，执行以下命令连接GaussDB(DWS)集群的默认数据库gaussdb：
gsql -d gaussdb -h 10.168.0.74 -U dbadmin -p 8000 -W password -r
显示如下信息表示gsql工具已经连接成功：
gaussdb=>

3.4 Windows gsql客户端连接集群

用户在创建好数据仓库集群，开始使用集群数据库之前，需要使用数据库SQL客户端连接到数据库。GaussDB(DWS)提供了与集群版本配套的Windows gsql命令行客户端工具，您可以使用Windows gsql客户端通过集群的公网地址或者内网地址访问集群。
操作步骤

  1. 在计算机本地Windows操作系统服务器（Windows cmd）中安装和运行gsql客户端。Windows操作系统支持Windows Server 2008/Windows 7及以上。
    2.下载Windows gsql客户端，并将压缩包解压到本地文件夹中。
    https://support.huaweicloud.com/mgtg-dws/dws_01_0031.html，
    图1 Windows gsql客户端文件夹

  2. 在本地主机单击“开始”并搜索“cmd”用管理员身份运行或单击快捷键“Win+R”打开Windows cmd窗口。

  3. 设置环境变量，32位选择x86文件夹；64位选择x64文件夹。
    方式一：命令行设置环境变量，打开Windows cmd窗口，执行set path=<window gsql>;%path%，其中<window gsql>为上一步骤解压Windows gsql客户端的文件夹路径。例如：
    set path=C:\Users\xx\Desktop\dws_8.1.x_gsql_for_windows\x64;%path%
    方式二：在控制面板中选择“系统 > 高级系统设置 > 高级 > 环境变量”，在系统环境变量Path中增加gsql路径。例如：
    图2 设置Windows环境变量

  4. 在Windows cmd窗口执行以下命令，使用gsql客户端连接GaussDB(DWS)集群中的数据库。
    gsql -d <数据库名称> -h <集群地址> -U <数据库用户> -p <数据库端口> -W <集群密码> -r
    参数说明如下：
    “数据库名称”： 输入所要连接的数据库名称。首次使用客户端连接集群时，请指定为集群的默认数据库“gaussdb”。
    “集群地址”： 请参见获取GaussDB(DWS)集群连接地址进行获取。如果通过公网地址连接，请指定为集群“公网访问地址”或“公网访问域名”，如果通过内网地址连接，请指定为集群“内网访问地址”或“内网访问域名”。如果通过弹性负载均衡连接，请指定为“弹性负载均衡地址”。
    “数据库用户”： 输入集群数据库的用户名。首次使用客户端连接集群时，请指定为创建集群时设置的默认管理员用户，例如“dbadmin”。
    “数据库端口”： 输入创建集群时设置的“数据库端口”。
    例如，执行以下命令连接GaussDB(DWS)集群的默认数据库gaussdb：
    gsql -d gaussdb -h 10.168.0.74 -U dbadmin -p 8000 -W password -r
    显示如下信息表示gsql工具已经连接成功：
    gaussdb=>

4. 第三方工具连接集群

4.1 Navicat连接GaussDB(DWS)集群

  1. 打开Navicat Premium，单击连接 > 华为 > 华为云 云数据仓库 GaussDB(DWS)。
    图1 新建连接
  2. 在“新建连接”界面，输入正确的连接名、主机，端口，初始数据库，用户名和密码。
    图2 华为云 云数据仓库 GaussDB(DWS)连接信息
  3. 最后点击“确定”;也可以先点击“测试连接”,确认是否连接成功后,再点击“确定”。

4.2 DBeaver连接GaussDB(DWS)集群

DBeaver下载： https://dbeaver.io/download/
DWS驱动下载链接： https://support.huaweicloud.com/mgtg-dws/dws_01_0032.html

  1. 点击数据库>驱动管理器

  1. 新建目标数据库连接驱动

  1. 填写驱动信息
    驱动名称: GS-DWS # 自定义名称
    驱动类型： Generic # 默认即可
    类名： org.postgresql.Driver # 固定写法
    URL模板： jdbc:postgresql://{host}[:{port}]/[{database}] # 固定写法
    默认端口: 8000 # 默认即可

  1. 手动添加jdbc.jar包

  1. 在DBeaver客户端单击，打开创建连接界面。在SQL页签中，选择GaussDB数据库，单击“下一步”。

  1. 输入主机IP地址，端口，数据库名，用户名和密码。

5. 总结

通过本文的介绍，用户可以了解到如何获取GaussDB(DWS)集群的连接地址以及如何使用不同的工具进行连接，从而更加方便地进行数据库操作。

  1. 在获取集群连接地址方面，可以通过连接客户端页面或者集群详情页面来获取。
  2. 在设置安全组方面，需要进行相应的配置以确保连接的安全性。
  3. 在驱动方面，可以选择下载对应版本的JDBC驱动或者ODBC驱动。
  4. 在使用第三方工具连接DWS集群方面，可以使用Navicat或者DBeaver等工具来连接GaussDB(DWS)集群。这些工具提供了便捷的界面和功能，方便用户进行数据库操作。
  5. 在使用客户端工具连接DWS集群方面，可以使用Data Studio、DataArts Studio、gsql来连接DWS集群，用户可以根据自己的需求选择合适的工具进行连接。

如有疑问，可参考华为云GaussDB（DWS）官方网站：https://support.huaweicloud.com/dws/index.html

【声明】本内容来自华为云开发者社区博主，不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源（华为云社区）、文章链接、文章作者等基本信息，否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容，欢迎发送邮件进行举报，并提供相关证据，一经查实，本社区将立刻删除涉嫌侵权内容，举报邮箱： cloudbbs@huaweicloud.com
云数据仓库 GaussDB(DWS)
  • 点赞
  • 收藏
  • 关注作者

评论（0）

0/1000
抱歉，系统识别当前为高风险访问，暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称，即可参与社区互动！

*长度不超过10个汉字或20个英文字符，设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符，设置后3个月内不可修改。

确认 取消

加入云驻计划，成为创作者

  • 华为云周边好礼
  • 免费体验产品
  • 特殊身份标识
  • 线下官方门票
  • 内部专家零距离
  • 与10000+优质创作者共同成长
立即加入