华为云用户手册

获取驱动包 根据不同版本的实例，下载不同版本的发布包，如表1所示。 表1 驱动包下载列表 版本 下载地址 3.x 驱动包 驱动包校验包 2.x 驱动包 驱动包校验包 为了防止软件包在传递过程或存储期间被恶意篡改，下载软件包时需下载对应的校验包对软件包进行校验，校验方法如下： 上传软件包和软件包校验包到虚拟机（Linux操作系统）的同一目录下。 执行如下命令，校验软件包完整性。 cat GaussDB _driver.zip.sha256 | sha256sum --check 如果回显OK，则校验通过。 GaussDB_driver.zip: OK

在Linux下使用ODBC连接数据库 下载驱动包。 Linux版本包名为GaussDB-Kernel_数据库版本号_操作系统版本号_64bit_Odbc.tar.gz。Linux环境下，开发应用程序要用到unixODBC提供的头文件（sql.h、sqlext.h等）和库libodbc.so。这些头文件和库可从unixODBC-2.3.7的安装包中获得。 Windows版本包名为GaussDB-Kernel_数据库版本号_Windows_Odbc_X64.tar.gz（64位）。Windows环境下，开发应用程序用到的相关头文件和库文件都由系统自带。 获取unixODBC源码包。 获取参考地址：https://gitee.com/src-openeuler/unixODBC/blob/openEuler-22.03-LTS-SP1/unixODBC-2.3.7.tar.gz。 下载后请先按照社区提供的完整性校验算法进行完整性校验。 安装unixODBC。如果机器上已经安装了其他版本的unixODBC，可以直接覆盖安装。 以unixODBC-2.3.7版本为例，在客户端执行如下命令安装unixODBC。 tar zxvf unixODBC-2.3.7.tar.gz cd unixODBC-2.3.7 ./configure --enable-gui=no #如果要在ARM服务器上编译，请追加一个configure参数： --build=aarch64-unknown-linux-gnu make #安装可能需要root权限 make install 目前不支持unixODBC-2.2.1版本。 默认安装在“/usr/local”目录下，生成数据源文件在“/usr/local/etc”目录下，库文件生成在“/usr/local/lib”目录。 通过编译含有--enable-fastvalidate=yes选项的unixODBC获得更高性能。但此选项可能会导致向ODBC API传递无效句柄的应用程序发生故障，而不是返回SQL_INVALID_HANDLE错误。 替换客户端GaussDB驱动程序。 将GaussDB-Kernel_数据库版本号_操作系统版本号_64bit_Odbc.tar.gz解压。解压后会得到两个文件夹：lib与odbc，在odbc文件夹中还会有一个lib文件夹。将解压后得到的/lib文件夹与/odbc/lib文件夹中的所有动态库都复制到“/usr/local/lib”目录下。 配置数据源。 配置ODBC驱动文件。 在“/usr/local/etc/odbcinst.ini”文件中追加以下内容。 [GaussMPP] Driver64=/usr/local/lib/psqlodbcw.so setup=/usr/local/lib/psqlodbcw.so odbcinst.ini文件中的配置参数说明如表3所示。 表3 odbcinst.ini文件配置参数 参数 描述 示例 [DriverName] 驱动器名称，对应数据源DSN中的驱动名。 [DRIVER_N] Driver64 驱动动态库的路径。 Driver64=/usr/local/lib/psqlodbcw.so setup 驱动安装路径，与Driver64中动态库的路径一致。 setup=/usr/local/lib/psqlodbcw.so 配置数据源文件。 在“/usr/local/etc/odbc.ini”文件中追加以下内容。 [gaussdb] Driver=GaussMPP Servername=127.0.0.1（数据库Server IP） Database=postgres （数据库名） Username=omm （数据库用户名） Password= （数据库用户密码） Port=8000 （数据库侦听端口） Sslmode=allow odbc.ini文件配置参数说明如表4 odbc.ini文件配置参数所示。 表4 odbc.ini文件配置参数 参数 描述 示例 [DSN] 数据源的名称。 [gaussdb] Driver 驱动名，对应odbcinst.ini中的DriverName。 Driver=DRIVER_N Servername 服务器的IP地址。可配置多个IP地址。 Servername=127.0.0.1 Database 要连接的数据库的名称。 Database=postgres Username 数据库用户名称。 Username=omm Password 数据库用户密码。 说明： ODBC驱动本身已经对内存密码进行过清理，以保证用户密码在连接后不会再在内存中保留。 但是如果配置了此参数，由于UnixODBC对数据源文件等进行缓存，可能导致密码长期保留在内存中。 推荐在应用程序连接时，将密码传递给相应API，而非写在数据源配置文件中。同时连接成功后，应当及时清理保存密码的内存段。 注意： 配置文件中填写密码时，需要遵循http规则： 字符应当采用URL编码规范，如"!"应写作"%21"，"%"应写作"%25"，因此应当特别注意字符。 "+"会被替换为空格" "。 Password=******** Port 服务器的端口号。当开启负载均衡时，可配置多个端口号，且需与配置的多IP一一对应。如果开启负载均衡配置多个IP时，仍只配置一个端口号，则默认所有IP共有同一个端口号，即为配置的端口号。 Port=8000 Sslmode 开启SSL模式 Sslmode=allow 其中关于Sslmode的选项的允许值，具体信息如表5所示。 表5 sslmode的可选项及其描述 sslmode 是否会启用SSL加密 描述 disable 否 不使用SSL安全连接。 allow 可能 如果数据库服务器要求使用，则可以使用SSL安全加密连接，但不验证数据库服务器的真实性。 prefer 可能 如果数据库支持，那么首选使用SSL安全加密连接，但不验证数据库服务器的真实性。 require 是 必须使用SSL安全连接，但是只做了 数据加密 ，并不验证数据库服务器的真实性。 verify-ca 是 必须使用SSL安全连接，并且验证数据库是否具有可信证书机构签发的证书。 verify-full 是 必须使用SSL安全连接，在verify-ca的验证范围之外，同时验证数据库所在主机的主机名是否与证书内容一致。如果不一致，需要使用root用户修改/etc/hosts文件，将连接数据库节点的IP地址和主机名加入。 说明： 此模式不支持产品默认证书，生成证书请联系管理员处理。 SSL模式。具体操作请联系管理员。 配置数据库服务器。具体操作请联系管理员。 在客户端配置环境变量。 vim ~/.bashrc 在配置文件中追加以下内容。 export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH export OD BCS YSINI=/usr/local/etc export ODBCINI=/usr/local/etc/odbc.ini 执行如下命令使设置生效。 source ~/.bashrc 执行以下命令，开始连接数据库。 isql -v GaussODBC GaussODBC为数据源名称 如果显示如下信息，表明配置正确，连接成功。 +---------------------------------------+ | Connected! | | | | sql-statement | | help [tablename] | | quit | | | +---------------------------------------+ 若显示ERROR信息，则表明配置错误。请检查上述配置是否正确。 若是集群环境，需要在所有机器上都复制配置一份unixODBC。

驱动类 在创建数据库连接之前，需要加载数据库驱动类“org.postgresql.Driver”（对应包gsjdbc4.jar）。 由于GaussDB在JDBC的使用上与PG的使用方法保持兼容，所以同时在同一进程内使用两个JDBC的驱动的时候，可能会造成类名冲突。 本版本JDBC不再支持 IAM 认证功能。 相比于PG驱动，GaussDB JDBC驱动主要做了以下特性的增强： 支持SHA256加密方式登录。 支持对接实现sf4j接口的第三方日志框架。 支持连接级别的分布式负载均衡。 支持容灾切换。

环境类 客户端需配置JDK1.8。JDK是跨平台的，支持Windows,Linux等多种平台，下面以Windows为例，介绍JDK配置流程： DOS窗口（windows下的命令提示符）输入“java -version”，查看JDK版本，确认为JDK1.8版本。如果未安装JDK，请下载安装包并安装。 在windows操作系统桌面中“此电脑”图标上单击右键，选择“属性”。 在弹出的“系统”窗口中，单击左侧导航栏中“高级系统设置”。 在弹出的“系统属性”窗口中，单击右下角的“环境变量”。 在弹出的“环境变量”窗口中的“系统变量”区域框中设置如下变量名和变量值。 表2 变量说明 变量名 操作 变量值 JAVA_HOME 若存在，则单击“编辑”。 若不存在，则单击“新建”。 JAVA的安装目录。 例如：C:\Program Files\Java\jdk1.8.0_131。 Path 单击“编辑”。 若配置了JAVA_HOME，则在变量值的最前面加上： %JAVA_HOME%\bin。 若未配置JAVA_HOME，则在变量值的最前面加上JAVA安装的全路径： C:\Program Files\Java\jdk1.8.0_131\bin。 CLASSPATH 单击“新建”。 %JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar。 单击“确定”，并依次关闭各窗口。

示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 //以下用例以gsjdbc4.jar为例。 //以下代码将获取数据库连接操作封装为一个接口，可通过给定用户名和密码来连接数据库。 public static Connection getConnect(String username, String passwd) { //驱动类。 String driver = "org.postgresql.Driver"; //数据库连接描述符。 String sourceURL = "jdbc:postgresql://$ip:$port/postgres"; Connection conn = null; try { //加载驱动。 Class.forName(driver); } catch( Exception e ) { e.printStackTrace(); return null; } try { //创建连接。 conn = DriverManager.getConnection(sourceURL, username, passwd); System.out.println("Connection succeed!"); } catch(Exception e) { e.printStackTrace(); return null; } return conn; }

获取驱动包 根据不同版本的实例，下载不同版本的发布包，如表1所示。 表1 驱动包下载列表 版本 下载地址 3.x 驱动包 驱动包校验包 2.x 驱动包 驱动包校验包 为了防止软件包在传递过程或存储期间被恶意篡改，下载软件包时需下载对应的校验包对软件包进行校验，校验方法如下： 上传软件包和软件包校验包到虚拟机（Linux操作系统）的同一目录下。 执行如下命令，校验软件包完整性。 cat GaussDB_driver.zip.sha256 | sha256sum --check 如果回显OK，则校验通过。 GaussDB_driver.zip: OK

加载驱动 在创建数据库连接之前，需要先加载数据库驱动程序。 加载驱动有两种方法： 在代码中创建连接之前任意位置隐含装载：在与数据库建立连接之前添加Class.forName("org.postgresql.Driver");，建立连接代码详见连接数据库示例章节。 在JVM启动时参数传递，指定驱动名字，适用于在DOS窗口或者Linux上执行Java代码。例如，java -Djdbc.drivers=org.postgresql.Driver jdbctest。 上述jdbctest为测试用例程序的名称。 当使用opengaussjdbc.jar时，上面的Driver类名相应修改为“com.huawei.opengauss.jdbc.Driver”。

GaussDB入门 实践 当您购买并连接到 GaussDB数据库 实例后，可以根据自身的业务需求使用GaussDB提供的一系列常用实践。 表1 GaussDB常用最佳实践 实践 描述 使用规范 数据库设计规范 介绍在使用GaussDB时，需要遵循的数据库对象命名规范、数据库设计规范、权限设计规范、表设计规范、字段设计规范、索引设计规范、函数/存储过程设计规范。 数据库编程规范 介绍在使用GaussDB时，需要遵循的GUC参数编程规范、 对象访问编程规范、WHERE、SELECT、INSERT、UPDATE、DELETE、关联查询、子查询、事务规范。 客户端编程规范 介绍在使用JDBC连接GaussDB时，需要遵循的编程规范。 数据库使用 创建数据库用户 介绍如何使用CREATE USER和ALTER USER语法创建和管理数据库用户。不通用的之间的数据并不共享。 创建和管理数据库 介绍使用CREATE DATABASE和ALTER DATABASE语法创建和管理数据库。 创建和管理表空间 通过使用表空间，管理员可以控制一个数据库安装的磁盘布局。介绍如何同SQL语法创建和管理表空间。 创建和管理表 表是建立在数据库中的，在不同的数据库中可以存放相同的表。可以通过使用模式在同一个数据库中创建相同名称的表。介绍如何使用SQL语法创建表。 查看系统表 除了创建的表以外，GaussDB还包含很多系统表。这些系统表包含集群安装信息以及GaussDB上运行的各种查询和进程的信息。介绍通过查询系统表来收集有关数据库的信息。 数据迁移 使用DRS迁移Oracle至GaussDB 介绍如何使用DRS将数据从Oracle迁移至GaussDB。 数据备份 设置自动备份策略 介绍如何在数据库实例的备份时段中创建数据库实例的自动备份，系统根据您指定的备份保留期保存数据库实例的自动备份。 手动创建全量备份 介绍如何手动为数据库实例备份数据，用户可以通过手动备份恢复数据，从而保证数据可靠性。 删除手动备份 GaussDB支持对实例级和表级手动备份进行删除，从而释放相关存储空间。介绍如何删除实例手动备份。 数据恢复 通过指定备份文件恢复GaussDB实例数据 介绍如何使用已有的自动备份和手动备份，将实例数据恢复到备份被创建时的状态。该操作恢复的为整个实例的数据。 通过指定时间点恢复GaussDB实例 介绍如何使用已有的自动备份，恢复实例数据到指定时间点。

步骤一：获取驱动包 获取驱动包和驱动包校验包。 根据不同版本的实例，下载对应版本的驱动包和驱动包校验包到本地任意目录，如表1所示。 表1 驱动包下载列表 版本 下载地址 3.x 驱动包 驱动包校验包 2.x 驱动包 驱动包校验包 校验驱动包。 为了防止驱动包在传递过程或存储期间被恶意篡改，需要对驱动包进行校验，校验方法如下： 使用快捷键“Win+R”打开“运行”窗口。 在“打开”栏，输入“cmd”，按“Enter”回车，打开命令行页面。 执行以下命令，获取驱动包的Hash值。 certutil -hashfile {驱动包本地目录}\{驱动包名} sha256 {驱动包本地目录}：请根据实际下载目录进行替换。例如：C:\Users {驱动包名}：请根据实际下载的驱动包名进行替换。例如：GaussDB_driver.zip 示例：certutil -hashfile C:\Users\GaussDB_driver.zip sha256 将2.b获取到的Hash值和1中获取到的驱动包校验包的Hash值进行比较。 若一致则通过校验。 若不一致，请重新下载驱动包，重复2.a~2.c进行校验。 解压驱动包。 将1中获取到的驱动包解压到本地， 找到gsjdbc4.jar包，放在本地任意目录下。

步骤四：连接数据库 在DBeaver客户端单击，打开创建连接界面。 搜索步骤三中创建的驱动，选中驱动，单击“下一步”。 图1 选择驱动 输入主机IP地址，端口，数据库名，用户名和密码。 表3 参数说明 参数 描述 主机 目标实例的内网地址。查看目标实例的内网地址及端口信息的步骤如下： 登录云数据库GaussDB的管理控制台。 选择目标实例所在区域。 单击目标实例名称，进入“基本信息”页面。 在“连接信息”模块，查看“弹性公网IP”信息。 如果未绑定弹性公网IP，那么您需要为数据库实例绑定弹性公网IP。具体操作请参考绑定弹性公网IP。 端口 需要连接的数据库端口。创建实例时自定义的端口，GaussDB实例的默认端口为8000。 数据库/模式 需要连接的数据库名。实例创建成功后，会默认生成名称为postgres的数据库。 用户名 需要访问GaussDB实例的账号名称。默认root。 密码 要访问GaussDB实例的账号所对应的密码。 单击“测试链接”。若弹框中显示“已连接”，则说明可正常连接，单击“确定”。 单击“完成”，即可连接到数据库。在“数据库导航”栏可查看到连接的数据库信息。

连接数据库 准备相关驱动和依赖库。可以从发布包中获取，包名为GaussDB-Kernel_数据库版本号_操作系统版本号_64bit_Python.tar.gz。 解压后有两个文件夹： psycopg2：psycopg2库文件。 lib：lib库文件。 加载驱动。 在使用驱动之前，需要做如下操作： 先解压版本对应驱动包。 tar zxvf xxxx-Python.tar.gz 使用root用户将psycopg2复制到python安装目录下的site-packages文件夹下。 su root cp psycopg2 $(python3 -c 'import site; print(site.getsitepackages()[0])') -r 修改psycopg2目录权限为755。 chmod 755 $(python3 -c 'import site; print(site.getsitepackages()[0])')/psycopg2 -R 将psycopg2目录添加到环境变量$PYTHONPATH，并使之生效。 export PYTHONPATH=$(python3 -c 'import site; print(site.getsitepackages()[0])'):$PYTHONPATH 对于非数据库用户，需要将解压后的lib目录，配置在LD_LIBRARY_PATH中。 export LD_LIBRARY_PATH=path/to/lib:$LD_LIBRARY_PATH 在创建数据库连接之前，需要先加载如下数据库驱动程序： 1 import psycopg2 连接数据库。 非SSL方式连接数据库： 使用psycopg2.connect函数获得connection对象。 使用connection对象创建cursor对象。 SSL方式连接数据库： 用户通过psycopy2连接GaussDB服务器时，可以通过开启SSL加密客户端和服务器之间的通讯。在使用SSL时，默认用户已经获取了服务端和客户端所需要的证书和私钥文件，关于证书等文件的获取请参见Openssl相关文档和命令。 使用*.ini文件（python的configparser包可以解析这种类型的配置文件）保存数据库连接的配置信息。 在连接选项中添加SSL连接相关参数：sslmode、sslcert、sslkey、sslrootcert。 sslmode：可选项见表3。 sslcert：客户端证书路径。 sslkey：客户端密钥路径。 sslrootcert：根证书路径。 使用psycopg2.connect函数获得connection对象。 使用connection对象创建cursor对象。 使用SSL安全连接数据库，需保证所使用的python解释器为生成动态链接库（.so）文件的方式编译，可通过如下步骤确认python解释器的连接方式。 在python解释器命令行中输入import ssl，导入SSL。 执行ps ux查询python解释器运行的pid（假设pid为******）。 在python解释器命令行中执行pmap -p ****** | grep ssl，查看返回结果中是否包含libssl.so的相关路径。如果有，则python解释器为动态链接方式编译。 表3 sslmode的可选项及其描述 sslmode 是否会启用SSL加密 描述 disable 否 不使用SSL安全连接。 allow 可能 如果数据库服务器要求使用，则可以使用SSL安全加密连接，但不验证数据库服务器的真实性。 prefer 可能 如果数据库支持，那么首选使用SSL连接，但不验证数据库服务器的真实性。 require 是 必须使用SSL安全连接，但是仅进行数据加密，而并不验证数据库服务器的真实性。 verify-ca 是 必须使用SSL安全连接，并且校验服务端CA有效性。 verify-full 是 必须使用SSL安全连接，目前GaussDB暂不支持。

获取驱动包 根据不同版本的实例，下载不同版本的发布包，如表1所示。 表1 驱动包下载列表 版本 下载地址 3.x 驱动包 驱动包校验包 2.x 驱动包 驱动包校验包 为了防止软件包在传递过程或存储期间被恶意篡改，下载软件包时需下载对应的校验包对软件包进行校验，校验方法如下： 上传软件包和软件包校验包到虚拟机（Linux操作系统）的同一目录下。 执行如下命令，校验软件包完整性。 cat GaussDB_driver.zip.sha256 | sha256sum --check 如果回显OK，则校验通过。 GaussDB_driver.zip: OK

获取驱动包 根据不同版本的实例，下载不同版本的发布包，如表1所示。 表1 驱动包下载列表 版本 下载地址 3.x 驱动包 驱动包校验包 2.x 驱动包 驱动包校验包 为了防止软件包在传递过程或存储期间被恶意篡改，下载软件包时需下载对应的校验包对软件包进行校验，校验方法如下： 上传软件包和软件包校验包到虚拟机（Linux操作系统）的同一目录下。 执行如下命令，校验软件包完整性。 cat GaussDB_driver.zip.sha256 | sha256sum --check 如果回显OK，则校验通过。 GaussDB_driver.zip: OK

连接数据库 准备相关驱动和依赖库。可以从发布包中获取，包名为GaussDB-Kernel_数据库版本号_操作系统版本号_64bit_Python.tar.gz。 解压后有两个文件夹： psycopg2：psycopg2库文件。 lib：lib库文件。 加载驱动。 在使用驱动之前，需要做如下操作： 先解压版本对应驱动包。 tar zxvf xxxx-Python.tar.gz 使用root用户将psycopg2复制到python安装目录下的site-packages文件夹下。 su root cp psycopg2 $(python3 -c 'import site; print(site.getsitepackages()[0])') -r 修改psycopg2目录权限为755。 chmod 755 $(python3 -c 'import site; print(site.getsitepackages()[0])')/psycopg2 -R 将psycopg2目录添加到环境变量$PYTHONPATH，并使之生效。 export PYTHONPATH=$(python3 -c 'import site; print(site.getsitepackages()[0])'):$PYTHONPATH 对于非数据库用户，需要将解压后的lib目录，配置在LD_LIBRARY_PATH中。 export LD_LIBRARY_PATH=path/to/lib:$LD_LIBRARY_PATH 在创建数据库连接之前，需要先加载如下数据库驱动程序： 1 import psycopg2 连接数据库。 非SSL方式连接数据库： 使用psycopg2.connect函数获得connection对象。 使用connection对象创建cursor对象。 SSL方式连接数据库： 用户通过psycopy2连接GaussDB服务器时，可以通过开启SSL加密客户端和服务器之间的通讯。在使用SSL时，默认用户已经获取了服务端和客户端所需要的证书和私钥文件，关于证书等文件的获取请参见Openssl相关文档和命令。 使用*.ini文件（python的configparser包可以解析这种类型的配置文件）保存数据库连接的配置信息。 在连接选项中添加SSL连接相关参数：sslmode、sslcert、sslkey、sslrootcert。 sslmode：可选项见表3。 sslcert：客户端证书路径。 sslkey：客户端密钥路径。 sslrootcert：根证书路径。 使用psycopg2.connect函数获得connection对象。 使用connection对象创建cursor对象。 使用SSL安全连接数据库，需保证所使用的python解释器为生成动态链接库（.so）文件的方式编译，可通过如下步骤确认python解释器的连接方式。 在python解释器命令行中输入import ssl，导入SSL。 执行ps ux查询python解释器运行的pid（假设pid为******）。 在python解释器命令行中执行pmap -p ****** | grep ssl，查看返回结果中是否包含libssl.so的相关路径。如果有，则python解释器为动态链接方式编译。 表3 sslmode的可选项及其描述 sslmode 是否会启用SSL加密 描述 disable 否 不使用SSL安全连接。 allow 可能 如果数据库服务器要求使用，则可以使用SSL安全加密连接，但不验证数据库服务器的真实性。 prefer 可能 如果数据库支持，那么首选使用SSL连接，但不验证数据库服务器的真实性。 require 是 必须使用SSL安全连接，但是仅进行数据加密，而并不验证数据库服务器的真实性。 verify-ca 是 必须使用SSL安全连接，并且校验服务端CA有效性。 verify-full 是 必须使用SSL安全连接，目前GaussDB暂不支持。

获取驱动包 根据不同版本的实例，下载不同版本的发布包，如表1所示。 表1 驱动包下载列表 版本 下载地址 3.x 驱动包 驱动包校验包 2.x 驱动包 驱动包校验包 为了防止软件包在传递过程或存储期间被恶意篡改，下载软件包时需下载对应的校验包对软件包进行校验，校验方法如下： 上传软件包和软件包校验包到虚拟机（Linux操作系统）的同一目录下。 执行如下命令，校验软件包完整性。 cat GaussDB_driver.zip.sha256 | sha256sum --check 如果回显OK，则校验通过。 GaussDB_driver.zip: OK

加载驱动 在创建数据库连接之前，需要先加载数据库驱动程序。 加载驱动有两种方法： 在代码中创建连接之前任意位置隐含装载在与数据库建立连接之前添加Class.forName("org.postgresql.Driver");，建立连接代码详见连接数据库示例章节。 在JVM启动时参数传递，指定驱动名字，适用于在DOS窗口或者Linux上执行Java代码。例如，java -Djdbc.drivers=org.postgresql.Driver jdbctest。 上述jdbctest为测试用例程序的名称。

环境类 客户端需配置JDK1.8，配置方法如下： DOS窗口（windows下的命令提示符）输入“java -version”，查看JDK版本，确认为JDK1.8版本。如果未安装JDK，请从官方网站下载安装包并安装。 根据如下步骤配置系统环境变量。 右键单击“我的电脑”，选择“属性”。 在“系统”页面左侧导航栏单击“高级系统设置”。 在“系统属性”页面，“高级”页签上单击“环境变量”。 在“环境变量”页面上，“系统变量”区域单击“新建”或“编辑”配置系统变量。变量说明请参见表2。 表2 变量说明 变量名 操作 变量值 JAVA_HOME 若存在，则单击“编辑”。 若不存在，则单击“新建”。 JAVA的安装目录。 例如：C:\Program Files\Java\jdk1.8.0_131。 Path 单击“编辑”。 若配置了JAVA_HOME，则在变量值的最前面加上： %JAVA_HOME%\bin。 若未配置JAVA_HOME，则在变量值的最前面加上JAVA安装的全路径： C:\Program Files\Java\jdk1.8.0_131\bin。 CLASSPATH 单击“新建”。 %JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar。

示例 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 //以下代码将获取数据库连接操作封装为一个接口，可通过给定用户名和密码来连接数据库。 public static Connection getConnect(String username, String passwd) { //驱动类。 String driver = "org.postgresql.Driver"; //数据库连接描述符。 String sourceURL = "jdbc:postgresql://$ip:$port/postgres"; Connection conn = null; try { //加载驱动。 Class.forName(driver); } catch( Exception e ) { e.printStackTrace(); return null; } try { //创建连接。 conn = DriverManager.getConnection(sourceURL, username, passwd); System.out.println("Connection succeed!"); } catch(Exception e) { e.printStackTrace(); return null; } return conn; }

获取驱动包 根据不同版本的实例，下载不同版本的发布包，如表1所示。 表1 驱动包下载列表 版本 下载地址 3.x 驱动包 驱动包校验包 2.x 驱动包 驱动包校验包 为了防止软件包在传递过程或存储期间被恶意篡改，下载软件包时需下载对应的校验包对软件包进行校验，校验方法如下： 上传软件包和软件包校验包到虚拟机（Linux操作系统）的同一目录下。 执行如下命令，校验软件包完整性。 cat GaussDB_driver.zip.sha256 | sha256sum --check 如果回显OK，则校验通过。 GaussDB_driver.zip: OK

L实例控制台集成的服务 增值服务 说明 相关操作 主机安全 仅支持主机安全基础版。 管理主机安全 云备份 仅支持服务器备份类型。 随L实例购买的云备份不支持单独解绑、退订。 如果您未随L实例购买云备份，您后续也可以在云备份控制台 购买云服务器 备份，对L实例备份数据。具体操作详见购买云服务器备份存储库。 在云备份控制台购买的云服务器备份支持解绑、删除或退订。 管理云备份 云耀负载均衡 云耀负载均衡只能和同区域下的L实例配套使用，不能单独使用。云耀负载均衡规格详见表6。 管理云耀负载均衡 云监控 L实例未包含云监控增值服务，请在云监控控制台安装Agent使用主机监控功能。 管理云监控 表6 云耀负载均衡规格 资源配置 规格 最大连接数 2000 每秒新建连接数 200 流量包 100GB 峰值带宽 2Mbit/s 云耀负载均衡中的流量包指的是每月固定流量。例如一个云耀负载均衡中流量包为100GB，指套餐中每个月都有100GB的流量。 用户业务消耗的流量优先抵扣云耀负载均衡中的流量包，超出流量包的部分为超额流量，采取按流量方式计费，计费单价为0.8元/GB。 峰值带宽表示实例可以达到的带宽峰值，该指标不作为业务承诺，仅作为参考值和带宽上限峰值，当出现资源争抢时，带宽峰值可能会受到限制。

HE CS 控制台集成的服务 HECS控制台提供了主机安全、云备份、云监控、云耀负载均衡服务，不同HECS控制台提供的服务不同。 增值服务 说明 主机安全（HSS） 主机安全（HSS）提升HECS整体安全性，通过入侵检测、漏洞管理、基线检查功能，可识别并管理云服务器中的信息资产，实时监测云服务器中的风险，降低服务器被入侵的风险。更多信息详见主机安全。 云备份（CBR） 云备份可以为云服务器、云硬盘提供简单易用的备份服务，当发生病毒入侵、人为误删除、软硬件故障等事件时，可将数据恢复到任意备份点。 更多信息详见云备份。 云监控（ CES ） 云监控服务 为您提供一个针对云服务器、带宽等资源的立体化监控平台。使您全面了解云上的资源使用情况、业务的运行状况，并及时收到异常告警做出反应，保证业务顺畅运行。更多信息详见云监控。 云耀负载均衡 云耀负载均衡是将公网访问流量根据转发规则分发到多台云耀云服务器的流量分发控制服务，可以通过流量分发扩展应用系统对外的服务能力。同时结合健康检查功能，流量只分发到后端正常工作的服务器来消除单点故障，进而提升应用系统的可靠性。 说明： 云耀负载均衡仅和L实例配套使用，不支持和其他HECS类型配套使用。

L实例网络配置 网络配置 说明 内网 创建L实例后，L实例默认配置固定的VPC，不支持自定义配置VPC。 同账号同区域的多台L实例默认处于同一个VPC中，内网互通。 同账号同区域的云资源（如ECS、云数据库等）和L实例处于同一VPC（VPC为vpc-default-smb）时，内网互通，否则内网不互通。内网不互通时，可通过对等连接实现内网互通，具体操作详见对等连接使用示例。 不同账号或不同区域的L实例、其他云资源均处于不同VPC中，默认内网不互通。 您可通过云连接，实现不同账号或不同区域间L实例与L实例或其他云资源（如ECS、云数据库等）内网互通，具体操作详见云连接。 您还可通过对等连接，实现同账号或者不同账号同区域间L实例与L实例或其他云资源（如ECS、云数据库等）内网互通，具体操作详见对等连接使用示例。 L实例不支持更换私有IP。 公网IP L实例创建后，默认分配一个固定的公网IP地址。 不支持解除、更换L实例的公网IP地址。 L实例被释放后不支持保留其公网IP地址。 L实例不支持配置IPv6地址。 流量包 L实例套餐包含每月流量包，超额流量（超出每月流量包的流量）按需计费。不支持单独购买、升级流量包。 弹性公网IP按流量计费，不支持变更弹性公网IP计费方式。 仅对出网流量（从服务器流出的流量）计费，入网流量（流入服务器的流量）不计费。 云耀云服务器L实例套餐流量包为月流量包。单月流量包使用周期为自购买日期起至下个月到期日的23:59:59。例如6月5日10:00:00购买云耀云服务器L实例，单月流量包使用截止时间为7月5日23:59:59。次月流量包使用周期为7月5日23:59:59~8月5日23:59:59，以此类推。 业务流量优先抵扣流量包，流量包固定流量使用完后将产生超额流量。超额流量以按流量计费的方式收取费用。超额流量的单价为0.8元/GB。 云耀云服务器L实例套餐中当月剩余流量按月清零，不累计至下月流量配额中。 退订、关机云耀云服务器L实例后，不再对超额流量计费。 云耀负载均衡未绑定云耀云服务器L实例时，不消耗云耀负载均衡的流量，消耗云耀云服务器L实例的流量。 云耀负载均衡绑定云耀云服务器L实例时，如果不经过云耀负载均衡直接通过EIP访问公网，消耗云耀云服务器L实例的流量；如果经过云耀负载均衡再通过EIP访问公网，消耗云耀负载均衡的流量。 公网峰值带宽 出网峰值带宽 L实例套餐内的峰值带宽指出网峰值带宽，即 云服务器访问外网 的最大带宽。 不支持单独变更峰值带宽。 说明： 峰值带宽表示实例可以达到的带宽峰值，该指标不作为业务承诺，仅作为参考值和带宽上限峰值，当出现资源争抢时，带宽峰值可能会受到限制。 入网峰值带宽 L实例套餐的出网峰值带宽如果是10Mbps及以下，入网的峰值带宽均为10Mbps。 L实例套餐的出网峰值带宽如果是10Mbps以上，入网的峰值带宽和出网峰值带宽相同。

X实例网络配置 网络配置 说明 内网 X实例支持自定义配置VPC。 同账号同区域，多台X实例若处于同一VPC，默认内网互通；若处于不同VPC，默认内网不互通。 不同账号或不同区域的X实例处于不同VPC中，默认内网不互通。 相同区域内的X实例可以通过对等连接实现内网互通；不同区域内的X实例可以通过云连接实现内网互通。 公网IP 购买X实例时，您可以自主选择是否购买弹性公网IP。您也可以后续购买并为服务器绑定弹性公网IP。 支持解绑、绑定弹性公网IP。 X实例被释放后不支持保留其公网IP地址。 X实例支持IPv6。 弹性公网IP计费方式 仅支持按需计费模式。 您可以选择按带宽计费、按流量计费或加入共享带宽多种计费方式。 支持修改带宽大小。

云耀云服务器X实例配置选型 您可以选择预置的X实例规格，也可以自定义选择vCPUs/内存规格。 表3 X实例配置选型 类型 实例规格 基准/最大带宽 内网收发包 预置规格 2vCPUs | 2G 0.2/2 Gbit/s 30万PPS 2vCPUs | 4G 0.2/2 Gbit/s 30万PPS 4vCPUs | 8G 0.4/3 Gbit/s 50万PPS 8vCPUs | 16G 0.8/6 Gbit/s 80万PPS 12vCPUs | 24G 1.2/8 Gbit/s 90万PPS 16vCPUs | 32G 1.6/12 Gbit/s 100万PPS 自定义vCPUs/内存规格 vCPUs：2/4/6/8/12/16 内存GiB：2/4/6/8/10/12/16/18/20/24/28/32/48/64 此处列举了vCPUs和内存的全量规格，不同vCPUs对应的内存范围不同，具体以控制台为准。 X实例根据不同的规格限制内网带宽和内网收发包能力。 内网基准带宽：指X实例能稳定达到的保证带宽。 内网最大带宽：指X实例能够达到的最大带宽。 内网最大收发包能力：指X实例能达到的最大收发包能力。

旧版云耀 云服务器配置 选型 旧版HECS将逐步下线，请优先选择L实例或X实例。 表4 云耀云服务器固定带宽配置选型 类型 实例规格 系统盘 带宽 入门型 1vCPUs | 1G 40GB 高IO 1Mbit/s 基本型 1vCPUs | 2G 40GB 高IO 1Mbit/s 进阶型 2vCPUs | 4G 40GB 高IO 2Mbit/s 随心购 您可以根据具体的业务场景自定义云服务器的规格，详见支持自定义的固定带宽套餐配置。 表5 支持自定义的固定带宽套餐配置 实例规格 云硬盘 带宽 1vCPUs | 1G 1vCPUs | 2G 2vCPUs | 4G 4vCPUs | 8G 8vCPUs | 16G 1vCPUs | 4G 2vCPUs | 8G 4vCPUs | 16G 8vCPUs | 32G 40GB 高IO 60GB 高IO 80GB 高IO 1 Mbit/s 2 Mbit/s 5 Mbit/s 10 Mbit/s 15 Mbit/s 暂不支持配置带宽

云硬盘 云硬盘（Elastic Volume Service，EVS）可以为HECS提供高可靠、高性能且可弹性扩展的块存储服务，满足不同场景的业务需求。云硬盘包括系统盘和数据盘。云耀云服务器默认包含一块系统盘。 了解更多云硬盘性能数据，请参考磁盘类型及性能介绍。 HECS类型 支持的云硬盘类型 说明 L实例 系统盘：高IO 数据盘：通用型SSD V2 L实例默认包含一块固定类型/容量的系统盘，您可根据业务需要配置数据盘。 一个L实例仅支持一块系统盘，最多支持一块数据盘。 不支持对系统盘单独进行新增、扩容、卸载、挂载等操作。如果您想扩容系统盘，仅支持通过升级实例规格扩容。 支持新增、扩容数据盘；不支持卸载或挂载已有数据盘。 X实例 系统盘/数据盘：普通IO、高IO、通用型SSD、超高IO、通用型SSD V2 X实例默认包含一块系统盘，您可根据业务需要配置系统盘、数据盘。 旧版HECS 系统盘：高IO 数据盘：高IO、超高IO、通用型SSD、极速型SSD、普通IO 旧版HECS默认包含一块固定类型/容量的系统盘，您可根据业务需要配置数据盘。仅支持新增包年/包月的数据盘。

云耀云服务器L实例规格 L实例以套餐形式整体售卖、管理， 套餐内资源统一退订、续费。创建后，不支持单独卸载、解绑或退订L实例中的流量包、云硬盘、云备份、主机安全等。 您可以选择预置的多种实例规格，并根据业务需要选择数据盘、主机安全或云备份服务，实例规格详见表1。 您也可以选择固定配置的云耀服务组合套餐，套餐规格详见表2 表1 L实例预置实例规格 云主机vCPU/内存规格 系统盘容量/类型 峰值带宽 | 流量包 随实例购买的服务（可选） 2vCPUs | 2G 40 GiB 高IO 2 Mbps | 200 GB 支持随L实例购买的服务： 数据盘：通用型SSD V2 | 自定义容量 主机安全：基础版 云备份：服务器备份 | 自定义存储库容量 2vCPUs | 2G 40 GiB 高IO 3 Mbps | 400 GB 2vCPUs | 2G 50 GiB 高IO 4 Mbps | 600 GB 2vCPUs | 4G 50 GiB 高IO 3 Mbps | 400 GB 2vCPUs | 4G 70 GiB 高IO 5 Mbps | 1000 GB 2vCPUs | 4G 80 GiB 高IO 6 Mbps | 1200 GB 2vCPUs | 4G 100 GiB 高IO 8 Mbps | 1600 GB 2vCPUs | 8G 120 GiB 高IO 10 Mbps | 2000 GB 4vCPUs | 8G 180 GiB 高IO 6 Mbps | 1200 GB 4vCPUs | 16G 180 GiB 高IO 10 Mbps | 2000 GB 表2 L实例云耀服务组合套餐 类型 云主机vCPU/内存规格 系统盘容量/类型 峰值带宽 | 流量包 随实例购买的服务（必选） 云耀服务组合（基础套餐） 2vCPUs | 4G 70 GiB 高IO 5 Mbit/s | 1000 GB 云备份：服务器备份 | 存储库100 GB 主机安全：基础版 云耀服务组合（高可用套餐） 2vCPUs | 4G（2台） 70 GiB 高IO（2个） 2 Mbit/s | 100 GB 云备份：服务器备份 | 存储库100 GB 主机安全：基础版 云耀负载均衡：最大连接数 2000｜每秒新建连接数 200

场景须知 禁止使用云耀云服务器搭建赌博、私服、跨境VPN等违法违规业务。 禁止使用云耀云服务器对电商网站开展刷单、刷广告等虚假交易操作。 禁止利用云耀云服务器对外部系统发起网络攻击，如：DDoS攻击、CC攻击，Web攻击，暴力破解，传播病毒、木马等。 禁止使用云耀云服务器提供流量穿透服务。 禁止利用云耀云服务器搭建爬虫环境，对外部系统发起爬虫搜索。 未经外部系统主体授权，禁止利用云耀云服务器对外部系统发起扫描、渗透等探测行为。 禁止在云耀云服务器上部署任何违法违规网站和应用。

通用使用须知 请勿卸载云服务器硬件的驱动程序。 请勿修改网卡的MAC地址。 部分软件的鉴权模式可能会导致License与物理机的硬件信息绑定，云服务器的迁移操作可能会引起物理信息变更进而导致License失效。 由于物理机故障导致云服务器发生迁移，迁移时可能会出现重启或关机现象，建议您在系统业务进程配置自动拉起和开机自启动，或者通过业务集群部署、主备部署等方式实现业务的高可用。 建议您为部署核心关键业务的云服务器做好数据备份。 建议您为云服务器上的应用业务指标做好监控配置。 不建议您修改默认的DNS，如您有公网DNS配置需求，可以在云服务器上配置公网DNS和内网DNS。

L实例使用限制 限制项 限制说明 配额 同一华为账号下，一个区域默认最多创建云耀云服务器L实例和云耀负载均衡总共5个资源。 一台云耀云服务器L实例默认最多备案5个网站。 说明： 如需扩大配额，请提交工单处理。 套餐管理 一台云耀云服务器L实例仅支持挂载一个同类型服务，即仅支持挂载一块数据盘、一个云备份、一个主机安全和一个负载均衡。 云耀云服务器L实例以套餐形式整体售卖、管理， 套餐内资源统一创建、退订、续费。不支持单独退订云耀云服务器L实例挂载或绑定的数据盘、云备份、主机安全、弹性公网IP。 增加配件 云耀云服务器L实例仅支持挂载一个同类型的服务，不支持增加已经存在的服务。例如云耀云服务器L实例中包含了数据盘，则不能再增加数据盘。 当前L实例控制台仅支持增加数据盘，不支持增加云备份、主机安全。 如果您未随L实例购买云备份、主机安全，可在云备份控制台购买云服务器备份并绑定L实例，在主机安全控制台开通主机安全。具体操作详见购买云服务器备份存储库、开通HSS。 说明： 仅支持在L实例控制台新增数据盘，不支持在云硬盘控制台新增并挂载数据盘，不支持挂载已有的数据盘。 不支持单独购买流量包。 增加的服务到期时间与所挂载的云耀云服务器L实例一致，不支持单独卸载和退订。 云耀云服务器L实例处于“运行中”、“关机”状态时，才能进行增配操作。 数据盘/云备份扩容 磁盘扩容不会影响云主机的已有数据，但误操作可能会导致数据丢失或异常，建议扩容前通过云备份对数据备份。 仅支持单独扩容数据盘，不支持单独扩容系统盘。您可通过升级整体实例规格扩容系统盘，具体操作步骤详见升级云耀云服务器L实例。 当前云硬盘只支持扩大容量，不支持缩小容量。 扩容量到期时间与所绑定的云耀云服务器L实例一致，且扩展容量无法单独退订。 云主机处于“运行中”、“关机”状态时，才能进行扩容操作。 镜像 系统镜像和应用镜像中，Windows Server镜像为Windows操作系统，除此之外的其他镜像均为Linux操作系统。 对于使用应用镜像创建的云耀云服务器L实例，请确保应用镜像启动完毕后再进行重置密码、重启或开关机操作。在应用镜像启动期间，进行重启或开关机操作可能导致无法正常登录应用镜像管理界面。 使用私有镜像创建或切换L实例的约束限制详见L实例约束限制。 登录云主机 只有运行中的云主机才允许用户登录。 L实例云主机没有默认登录密码，首次登录云主机时，请先设置密码，并妥善保存。 仅支持在云服务器“关机”状态或者“运行中”状态下重置密码。云服务器在“运行中”状态下重置密码时，重启后新密码才能生效。 网络连通性 公网 云耀云服务器L实例默认配置一个公网IP，该公网IP不支持更换、服务器被释放后不支持保留。 云耀云服务器L实例不支持IPv6。 内网 不支持切换VPC。 云耀云服务器L实例默认配置一个私网IP，该私网IP不支持更换、服务器被释放后不支持保留。