{"id":18960,"date":"2022-09-15T10:11:53","date_gmt":"2022-09-15T08:11:53","guid":{"rendered":"https:\/\/www.dbi-services.com\/blog\/?p=18960"},"modified":"2024-09-10T15:48:12","modified_gmt":"2024-09-10T13:48:12","slug":"sql-server-2022-synapse-link","status":"publish","type":"post","link":"https:\/\/www.dbi-services.com\/blog\/sql-server-2022-synapse-link\/","title":{"rendered":"SQL Server 2022 – Azure Synapse Link"},"content":{"rendered":"\n
Why is this feature interesting?<\/h2>\n\n\n\n
The Azure Synapse Link for SQL Server 2022 will enable you to replicate your operational data into Azure Synapse Analytics dedicated SQL pool.<\/p>\n\n\n\n
Azure Synapse is an enterprise analytics service that accelerates time to insight across data warehouses and big data systems. Azure Synapse brings together the best of SQL technologies used in enterprise data warehousing, Spark technologies used for big data, Data Explorer for log and time series analytics, Pipelines for data integration and ETL\/ELT, and deep integration with other Azure services such as Power BI, CosmosDB, and AzureML.<\/p>\n\n\n\n
Diagram of Azure Synapse Analytics architecture.<\/p>\n\n\n\n<\/figure>\n\n\n\n
The advantage of creating a Synapse Link to your SQL server 2022 is that you can replicate your operational data in SQL Server to the Synapse dedicated SQL pool in an automatic way.<\/p>\n\n\n\n
The data is first loaded in a landing zone and than copied to the Synapse dedicated SQL pool. The Azure Data Lake Storage Gen2 account is used for the landing zone. This data lake storage must be dedicated only for this Synapse Link for SQL landing zone.<\/p>\n\n\n\n
You will be able to use the full power of Synapse to analyze your data without impacting the operational applications. You are also able to federate the data of several SQL Server 2022 databases without having to build complicated load processes.<\/p>\n\n\n\n
Prerequisite<\/h2>\n\n\n\n
On Azure side, you need first to have a Synapse workspace created<\/li><\/ul>\n\n\n\n
On your data center side you need to have SQL Server 2022 Instance installed
Make sure to have an master encryption key created on the database you want to link with your Synapse Analytics
CREATE MASTER KEY ENCRYPTION BY PASSWORD = ‘************’<\/li><\/ul><\/li>
Be also sure not to have clustered columnstore indexes on the tables you want to link in Synapse. This is not supported<\/li><\/ul><\/li><\/ul>\n\n\n\n
Create an Azure Data Lake Storage Gen2 account (different from the account created with the Azure Synapse Analytics workspace) used as the landing zone to stage the data submitted by SQL Server 2022.
If you don’t have a container available, create one that will be used for the landing zone of the data coming from your SQL Server 2022 instance on-premises<\/li><\/ul><\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
You will also need a Share Access Signature (SAS) on your container later on to allow to access it
In the Azure portal navigate to your storage account you will use for the landing zone<\/li>
Select the containers<\/li>
Click the ellipse button of the container you created previously<\/li>
Use User delegation key as the signing method<\/li>
Select Read\/Write\/List in the permissions<\/li>
Set the validity period of your signature (max duration is 7 days, after that you have to renew the signature)<\/li>
Defined the IP address of the computer which will access the landing zone container<\/li>
Select the protocol communication protocol<\/li>
Generate the SAS token<\/li>
Copy and save the token generated, you will need it later<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
Make sure that the computer you are working on is allow to access your synapse workspace. Check the firewall rules.<\/li><\/ul>\n\n\n\n
In the Azure portal navigate to your synapse workspace<\/p>\n\n\n\n
select the networking option<\/li>
Enable the checkbox to allow Azure services to access the workspace<\/li>
add the IP address of your client. Check that it appears in the list of rules<\/li>
save your settings.<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
Now that the prerequisites are fulfilled we can start with the real setup of the SQL Server 2022 link with Synapse.<\/p>\n\n\n\n
Create your target Synapse dedicated SQL pool<\/h2>\n\n\n\n
In Azure portal go to the synapse workspace you created and open the synapse studio.<\/p>\n\n\n\n
Select the manage hub <\/li>
Select SQL pool<\/li>
Click the +New to add a new SQL pool <\/li>
Key in a name <\/li>
choose the performance level depending of your needs <\/li>
create your SQL pool.<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
It takes some times until the SQL pool is deployed. Check the online indicator<\/p>\n\n\n\n<\/figure>\n\n\n\n
Create a master key for your synapse SQL Pool.<\/p>\n\n\n\n
go to data hub<\/li>
select your SQL pool <\/li>
create a new SQL script with the empty script option<\/li><\/ul>\n\n\n\n
If you just created your dedicated SQL pool refresh your synapse studio, it might be that the SQL database does not appear in the workspace list.<\/p>\n\n\n\n
<\/p>\n\n\n\n<\/figure>\n\n\n\n
Paste the command CREATE MASTER KEY in the script pane and run it. Be sure the script is successfully executed.<\/p>\n\n\n\n<\/figure>\n\n\n\n
Create linked service for your source SQL Server 2022<\/h2>\n\n\n\n
Create a Self-hosted integration Runtime : is a software agent that you can download and install on your on-premises machine or a virtual machine. It is a required component for synapse to get access to the data on SQL Server 2022<\/p>\n\n\n\n
The Self-hosted Integration Runtime is only supported on Windows Operating System<\/p>\n\n\n\n
Define your owned integration runtime, by opening the dropdown <\/li>
select +New<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
Select the Self-Hosted option <\/li>
validate with continue<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
Define a name unique in the workspace matching the naming convention <\/li>
and click create.<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
I opted for the manual setup. So I downloaded and installed the integration runtime manually. Copy the key in when installing it when required.<\/p>\n\n\n\n<\/figure>\n\n\n\n
When the installation is finished the configuration manager will open. Copy the key provided by the setup in the synapse workspace and click register<\/p>\n\n\n\n<\/figure>\n\n\n\n
Check that the validation is ok and click finish to finalize the registration<\/p>\n\n\n\n<\/figure>\n\n\n\n
Check if the registration is successful<\/p>\n\n\n\n<\/figure>\n\n\n\n
You can now finalize the creation of the linked service on your synapse workspace.<\/p>\n\n\n\n
Check that your integration runtime is valid<\/li>
Capture the name of you on-premises SQL Sever instance<\/li>
Specify the database name<\/li>
Define the authentication to your on-premises SQL Server instance.<\/li>
The last think you can do for this step is verify that your integration runtime is up and running<\/p>\n\n\n\n
Go to the monitor hub<\/li>
Select integration runtimes<\/li>
Check the status of your self-hosted integration runtime<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
<\/p>\n\n\n\n
Create a linked service to connect to your data lake staging area<\/h2>\n\n\n\n
First you have to grant permissions to your Azure data lake gen2 for your synapse workspace to access it. On the Azure portal, go to the Azure Data Lake Storage Gen2 account you created.<\/p>\n\n\n\n
Select the Access Control (IAM) menu.<\/li>
Click +Add, and select Add role assignment.<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
Search for Storage Blob Data Contributor for the selected role<\/li>
Select the line in the list<\/li>
Click next<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
Choose Managed identity in the assign access to section<\/li>
Click select members<\/li><\/ul>\n\n\n\n
In the right pane<\/p>\n\n\n\n
Select the subscription to use<\/li>
Select Synapse workspaces in the managed identity dowpdown<\/li>
Select the synapse workspace you want to grant the role to.<\/li>
Select the AutoResolveIntegrationRuntime connection method<\/li>
Select Accountkey in the authentication type<\/li>
Select the option Fron Azure subscription<\/li>
Select the subscription<\/li>
Select your storage account name to be the destination of your landing zone<\/li>
Test your connection and check if everything is fine<\/li>
Finalize the creation by clicking create<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
Do not to forget to publish the changes when needed<\/p>\n\n\n\n
Click the Publishing command<\/li>
Click the publish button after having reviewed the list of changes to apply<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
Create the Azure synapse link connection<\/h2>\n\n\n\n
First be sure that all the tables you need to replicate in your Synapse have a primary key on the on-premises SQL Server instance side. This is mandatory for the data replication<\/p>\n\n\n\n
Stay in your Synapse Studio to set this configuration<\/p>\n\n\n\n
Go to the integrate hub<\/li>
Click on the +<\/li>
Select the Link connection option<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
Define your new connection to the SQL Server 2022 instance you have on-premises<\/p>\n\n\n\n
In the New link connection window<\/p>\n\n\n\n
Define the source type, in our case SQL Server<\/li>
Select the Source linked server you created previously to bind your SQL Server instance on-premises<\/li>
Select the tables to be replicated on Synapse side<\/li>
Set the number of core dedicated to the connection<\/li>
Select the mode of the connection<\/li>
Sekect the linked service to the landing zone your created previously<\/li>
Select the storage account container you created (see the prerequisite chapter)<\/li>
Copy the storage container SSAS token you generated (see the prerequisite chapter)<\/li>
Click the OK button to create the link connection<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
On the next screen, you will get a summary of the whole link connection your just defined<\/p>\n\n\n\n
Change the target table names, distribution type\/Column and structure type to fit best the data you are dealing with<\/li>
Test again the connection with your SQL Server instance on-premises<\/li>
Publish the link connection your created on your synapse workspace<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
<\/p>\n\n\n\n
Start and control the data replication<\/h2>\n\n\n\n
Now we are finally ready to start the data replication from your SQL Server 2022 on-premises to your Synapse workspace.<\/p>\n\n\n\n
It can take several minutes for the link to take effect and data starting to be replicating.<\/p>\n\n\n\n
It will first create the table structure on the SQL pool, than snapshot the data to make an initial data load and start the replication.<\/p>\n\n\n\n
In the Synapse Analytics Studio<\/p>\n\n\n\n
go to the Integrate hub<\/li>
Select the link connections you create previously<\/li>
Click on the Start button<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
You can follow the status of the data replication from the Synapse Studio<\/p>\n\n\n\n
Go to the monitoring hub<\/li>
Select the Link connection option<\/li>
Be sure that the status is running<\/li>
Notice as well that a warning is displayed indicating the landing zone token has an expiring date. I will have to rotate the key to ensure for the replication to continue working<\/li>
Click on the link connection name to see the detailed information of the replication<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
Check the status of the replication per table you selected. When error occur you will see it here too. In this case you can click on the error to see the error message.<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
Control in the SQL pool that the tables have been created correctly and that they contain data<\/p>\n\n\n\n
From Synapse Analytics Studio<\/p>\n\n\n\n
Select the Data hub<\/li>
From the Workspace tab, expand the table folder of your SQL pool and check the table created. The specific icon in front of the table indicate that it is a linked table<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
Hover on the table name<\/li>
Click the [\u2026] button to create action on the table<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
Select New SQL Script<\/li>
Click on Select TOP 100 rows to generate the query and see the result set<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
The query will be written in the SQL script frame<\/li>
The dataset will be display below<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
You can query your data and check the replication consistency by changing the query.<\/p>\n\n\n\n
You can publish your queries and thus create control script to control if the replication is running as expected.<\/p>\n\n\n\n
Check to be done on SQL Server side<\/h2>\n\n\n\n
There are some checks you can do on your SQL Server side.<\/p>\n\n\n\n
Within the database use to link the tables in Synapse, you will find 3 new system tables in which you can query information about the linked tables using the change feed feature<\/p>\n\n\n\n
You will find connection info used by Synapse to replicate the table through the link service running the following query on your database level:<\/p>\n\n\n\n
use [<YourDatabaseName>]<\/p>\n\n\n\n
select * from sys.database_scoped_credentials<\/p>\n\n\n\n
And check the result you obtain:<\/p>\n\n\n\n
The name of the scoped credential must match your Azure Storage Account container folder your defined<\/li>
The principal id must match the database user id you used to connect to the database through the Microsoft integration Runtime service<\/li><\/ul>\n\n\n\n<\/figure>\n\n\n\n
On table level check the propoties. You notice that the Table is replicated is set to True.<\/p>\n\n\n\n<\/figure>\n\n\n\n
Limitation<\/h2>\n\n\n\n
In the documentation you can find information on the limitations you have at the moment. You will also find the know issues: <\/p>\n\n\n\n
![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-7.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-8-1024x640.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-9-1024x507.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-50.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-10.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-14-1024x476.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-12.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-15.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-13.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-19-1024x474.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-17.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-22.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-18.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-20.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-16.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-21.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-23.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-24.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-25-1024x462.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-26.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-27-1024x726.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-28-1024x733.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-29.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-30-1024x518.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-31.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-32-1024x541.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-35.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-37.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-36.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-34.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-33-1024x495.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-41-1024x496.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-43-1024x339.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-39-1024x329.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-38.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-44.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-40.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-42-1024x388.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-48-1024x326.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-49.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.dbi-services.com\/blog\/wp-content\/uploads\/sites\/2\/2022\/09\/image-47.png\")
<\/figure>\n\n\n\n