跳转至

AIR 新手引导

快速入门

准备数据集

如果是云上试用客户，可以直接跳过这一步，因为一般开通的客户数据源都已经提前添加好了。

  • 第一步：选择“数据源”菜单 AIR 新手引导_image_1.png

  • 第二步：点击“新建数据源” AIR 新手引导_image_2.png

  • 第三步：选择想连接的数据源，进入数据源添加页面。 AIR 新手引导_image_3.png AIR 新手引导_image_4.png 标“”的项代表必填项，填入服务器ip，端口等，非标“”的项都可以默认不填任何信息，一般DB的连接都需要选择Master认证，填入DB的用户名和密码，完成后点击保存，即可完成数据源的添加工作。 AIR 新手引导_image_5.png 备注：数据源添加完成后，AIR会自动采集数据源中的库表等数据信息，且源端的表结构变化后，元数据采集系统会自动同步相关变更的表结构（默认30分钟采集一次，可通过编辑数据源的配置来设置元数据的采集同步周期），也可以手工点击数据源或者表右上角的元数据刷新来手动同步。 元数据的采集过程可能会有一定延时，取决于源端库表的数量多少，以及数据库本身的性能。

进行数据探查

  • 第一步，选择“工作簿”，首次进入需要创建一个新的工作簿，点击“新建工作簿”
  • 第二步，进入工作簿编辑界面，左侧会显示当前已有的数据源和数据空间的列表， -- 注意对应的数据源名称是否是跟当前环境相同。如：gauss.tpcds SELECT item.i_brand,ss_ext_sales_price,store_sales.ss_item_sk,item.i_item_sk,item.i_manufact_id FROM gauss.tpcds.store_sales, gauss.tpcds.item WHERE store_sales.ss_item_sk = item.i_item_sk AND item.i_manufact_id >= 128 limit 1000 AIR 新手引导_image_6.png 在工作簿可以执行任意SQL，且左侧显示的所有列表的数据，都可以按照“数据源名称”.“数据空间名称”.“表名”的方式来查询，或者跟其它数据源中的表进行Join等任何符合引擎SQL语法的取数操作。

制作一个视图

  • 第一步，进入“视图”界面，如果首次进入，可能没有任何已有的数据空间，这时可以选择“新建数据空间” 输入“demo”，新建一个名为demo的数据空间，数据空间的名称必须输入英文名，便于编写SQL。

  • 第二步，如果是新建了一个数据空间，接下来还需要在该数据空间下再新建一个文件夹，点击“新建文件夹”，输入“demo”的文件夹，到此，创建视图的前期准备工作就完成了。

  • 第三步，创建一个视图之前，需先选择一个文件夹，点击“新建视图”

  • 第四步，输入以下SQL，可以点击查询进行数据查询预览（ 注意：当前SQL查询默认是不加任何limit，建议进行数据预览时加上limit 100，否则查询结果返回过大会导致预览数据时间耗时很长 ） -- 注意对应的数据源名称是否是跟当前环境相同。如：gauss.tpcds SELECT item.i_brand,ss_ext_sales_price,store_sales.ss_item_sk,item.i_item_sk,item.i_manufact_id FROM gauss.tpcds.store_sales, gauss.tpcds.item WHERE store_sales.ss_item_sk = item.i_item_sk AIR 新手引导_image_7.png

  • 第五步，视图创建成功后，即可在工作簿中查询该视图了。如下： select * from demo.demo.store_sales_join_item limit 10; AIR 新手引导_image_8.png

执行一次加速

  • 第一步，选择某个视图，或者是某个PDS，这里我们选择前面刚刚创建的View，

  • 第二步，在视图详情页面，进一步选择“投影”标签页。

  • 第三步，创建一个明细投影 出现以下状态，代表RP已经构建成功了。
  • 第四步，查看加速命中效果，输入如下SQL（可以看到sql1和sql2都可以命中加速）： --sql1 select * from demo.demo.store_sales_join_item limit 10;

--sql2 SELECT item.i_brand,ss_ext_sales_price,store_sales.ss_item_sk,item.i_item_sk,item.i_manufact_id FROM gauss.tpcds.store_sales, gauss.tpcds.item WHERE store_sales.ss_item_sk = item.i_item_sk AND item.i_manufact_id >= 128 limit 1000 AIR 新手引导_image_9.png

创建一个数据服务

  • 第一步，选择“数据服务”菜单，首次进入需要创建一个服务分类，点击“新建服务分类”，输入“demo”新建一个demo的服务分类
  • 第二步，选择刚刚创建的“demo”服务类目，点击“新建数据服务”，进入数据服务新建界面。

  • 第三步，输入以下sql： select * from demo.demo.store_sales_join_item where i_manufact_id=${country} AIR 新手引导_image_10.png

  • 第四步，服务发布上线，进入服务列表，选择刚刚创建的那个数据服务。 点击“发布至线上” 如果服务列表看到服务显示为以下状态，代表服务发布成功。

  • 第五步，使用服务，可以打开任何第三方工具，例如Postman，其中userKey、tenantName，workspaceName，需要向账号创建方获取。

查看SQL执行详情

  • 第一步，点击“查询记录”，可以进入当前用户的执行SQL记录列表，我们可以根据SQL的JobId或者sql内容（关键词）来检索对应的SQL查询记录。如下图：
  • 第二步，点击某条SQL的内容，可进入该SQL的执行详细记录页面 查看查询命中RP加速的详情 查看候选RP：当前查询SQL的执行计划详情，例如当前查询参考了哪些RP，有真正选用了哪些RP，包括执行计划的一些优化。 查看当前SQL是否下推，以及哪些算子下推导源