(SQL Server) Upload File with User-Defined Metadata

Demonstrates how to upload a file with user-defined metadata to the Amazon S3 service.

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

-- Important: See this note about string length limitations for strings returned by sp_OAMethod calls.
--
CREATE PROCEDURE ChilkatSample
AS
BEGIN
    DECLARE @hr int
    -- Important: Do not use nvarchar(max).  See the warning about using nvarchar(max).
    DECLARE @sTmp0 nvarchar(4000)
    -- This example assumes the Chilkat API to have been previously unlocked.
    -- See Global Unlock Sample for sample code.

    DECLARE @http int
    -- Use "Chilkat_9_5_0.Http" for versions of Chilkat < 10.0.0
    EXEC @hr = sp_OACreate 'Chilkat.Http', @http OUT
    IF @hr <> 0
    BEGIN
        PRINT 'Failed to create ActiveX component'
        RETURN
    END

    -- Insert your AWS keys here:
    EXEC sp_OASetProperty @http, 'AwsAccessKey', 'AWS_ACCESS_KEY'
    EXEC sp_OASetProperty @http, 'AwsSecretKey', 'AWS_SECRET_KEY'

    DECLARE @bucketName nvarchar(4000)
    SELECT @bucketName = 'chilkat.ocean'
    DECLARE @objectName nvarchar(4000)
    SELECT @objectName = 'seahorse.jpg'
    DECLARE @localFilePath nvarchar(4000)
    SELECT @localFilePath = 'qa_data/jpg/seahorse.jpg'
    DECLARE @contentType nvarchar(4000)
    SELECT @contentType = 'image/jpg'

    -- User-defined metadata are name/value pairs, and are added to the HTTP request header.
    -- Header names must begin with "x-amz-meta-" to distinguish them from other HTTP headers.
    -- Note that Amazon S3 stores user-defined metadata keys in lowercase.

    -- For example, to add genus=Hippocampus, we do this:
    EXEC sp_OAMethod @http, 'SetRequestHeader', NULL, 'x-amz-meta-genus', 'Hippocampus'

    -- Add a few more user-metadata key pairs.
    EXEC sp_OAMethod @http, 'SetRequestHeader', NULL, 'x-amz-meta-species', 'big-belly seahorse'
    EXEC sp_OAMethod @http, 'SetRequestHeader', NULL, 'x-amz-meta-habitat', 'shallow tropical and temperate waters'

    DECLARE @success int
    EXEC sp_OAMethod @http, 'S3_UploadFile', @success OUT, @localFilePath, @contentType, @bucketName, @objectName

    IF @success <> 1
      BEGIN
        EXEC sp_OAGetProperty @http, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
      END
    ELSE
      BEGIN

        PRINT 'File uploaded.'
      END

    EXEC @hr = sp_OADestroy @http


END
GO