Skip to main content

Azure Synapse dedicated SQL pools

Prophecy's Azure Synapse connector supports connecting to dedicated SQL pools that run Microsoft SQL Server (MSSQL). Use this connection instead of the MSSQL connection when you host MSSQL in Azure Synapse dedicated SQL pool.

This page describes how to set up the connection.

Prerequisites

Prophecy connects to Azure Synapse using the database credentials you provide. These credentials are used to authenticate your session and authorize all data operations during pipeline execution. To use an Azure Synapse connection effectively, your user account must have:

  • SELECT, INSERT, UPDATE, and DELETE on the tables used in your Prophecy pipelines.
  • Access to the database and schema where tables are located.

Feature support

The table below outlines whether the connection supports certain Prophecy features.

FeatureSupported
Read data with a Source gemYes
Write data with a Target gemNo
Browse data in the Environment browserYes

Connection parameters

To create a connection with Azure Synapse, enter the following parameters:

ParameterDescription
Connection NameName to identify your connection
ServerAddress of the server to connect to
PortPort to use for the connection
UsernameUsername for Synapse authentication
DatabaseName of the specific SQL database within your Synapse SQL pool
Password (Secret required)Password for Synapse authentication

Sharing connections within teams

Connections in Prophecy are stored within fabrics, which are assigned to specific teams. Once a Synapse connection is added to a fabric, all team members who have access to the fabric can use the connection in their projects. No additional authentication is required—team members automatically inherit the access and permissions of the stored connection credentials.

caution

Be mindful of the access level granted by the stored credentials. Anyone on the team will have the same permissions—including access to sensitive data if allowed.

To manage this securely, consider creating a dedicated fabric and team for high-sensitivity connections. This way, only approved users have access to those credentials.

Fetching data

Prophecy fetches data from Synapse connections in the following ways:

  • When you browse a Synapse connection in the Environment browser, Prophecy fetches data on demand as you expand folders. You can manually refresh the Environment browser to see updated files.

  • When a pipeline runs, Source gems will read the latest available version of the data. If the schema of your data in Synapse changes, Prophecy will automatically use the new schema.