Azure MS SQL

Azure MS SQL Database is an intelligent, scalable, and relational database service built for the cloud. It can automate your database management and maintenance, including routine updates, backups, and security, enabling you to focus on working with your data.

You can ingest data from your Azure MS SQL database using Hevo Pipelines and replicate it to a Destination of your choice.

Prerequisites

Whitelisting Hevo’s IP Addresses

You need to whitelist the Hevo IP addresses for your region to enable Hevo to connect to your Azure SQL database. You can do this by creating firewall rules in your Microsoft Azure database settings as follows:

  1. Access your Azure MS SQL instance.

  2. Under Resources, select the database you want to synchronize with Hevo.

    Select Database

  3. In the right pane, click the Set server firewall tab to open the Firewall settings.

    Set Firewall

  4. Create a firewall rule:

    1. Specify a Rule name.
    2. Specify Hevo’s IP addresses in the Start IP and End IP fields as per your region.

      Note: As Hevo has specific IP addresses and not a range, the value in Start IP and End IP fields is the same.

      Set Firewall Rule

    3. Click Save.
    4. Repeat this step to add the IP address for each applicable Hevo region.

Enabling Change Tracking for Logical Replication

The Change Tracking mechanism captures changes made to a database. In order to enable, or disable change tracking, the database user must have the ALTER DATABASE privilege.

To enable change tracking for Logical Replication, connect your Azure SQL Database in your SQL Client tool, and enter these commands:

  • Enable change tracking at the database level:
    ALTER DATABASE [<database>] ; SET CHANGE_TRACKING = ON;

  • Enable change tracking for each table you want to integrate:
    ALTER TABLE [<schema>].[<table>] ; ENABLE CHANGE_TRACKING;

Granting Privileges to a User

The database user specified in the Hevo Pipeline must have the following global privileges:

  • SELECT
  • VIEW CHANGE TRACKING (If Query Mode is Change Tracking)

To set up these privileges, connect your Azure SQL Database in your SQL Client tool, and enter these commands:

  • Grant SELECT privilege:
    GRANT SELECT ON <schema_name>.<table_name> TO <username>;

  • Grant VIEW CHANGE TRACKING privilege, if Query Mode is Change Tracking:
    GRANT VIEW CHANGE TRACKING ON <schema_name>.<table_name> TO <username>;

Limitations

Last updated on 28 Dec 2020