数据集相关

更新时间：2025-08-11

获取数据集列表

使用以下代码可以查询数据集列表

                Java
                
            

                DescribeDatasetsRequest request = new DescribeDatasetsRequest();
try {
    // 方式1：传统调用方式
    System.out.println("--- 方式1：传统调用方式 ---");
    DescribeDatasetsResponse response = client.dataset().describeDatasets(request);
    System.out.println("数据集总数: " + (response.getDatasets() != null ? response.getDatasets().size() : 0));
    
    // 打印完整的JSON响应
    System.out.println("\n=== API返回的JSON数据 ===");
    String jsonResponse = JsonUtils.toJsonString(response);
    System.out.println(jsonResponse);
} catch (BceClientException e) {
    System.out.println("API调用失败: " + e.getMessage());
}
            

注意:

根据接口文档填写具体的访问参数，相关接口文档详见 API参考/数据集相关接口/获取数据集列表

获取数据集详情

使用以下代码可以查询数据集详情

                Java
                
            

                DescribeDatasetRequest request = new DescribeDatasetRequest();
// 设置必选参数
request.setDatasetId(System.getenv("DATASET_ID"));  // 数据集ID

try {
    // 方式1：传统调用方式（向后兼容）
    System.out.println("--- 方式1：传统调用方式 ---");
    DescribeDatasetResponse response = client.dataset().describeDataset(request);
    System.out.println("数据集ID: " + response.getId());
    System.out.println("数据集名称: " + response.getName());
    System.out.println("存储类型: " + response.getStorageType());
    System.out.println("存储实例: " + response.getStorageInstance());
    System.out.println("导入格式: " + response.getImportFormat());
    System.out.println("描述: " + response.getDescription());
    System.out.println("所有者: " + response.getOwner());
    System.out.println("所有者名称: " + response.getOwnerName());
    System.out.println("可见范围: " + response.getVisibilityScope());
    System.out.println("权限: " + response.getPermission());
    System.out.println("最新版本ID: " + response.getLatestVersionId());
    System.out.println("最新版本号: " + response.getLatestVersion());
    System.out.println("创建时间: " + response.getCreatedAt());
    System.out.println("更新时间: " + response.getUpdatedAt());
    
    // 打印最新版本信息
    if (response.getLatestVersionEntry() != null) {
        DescribeDatasetResponse.DatasetVersionEntry latestVersionEntry = response.getLatestVersionEntry();
        System.out.println("\n=== 最新版本信息 ===");
        System.out.println("版本ID: " + latestVersionEntry.getId());
        System.out.println("版本号: " + latestVersionEntry.getVersion());
        System.out.println("版本描述: " + latestVersionEntry.getDescription());
        System.out.println("存储路径: " + latestVersionEntry.getStoragePath());
        System.out.println("挂载路径: " + latestVersionEntry.getMountPath());
        System.out.println("创建用户: " + latestVersionEntry.getCreateUser());
        System.out.println("创建用户名: " + latestVersionEntry.getCreateUserName());
        System.out.println("版本创建时间: " + latestVersionEntry.getCreatedAt());
        System.out.println("版本更新时间: " + latestVersionEntry.getUpdatedAt());
    }
    
    // 打印用户权限列表
    if (response.getVisibilityUser() != null && !response.getVisibilityUser().isEmpty()) {
        System.out.println("\n=== 用户权限列表 ===");
        for (DescribeDatasetResponse.PermissionEntry user : response.getVisibilityUser()) {
            System.out.println("用户ID: " + user.getId() + ", 用户名: " + user.getName() + ", 权限: " + user.getPermission());
        }
    }
    
    // 打印用户组权限列表
    if (response.getVisibilityGroup() != null && !response.getVisibilityGroup().isEmpty()) {
        System.out.println("\n=== 用户组权限列表 ===");
        for (DescribeDatasetResponse.PermissionEntry group : response.getVisibilityGroup()) {
            System.out.println("用户组ID: " + group.getId() + ", 用户组名: " + group.getName() + ", 权限: " + group.getPermission());
        }
    }
    
    // 打印完整的JSON响应
    System.out.println("\n=== API返回的JSON数据 ===");
    String jsonResponse = JsonUtils.toJsonString(response);
    System.out.println(jsonResponse);
} catch (BceClientException e) {
    System.out.println("API调用失败: " + e.getMessage());
}
            

注意:

根据接口文档填写具体的访问参数，相关接口文档详见 API参考/数据集相关接口/获取数据集详情

创建数据集

                Java
                
            

                CreateDatasetRequest request = new CreateDatasetRequest();

// 设置必选参数
request.setName("test-dataset-11111");  // 数据集名称
request.setStorageType("BOS");  // 存储类型：PFS 或 BOS
request.setStorageInstance("bucket1");  // 存储实例ID
request.setImportFormat("FOLDER");  // 导入格式：FILE 或 FOLDER
request.setVisibilityScope("USER_GROUP");  // 可见范围：ALL_PEOPLE、ONLY_OWNER、USER_GROUP

// 设置可选参数
request.setDescription("test dataset");  // 数据集描述
request.setOwner("xxx");  // 修改为实际的owner id（可选）

// 设置用户权限列表（可选）
List<CreateDatasetRequest.PermissionEntry> visibilityUser = new ArrayList<>();
CreateDatasetRequest.PermissionEntry user1 = new CreateDatasetRequest.PermissionEntry();
user1.setId("xxxxx"); // 修改为实际的user id
user1.setName("lisi");
user1.setPermission("r");  // 只读权限
visibilityUser.add(user1);

CreateDatasetRequest.PermissionEntry user2 = new CreateDatasetRequest.PermissionEntry();
user2.setId("xxxxx"); // 修改为实际的user id
user2.setName("wangwu");
user2.setPermission("rw");  // 读写权限
visibilityUser.add(user2);

request.setVisibilityUser(visibilityUser);

// 设置用户组权限列表（可选）
List<CreateDatasetRequest.PermissionEntry> visibilityGroup = new ArrayList<>();
CreateDatasetRequest.PermissionEntry group1 = new CreateDatasetRequest.PermissionEntry();
group1.setId("group1");
group1.setName("开发组");
group1.setPermission("r");
visibilityGroup.add(group1);

request.setVisibilityGroup(visibilityGroup);

// 设置初始版本信息（必选）
CreateDatasetRequest.DatasetVersionEntry initVersionEntry = new CreateDatasetRequest.DatasetVersionEntry();
initVersionEntry.setDescription("dataset first version");
initVersionEntry.setStoragePath("/path/to/dir");
initVersionEntry.setMountPath("/mnt/datasets/test1");
request.setInitVersionEntry(initVersionEntry);

try {
    System.out.println("=== 开始创建数据集 ===");
    System.out.println("数据集名称: " + request.getName());
    System.out.println("存储类型: " + request.getStorageType());
    System.out.println("存储实例: " + request.getStorageInstance());
    System.out.println("导入格式: " + request.getImportFormat());
    System.out.println("可见范围: " + request.getVisibilityScope());
    System.out.println("描述: " + request.getDescription());
    
    // 方式1：传统调用方式（向后兼容）
    System.out.println("\n--- 方式1：传统调用方式 ---");
    CreateDatasetResponse response = client.dataset().createDataset(request);
    System.out.println("数据集创建成功！");
    System.out.println("数据集ID: " + response.getId());
    System.out.println("Request ID: " + response.getMetadata().getBceRequestId());
    
    // 打印完整的JSON响应
    System.out.println("\n=== API返回的JSON数据 ===");
    String jsonResponse = JsonUtils.toJsonString(response);
    System.out.println(jsonResponse);
    
    System.out.println("\n=== 创建的数据集信息 ===");
    System.out.println("数据集ID: " + response.getId());
    System.out.println("数据集名称: " + request.getName());
    System.out.println("存储类型: " + request.getStorageType());
    System.out.println("存储实例: " + request.getStorageInstance());
    System.out.println("导入格式: " + request.getImportFormat());
    System.out.println("可见范围: " + request.getVisibilityScope());
    System.out.println("描述: " + request.getDescription());
    System.out.println("初始版本描述: " + initVersionEntry.getDescription());
    System.out.println("存储路径: " + initVersionEntry.getStoragePath());
    System.out.println("挂载路径: " + initVersionEntry.getMountPath());
    
} catch (BceClientException e) {
    System.out.println("API调用失败: " + e.getMessage());
}
            

注意：

根据接口文档填写具体的访问参数，相关接口文档详见 API参考/数据集相关接口/创建数据集

修改数据集

                Java
                
            

                ModifyDatasetRequest request = new ModifyDatasetRequest();

// 设置必选参数
request.setDatasetId(System.getenv("DATASET_ID"));  // 数据集ID

// 设置可选参数（根据需要修改）
request.setName("my-dataset-1");  // 数据集名称
request.setDescription("my dataset test modify");  // 数据集描述
request.setVisibilityScope("ALL_PEOPLE");  // 可见范围：ALL_PEOPLE、ONLY_OWNER、USER_GROUP

// 设置用户权限列表（可选）
List<ModifyDatasetRequest.PermissionEntry> visibilityUser = new ArrayList<>();
ModifyDatasetRequest.PermissionEntry user1 = new ModifyDatasetRequest.PermissionEntry();
user1.setId("xxxxx");
user1.setName("lisi");
user1.setPermission("r");  // 只读权限
visibilityUser.add(user1);

ModifyDatasetRequest.PermissionEntry user2 = new ModifyDatasetRequest.PermissionEntry();
user2.setId("xxxxx");
user2.setName("wangwu");
user2.setPermission("rw");  // 读写权限
visibilityUser.add(user2);

// request.setVisibilityUser(visibilityUser);

// 设置用户组权限列表（可选）
List<ModifyDatasetRequest.PermissionEntry> visibilityGroup = new ArrayList<>();
ModifyDatasetRequest.PermissionEntry group1 = new ModifyDatasetRequest.PermissionEntry();
group1.setId("group1");
group1.setName("开发组");
group1.setPermission("r");
visibilityGroup.add(group1);

// request.setVisibilityGroup(visibilityGroup);

try {
    System.out.println("=== 开始修改数据集 ===");
    System.out.println("数据集ID: " + request.getDatasetId());
    System.out.println("新名称: " + request.getName());
    System.out.println("新描述: " + request.getDescription());
    System.out.println("新可见范围: " + request.getVisibilityScope());
    
    // 方式1：传统调用方式（向后兼容）
    System.out.println("\n--- 方式1：传统调用方式 ---");
    ModifyDatasetResponse response = client.dataset().modifyDataset(request);
    System.out.println("数据集修改成功！");
    System.out.println("Request ID: " + response.getMetadata().getBceRequestId());
    
    // 打印完整的JSON响应
    System.out.println("\n=== API返回的JSON数据 ===");
    String jsonResponse = JsonUtils.toJsonString(response);
    System.out.println(jsonResponse);
    
    System.out.println("\n=== 修改的数据集信息 ===");
    System.out.println("数据集ID: " + request.getDatasetId());
    System.out.println("数据集名称: " + request.getName());
    System.out.println("数据集描述: " + request.getDescription());
    System.out.println("可见范围: " + request.getVisibilityScope());
    
    if (request.getVisibilityUser() != null && !request.getVisibilityUser().isEmpty()) {
        System.out.println("用户权限列表:");
        for (ModifyDatasetRequest.PermissionEntry user : request.getVisibilityUser()) {
            System.out.println("  - 用户ID: " + user.getId() + ", 用户名: " + user.getName() + ", 权限: " + user.getPermission());
        }
    }
    
    if (request.getVisibilityGroup() != null && !request.getVisibilityGroup().isEmpty()) {
        System.out.println("用户组权限列表:");
        for (ModifyDatasetRequest.PermissionEntry group : request.getVisibilityGroup()) {
            System.out.println("  - 用户组ID: " + group.getId() + ", 用户组名: " + group.getName() + ", 权限: " + group.getPermission());
        }
    }
    
} catch (BceClientException e) {
    System.out.println("API调用失败: " + e.getMessage());
}
            

注意：

根据接口文档填写具体的访问参数，相关接口文档详见 API参考/数据集相关接口/修改数据集

删除数据集

                Java
                
            

                DeleteDatasetRequest request = new DeleteDatasetRequest();
// 设置必选参数
request.setDatasetId(System.getenv("DATASET_ID"));  // 数据集ID

try {
    System.out.println("=== 开始删除数据集 ===");
    System.out.println("数据集ID: " + request.getDatasetId());
    
    // 方式1：传统调用方式（向后兼容）
    System.out.println("\n--- 方式1：传统调用方式 ---");
    DeleteDatasetResponse response = client.dataset().deleteDataset(request);
    System.out.println("数据集删除成功！");
    System.out.println("Request ID: " + response.getMetadata().getBceRequestId());
    
    // 打印完整的JSON响应
    System.out.println("\n=== API返回的JSON数据 ===");
    String jsonResponse = JsonUtils.toJsonString(response);
    System.out.println(jsonResponse);
    
    System.out.println("\n=== 注意事项 ===");
    System.out.println("删除操作是不可逆的，数据集及其所有版本将被永久删除。");
    System.out.println("请确保您要删除的数据集不再被使用。");
    
} catch (BceClientException e) {
    System.out.println("API调用失败: " + e.getMessage());
}
            

注意：

根据接口文档填写具体的访问参数，相关接口文档详见 API参考/数据集相关接口/删除数据集

获取数据集版本列表

                Java
                
            

                DescribeDatasetVersionsRequest request = new DescribeDatasetVersionsRequest();
// 设置必选参数
request.setDatasetId(System.getenv("DATASET_ID"));  // 数据集ID
// 设置可选参数
request.setPageNumber(1);  // 第1页
request.setPageSize(10);   // 每页10条

try {
    // 方式1：传统调用方式（向后兼容）
    System.out.println("--- 方式1：传统调用方式 ---");
    DescribeDatasetVersionsResponse response = client.dataset().describeDatasetVersions(request);
    System.out.println("数据集版本总数: " + response.getTotalCount());
    System.out.println("当前页版本数量: " + (response.getVersions() != null ? response.getVersions().size() : 0));
    
    // 打印版本列表
    if (response.getVersions() != null && !response.getVersions().isEmpty()) {
        System.out.println("\n=== 数据集版本列表 ===");
        for (int i = 0; i < response.getVersions().size(); i++) {
            DescribeDatasetVersionsResponse.DatasetVersionEntry version = response.getVersions().get(i);
            System.out.println("\n--- 版本 " + (i + 1) + " ---");
            System.out.println("版本ID: " + version.getId());
            System.out.println("版本号: " + version.getVersion());
            System.out.println("版本描述: " + version.getDescription());
            System.out.println("存储路径: " + version.getStoragePath());
            System.out.println("挂载路径: " + version.getMountPath());
            System.out.println("创建用户: " + version.getCreateUser());
            System.out.println("创建用户名: " + version.getCreateUserName());
            System.out.println("创建时间: " + version.getCreatedAt());
            System.out.println("更新时间: " + version.getUpdatedAt());
        }
    } else {
        System.out.println("\n=== 数据集版本列表 ===");
        System.out.println("暂无版本数据");
    }
    
    // 打印完整的JSON响应
    System.out.println("\n=== API返回的JSON数据 ===");
    String jsonResponse = JsonUtils.toJsonString(response);
    System.out.println(jsonResponse);
} catch (BceClientException e) {
    System.out.println("API调用失败: " + e.getMessage());
}
            

注意：

根据接口文档填写具体的访问参数，相关接口文档详见 API参考/数据集相关接口/获取数据集版本列表

获取数据集版本详情

                Java
                
            

                DescribeDatasetVersionRequest request = new DescribeDatasetVersionRequest();
// 设置必选参数
request.setDatasetId(System.getenv("DATASET_ID"));  // 数据集ID
request.setVersionId(System.getenv("DATASET_VERSION_ID"));  // 数据集版本ID

try {
    // 方式1：传统调用方式（向后兼容）
    System.out.println("--- 方式1：传统调用方式 ---");
    DescribeDatasetVersionResponse response = client.dataset().describeDatasetVersion(request);
    System.out.println("数据集ID: " + response.getId());
    
    System.out.println("数据集名称: " + response.getName());
    System.out.println("存储类型: " + response.getStorageType());
    System.out.println("存储实例: " + response.getStorageInstance());
    System.out.println("导入格式: " + response.getImportFormat());
    System.out.println("描述: " + response.getDescription());
    System.out.println("所有者: " + response.getOwner());
    System.out.println("所有者名称: " + response.getOwnerName());
    System.out.println("可见范围: " + response.getVisibilityScope());
    System.out.println("权限: " + response.getPermission());
    System.out.println("创建时间: " + response.getCreatedAt());
    System.out.println("更新时间: " + response.getUpdatedAt());
    
    // 打印版本信息
    if (response.getVersionEntry() != null) {
        DescribeDatasetVersionResponse.DatasetVersionEntry versionEntry = response.getVersionEntry();
        System.out.println("\n=== 版本信息 ===");
        System.out.println("版本ID: " + versionEntry.getId());
        System.out.println("版本号: " + versionEntry.getVersion());
        System.out.println("版本描述: " + versionEntry.getDescription());
        System.out.println("存储路径: " + versionEntry.getStoragePath());
        System.out.println("挂载路径: " + versionEntry.getMountPath());
        System.out.println("创建用户: " + versionEntry.getCreateUser());
        System.out.println("创建用户名: " + versionEntry.getCreateUserName());
        System.out.println("版本创建时间: " + versionEntry.getCreatedAt());
        System.out.println("版本更新时间: " + versionEntry.getUpdatedAt());
    }
    
    // 打印用户权限列表
    if (response.getVisibilityUser() != null && !response.getVisibilityUser().isEmpty()) {
        System.out.println("\n=== 用户权限列表 ===");
        for (DescribeDatasetVersionResponse.PermissionEntry user : response.getVisibilityUser()) {
            System.out.println("用户ID: " + user.getId() + ", 用户名: " + user.getName() + ", 权限: " + user.getPermission());
        }
    }
    
    // 打印用户组权限列表
    if (response.getVisibilityGroup() != null && !response.getVisibilityGroup().isEmpty()) {
        System.out.println("\n=== 用户组权限列表 ===");
        for (DescribeDatasetVersionResponse.PermissionEntry group : response.getVisibilityGroup()) {
            System.out.println("用户组ID: " + group.getId() + ", 用户组名: " + group.getName() + ", 权限: " + group.getPermission());
        }
    }
    
    // 打印完整的JSON响应
    System.out.println("\n=== API返回的JSON数据 ===");
    String jsonResponse = JsonUtils.toJsonString(response);
    System.out.println(jsonResponse);
} catch (BceClientException e) {
    System.out.println("API调用失败: " + e.getMessage());
}
            

注意：

根据接口文档填写具体的访问参数，相关接口文档详见 API参考/数据集相关接口/获取数据集版本详情

创建数据集版本

                Java
                
            

                CreateDatasetVersionRequest request = new CreateDatasetVersionRequest();

// 设置必选参数
request.setDatasetId(System.getenv("DATASET_ID"));  // 数据集ID
request.setStoragePath("/path/to/version2");  // 存储路径
request.setMountPath("/mnt/datasets/my-dataset-1/v2");  // 默认挂载路径

// 设置可选参数
request.setDescription("new version");  // 版本描述

try {
    System.out.println("=== 开始创建数据集版本 ===");
    System.out.println("数据集ID: " + request.getDatasetId());
    System.out.println("版本描述: " + request.getDescription());
    System.out.println("存储路径: " + request.getStoragePath());
    System.out.println("挂载路径: " + request.getMountPath());
    
    // 方式1：传统调用方式（向后兼容）
    System.out.println("\n--- 方式1：传统调用方式 ---");
    CreateDatasetVersionResponse response = client.dataset().createDatasetVersion(request);
    System.out.println("数据集版本创建成功！");
    System.out.println("版本ID: " + response.getId());
    System.out.println("Request ID: " + response.getMetadata().getBceRequestId());
    
    // 打印完整的JSON响应
    System.out.println("\n=== API返回的JSON数据 ===");
    String jsonResponse = JsonUtils.toJsonString(response);
    System.out.println(jsonResponse);
    
    System.out.println("\n=== 创建的数据集版本信息 ===");
    System.out.println("数据集ID: " + request.getDatasetId());
    System.out.println("版本ID: " + response.getId());
    System.out.println("版本描述: " + request.getDescription());
    System.out.println("存储路径: " + request.getStoragePath());
    System.out.println("挂载路径: " + request.getMountPath());
    
    System.out.println("\n=== 注意事项 ===");
    System.out.println("新创建的版本将成为数据集的最新版本。");
    System.out.println("请确保存储路径中的数据已经准备好。");
    System.out.println("挂载路径将在使用数据集时生效。");
    
} catch (BceClientException e) {
    System.out.println("API调用失败: " + e.getMessage());
}
            

注意：

根据接口文档填写具体的访问参数，相关接口文档详见 API参考/数据集相关接口/创建数据集版本

删除数据集版本

                Java
                
            

                // 创建请求对象
DeleteDatasetVersionRequest request = new DeleteDatasetVersionRequest();

// 设置必选参数
String datasetId = System.getenv("DATASET_ID");  // 数据集ID - 请替换为实际的数据集ID
String versionId = System.getenv("DATASET_VERSION_ID");  // 数据集版本ID - 请替换为实际的版本ID

request.setDatasetId(datasetId);
request.setVersionId(versionId);

try {
    System.out.println("=== 开始删除数据集版本 ===");
    System.out.println("数据集ID: " + request.getDatasetId());
    System.out.println("版本ID: " + request.getVersionId());
    System.out.println();
    
    // 确认删除操作
    System.out.println("警告：此操作将永久删除指定的数据集版本！");
    System.out.println("请确认您要删除的版本信息是否正确。");
    System.out.println();
    
    // 方式1：传统调用方式（向后兼容）
    System.out.println("--- 方式1：传统调用方式 ---");
    DeleteDatasetVersionResponse response = client.dataset().deleteDatasetVersion(request);
    System.out.println("数据集版本删除成功！");
    System.out.println("Request ID: " + response.getMetadata().getBceRequestId());
    
    // 打印完整的JSON响应
    System.out.println("\n=== API返回的JSON数据 ===");
    String jsonResponse = JsonUtils.toJsonString(response);
    System.out.println(jsonResponse);
    
    System.out.println("\n=== 操作完成 ===");
    System.out.println("数据集版本删除操作已成功完成");
    System.out.println("删除的版本信息：");
    System.out.println("   - 数据集ID: " + datasetId);
    System.out.println("   - 版本ID: " + versionId);
    System.out.println("   - 请求ID: " + response.getMetadata().getBceRequestId());
    
} catch (BceClientException e) {
    System.err.println("API调用失败: " + e.getMessage());
    System.err.println();
    System.err.println("可能的原因：");
    System.err.println("1. 访问密钥无效或权限不足");
    System.err.println("2. 数据集ID或版本ID不存在");
    System.err.println("3. 网络连接问题");
    System.err.println("4. 服务端点不可用");
    System.err.println();
    System.err.println("建议的解决方案：");
    System.err.println("1. 检查环境变量设置是否正确");
    System.err.println("2. 验证数据集ID和版本ID是否存在");
    System.err.println("3. 确认网络连接正常");
    System.err.println("4. 检查账户权限是否足够");
} catch (Exception e) {
    System.err.println("程序执行异常: " + e.getMessage());
    e.printStackTrace();
}
            

注意：

根据接口文档填写具体的访问参数，相关接口文档详见 API参考/数据集相关接口/删除数据集版本

初始化

常用工具

百度智能云

百度百舸 · AI计算平台

百度百舸 · AI计算平台

数据集相关

获取数据集列表

获取数据集详情

创建数据集

修改数据集

删除数据集

获取数据集版本列表

获取数据集版本详情

创建数据集版本

删除数据集版本