Prerequisites
We need the following details for Azure Synapse:- Server (SQL endpoint from your Synapse workspace)
- Database
- Username
- Password
- Port (default: 1433)
Permissions
We recommend creating a dedicated user for Seam to ensure audit logs clearly distinguish Seam activity from other operations. At a minimum, the Seam user needs:-
SELECTpermission on tables you want to read from -
INSERTandUPDATEpermissions on tables you want to write to -
CREATE TABLEpermission if you want Seam to create new tables
I. Obtaining Your Server Credentials
- In Azure Portal, navigate to Synapse workspaces.
- Select the workspace you want to connect to.
- Go to Overview.
- Locate the SQL endpoint - this is your Server value.
II. Setting Up a User
Create a dedicated user for Seam in your Azure Synapse Portal:dbo) and permissions as needed for your specific setup.
III. Connecting to Seam
- In Seam, go to Settings → Connections.
- Find Azure Synapse and click Connect.
- Enter your connection details:
- Server: Your SQL endpoint (from Step I)
- Database: The database name
- Username:
seam_user(or your chosen username) - Password: The password you set
- Port: 1433 (default)
- Click Save.
IV. Troubleshooting
Connection Failed
If the connection fails, verify:- Firewall rules: Ensure Seam’s IP addresses are whitelisted in your Azure Synapse firewall settings.
- Credentials: Double-check the server endpoint, database name, username, and password.
- Network policies: Check if your workspace has additional network restrictions.
Tables Do Not Appear in Seam
If tables or schemas are not visible, ensure:- The Seam user has
SELECTpermission on the relevant schemas and tables. - The database name in your connection matches the database containing your tables.
- Tables exist in the schema you’re querying.
Permission Denied Errors
If you encounter permission errors during sync:- Verify the Seam user has appropriate permissions (
SELECT,INSERT,UPDATE,CREATE TABLE). - Check that permissions are granted at both the schema and table level.
- Ensure the user can connect to the specific database.

