layout: docs31-cn title: 样例数据集 categories: howto permalink: /cn/docs31/howto/sample_dataset.html

Kylin 的二进制包中包含了一份样例数据集,共计 5 张表,其中事实表有 10000 条数据。用户可以在 Kylin 部署完成后,利用样例数据集进行测试。用户可通过执行脚本方式,将 Kylin 中自带的样例数据导入至 Hive。

将样例数据集导入至 Hive

导入样例数据集的可执行脚本为 sample.sh ,其默认存放路径为系统安装目录下的 /bin 目录:

$KYLIN_HOME/bin/sample.sh

脚本执行成功之后,可在服务器终端执行 hive 命令行,进入 hive,然后执行查询语句验证导入正常:

hive

系统默认将 5 张表导入 Hive 的 default 数据库中,用户可以检查导入 Hive 的表清单或查询具体表:

hive> use default;
hive> show tables;
hive> select count(*) from kylin_sales;

提示:如果需要将表导入至 Hive 中指定的数据库,您可以修改 Kylin 配置文件 $KYLIN_HOME/conf/kylin.properties 中的配置项 kylin.source.hive.database-for-flat-table 至指定的 Hive 数据库。

数据表介绍

本产品支持星型数据模型和雪花模型。本文中用到的样例数据集是一个规范的雪花模型结构,它总共包含了 5 个数据表:

  • KYLIN_SALES

    事实表,保存了销售订单的明细信息,每一行对应着一笔交易订单。交易记录包含了卖家、商品分类、订单金额、商品数量等信息,

  • KYLIN_CATEGORY_GROUPINGS

    维度表,保存了商品分类的详细介绍,例如商品分类名称等。

  • KYLIN_CAL_DT

    维度表,保存了时间的扩展信息。如单个日期所在的年始、月始、周始、年份、月份等。

  • KYLIN_ACCOUNT

    维度表,用户账户表,每行是一个用户。用户在事实表中可以是买方(Buyer)或者卖方(Seller)。通过 ACCOUNT_ID 链接到 KYLIN_SALES 的 BUYER_ID 或者 SELLER_ID 上。

  • KYLIN_COUNTRY

    维度表,用户所在的国家表,链接到 KYLIN_ACCOUNT

这5张表一起构成了整个雪花模型的结构,下图是实例-关系(ER)图:

样例数据表

数据表与关系

通过脚本 sample.sh 生成的 Hive 表中包含的列较多,下面以样例项目 learn_kylin 中模型 kylin_sales_models 中被定义为维度的列为主,介绍一些主要的列。

字段意义
KYLIN_SALESTRANS_ID订单 ID
KYLIN_SALESPART_DT订单日期
KYLIN_SALESLEAF_CATEG_ID商品分类 ID
KYLIN_SALESLSTG_SITE_ID网站 ID
KYLIN_SALESSELLER_ID卖家 ID
KYLIN_SALESBUYER_ID买家 ID
KYLIN_SALESPRICE订单金额
KYLIN_SALESITEM_COUNT购买商品个数
KYLIN_SALESLSTG_FORMAT_NAME订单交易类型
KYLIN_SALESOPS_USER_ID系统用户 ID
KYLIN_SALESOPS_REGION系统用户地区
KYLIN_CATEGORY_GROUPINGSUSER_DEFINED_FIELD1用户定义字段 1
KYLIN_CATEGORY_GROUPINGSUSER_DEFINED_FIELD3用户定义字段 3
KYLIN_CATEGORY_GROUPINGSUPD_DATE更新日期
KYLIN_CATEGORY_GROUPINGSUPD_USER更新负责人
KYLIN_CATEGORY_GROUPINGSMETA_CATEG_NAME一级分类
KYLIN_CATEGORY_GROUPINGSCATEG_LVL2_NAME二级分类
KYLIN_CATEGORY_GROUPINGSCATEG_LVL3_NAME三级分类
KYLIN_CAL_DTCAL_DT日期
KYLIN_CAL_DTWEEK_BEG_DT周始日期
KYLIN_CAL_DTMONTH_BEG_DT月始日期
KYLIN_CAL_DTYEAR_BEG_DT年始日期
KYLIN_ACCOUNTACCOUNT_ID用户账户 ID
KYLIN_ACCOUNTACCOUNT_COUNTRY账户所在国家 ID
KYLIN_ACCOUNTACCOUNT_BUYER_LEVEL买家账户等级
KYLIN_ACCOUNTACCOUNT_SELLER_LEVEL卖家账户等级
KYLIN_ACCOUNTACCOUNT_CONTACT账户联系方式
KYLIN_COUNTRYCOUNTRY国家 ID
KYLIN_COUNTRYNAME国家名称