更新时间:2024-02-07 GMT+08:00

通过公网连接实例

GeminiDB Cassandra支持使用弹性云服务器或本地设备,通过公网连接实例。

本章节以Linux操作系统和弹性云服务器为例,指导您通过公网连接GeminiDB Cassandra实例。

您可以根据业务需求选用普通方式或SSL方式连接实例。

前提条件

  1. GeminiDB Cassandra实例需要绑定弹性公网IP并设置安全组规则,确保可以通过弹性云服务器访问弹性公网IP,具体操作请参见绑定弹性公网IP设置安全组规则
  2. 创建弹性云服务器,以Linux操作系统为例。详情请参见《弹性云服务器快速入门》中购买弹性云服务器的内容。
  3. 根据已购弹性云服务器的CPU类型,选择下载并安装对应的Cassandra客户端。
  4. 使用SSL方式连接实例时,需要提前获取SSL证书,具体操作请参见下载SSL证书

非SSL方式

  1. 登录弹性云服务器,详情请参见《弹性云服务器快速入门》中登录弹性云服务器的内容。
  2. 将Cassandra客户端安装包上传到弹性云服务器
  3. 使用如下命令,解压客户端安装包,此处以x86的客户端为例。

    unzip Cassandra_cqlsh_x86_64.zip

  4. 使用如下命令,给所有文件添加执行权限。

    chmod +x *

  5. 在客户端工具“cqlsh”所在的目录下,连接数据库实例

    ./cqlsh <DB_HOST> <DB_PORT> -u <DB_USER>

    示例:

    ./cqlsh 192.xx.xx.xx 8635 -u rwuser

    表1 参数说明

    参数

    说明

    <DB_HOST>

    待连接实例的弹性公网IP。

    您可以在“实例管理”页面,单击实例名称,进入“基本信息”页面,在节点信息列表中获取“弹性IP”。

    如果您购买的实例有多个节点,选择其中任意一个节点的弹性公网IP即可连接GeminiDB Cassandra实例。

    图1 查看弹性公网IP

    若当前实例未绑定弹性公网IP,请您先参考绑定弹性公网IP为当前实例绑定弹性公网IP后,再根据本章节的操作连接实例。

    <DB_PORT>

    待连接实例的端口。一般默认为8635,请以实际端口为准。

    您可以在“实例管理”页面,单击实例名称,进入“基本信息”页面,在网络信息处获取“数据库端口”。

    图2 查看端口

    <DB_USER>

    数据库账号,默认为rwuser。

  6. 出现如下信息,说明连接成功。

    rwuser@cqlsh>

SSL连接

  1. 登录弹性云服务器,详情请参见《弹性云服务器快速入门》中登录弹性云服务器的内容。
  2. 将Cassandra客户端安装包上传到弹性云服务器
  3. 将SSL证书上传到弹性云服务器
  4. 使用如下命令,解压客户端安装包,此处以x86的客户端为例。

    unzip Cassandra_cqlsh_x86_64.zip

  5. 使用如下命令,给所有文件添加执行权限。

    chmod +x *

  6. 在客户端工具“cqlsh”所在的目录下,连接数据库实例

    export SSL_CERTFILE=/<PATH_OF_SSL_CERT_FILE>

    export SSL_VERSION=TLSv1_2

    ./cqlsh <DB_HOST> <DB_PORT> --ssl -u <DB_USER>

    示例:

    ./cqlsh 192.168.1.8 8635 --ssl -u rwuser

    表2 参数说明

    参数

    说明

    <PATH_OF_SSL_CERT_FILE>

    SSL文件的路径。

    <DB_HOST>

    待连接实例的弹性公网IP。

    您可以在“实例管理”页面,单击实例名称,进入“基本信息”页面,在节点信息列表中获取“弹性IP”。

    如果您购买的实例有多个节点,选择其中任意一个节点的弹性公网IP即可连接GeminiDB Cassandra实例。

    图3 查看弹性公网IP

    若当前实例未绑定弹性公网IP,请您先参考绑定弹性公网IP为当前实例绑定弹性公网IP后,再根据本章节的操作连接实例。

    <DB_PORT>

    待连接实例的端口。一般默认为8635,请以实际端口为准。

    您可以在“实例管理”页面,单击实例名称,进入“基本信息”页面,在网络信息处获取“数据库端口”。

    图4 查看端口

    <DB_USER>

    数据库账号,默认为rwuser。

  7. 出现如下信息,说明连接成功。

    rwuser@cqlsh>

后续操作

成功登录实例后,您可以创建keyspace、数据库、表等操作,具体请参见购买并连接GeminiDB Cassandra实例