Lua

Azure Table Insert Entity

See more Azure Table Service Examples

Insert an entity into an Azure table. Lua

local chilkat = require("chilkat")

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

local rest = chilkat.Rest.new()

-- 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
local bTls = true
local port = 443
local bAutoReconnect = true
local success = rest:connect("myaccount.table.core.windows.net", port, bTls, bAutoReconnect)
if not success then
    print("ConnectFailReason: " .. rest.connect_fail_reason)
    print(rest.last_error_text)
    return
end

-- Provide Azure Cloud credentials for the REST call.
local azAuth = chilkat.AuthAzureStorage.new()
azAuth.access_key = "AZURE_ACCESS_KEY"
-- The account name used here should match the 1st part of the domain passed in the call to Connect (above).
azAuth.account = "myaccount"
azAuth.scheme = "SharedKey"
azAuth.service = "Table"

-- This causes the "x-ms-version: 2019-07-07" header to be automatically added.
azAuth.xms_version = "2019-07-07"
success = rest:set_auth_azure_storage(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"
-- }

local json = chilkat.JsonObject.new()
json:update_string("PartitionKey", "mypartitionkey")
json:update_string("RowKey", "myrowkey")
json:update_string("Timestamp", "2013-08-22T01:12:06.2608595Z")
json:update_string("Address", "Mountain View")
json:update_int("Age", 23)
json:update_number("AmountDue", "200.23")
json:update_string("CustomerCode", "c9da6455-213d-42c9-9a79-3e9149a57833")
json:update_string("CustomerSince", "2008-07-10T00:00:00")
json:update_bool("IsActive", true)
json:update_string("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:add_header("Accept", "application/json;odata=nometadata")
rest:add_header("Prefer", "return-no-content")
rest:add_header("Content-Type", "application/json")

local sbRequestBody = chilkat.StringBuilder.new()
json:emit_sb(sbRequestBody)
local sbResponseBody = chilkat.StringBuilder.new()
-- IMPORTANT: Change "mytable" to the name of your actual table.
success = rest:full_request_sb("POST", "/mytable", sbRequestBody, sbResponseBody)
if not success then
    print(rest.last_error_text)
    return
end

-- A status code of 204 is a success response for the case where Prefer=return-no-content.
local respStatusCode = rest.response_status_code
print("Response Status Code = " .. respStatusCode)
if respStatusCode >= 400 then
    print("Response Header:")
    print(rest.response_header)
    print("Response Body:")
    print(sbResponseBody:get_as_string())
    return
end

print("Success.")