SQL Server connection reference

Learn about the fields used to create an SQL Server connection with ThoughtSpot DataFlow.

Here is a list of the fields for an SQL Server connection in ThoughtSpot DataFlow. You need specific information to establish a seamless and secure connection.

Connection properties

Connection name

Name your connection. Mandatory field.

Example

SQLServerConnection

Connection type

Choose the SQL Server connection type. Mandatory field.

Example:

SQL Server

SQL server type

Specify the SQL server type, either On-premise, Azure SQL database, or SQL server on Cloud VM. Mandatory field.

Default:

On-premise

Authentication type

Specifies the type of security protocol to connect to the instance. Based on the type of security, select the authentication type and provide details. Mandatory field.

Valid Values:

Database credentials, Active directory password, Active directory service principal, Active directory MSI

Other notes:

Field appears when you select "Azure SQL database" as server type.

Host

Specify the hostname or the IP address of the SQL Server system. Mandatory field.

Example:

www.example.com

Instance

Specify an instance with all SQL Server databases run by a single SQL Server service. This option appears when SQL server type is "On-premise" or "SQL Server on Cloud VM". To access, select the box next to Named instance. When selected, Instance replaces the Port option.

Port

Specify the port associated with the SQL Server system. This option appears when SQL server type is "Azure SQL database", or when the Named instance option is not selected. Mandatory field.

Example:

1234

User

Specify the user id that will be used to connect to the SQL Server system. This user should have necessary privileges to access the data in the databases. Mandatory field.

Example:

userdi

Password

Specify the password for the User.

Mandatory field.

Example:

pswrd234%!

AAD secure principal id

Specify the Azure Active Directory secure principal id. Field appears when you select the "Active directory service principal" authentication type.

AAD secure principal secret

Specify the Azure Active Directory secure principal secret. Field appears when you select the "Active directory service principal" authentication type.

Azure AD User

This option appears when you select "Azure SQL database" in SQL server type. Select the checkbox next to Azure AD User to provide Azure Active Directory authentication details.

JDBC options

Specify the options associated with the JDBC URL.

Optional field.

Example:
jdbc:sqlserver://[serverName[\instanceName][:portNumber]]
Other notes:

Advanced configuration.

Sync properties

Data extraction mode

Specify the extraction type. Optional field.

Example:

JDBC

Valid Values:

JDBC, BCP

Default:

JDBC

Column delimiter

Specify the column delimiter character. Mandatory field.

Example:

1

Valid Values:

Any printable ASCII character or decimal value for ASCII character

Default:

1

Null value

Specifies the string literal that indicates the null value in the extracted data. During the data load, the column value matching this string loads as null in the target. Optional field.

Example:

NULL

Valid Values:

Any string literal

Default:

NULL

Enclosing character

Specify if the text columns in the source data needs to be enclosed in quotes. Optional field.

Example:

DOUBLE

Valid Values:

SINGLE, DOUBLE

Default:

DOUBLE

Other notes:

This is required if the text data has newline character or delimiter character.

Escape character

Specify the escape character if using a text qualifier in the source data. Optional field.

Example:

\"

Valid Values:

Any ASCII character

Default:

\"

Max ignored rows

Abort the transaction after encountering 'n' ignored rows. Optional field.

Example:

0

Valid Values:

Any numeric value

Default:

0

tsload options

Specifies the parameters passed with the tsload command, in addition to the commands already included by the application. The format for these parameters is:

<param_1_name> = <param_1_value>
Example:
date_time_format = %Y-%m-%d
date_format = %Y-%m-%d;time_format = %H:%M:%S
Valid Values:
null_value = NULL
max_ignored_rows = 0
Default:
max_ignored_rows = 0

Related information