Fast Synapse Deploy (Prerelease)

[!CAUTION] Prerelease version, not intended for production.

Overview

This task will deploy Azure Synapse artifacts using the publish branch.

Major Features

• Optimized for speed using connection pooling and multiple async requests to the Synapse API.
• Leverages Azure CLI for authentication.
• Supports HTTP_PROXY, HTTPS_PROXY, and NO_PROXY environment variables.

Pre-requisites for the task

Requires Azure CLI installed on the agents.

Not Supported

• Deploying from branch other than publish (requires arm template file & parameters file)
• Deploying ManagedPrivateEndpoints (use the official Microsoft task)
• Incremental deployment (probably not needed given the speed optimizations)

Should I use this task?

• If the official Microsoft task doesn't meet your needs, give it a try. This task allows for more async requests, resulting in a faster deployment.

SYNAPSE_API_LIMIT

This task seeks to deploy artifacts as quickly as possible. To that end, it will make multiple concurrent requests to the Synapse API. Depending on usage patterns (multiple and/or frequent deployments, for example), the Synapse API might respond with TooManyRequests [429]. The SYNAPSE_API_LIMIT environment variable is used to limit the number of concurrent requests to try and mitigate this issue. Unfortunately, the Synapse API does not implement a retry-after header, so the entire deploy must be terminated.

Release Notes

• 1.0.11

  • Replace parameters fix

• 1.0.10

  • Improved JSON parsing & retry logic
  • Dependency updates including fix for breaking change in ChainedTokenCredential
  • Reduced SYNAPSE_API_LIMIT default from unlimited to 150

• 1.0.9

  • Initial public release