检索对象内容

最后更新时间:2020-08-25 17:53:23

    简介

    本文档提供关于检索对象内容操作相关的 API 概览以及 SDK 示例代码。

    API 操作名 操作描述
    SELECT Object Content 检索对象内容 从指定对象(CSV 格式或者 JSON 格式)中检索内容

    SDK API 参考

    SDK 所有接口的具体参数与方法说明,请参考 SDK API

    检索对象内容

    功能说明

    COS Select 支持检索以下格式的对象数据:

    • CSV 格式:对象以 CSV 格式存储,并以固定的分隔符划分。
    • JSON 格式:对象以 JSON 格式存储,可以是 JSON 文件或者 JSON 列表。

    注意:

    • 使用 COS Select,您必须具有 cos:GetObject 的授权。
    • CSV、JSON 对象需要以 UTF-8 格式编码。
    • COS Select 支持检索 GZIP 或者 BZIP2 压缩的 CSV、JSON 对象。
    • COS Select 支持检索 SSE-COS 加密的 CSV、JSON 对象。

    示例代码

    try
    {
        string bucket = "examplebucket-1250000000"; //存储桶,格式:BucketName-APPID
        string key = "exampleobject"; //对象键
    
        SelectObjectRequest request = new SelectObjectRequest(bucket, key);
    
        ObjectSelectionFormat.JSONFormat jSONFormat = new ObjectSelectionFormat.JSONFormat();
        jSONFormat.Type = "DOCUMENT";
        jSONFormat.RecordDelimiter = "\n";
    
        string outputFile = "select_local_file.json";
    
        request.setExpression("Select * from COSObject")
                .setInputFormat(new ObjectSelectionFormat(null, jSONFormat))
                .setOutputFormat(new ObjectSelectionFormat(null, jSONFormat))
                .SetCosProgressCallback(delegate (long progress, long total) {
                    Console.WriteLine("OnProgress : " + progress + "," + total);
                })
                .outputToFile(outputFile)
                ;
    
        SelectObjectResult selectObjectResult =  cosXml.selectObject(request);
        Console.WriteLine(selectObjectResult.stat);
    }
    catch (COSXML.CosException.CosClientException clientEx)
    {
        Console.WriteLine("CosClientException: " + clientEx.StackTrace);
        Console.WriteLine("CosClientException: " + clientEx.Message);
    }
    catch (COSXML.CosException.CosServerException serverEx)
    {
        Console.WriteLine("CosServerException: " + serverEx.GetInfo());
    }

    说明:

    更多完整示例,请前往 GitHub 查看。

    Was this page helpful?

    本页内容是否解决了您的问题?

    • 完全没帮助
    • 文档较差
    • 文档一般
    • 文档不错
    • 文档很好
    反馈
    帮助