购买并连接GeminiDB Cassandra实例

本章节以Linux系统为例，介绍从购买到内网连接GeminiDB Cassandra实例的操作步骤和基础语法。

步骤一：购买GeminiDB Cassandra实例
步骤二：购买ECS
步骤三：连接GeminiDB Cassandra实例
基础语法

步骤一：购买GeminiDB Cassandra实例

登录管理控制台。
在服务列表中选择“数据库 > 云数据库 GeminiDB Cassandra 接口”。
在“实例管理”页面，单击“购买数据库实例”，进入“服务选型”页面。
在“购买数据库实例”页面，选择计费模式，填写并选择实例相关信息后，单击“立即购买”。

图1 基本信息

图2 设置密码
查看购买成功的GeminiDB Cassandra实例。

图3 购买成功

步骤二：购买ECS

登录管理控制台。
在服务列表中选择“计算 > 弹性云服务器 ECS”，进入云服务器控制台，单击“购买弹性云服务器”。
配置基础信息后，单击“下一步：网络配置”。ECS与待连接的GeminiDB Cassandra实例的区域及可用区一致。ECS与待连接的GeminiDB Cassandra实例的区域、可用区、VPC和安全组一致。

图4 基础配置

图5 选择规格

图6 选择镜像
配置网络信息后，单击“下一步：高级配置”。ECS与待连接的GeminiDB Cassandra实例的VPC和安全组一致。
- 如果安全组规则允许弹性云服务器云主机访问，即可连接实例。
- 如果安全组规则不允许弹性云服务器云主机访问，需要在实例安全组添加一条“入”的访问规则。
图7 网络配置

图8 选择弹性公网IP
配置密码等信息后，单击“下一步：确认配置”。

图9 高级配置
确认配置信息后，单击“立即购买”。

图10 确认配置
查看购买成功的ECS。

步骤三：连接GeminiDB Cassandra实例

在ECS上，使用控制台提供的VNC方式登录。

图11 远程登录
输入用户名和创建ECS时设置的密码。

图12 输入用户名和密码
将Cassandra客户端安装包上传到弹性云服务器。

方法一：
```
wget https://dbs-download.obs.cn-north-1.myhuaweicloud.com/nosql/Cassandra_cqlsh_x86_64.zip
```
方法二：

下载Cassandra客户端安装包，并将Cassandra客户端安装包上传到弹性云服务器。
解压客户端工具包。

unzip Cassandra_cqlsh_x86_64.zip
使用如下命令，给所有文件添加执行权限。

chmod +x *

在客户端工具“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实例。
<DB_PORT>	待连接实例的端口。一般默认为8635，请以实际端口为准。您可以在“实例管理”页面，单击实例名称，进入“基本信息”页面，在网络信息处获取“数据库端口”。
<DB_USER>	数据库账号，默认为rwuser。

出现如下信息，说明连接成功。
```
rwuser@cqlsh>
```

基础语法

keyspace语法
- 创建keyspace。
  示例：
  
  CREATE KEYSPACE IF NOT EXISTS nosql WITH replication = {'class': 'SimpleStrategy', 'replication_factor': '3'};
  
  keyspace名称为“nosql”，“class”选项指定副本位置策略为简单策略(SimpleStrategy)，“replication_factor”选项指定副本数量。GeminiDB Cassandra提供强一致性级别，副本数不论指定多少都是默认存储3个副本。
- DESC <keyspace_name>，验证创建结果。
  图13 验证创建结果
- use <keyspace_name>，切换到创建的keyspace。
  图14 切换keyspace
- DROP KEYSPACE <keyspace_name>，删除已创建的keyspace。
  图15 删除keyspace
表语法
- 创建表。
  示例：
  
  CREATE TABLE nosql_table(user_id int, age int, user_name text, PRIMARY KEY(user_id));
  
  表名为nosql_table，定义三列：user_id、age、user_name。user_id是int类型，表示用户ID；age是int类型，表示用户年龄；user_name是text类型，表示用户名称。主键为user_id。
- DESC <table_name>，验证创建结果。
  图16 验证创建结果
- 向表中插入数据，示例：
  INSERT INTO nosql_table (user_id, age, user_name) VALUES (1, 10, 'user1');
  
  INSERT INTO nosql_table (user_id, age, user_name) VALUES (2, 20, 'user2');
  
  INSERT INTO nosql_table (user_id, age, user_name) VALUES (3, 30, 'user3');
- SELECT * FROM <table_name>，查询表数据。
  图17 查询表数据
- 向表中添加类别，示例：
  ALTER TABLE nosql_table ADD gender text;
- 向某一keyspace的表中更新该类别的数据，示例：
  UPDATE nosql.nosql_table SET gender = 'male' WHERE user_id = 1;
  
  UPDATE nosql.nosql_table SET gender = 'male' WHERE user_id = 2;
  
  UPDATE nosql.nosql_table SET gender = 'female' WHERE user_id = 3;
  
  图18 查看更新结果
- 删除某一keyspace下的表数据，示例：
  删除用户ID为1对应的age数据：
  
  DELETE age FROM nosql.nosql_table WHERE user_id=1;
  
  图19 删除某一条数据
  
  删除用户ID为2对应的整条记录：
  
  DELETE FROM nosql.nosql_table WHERE user_id=2;
  
  图20 删除整条记录
- 删除整个表，示例：
  DROP TABLE nosql.nosql_table;
  
  图21 删除整个表
HELP命令
- HELP，查看所有支持的命令。
  图22 查看支持的全部命令
- HELP <COMMAND>，查询某一命令的使用方法。
  示例：HELP DESC