(SQL Server) S3 Download Specific Version of File

Demonstrates how to download a file from the Amazon S3 service using the versionId query parameter.

Note: This example requires Chilkat v9.5.0.89 or later. (A problem regarding AwsSubResources w/ downloads was fixed shortly after the v9.5.0.88 release.)

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 requires 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

    EXEC sp_OASetProperty @http, 'AwsAccessKey', 'AWS_ACCESS_KEY'
    EXEC sp_OASetProperty @http, 'AwsSecretKey', 'AWS_SECRET_KEY'
    EXEC sp_OASetProperty @http, 'S3Ssl', 1
    EXEC sp_OASetProperty @http, 'AwsRegion', 'us-east-1'
    EXEC sp_OASetProperty @http, 'AwsEndpoint', 's3.amazonaws.com'
    EXEC sp_OASetProperty @http, 'AwsSubResources', 'versionId=x8UPzRsgskmbe55lEQvhLi25PQl2lcFH'

    DECLARE @bucketName nvarchar(4000)
    SELECT @bucketName = 'chilkat100'
    DECLARE @objectName nvarchar(4000)
    SELECT @objectName = 'frenchUtf8.txt'
    DECLARE @localFilePath nvarchar(4000)
    SELECT @localFilePath = 'qa_output/frenchUtf8.txt'

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

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

        PRINT 'File downloaded.'
      END

    EXEC @hr = sp_OADestroy @http


END
GO