SQL Server

(using AWS Signature Version 2) Streaming Download to File

See more Amazon S3 (new) Examples

The main purpose of this example is to demonstrate how to use the older Signature Version 2 authentication w/ S3. It uses V2 authentication to download a file. SQL Server

-- Important: See this note about string length limitations for strings returned by sp_OAMethod calls.
--
CREATE PROCEDURE ChilkatSample
AS
BEGIN
    DECLARE @hr int
    DECLARE @iTmp0 int
    -- Important: Do not use nvarchar(max).  See the warning about using nvarchar(max).
    DECLARE @sTmp0 nvarchar(4000)
    DECLARE @success int
    SELECT @success = 0

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

    DECLARE @rest int
    EXEC @hr = sp_OACreate 'Chilkat.Rest', @rest OUT
    IF @hr <> 0
    BEGIN
        PRINT 'Failed to create ActiveX component'
        RETURN
    END

    -- Connect to the Amazon AWS REST server.
    DECLARE @bTls int
    SELECT @bTls = 1
    DECLARE @port int
    SELECT @port = 443
    DECLARE @bAutoReconnect int
    SELECT @bAutoReconnect = 1
    -- The file is located in the bucket named "chilkat100", which becomes part of the domain:
    EXEC sp_OAMethod @rest, 'Connect', @success OUT, 'chilkat100.s3.amazonaws.com', @port, @bTls, @bAutoReconnect

    -- Provide AWS credentials for the REST call.
    DECLARE @authAws int
    EXEC @hr = sp_OACreate 'Chilkat.AuthAws', @authAws OUT

    EXEC sp_OASetProperty @authAws, 'AccessKey', 'AWS_ACCESS_KEY'
    EXEC sp_OASetProperty @authAws, 'SecretKey', 'AWS_SECRET_KEY'
    EXEC sp_OASetProperty @authAws, 'ServiceName', 's3'

    -- For AWS Signature Version 2, the following two properties need to be set:
    EXEC sp_OASetProperty @authAws, 'SignatureVersion', 2
    -- See http://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html#ConstructingTheCanonicalizedResourceElement
    EXEC sp_OASetProperty @authAws, 'CanonicalizedResourceV2', '/chilkat100/starfish.jpg'

    EXEC sp_OAMethod @rest, 'SetAuthAws', @success OUT, @authAws

    -- Send the request to download the JPG.
    EXEC sp_OAMethod @rest, 'SendReqNoBody', @success OUT, 'GET', '/starfish.jpg'
    IF @success <> 1
      BEGIN
        EXEC sp_OAGetProperty @rest, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @rest
        EXEC @hr = sp_OADestroy @authAws
        RETURN
      END

    -- Read the response header.
    DECLARE @responseStatusCode int
    EXEC sp_OAMethod @rest, 'ReadResponseHeader', @responseStatusCode OUT
    IF @responseStatusCode < 0
      BEGIN
        EXEC sp_OAGetProperty @rest, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @rest
        EXEC @hr = sp_OADestroy @authAws
        RETURN
      END


    PRINT 'Response status code = ' + @responseStatusCode

    -- We expect a 200 response status if the JPG data is coming.
    -- Otherwise, we'll get a string response body with an error message(or no response body).
    IF @responseStatusCode = 200
      BEGIN

        DECLARE @bodyStream int
        EXEC @hr = sp_OACreate 'Chilkat.Stream', @bodyStream OUT

        -- The stream's sink will be a file.
        EXEC sp_OASetProperty @bodyStream, 'SinkFile', 'qa_output/starfish.jpg'

        -- Read the response body to the stream.  Given that we've
        -- set the stream's sink to a file, it will stream directly
        -- to the file.
        EXEC sp_OAMethod @rest, 'ReadRespBodyStream', @success OUT, @bodyStream, 1
        IF @success <> 1
          BEGIN
            EXEC sp_OAGetProperty @rest, 'LastErrorText', @sTmp0 OUT
            PRINT @sTmp0
            EXEC @hr = sp_OADestroy @rest
            EXEC @hr = sp_OADestroy @authAws
            EXEC @hr = sp_OADestroy @bodyStream
            RETURN
          END


        PRINT 'Successfully received the JPG file.'

      END
    ELSE
      BEGIN
        DECLARE @errResponse nvarchar(4000)
        EXEC sp_OAMethod @rest, 'ReadRespBodyString', @errResponse OUT
        EXEC sp_OAGetProperty @rest, 'LastMethodSuccess', @iTmp0 OUT
        IF @iTmp0 <> 1
          BEGIN
            EXEC sp_OAGetProperty @rest, 'LastErrorText', @sTmp0 OUT
            PRINT @sTmp0
          END
        ELSE
          BEGIN

            PRINT @errResponse
          END
      END

    EXEC @hr = sp_OADestroy @rest
    EXEC @hr = sp_OADestroy @authAws
    EXEC @hr = sp_OADestroy @bodyStream


END
GO