(Tcl) Azure Table Insert Entity

See more Azure Table Service Examples

Insert an entity into an Azure table.

For more information, see https://docs.microsoft.com/en-us/rest/api/storageservices/insert-entity

Chilkat Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

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

set rest [new_CkRest]

# 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
set bTls 1
set port 443
set bAutoReconnect 1
set success [CkRest_Connect $rest "myaccount.table.core.windows.net" $port $bTls $bAutoReconnect]
if {$success != 1} then {
    puts "ConnectFailReason: [CkRest_get_ConnectFailReason $rest]"
    puts [CkRest_lastErrorText $rest]
    delete_CkRest $rest
    exit
}

# Provide Azure Cloud credentials for the REST call.
set azAuth [new_CkAuthAzureStorage]

CkAuthAzureStorage_put_AccessKey $azAuth "AZURE_ACCESS_KEY"
# The account name used here should match the 1st part of the domain passed in the call to Connect (above).
CkAuthAzureStorage_put_Account $azAuth "myaccount"
CkAuthAzureStorage_put_Scheme $azAuth "SharedKey"
CkAuthAzureStorage_put_Service $azAuth "Table"

# This causes the "x-ms-version: 2019-07-07" header to be automatically added.
CkAuthAzureStorage_put_XMsVersion $azAuth "2019-07-07"
set success [CkRest_SetAuthAzureStorage $rest $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"  
# }  

set json [new_CkJsonObject]

CkJsonObject_UpdateString $json "PartitionKey" "mypartitionkey"
CkJsonObject_UpdateString $json "RowKey" "myrowkey"
CkJsonObject_UpdateString $json "Timestamp" "2013-08-22T01:12:06.2608595Z"
CkJsonObject_UpdateString $json "Address" "Mountain View"
CkJsonObject_UpdateInt $json "Age" 23
CkJsonObject_UpdateNumber $json "AmountDue" "200.23"
CkJsonObject_UpdateString $json "CustomerCode" "c9da6455-213d-42c9-9a79-3e9149a57833"
CkJsonObject_UpdateString $json "CustomerSince" "2008-07-10T00:00:00"
CkJsonObject_UpdateBool $json "IsActive" 1
CkJsonObject_UpdateString $json "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
CkRest_AddHeader $rest "Accept" "application/json;odata=nometadata"
CkRest_AddHeader $rest "Prefer" "return-no-content"
CkRest_AddHeader $rest "Content-Type" "application/json"

set sbRequestBody [new_CkStringBuilder]

CkJsonObject_EmitSb $json $sbRequestBody
set sbResponseBody [new_CkStringBuilder]

# IMPORTANT: Change "mytable" to the name of your actual table.
set success [CkRest_FullRequestSb $rest "POST" "/mytable" $sbRequestBody $sbResponseBody]
if {$success != 1} then {
    puts [CkRest_lastErrorText $rest]
    delete_CkRest $rest
    delete_CkAuthAzureStorage $azAuth
    delete_CkJsonObject $json
    delete_CkStringBuilder $sbRequestBody
    delete_CkStringBuilder $sbResponseBody
    exit
}

# A status code of 204 is a success response for the case where Prefer=return-no-content.
set respStatusCode [CkRest_get_ResponseStatusCode $rest]
puts "Response Status Code = $respStatusCode"
if {$respStatusCode >= 400} then {
    puts "Response Header:"
    puts [CkRest_responseHeader $rest]
    puts "Response Body:"
    puts [CkStringBuilder_getAsString $sbResponseBody]
    delete_CkRest $rest
    delete_CkAuthAzureStorage $azAuth
    delete_CkJsonObject $json
    delete_CkStringBuilder $sbRequestBody
    delete_CkStringBuilder $sbResponseBody
    exit
}

puts "Success."

delete_CkRest $rest
delete_CkAuthAzureStorage $azAuth
delete_CkJsonObject $json
delete_CkStringBuilder $sbRequestBody
delete_CkStringBuilder $sbResponseBody