Manage the Microsoft SQL Server Connector

Describes the Microsoft SQL Server connector.

Self-Service Analytics’s SQL Server connector lets you access the data available in the SQL query engine using the Self-Service Analytics client. The minimum version of Microsoft SQL you can use is v12.0 (SQL Server 2014).

Before you can establish a connection from Self-Service Analytics to SQL Server storage, a connector server needs to be installed and configured. See Manage Connectors and Connector Servers for general instructions and Connect to Microsoft SQL Server for details specific to the Microsoft SQL Server connector.

After setting up the connector, create data sources that specify the necessary connection information and identify the data you want to use. See Create and Manage Data Sources for more information. After you set up your data sources, create dashboards, self service reports, and visuals from the data in these data sources.

Feature Support

Connector support for specific features is shown in the following table.

Key: Y - Supported; N - Not Supported; N/A - not applicable

Feature	Supported?
Admin-Defined Functions	Y
Box Plots	Y
Custom SQL Queries	Y
Derived Fields (Row-Level Expressions)	Y
Distinct Counts	Y
Fast Distinct Values	N/A
Group By Multiple Fields	Y
Group By Time	Y
Group By UNIX Time	Y
Histogram Floating Point Values	Y
Histograms	Y
Kerberos Authentication	N
Last Value	Y
Live Mode and Playback	Y
Multivalued Fields	N/A
Nested Fields	N/A
Partitions	N
Pushdown Joins for Fusion Data Sources	Y
Schemas	Y
Text Search	N/A
TLS	Y
User Delegation	N
Wildcard Filters	Y
Wildcard Filters, Case-Insensitive Mode	Y
Wildcard Filters, Case-Sensitive Mode	N

Connect to Microsoft SQL Server

When establishing a connection to SQL Server, you need to provide the following.

• Specify the connection name and JDBC URL. The JDBC URL for SQL Server database being connected, must be in the format jdbc:sqlserver://MYSQLSERVERHOST:PORT;databaseName=DATABASE.

• If not using the default PORT of 1433, you can specify a port.

  For example: jdbc:sqlserver://MYSQLSERVERHOST:1434;databaseName=AdventureWorks2014.

• If authentication is required, provide the username and password.

For more information on building your connection url, see https://learn.microsoft.com/en-us/sql/connect/jdbc/building-the-connection-url.

Support for Azure Synapse Data Sources

This connector can also be used to connect to Azure Synapse data sources with the following caveats:

• If you use offset, pagination is implemented using the ROW_NUMBER() function.
• When you use a LIKE pattern, use square brackets [ ] as the escape characters.
• When using the IIF function, use the CASE expression.