Microsoft SQL Server

This guide describes how to connect Aporia to an MSSQL data source in order to monitor your ML Model in production.

We will assume that your model inputs, outputs and optionally delayed actuals can be queried with SQL. This data source may also be used to connect to your model's training set to be used as a baseline for model monitoring.

Access MSSQL using user/password authentication

In order to provide access to MSSQL, create a read-only user for Aporia in MSSQL.

Please use the SQL snippet below to create the user for Aporia. Before using the snippet, you will need to populate the following:

• <user_name>: The name of the user you want to create

• <password>: Strong password to be used by the user

CREATE USER <user_name> WITH PASSWORD '<password>';
ALTER ROLE db_datareader ADD MEMBER <user_name>;

Access MSSQL using Azure AD authentication

This authentication method is currently supported for databricks deployments only. Need it for other deployment type? Let us know!

Step 1: Create a new application for Aporia access in your Azure Active Directory

1. Go the Azure Active Directory portal and login

2. Click on + Add and choose App registration

   
3. Insert a display name for the Aporia app and click on Register

4. Create a new secret for the newly created application

   

   Click on "Add a certificate or secret"

   

   Click on "+ New client secret"

   

   Save the newly created secret for later

Step 2: Create corresponding secrets in your databricks account

In order to enable authentication using Azure AD, create the following secrets in the same databricks account where Aporia is deployed:

• aporia-client-secret - The application secret value you created in the previous step

• aporia-client-id - Client ID of the application created in the previous step

• aporia-tenant-id - Tenant ID of the application created in the previous step

Client ID & Tenant ID can be found in the application page

Step 3: Create a read-only user for MSSQL access

In order to provide access to MSSQL, create a read-only user for Aporia in MSSQL.

Please use the SQL snippet below to create the user for Aporia. Before using the snippet, you will need to populate the following:

• <application_name>: The name of the application you have created in the previous step

CREATE USER <application_name> FROM EXTERNAL PROVIDER;
ALTER ROLE db_datareader ADD MEMBER <application_name>;

Make sure that the Aporia data plane IP can access your Microsoft SQL Server

Create a MSSQL data source in Aporia

1. Go to Aporia platform and login to your account.
2. Go to Integrations page and click on the Data Connectors tab

3. Scroll to Connect New Data Source section

4. Click Connect on the MSSQL card and follow the instructions

   1. Note that the provided URL should be in the following format jdbc:mssqlsql://<SERVER_HOSTNAME>.

Bravo! 👏 now you can use the data source you've created across all your models in Aporia.