C++

Azure Table Insert Entity

See more Azure Table Service Examples

Insert an entity into an Azure table. C++

#include <CkRest.h>
#include <CkAuthAzureStorage.h>
#include <CkJsonObject.h>
#include <CkStringBuilder.h>

void ChilkatSample(void)
    {
    bool success = false;

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    CkRest rest;

    // IMPORTANT: Make sure to change "myaccount" to your actual Azure Storage Account name.
    // IMPORTANT: Also change "mytable" to the name of your Azure table.
    // We're going to POST to this URL:  https://myaccount.table.core.windows.net/mytable
    bool bTls = true;
    int port = 443;
    bool bAutoReconnect = true;
    success = rest.Connect("myaccount.table.core.windows.net",port,bTls,bAutoReconnect);
    if (success != true) {
        std::cout << "ConnectFailReason: " << rest.get_ConnectFailReason() << "\r\n";
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

    // Provide Azure Cloud credentials for the REST call.
    CkAuthAzureStorage azAuth;
    azAuth.put_AccessKey("AZURE_ACCESS_KEY");
    // The account name used here should match the 1st part of the domain passed in the call to Connect (above).
    azAuth.put_Account("myaccount");
    azAuth.put_Scheme("SharedKey");
    azAuth.put_Service("Table");

    // This causes the "x-ms-version: 2019-07-07" header to be automatically added.
    azAuth.put_XMsVersion("2019-07-07");
    success = rest.SetAuthAzureStorage(azAuth);

    // Note: The application does not need to explicitly set the following
    // headers: Content-Length, x-ms-date, Authorization.  These headers
    // are automatically set by Chilkat.

    // Note: The above code does not need to be repeatedly called for each REST request.
    // The rest object can be setup once, and then many requests can be sent.  Chilkat will automatically
    // reconnect within a FullRequest* method as needed.  It is only the very first connection that is explicitly
    // made via the Connect method.

    // Use this online tool to generate code from sample JSON:
    // Generate Code to Create JSON

    // The following JSON is sent in the request body.

    // {  
    //    "PartitionKey":"mypartitionkey",  
    //    "RowKey":"myrowkey",  
    //    "Timestamp":"2013-08-22T01:12:06.2608595Z",  
    //    "Address":"Mountain View",  
    //    "Age":23,  
    //    "AmountDue":200.23,  
    //    "CustomerCode":"c9da6455-213d-42c9-9a79-3e9149a57833",  
    //    "CustomerSince":"2008-07-10T00:00:00",  
    //    "IsActive":true,  
    //    "NumberOfOrders":"255"  
    // }  

    CkJsonObject json;
    json.UpdateString("PartitionKey","mypartitionkey");
    json.UpdateString("RowKey","myrowkey");
    json.UpdateString("Timestamp","2013-08-22T01:12:06.2608595Z");
    json.UpdateString("Address","Mountain View");
    json.UpdateInt("Age",23);
    json.UpdateNumber("AmountDue","200.23");
    json.UpdateString("CustomerCode","c9da6455-213d-42c9-9a79-3e9149a57833");
    json.UpdateString("CustomerSince","2008-07-10T00:00:00");
    json.UpdateBool("IsActive",true);
    json.UpdateString("NumberOfOrders","255");

    // IMPORTANT: Pay attention to the options for nometadata, minimalmetadata, or fullmetadata.
    // See the Azure table service API documentation at https://docs.microsoft.com/en-us/rest/api/storageservices/insert-entity
    rest.AddHeader("Accept","application/json;odata=nometadata");
    rest.AddHeader("Prefer","return-no-content");
    rest.AddHeader("Content-Type","application/json");

    CkStringBuilder sbRequestBody;
    json.EmitSb(sbRequestBody);
    CkStringBuilder sbResponseBody;
    // IMPORTANT: Change "mytable" to the name of your actual table.
    success = rest.FullRequestSb("POST","/mytable",sbRequestBody,sbResponseBody);
    if (success != true) {
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

    // A status code of 204 is a success response for the case where Prefer=return-no-content.
    int respStatusCode = rest.get_ResponseStatusCode();
    std::cout << "Response Status Code = " << respStatusCode << "\r\n";
    if (respStatusCode >= 400) {
        std::cout << "Response Header:" << "\r\n";
        std::cout << rest.responseHeader() << "\r\n";
        std::cout << "Response Body:" << "\r\n";
        std::cout << sbResponseBody.getAsString() << "\r\n";
        return;
    }

    std::cout << "Success." << "\r\n";
    }