Sample code for 30+ languages & platforms
SQL Server

OneDrive -- Streaming File Upload

See more OneDrive Examples

Uploads a local file by path to the signed-in user's OneDrive. This uses OneDrive's simple upload API to upload in a single API call. Uploading in this way only supports files up to 4MB in size. The 4MB limitation is a OneDrive limitation, not a Chilkat limitation. (See the other example(s) for uploading larger files.)

Chilkat SQL Server Downloads

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.

    -- This example uses the OAuth client credentials flow.
    -- See How to Create an Azure App Registration for OAuth 2.0 Client Credentials

    -- Use your client ID, client secret, and tenant ID in the following lines
    DECLARE @json int
    EXEC @hr = sp_OACreate 'Chilkat.JsonObject', @json OUT
    IF @hr <> 0
    BEGIN
        PRINT 'Failed to create ActiveX component'
        RETURN
    END

    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'client_id', '2871da2c-8176-4b7f-869b-2311aa82e743'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'client_secret', '2hu9Q~r5QuryUcEkNbg1btLtnfU1VUXzhSCG6brH'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'scope', 'https://graph.microsoft.com/.default'
    EXEC sp_OAMethod @json, 'UpdateString', @success OUT, 'token_endpoint', 'https://login.microsoftonline.com/114d7ed6-71bf-4dbe-a866-748364121bf2/oauth2/v2.0/token'

    DECLARE @http int
    EXEC @hr = sp_OACreate 'Chilkat.Http', @http OUT

    EXEC sp_OAMethod @json, 'Emit', @sTmp0 OUT
    EXEC sp_OASetProperty @http, 'AuthToken', @sTmp0

    -- To upload in a single HTTP request, send a PUT request such as the following:

    -- 	PUT /v1.0/users/{$user-id}/drive/root:/{item-path}:/content
    -- 	Content-type: text/plain
    -- 	Content-Length: <the actual content length>
    -- 
    -- 	The contents of the file goes here.

    -- Note: This example can upload any type of file.
    -- Chilkat automatically adds the Content-Length header.

    DECLARE @req int
    EXEC @hr = sp_OACreate 'Chilkat.HttpRequest', @req OUT

    EXEC sp_OASetProperty @req, 'HttpVerb', 'PUT'
    -- Use your actual user-id instead of "4fe732c3-322e-4a6b-b729-2fd1eb5c6104"
    EXEC sp_OASetProperty @req, 'Path', '/v1.0/users/4fe732c3-322e-4a6b-b729-2fd1eb5c6104/drive/root:/TestDir/penguins.jpg:/content'
    -- Indicate the local file to be streamed in the upload.
    EXEC sp_OAMethod @req, 'StreamBodyFromFile', @success OUT, 'qa_data/jpg/penguins.jpg'
    -- If you're uploading a file and don't know what the Content-Type should be,
    -- just use "application/octet-stream".  See below for an example..
    EXEC sp_OASetProperty @req, 'ContentType', 'image/jpeg'

    DECLARE @resp int
    EXEC @hr = sp_OACreate 'Chilkat.HttpResponse', @resp OUT

    EXEC sp_OAMethod @http, 'HttpSReq', @success OUT, 'graph.microsoft.com', 443, 1, @req, @resp
    IF @success = 0
      BEGIN
        EXEC sp_OAGetProperty @http, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @json
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @req
        EXEC @hr = sp_OADestroy @resp
        RETURN
      END

    -- If successful, a 201 status code is returned, with the driveItem object in the response body for the newly created file.
    EXEC sp_OASetProperty @json, 'EmitCompact', 0
    EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
    EXEC sp_OAMethod @json, 'Load', @success OUT, @sTmp0

    EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
    IF @iTmp0 <> 201
      BEGIN

        -- Here is an example of an error:

        -- 		{
        -- 		  "error": {
        -- 		    "code": "nameAlreadyExists",
        -- 		    "message": "An item with the same name already exists under the parent",
        -- 		    "innerError": {
        -- 		      "request-id": "22302ba5-b885-4b67-9e20-8f6801aec372",
        -- 		      "date": "2017-06-03T14:22:27"
        -- 		    }
        -- 		  }
        -- 		}
        -- 
        -- 		Response status = 409

        EXEC sp_OAMethod @json, 'Emit', @sTmp0 OUT
        PRINT @sTmp0

        EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
        PRINT 'Response status = ' + @iTmp0
        EXEC @hr = sp_OADestroy @json
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @req
        EXEC @hr = sp_OADestroy @resp
        RETURN
      END

    -- Success.  Examine the driveItem JSON object:
    EXEC sp_OAMethod @json, 'Emit', @sTmp0 OUT
    PRINT @sTmp0

    PRINT '-- Success --'

    -- Here is a sample successful response:

    -- 	{
    -- 	  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/drive/root/$entity",
    -- 	  "@microsoft.graph.downloadUrl": "https://s5ucmg.dm2301.livefilestore.com/y4p0MT4NGBshn3EMBjrq8NuU3c_3Bt4DBz0BjZiQPNhiCDj3DjXEHrMr71M6wAGRrvT6WJmPIqNo_lxBP4Uen5MXFVtO3Dz_tdZ531hC_J9fb-eU6CoEmvjonwapmTorJb6hbi6g8VNxBQLItDyVgWM-InmxoNRo0N6xpcAuIbKZccN5vuctIs-Wqxefaza19thlu__bOl8kfG_SkgsrbBzKdTjOS0phBhIi8kYo9wG25k",
    -- 	  "createdBy": {
    -- 	    "application": {
    -- 	      "displayName": "Chilkat",
    -- 	      "id": "441c9990"
    -- 	    },
    -- 	    "user": {
    -- 	      "displayName": "Matt Smith",
    -- 	      "id": "3a33fceb9b74cc15"
    -- 	    }
    -- 	  },
    -- 	  "createdDateTime": "2017-06-03T14:23:52.153Z",
    -- 	  "cTag": "aYzozQTMzRkNFQjlCNzRDQzE1ITQ4NjMuMjU3",
    -- 	  "eTag": "aM0EzM0ZDRUI5Qjc0Q0MxNSE0ODYzLjA",
    -- 	  "id": "3A33FCEB9B74CC15!4863",
    -- 	  "lastModifiedBy": {
    -- 	    "application": {
    -- 	      "displayName": "Chilkat",
    -- 	      "id": "441c9990"
    -- 	    },
    -- 	    "user": {
    -- 	      "displayName": "Matt Smith",
    -- 	      "id": "3a33fceb9b74cc15"
    -- 	    }
    -- 	  },
    -- 	  "lastModifiedDateTime": "2017-06-03T14:23:52.153Z",
    -- 	  "name": "penguins.jpg",
    -- 	  "parentReference": {
    -- 	    "driveId": "3a33fceb9b74cc15",
    -- 	    "id": "3A33FCEB9B74CC15!4862",
    -- 	    "name": "someFolder",
    -- 	    "path": "/drive/root:/someFolder"
    -- 	  },
    -- 	  "size": 777835,
    -- 	  "webUrl": "https://1drv.ms/i/s!ABXMdJvr_DM6pX8",
    -- 	  "file": {
    -- 	    "hashes": {
    -- 	      "sha1Hash": "DF7BE9DC4F467187783ACA68C7CE98E4DF2172D0"
    -- 	    },
    -- 	    "mimeType": "image/jpeg",
    -- 	    "processingMetadata": true
    -- 	  },
    -- 	  "fileSystemInfo": {
    -- 	    "createdDateTime": "2017-06-03T14:23:52.153Z",
    -- 	    "lastModifiedDateTime": "2017-06-03T14:23:52.153Z"
    -- 	  }
    -- 	}

    -- ------------------------------------------------------------------------------------
    -- Now let's upload some file where we don't know what the Content-Type should be.
    -- 
    -- In this case, we're uploading the same JPG file but instead of providing "image/jpeg" for the
    -- Content-Type, we provide "application/octet-stream".  ("application/octet-stream" is the general
    -- HTTP content-type used for anything unkown.  "octet" is a synonym for "byte".  It's just a way of
    -- saying: Here's a stream of bytes that comprise the file.)

    -- Also, you'll notice in the successful JSON response (below), that Microsoft automatically
    -- detected the Content-Type as "image/jpeg", because the mimeType is set as such.
    -- It is likely Microsoft set the MIME type (i.e. Content-Type) based on the file extension, or even better
    -- it may have determined the MIME type by examining the initial bytes of the file to find the standard 
    -- identifying markers that signify common file types such as PDF, JPG, ZIP, and many more.

    -- In a nutshell:  Don't worry about setting the ContentType precisely. If you know it, great.  If not, just
    -- use "application/octet-stream".

    EXEC sp_OASetProperty @req, 'HttpVerb', 'PUT'
    -- Use your actual user-id instead of "4fe732c3-322e-4a6b-b729-2fd1eb5c6104"
    EXEC sp_OASetProperty @req, 'Path', '/v1.0/users/4fe732c3-322e-4a6b-b729-2fd1eb5c6104/drive/root:/TestDir/penguins2.jpg:/content'
    EXEC sp_OAMethod @req, 'StreamBodyFromFile', @success OUT, 'qa_data/jpg/penguins.jpg'
    EXEC sp_OASetProperty @req, 'ContentType', 'application/octet-stream'

    EXEC sp_OAMethod @http, 'HttpSReq', @success OUT, 'graph.microsoft.com', 443, 1, @req, @resp
    IF @success = 0
      BEGIN
        EXEC sp_OAGetProperty @http, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @json
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @req
        EXEC @hr = sp_OADestroy @resp
        RETURN
      END

    EXEC sp_OAGetProperty @resp, 'BodyStr', @sTmp0 OUT
    EXEC sp_OAMethod @json, 'Load', @success OUT, @sTmp0
    EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
    IF @iTmp0 <> 201
      BEGIN
        EXEC sp_OAMethod @json, 'Emit', @sTmp0 OUT
        PRINT @sTmp0

        EXEC sp_OAGetProperty @resp, 'StatusCode', @iTmp0 OUT
        PRINT 'Response status = ' + @iTmp0
        EXEC @hr = sp_OADestroy @json
        EXEC @hr = sp_OADestroy @http
        EXEC @hr = sp_OADestroy @req
        EXEC @hr = sp_OADestroy @resp
        RETURN
      END
    -- Success.  Examine the driveItem JSON object:
    EXEC sp_OAMethod @json, 'Emit', @sTmp0 OUT
    PRINT @sTmp0

    PRINT '-- Success --'

    -- 	{
    -- 	  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/drive/root/$entity",
    -- 	  "@microsoft.graph.downloadUrl": "https://s5ucmg.dm2301.livefilestore.com/y4pKX-VIcxZfOUa1iYzGo7K4dX8an2xkcL7i-bb1YLE2ralUEPAixycWzekSn6-lUl5ojvZLQzpce45pgX2SIZfHe9l9scGcYu1viPHxKQ67Xh5b6iMhQNwbjbPQdr3ez6DET55DL25f7kS-fnksazALBtHiTLYayEqMc3WokdQYPsCj7AtzyNPzgKh6ye9R0FxM6ZRS5y6ARY23dIWuGkAKE9lKLgC4PPjvgNBBvl7zi8",
    -- 	  "createdBy": {
    -- 	    "application": {
    -- 	      "displayName": "Chilkat",
    -- 	      "id": "441c9990"
    -- 	    },
    -- 	    "user": {
    -- 	      "displayName": "Matt Smith",
    -- 	      "id": "3a33fceb9b74cc15"
    -- 	    }
    -- 	  },
    -- 	  "createdDateTime": "2017-06-03T14:30:22.017Z",
    -- 	  "cTag": "aYzozQTMzRkNFQjlCNzRDQzE1ITQ4NjUuMjU3",
    -- 	  "eTag": "aM0EzM0ZDRUI5Qjc0Q0MxNSE0ODY1LjA",
    -- 	  "id": "3A33FCEB9B74CC15!4865",
    -- 	  "lastModifiedBy": {
    -- 	    "application": {
    -- 	      "displayName": "Chilkat",
    -- 	      "id": "441c9990"
    -- 	    },
    -- 	    "user": {
    -- 	      "displayName": "Matt Smith",
    -- 	      "id": "3a33fceb9b74cc15"
    -- 	    }
    -- 	  },
    -- 	  "lastModifiedDateTime": "2017-06-03T14:30:22.017Z",
    -- 	  "name": "penguins2.jpg",
    -- 	  "parentReference": {
    -- 	    "driveId": "3a33fceb9b74cc15",
    -- 	    "id": "3A33FCEB9B74CC15!4862",
    -- 	    "name": "someFolder",
    -- 	    "path": "/drive/root:/someFolder"
    -- 	  },
    -- 	  "size": 777835,
    -- 	  "webUrl": "https://1drv.ms/i/s!ABXMdJvr_DM6pgE",
    -- 	  "file": {
    -- 	    "hashes": {
    -- 	      "sha1Hash": "DF7BE9DC4F467187783ACA68C7CE98E4DF2172D0"
    -- 	    },
    -- 	    "mimeType": "image/jpeg",
    -- 	    "processingMetadata": true
    -- 	  },
    -- 	  "fileSystemInfo": {
    -- 	    "createdDateTime": "2017-06-03T14:30:22.016Z",
    -- 	    "lastModifiedDateTime": "2017-06-03T14:30:22.016Z"
    -- 	  }
    -- 	}

    EXEC @hr = sp_OADestroy @json
    EXEC @hr = sp_OADestroy @http
    EXEC @hr = sp_OADestroy @req
    EXEC @hr = sp_OADestroy @resp


END
GO