简介
查询数据集功能是由 数据万象（Cloud Infinite，CI）提供的，数据万象将处理能力与 COS SDK 完全结合，您可以直接按照本篇文档指引进行使用。
本文档提供关于查询数据集的相关 API 概览以及 SDK 示例代码。
注意：
API | 操作描述 |
查询数据集 |
查询数据集
功能说明
查询一个数据集（Dataset）信息。
方法原型
public DescribeDatasetResponse describeDataset(DescribeDatasetRequest customRequest)
请求示例
DescribeDatasetRequest request = new DescribeDatasetRequest();request.setAppId("1234567890");//设置数据集名称，同一个账户下唯一。;是否必传：是request.setDatasetname("数据集名称");//设置是否需要实时统计数据集中文件相关信息。有效值： false：不统计，返回的文件的总大小、数量信息可能不正确也可能都为0。 true：需要统计，返回数据集中当前的文件的总大小、数量信息。 默认值为false。;是否必传：否request.setStatistics(false);DescribeDatasetResponse response = client.describeDataset(request);
参数说明
Request： 中的具体数据描述如下
参数名称 | 描述 | 类型 | 是否必传 |
AppId | String | 是 | |
datasetname | 数据集名称，同一个账户下唯一。 | String | 是 |
statistics | 该参数用于指定是否需要立即统计一次数据集中最新的文件数量、大小等数据，参数有效值： false：不立即统计，接口返回的文件总大小、数量等数据存在10分钟的延迟。 true：立即统计，接口返回的文件总大小、数量等统计数据为实时统计的，统计实时数据需要一定时间，请耐心等待。 默认值为 false。 | boolean | 否 |
响应参数说明：
DescribeDatasetResponse 中的具体数据描述如下：
参数名称 | 描述 | 类型 |
requestId | 请求 ID | String |
dataset | 数据集信息 | Container |
Dataset 中的具体数据描述如下：
参数名称 | 描述 | 类型 |
region | 园区信息 | String |
templateId | 模板 ID | String |
description | 数据集描述信息 | String |
createTime | 数据集创建时间的时间戳，格式为 RFC3339Nano | String |
updateTime | 数据集修改时间的时间戳，格式为 RFC3339Nano 创建数据集后，如果未更新过数据集，则数据集修改时间的时间戳和数据集创建时间的时间戳相同 | String |
bindCount | 数据集当前绑定的 COS Bucket 数量 | Integer |
fileCount | 数据集当前文件数量 | Integer |
totalFileSize | 数据集中当前文件总大小，单位为字节 | Integer |
datasetName | 数据集名称 | String |
返回结果说明
成功：返回 DescribeDatasetResponse 对象响应信息。
失败：发生错误（如 Bucket 不存在），抛出异常 CosClientException 或者 CosServiceException。详情请参见 异常处理。
