Extracting Object Content

Last updated: 2020-12-17 15:51:34


    This document provides an overview of the API and SDK code samples related to extracting object content.

    API Operation Description
    SELECT Object Content Extracting object content Extracts the content of a specified object (in CSV or JSON format)

    SDK API Reference

    For the parameters and method descriptions of all the APIs in the SDK, see Api Documentation.

    Extracting Object Content

    API description

    This API is used by the COS Select feature to extract objects in the following formats:

    • CSV: an object is stored in CSV format with its data records separated with a specific delimiter.
    • JSON: an object is stored in JSON format, which can be either a JSON file or a JSON list.


    • To use COS Select, you must have the permission for cos:GetObject.
    • CSV- or JSON-formatted objects need to be encoded in UTF-8.
    • COS Select can extract CSV- or JSON-formatted objects compressed by gzip or bzip2.
    • COS Select can extract CSV- or JSON-formatted objects encrypted with SSE-COS.

    Sample code

        string bucket = "examplebucket-1250000000"; // Bucket name in the format: BucketName-APPID
        string key = "exampleobject"; // Object key
        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);
        SelectObjectResult selectObjectResult =  cosXml.selectObject(request);
    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());


    For the complete sample, go to GitHub.