本篇介绍如何在管理控制台购买GaussDB实例，并通过内网使用弹性云服务器连接GaussDB实例。

准备工作

GaussDB提供gsql工具帮助您在命令行下连接数据库，您需要提前创建一台弹性云服务器用于安装gsql工具。

创建并连接ECS，请参见弹性云服务器快速入门。

须知：

操作系统需要选择Euler操作系统。gsql支持的操作系统版本如下：

X86：EulerOS V2.0SP5。

鲲鹏服务器：EulerOS V2.0SP8。

设置安全组规则

在访问数据库前，您需要将访问数据库的IP地址，或者IP段加入安全组入方向的访问规则，操作请参见设置安全组规则。

获取驱动包

根据不同版本的实例，下载不同版本的发布包，如表1所示。

为了防止软件包在传递过程或存储期间被恶意篡改，下载软件包时需下载对应的校验包对软件包进行校验，校验方法如下：

1. 上传软件包和软件包校验包到虚拟机（Linux操作系统）的同一目录下。
2. 执行如下命令，校验软件包完整性。

   cat GaussDB_driver.zip.sha256 | sha256sum --check

   如果回显OK，则校验通过。

   GaussDB_driver.zip: OK

   
   

远程连接数据库

1. 为了防止软件包在传递过程或存储期间被恶意篡改，下载软件包时需下载对应的校验包对软件包进行校验，校验方法如下：

   1. 上传软件包和软件包校验包到虚拟机（Linux操作系统）的同一目录下。
   2. 执行如下命令，校验软件包完整性。

      cat GaussDB_driver.zip.sha256 | sha256sum --check

      如果回显OK，则校验通过。

      GaussDB_driver.zip: OK

   远程连接数据库

   1. 登录申请的弹性云服务器。
   2. 在申请的弹性云服务器上，上传客户端工具包并配置gsql的执行环境变量。
      1. 以root用户登录客户端机器。
      2. 创建“/tmp/tools”目录。

         mkdir /tmp/tools
      3. 解压GaussDB软件包“GaussDB_driver.zip”。

         unzip GaussDB_driver.zip

      4. 根据申请的弹性云服务器的操作系统架构进入不同目录，获取“GaussDB-Kernel-VxxxRxxxCxx-EULER-64bit-gsql.tar.gz”，并上传到申请的弹性云服务器“/tmp/tools”路径下。
         说明：

         软件包相对位置为安装时所放位置，根据实际情况填写。

         cd GaussDB_driver/Centralized/Euler2.5_X86_64/
         cp GaussDB-Kernel-VxxxRxxxCxx-EULER-64bit-gsql.tar.gz /tmp/tools
      5. 解压文件。

         cd /tmp/tools
         tar -zxvf GaussDB-Kernel-VxxxRxxxCxx-EULER-64bit-gsql.tar.gz
      6. 设置环境变量。

         打开“~/.bashrc”文件。

         vim ~/.bashrc

         按下i键进入INSERT模式，在其中输入如下内容后，单击“ESC”退出编辑模式，使用“:wq!”命令保存并退出。

         export PATH=/tmp/tools/bin:$PATH

         export LD_LIBRARY_PATH=/tmp/tools/lib:$LD_LIBRARY_PATH
         使环境变量配置生效。

         source ~/.bashrc
   3. 执行如下指令，根据提示输入密码，连接数据库。

      数据库创建成功后，会默认生成名称为postgres的数据库，此处以postgres库为例。

      gsql -d postgres -h 10.0.0.0 -U root -p 8000
      Password for user root:

      postgres为需要连接的数据库名称，10.0.0.0分布式为CN的IP地址，主备版为主DN的IP地址，root为登录数据库的用户名，8000为CN或主DN的端口号。

   登录申请的弹性云服务器。
2. 在申请的弹性云服务器上，上传客户端工具包并配置gsql的执行环境变量。

   
   

   1. 以root用户登录客户端机器。
   2. 创建“/tmp/tools”目录。

      mkdir /tmp/tools

      
      

   3. 解压GaussDB软件包“GaussDB_driver.zip”。

      unzip GaussDB_driver.zip

   4. 根据申请的弹性云服务器的操作系统架构进入不同目录，获取“GaussDB-Kernel-VxxxRxxxCxx-EULER-64bit-gsql.tar.gz”，并上传到申请的弹性云服务器“/tmp/tools”路径下。

      说明：

      软件包相对位置为安装时所放位置，根据实际情况填写。

      cd GaussDB_driver/Centralized/Euler2.5_X86_64/
      cp GaussDB-Kernel-VxxxRxxxCxx-EULER-64bit-gsql.tar.gz /tmp/tools

      
      

   5. 解压文件。

      cd /tmp/tools
      tar -zxvf GaussDB-Kernel-VxxxRxxxCxx-EULER-64bit-gsql.tar.gz

      
      

   6. 设置环境变量。

      打开“~/.bashrc”文件。

      vim ~/.bashrc

      
      

      按下i键进入INSERT模式，在其中输入如下内容后，单击“ESC”退出编辑模式，使用“:wq!”命令保存并退出。

      export PATH=/tmp/tools/bin:$PATH

      
      

      export LD_LIBRARY_PATH=/tmp/tools/lib:$LD_LIBRARY_PATH

      
      

      使环境变量配置生效。

      source ~/.bashrc

      
      

   
   

3. 执行如下指令，根据提示输入密码，连接数据库。

   
   

   数据库创建成功后，会默认生成名称为postgres的数据库，此处以postgres库为例。

   gsql -d postgres -h 10.0.0.0 -U root -p 8000
   Password for user root:

   
   

   postgres为需要连接的数据库名称，10.0.0.0分布式为CN的IP地址，主备版为主DN的IP地址，root为登录数据库的用户名，8000为CN或主DN的端口号。