通用数据集查询接口

本文介绍了通用数据集查询接口。关于下钻数据集和通用数据集的区别，请参考通用维度与下钻维度。

描述

查询接口与“下钻数据集”相同，ARMSQueryDataSet 主要用于查询 ARMS 中的数据集的数据。

请求参数

请求参数包含 POP 公共参数和业务参数两个部分。公共请求参数请参考 POP 参数说明。

业务参数说明

阿里云将用户所有的请求参数封装在一个 Request 中，返回一个 Response。

ARMSQueryDataSetRequest 包含以下字段：

RequiredDims(OptionalDims) 复合字段说明

• 当您想选择该维度下面的所有的维度值时，type 设置为 ALL，value 为 null。
• 当您想选择该维度下面的其中某个维度值时，type 设置为 STATIC（静态值），value 为输入维度值。
• 当您不想选择该维度时候，可以直接忽略，或者将 type 设置为 DISABLED。

返回参数

返回值为 JSON 串形式返回，可通过 ARMSQueryDataSetResponse.getdata() 获取。

ARMSQueryDataSetResponse 主要字段有：

完整使用示例

1. 在不选择维度情况下，查询所有数据的汇总信息（没有设置必选维度）：

    import java.util.ArrayList;
    import java.util.List;
    import com.aliyuncs.DefaultAcsClient;
    import com.aliyuncs.IAcsClient;
    import com.aliyuncs.arms.model.v20180620.ARMSQueryDataSetRequest;
    import com.aliyuncs.arms.model.v20180620.ARMSQueryDataSetRequest.Dimensions;
    import com.aliyuncs.arms.model.v20180620.ARMSQueryDataSetResponse;
    import com.aliyuncs.exceptions.ClientException;
    import com.aliyuncs.profile.DefaultProfile;
    import com.aliyuncs.profile.IClientProfile;
    public class ARMSGeneralQuery {
        public static void main(String[] args) throws ClientException {
            // 用户主账号/RAM 子账号的 AK，或者 RAM 用户角色的临时安全令牌的 AK
            String accessKeyId = "xxx";
            // 用户主账号/RAM 子账号的 SK，或者 RAM 用户角色的临时安全令牌的 SK
            String accessKeySecret = "xxx";
            //Region和endpoint保持一致，具体内容和ARMS的region绑定，
            String endpoint = "xxx";//例如 cn-hangzhou
            String region = "xxx";//例如 cn-hangzhou
            //产品名请固定填"ARMS"
            String productName = "ARMS";
            //如果是非杭州区域，请改写，如cn-beijing，
            String domain = "arms.cn-hangzhou.aliyuncs.com";
            IClientProfile profile = DefaultProfile.getProfile(region, accessKeyId, accessKeySecret);
            DefaultProfile.addEndpoint(endpoint, region, productName, domain);
            // 设置业务参数
            ARMSQueryDataSetRequest armsQueryDataSetRequest = new ARMSQueryDataSetRequest();
            //DatasetID在数据集管理页面上可查询到
            armsQueryDataSetRequest.setDatasetId(1340l);
            //查询数据的返回间隔，请务必自行保证为60的倍数
            armsQueryDataSetRequest.setIntervalInSec(60);
            //设置查询的起始时间，该例子为查询最近十分钟数据，注意单位为毫秒
            armsQueryDataSetRequest.setMinTime(System.currentTimeMillis() - 600000);
            armsQueryDataSetRequest.setMaxTime(System.currentTimeMillis());
            // ****后续的2、3示例代码插入此处****
            IAcsClient client = new DefaultAcsClient(profile);
            try {
                //发送请求
                ARMSQueryDataSetResponse armsQueryDataSetResponse = client.getAcsResponse(armsQueryDataSetRequest);
                //获取并打印请求结果
                System.out.println(armsQueryDataSetResponse.getData());
            } catch (ClientException e) {
                e.printStackTrace();
            }
        }
    }

2. 请检查您是否配置了“必选维度”。如果没有配置，请忽略该本注意事项。如果配置了“必选维度”，那么在查询时一定要设置“必选维度”相关配置，否则无法进行查询。

   ARMSQueryDataSetRequest.RequiredDims dimensions = new ARMSQueryDataSetRequest.RequiredDims();
   dimensions.setKey("code");//必选维度名称
   dimensions.setValue("CODE");//必选维度值
   dimensions.setType("STATIC");//统一填写STATIC
   List<ARMSQueryDataSetRequest.RequiredDims> dimensionss = new  ArrayList<ARMSQueryDataSetRequest.RequiredDims>();
   dimensionss.add(dimensions);
   armsQueryDataSetRequest.setRequiredDimss(dimensionss);

3. 选择要查询的指标列表，返回结果只返回您指定的指标：

    List<String> measuress = new ArrayList<String>();
    measuress.add("价格");
    measuress.add("数量");
    armsQueryDataSetRequest.setMeasuress(measuress);