Apache Kylin3.0.1对接FusionInsight HD

适用场景

Apache Kylin 3.0.1 ↔ FusionInsight HD 6.5 (Hive/HBase/Kafka/Spark)

说明

Apache Kylin™是一个开源的分布式分析引擎,提供Hadoop之上的SQL查询接口及多维分析(OLAP)能力以支持超大规模数据,最初由eBay Inc. 开发并贡献至开源社区。它能在亚秒内查询巨大的Hive表。

Apache Kylin主要与FusionInsight的Hive和HBase进行对接

如果需要读取hive分区表需要修改源码,本文不提供该方法

环境准备

  • 修改/etc/hosts

添加本机主机名解析

172.16.52.86 kylin

  • 配置NTP服务(若kylin主机与集群时间在5min之内此步骤可选)

使用vi /etc/ntp.conf增加NTP服务的配置,时间与FusionInsight集群同步

server 172.18.0.18 nomodify notrap nopeer noquery

启动NTP服务

service ntpd start
chkconfig ntpd on

  • 参考FusionInsight产品文档在Kylin节点安装FusionInsight客户端

在FusionInsight Manager服务管理页面下载客户端,上传到kylin节点安装FusionInsight客户端到/opt/hadoopclient目录

./install.sh /opt/135_651armhdclient/hadoopclient

  • 安装JDK1.8(可选)
    rpm -Uvh jdk-8u112-linux-x64.rpm
    

下载Kylin

Fusioninsight配套的HBase是1.3.1,Apache Kylin可直接下载apache-kylin-3.0.1-hbase1x-bin.tar.gz主版本二进制包,无需编译Apache kylin

下载解压Kylin

配置Kylin

配置环境变量

  • 配置环境变量:vi /etc/profile,增加以下配置

    export KYLIN_HOME=/opt/kylin/apache-kylin-3.0.1-bin-hbase1x
    

  • 导入环境变量

    source /etc/profile
    

  • Kylin启动还需要配置HIVE_CONF、HCAT_HOME,使用vi /opt/135_651armhdclient/hadoopclient/Hive/component_env,在文件最后增加

    export HIVE_CONF=/opt/135_651armhdclient/hadoopclient/Hive/config
    export HCAT_HOME=/opt/135_651armhdclient/hadoopclient/Hive/HCatalog
    

  • 导入环境变量

    source /opt/135_651armhdclient/hadoopclient/bigdata_env
    

  • 进行kerberos认证

    kinit developuser
    

  • Kylin检查环境设置:

    cd /opt/kylin/apache-kylin-3.0.1-bin-hbase1x/bin
    ./check-env.sh
    

修改FusionInsight的Hive配置项

  • 在hive.security.authorization.sqlstd.confwhitelist.append参数最后追加一下参数配置,保存配置,重启影响的服务
|mapreduce\.job\..*|dfs\..*|mapred\..*

修改Kylin配置

  • 获取Hive的JDBC字符串

执行Beeline查看Hive的JDBC字符串

source bigdata_env
kinit developuser
beeline

  • 修改kylin.properties: vi /opt/kylin/apache-kylin-3.0.1-bin-hbase1x/conf/kylin.properties

配置Hive client使用beeline:

kylin.source.hive.client=beeline
kylin.source.hive.beeline-shell=beeline
kylin.source.hive.beeline-params=-n root -u 'jdbc:hive2://172.16.10.131:24002,172.16.10.132:24002,172.16.10.133:24002/;serviceDiscoveryMode=zooKeeper;zooKeeperNamespace=hiveserver2;sasl.qop=auth-conf;auth=KERBEROS;principal=hive/hadoop.hadoop.com@HADOOP.COM'
JDBC字符串使用上一步骤获取的字符串

注意:kylin.source.hive.beeline-params参数里面原有的 --hiveconf hive.security.authorization.sqlstd.confwhitelist.append='mapreduce.job.*|dfs.*' 要去掉

  • 修改Hive/HBase配置

将/opt/135_651armhdclient/hadoopclient/Hive/config/hivemetastore-site.xml中的配置合并到hive-site.xml

将/opt/135_651armhdclient/hadoopclient/HBase/hbase/conf/hbase-site.xml中的配置合并到/opt/kylin/apache-kylin-3.0.1-bin-hbase1x/conf/kylin_job_conf.xml

  • Hive lib路径

kylin的/opt/kylin/apache-kylin-3.0.1-bin-hbase1x/bin/find-hive-dependency.sh默认Hive lib路径为大数据集群中Hive的安装路径,需要修改为客户端路径

启动Kylin

  • 使用./kylin.sh start启动Kylin

输入默认用户名密码:ADMIN/KYLIN登陆

Demo测试

导入Demo数据

  • 执行以下命令导入sample数据
    cd /opt/kylin/apache-kylin-3.0.1-bin-hbase1x/bin
    ./sample.sh
    

选择菜单 System -> Actions -> Reload Metadata

选择菜单 System -> Model

构建Cube

  • 构建默认的kylin_sales_cube

  • 选择End Data(Exclude)时间:

  • 点击Monitor可以查看build状态:

  • Build完成:

  • Cube构建成功,状态变为READY

查询表数据

  • 在Insight页面执行查询

Streaming Sample用例,Kafka普通模式

参考官方网站http://kylin.apache.org/docs30/tutorial/kylin_sample.html

  • (重要)首先下载集群认证文件krb5.conf, 登陆对接集群节点,将下载下来有效的krb5.conf文件放置到集群各个节点的/etc/路径下,完成后使用命令export JAVA_TOOL_OPTIONS="-Djava.security.krb5.conf=/etc/krb5.conf"加载认证参数

下图以其中一个节点为例,其余各节点参考相同命令

  • 停止之前运行的Kylin任务,使用如下命令引入已安装的各组件客户端位置

``` export HIVE_CONF=/opt/135_651armhdclient/hadoopclient/Hive/config export HCAT_HOME=/opt/135_651armhdclient/hadoopclient/Hive/HCatalog export KAFKA_HOME=/opt/135_651armhdclient/hadoopclient/Kafka/kafka ````

  • 到kylin webUI的Model -> Data Source -> 选中表KYLIN_STREAMING_TABLE -> 选择Streaming Cluster -> 点击Edit

  • 填写对应集群kafka连接信息,点击save保存后,在点击submit

  • 登陆kylin安装主机后台,修改bin目录下的sample-streaming.sh文件

  • 登陆后台使用命令bin/sample-streaming.sh启动任务

  • 回到Model,选择kylin_streaming_cube,点击Build

  • 登陆Monitor界面检查

  • 登陆Model界面检查

  • 登陆Insight界面输入SQL语句查询

用spark构建cube用例

参考Kylin官方文档:http://kylin.apache.org/docs30/tutorial/cube_spark.html

  • 停止之前运行的Kylin任务,使用如下命令引入已安装的各组件客户端位置

``` export HIVE_CONF=/opt/135_651armhdclient/hadoopclient/Hive/config export HCAT_HOME=/opt/135_651armhdclient/hadoopclient/Hive/HCatalog export KAFKA_HOME=/opt/135_651armhdclient/hadoopclient/Kafka/kafka export SPARK_HOME=/opt/135_651armhdclient/hadoopclient/Spark2x/spark ````

  • (可选)新建路径/opt/kylin/apache-kylin-3.0.1-bin-hbase1x/spark/jars,使用如下命令将已安装的Spark2x客户端的jar包拷贝到该路径下,并且删除hadoop开头的jar包
cp /opt/135_651armhdclient/hadoopclient/Spark2x/spark/jars/*.jar /opt/kylin/apache-kylin-3.0.1-bin-hbase1x/spark/jars/
rm -rf hadoop-*
  • 启动Kylin,登陆web UI

  • 选择kylin_sales_cube点Clone, 将新的cube重命名为kylin_sales_cube_clone_Spark2x

  • 选择kylin_sales_cube_clone_Spark2x,在Actions下选择Edit

在Advanced Setting下将Cube Engine选成Spark

在Configuration Overwrites检查参数

保存

  • Build新创建的kylin_sales_cube_clone_Spark2x

  • 在Monitor下检查作业情况

  • 可登陆对接集群yarn查看作业情况:

  • 登陆Model界面检查

  • 登陆Insight界面输入SQL语句查询

FAQ

问题1: 在做bin/sample.sh之后再build cube的时候,第一步遇到报错:

问题原因:权限没加够,参考之前的在hive加权限:

增加|mapred\..*,同步该配置后重启hive服务问题解决

问题2: 在《用spark构建cube用例》这一节中,build作业之后在Monitor查看任务失败

错误卡在第7步

登陆对接集群YARN查看失败任务日志:

在container下查看具体报错日志日志:

解决办法:将Kylin主机名 172-16-2-120增加到对接集群的/etc/hosts配置文件下重新运行该任务问题解决