
# 快速创建和使用ClickHouse列式数据库集群
#### 操作场景
本入门提供从零开始创建ClickHouse集群并通过集群客户端进行ClickHouse表的创建与查询操作指导。
ClickHouse是一款开源的面向联机分析处理的列式数据库，独立于Hadoop大数据体系，具有压缩率和极速查询性能。
#### 操作流程
开始使用如下样例前，请务必按[准备工作]指导完成必要操作。
1. [创建MRS集群]：自定义创建一个MRS 3.2.0-LTS.1版本的"ClickHouse集群"。
2. [安装集群客户端]：下载并安装MRS集群客户端。
3. [使用ClickHouse客户端创建表]：在ClickHouse客户端创建表并插入数据。
4. [释放资源]：如果您在完成实践后不需要继续使用MRS集群，请及时清理资源以免产生额外扣费。
 
 #### 准备工作
- 注册账号并实名认证。 在创建MRS集群之前，请先[注册华为账号并开通华为云](https://support.huaweicloud.com/usermanual-account/account_id_001.html)，进行[实名认证](https://support.huaweicloud.com/usermanual-account/zh-cn_topic_0071343161.html)。
  如果您已开通华为云并进行实名认证，请忽略此步骤。
  
- 请您保证账户有足够的资金，以免创建MRS集群失败，具体操作请参见[账户充值](https://support.huaweicloud.com/usermanual-billing/bills-topic_30000002.html)。
- 已准备具有创建MRS集群权限的IAM用户，详细操作请参见[创建IAM用户并授权使用MRS](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0453.html)。
 
#### 操作视频
该视频为您介绍如何在MRS集群创建成功后，通过ClickHouse客户端实现创建表，往表中插入数据等功能。
因不同版本操作界面可能存在差异，相关视频供参考，具体以实际环境为准。
<video controls="controls" preload="none" id="zh-cn_topic_0000001676906834_object1948841162812" class="idp-external-video" src="https://res-video.hc-cdn.com/cloudbu-site/china/zh-cn/support/mrs-video/Use_ClickHouse_MRS_cn.mp4" title="使用ClickHouse客户端" poster="https://support.huaweicloud.com/qs-mrs/zh-cn_image_0000002350312501.jpg" height="300.0000" width="600.0000"></video>
 #### 步骤一：创建MRS集群
1. 进入[购买MRS集群页面](https://console.huaweicloud.com/mrs/?#/clusterCreate/quick)。
2. 在服务列表中搜索"MapReduce服务 MRS"，进入MRS服务管理控制台。
3. 单击"购买集群"，进入"购买集群"页面，选择"快速购买"页签。
4. 根据实际业务规划情况填写集群配置信息（本示例为快速创建按需计费的MRS 3.2.0-LTS.1版本集群，如需了解更多参数配置请参考[快速创建MRS集群](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0496.html)）。
   
   表1MRS集群配置参数 
   | 参数         | 示例                  | 参数说明                                                                                                         |
   |:---|:---|:---|
   | 区域         | **华北-北京四**          | 选择区域。 不同区域的云服务产品之间内网互不相通。请就近选择靠近您业务的区域，可减少网络时延，提高访问速度。                       |
   | 计费模式       | **按需计费**            | 选择待创建的集群的计费模式，MRS提供"包年/包月"与"按需计费"两种计费模式。 按需计费是一种后付费模式，即先使用再付费，按照MRS集群实际使用时长计费。 |
   | 集群名称       | **mrs_demo**        | 待创建的MRS集群名称。                                                                                                 |
   | 集群类型       | **自定义**             | 根据业务实际需要选择待创建的MRS集群类型。"自定义"类型集群提供丰富的组件搭配，可自行选择对应版本MRS集群所支持的所有组件。                                             |
   | 版本类型       | **LTS版**            | 待创建的MRS集群版本类型。                                                                                               |
   | 集群版本       | **MRS 3.2.0-LTS.1** | 待创建的MRS集群版本，不同版本所包含的开源组件版本及功能特性可能不同，推荐选择最新版本。                                                                |
   | 组件选择       | **ClickHouse集群**    | 基于系统预置的集群模板选择要购买的集群组件。                                                                                       |
   | 可用区        | **可用区1**            | 选择集群工作区域下关联的可用区。                                                                                             |
   | 虚拟私有云      | **vpc-default**     | 选择需要创建集群的VPC，单击"查看虚拟私有云"进入VPC服务查看已创建的VPC名称和ID。如果没有VPC，需要创建一个新的VPC。                                           |
   | 子网         | **subnet-default**  | 选择需要创建集群的子网，可进入VPC服务查看VPC下已创建的子网名称和ID。如果VPC下未创建子网，请单击"创建子网"进行创建。                                             |
   | 集群节点       | **保持默认**            | 配置集群节点信息。                                                                                                    |
   | Kerberos认证 | **不开启**             | 是否启用Kerberos认证。                                                                                              |
   | 用户名        | **admin/root**      | 登录集群管理页面及ECS节点的用户名。                                                                                          |
   | 密码         | -                   | 设置登录集群管理页面及ECS节点用户的密码。                                                                                       |
   | 确认密码       | -                   | 再次输入设置用户密码。                                                                                                  |
   | 企业项目       | **default**         | 选择集群所属的企业项目。                                                                                                 |
   | 通信安全授权     | **勾选**              | 勾选确认授权。                                                                                                      |
      
   图1购买ClickHouse集群   
   ![](https://support.huaweicloud.com/qs-mrs/zh-cn_image_0000002456693784.png "点击放大")
   
   
5. 单击"立即购买"，进入任务提交成功页面。
6. 单击"返回集群列表"，在"现有集群"列表中可以查看到集群创建的状态。 
   集群创建需要时间，所创集群的初始状态为"启动中"，创建成功后状态更新为"运行中"，请您耐心等待。
   
   
 
 #### 步骤二：安装集群客户端
MRS集群创建成功后，用户可安装集群客户端用于连接集群内各组件服务，进行作业提交等操作。
客户端可以安装在集群内的节点上，也可以安装在集群外的节点上。本指南以在Master1节点上安装客户端为例进行介绍。
1. MRS集群创建成功后，在集群列表中单击MRS集群名称进入集群概览页面。
2. 单击"集群管理页面 "后的"前往 Manager"，在弹出的窗口中选择"EIP访问"并配置弹性IP信息。 
   首次访问时，可单击"管理弹性公网IP"，在弹性公网IP控制台购买一个弹性公网IP，购买成功后刷新弹性公网IP列表并选择。
   
   
3. 勾选确认信息后，单击"确定"，登录集群的FusionInsight Manager管理界面。 
   Manager登录用户名为admin，密码为购买集群时配置的用于登录Manager管理界面的"admin"用户的自定义密码。
   
   
4. 在"主页"页签的集群名称后单击![](https://support.huaweicloud.com/qs-mrs/zh-cn_image_0000001936418614.png)，单击"下载客户端"下载集群客户端。
   
   图2下载客户端   
   ![](https://support.huaweicloud.com/qs-mrs/zh-cn_image_0000001936419918.png "点击放大")
   在"下载集群客户端"弹窗中，配置以下参数：
   - 选择客户端类型：选择"完整客户端"。
   
   - 选择平台类型：默认勾选即可，例如"x86_64"。
   
   - 勾选"仅保存到如下路径"，使用默认保存路径，文件生成后将保存在集群主OMS节点的"/tmp/FusionInsight-Client"目录下。
   
   
   图3下载集群客户端提示框   
   ![](https://support.huaweicloud.com/qs-mrs/zh-cn_image_0000001963580973.png)
   单击"确定"后，等待客户端软件生成成功。
   
   
5. 在MRS服务管理控制台的集群列表中，单击集群名称，在集群的"节点管理"页签，单击包含"master1"的节点名称，在ECS详情页面单击右上角的"远程登录"登录Master1节点。 
   图4查看Master1节点   
   ![](https://support.huaweicloud.com/qs-mrs/zh-cn_image_0000002184974017.png "点击放大")
   
   
6. 使用**root**用户登录Master1节点，密码为购买集群时配置的用于登录集群节点的"root"用户自定义密码。
7. 执行以下命令切换到客户端软件包所在目录，并解压客户端软件包： 
   ```
   cd /tmp/FusionInsight-Client/
   ```
   ```
   tar -xvf FusionInsight_Cluster_1_Services_Client.tar
   ```
   ```
   tar -xvf FusionInsight_Cluster_1_Services_ClientConfig.tar
   ```
   
   
8. 执行以下命令进入安装包所在目录，安装客户端： 
   ```
   cd FusionInsight_Cluster_1_Services_ClientConfig
   ```
   执行如下命令安装客户端到指定目录（绝对路径），例如安装到"/opt/client"目录，等待客户端安装完成。
   ```
   ./install.sh /opt/client
   ```
   执行结果如下：
   ```
   ...
   ... component client is installed successfully
   ...
   ```
   ![](https://support.huaweicloud.com/qs-mrs/public_sys-resources/note_3.0-zh-cn.png)
   客户端安装目录可以不存在，会自动创建。但如果存在，则必须为空，目录路径不能包含空格。且客户端安装目录路径只能包含大写字母、小写字母、数字以及**_**字符。
   
   
 
 #### 步骤三：使用ClickHouse客户端创建表
本操作以创建ClickHouse的普通模式集群（未启用Kerberos认证）为例，安全模式集群（启用Kerberos认证）使用ClickHouse客户端创建表请参考[ClickHouse客户端使用实践](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_2345.html)。
1. 以**root**用户登录MRS客户端所在节点（Master1节点）。
2. 执行以下命令切换到客户端安装目录并配置环境变量。 
   ```
   cd /opt/client
   ```
   ```
   source bigdata_env
   ```
   
   
3. 使用**clickhouse client** 命令连接ClickHouse服务端。
   
   ```
   clickhouse client --host ClickHouseServer实例的IP地址 --port 9000 --user 用户名 --password
   ```
   ![](https://support.huaweicloud.com/qs-mrs/public_sys-resources/note_3.0-zh-cn.png)
   - ClickHouseServer实例的IP地址可登录集群FusionInsight Manager界面，选择"集群 \> 服务 \> ClickHouse \> 实例"获取。
   
   - 未开启Kerberos认证的集群默认使用非SSL安全连接，默认连接端口为**9000**，可登录集群FusionInsight Manager界面，选择"集群 \> 服务 \> ClickHouse \> 配置"，搜索"tcp_port"参数查看。
   
   - 如果不指定**--user** 和**--password** 参数，默认使用**default** 用户登录ClickHouse客户端。如果需要指定用户名和密码，则需在ClickHouse客户端执行**create user** SQL语句创建ClickHouse用户。
    
   
   
4. 执行以下命令创建数据库"test001"： 
   ```
   create database test001 on cluster default_cluster;
   ```
   
   
5. 执行以下命令创建复制表"test010"： 
   ```
   CREATE TABLE test001.test010 on cluster default_cluster
   (
   `EventDate` DateTime,
   `CounterID` UInt32,
   `UserID` UInt32,
   `ver` UInt16
   )
   ENGINE = ReplicatedReplacingMergeTree('/clickhouse/tables/{shard}/test3', '{replica}', ver)
   ORDER BY (CounterID, EventDate, intHash32(UserID));
   ```
   
   
6. 执行以下命令创建复制表"test010"中插入数据： 
   ```
   insert into test001.test010 values('2020-01-29',111,111,111);
   ```
   
   
7. 执行以下命令查看"test010"表数据： 
   ```
   select * from test001.test010;
   ```
   图5查看"test010"表数据   
   ![](https://support.huaweicloud.com/qs-mrs/zh-cn_image_0000001936524574.png "点击放大")
   
   
8. 执行以下命令创建分布式表"test001.test010_dir"并插入数据： 
   ```
   create table test001.test010_dir ON CLUSTER default_cluster as  test001.test010 ENGINE = Distributed(default_cluster, test001, test010, rand());
   ```
   ```
   insert into test001.test010_dir values('2020-01-29',111,111,111);
   ```
   
   
9. 执行以下命令查询分布式表： 
   ```
   select * from test001.test010_dir;
   ```
   图6查看"test010_dir"表数据   
   ![](https://support.huaweicloud.com/qs-mrs/zh-cn_image_0000001963689241.png)
   
   
10. 执行以下命令删除创建的库表： 
    ```
    drop database test001 on cluster default_cluster no delay;
    ```
    
    
 
 #### 后续操作：释放资源
如果您无需继续使用该MRS集群，请及时释放资源，避免产生额外的费用。详细操作步骤请参见[删除MRS集群](https://support.huaweicloud.com/usermanual-mrs/mrs_01_0042.html)。
#### 相关信息
更多ClickHouse权限管理、导入RDS MySQL/OBS/HDFS/DWS等数据至ClickHouse表中、ClickHouse多租户管理、通过ELB访问ClickHouse等操作请参见[使用ClickHouse](https://support.huaweicloud.com/cmpntguide-lts-mrs/mrs_01_2344.html)。
