Create SAP Connections
You can create a new SAP IQ, SAP SQL Anywhere, or SAP ASE connection, or connect to an existing connection from the Create New Connection window. See Troubleshoot SAP Issues for more information about troubleshooting connection issues.
Note: This topic focuses on information that may be unfamiliar to you. It does not include all step and field descriptions.
To create an SAP connection
-
Click
on the toolbar (ALT+F+N).
- Select SAP ASE, SAP IQ, or SAP SQL Anywhere from the Group list.
-
Enter the login information. Review the following for additional information:
Login Tab Description Host
Enter the host name for the connection.
Note: This field is only available when you select an SAP IQ or SAP SQL Anywhere connection.
Port
Enter the number of port. Password
Enter the password to use when connecting.
Tip: After connecting, you can set a master password to further secure your connection in Tools | Options| Environment | Security.
CharSet
Enter the client character set such as UTF-8 in this field if it differs from the default character set. This helps you avoid connection issues.
Notes:
-
This field is not case sensitive.
- This field is only available when you select an SAP ASE connection.
Category
Select or create a category if you want to color code Editor tabs for a specific connection. This can help differentiate between development and production databases. You can also set an option to color code the Object Explorer pane and object editor windows (Create, Alter, Drop, etc.). Options Tab Description Language
Default is us_english.
Kerberos
Select whether you want to use Kerberos when connecting.
Default is No.Encryption
Select None if you do not want to use encryption during connecting. Select TLS to use the highest available encryption when connecting. Indicate the path to your certificate file if you want to use TLS encryption. Advanced Tab Description ODBC driver Select an ODBC driver to use for this connection when creating cross-connection queries.
Tip: You can specify the ODBC driver to use for all connections for this database provider in Tools | Options | Database | Oracle.
-
-
Click Connect to save the connection and immediately connect to the database.
or
Click Save to save the connection without connecting to the database.
Tip: Connections are stored in the connections.xml file and can be found by clicking the Application Data Directory link in Help | About.
Create SAP HANA Connection
To create an SAP HANA connection
- Click
- Select SAP HANA from the Group list box.
-
Specify the connection properties in the Create New Connection dialog. Review the following for additional information:
General tab Description Host
Enter IP address (or the master host name).
Note: Enter the master host name. Host names for distributed systems are determined automatically. If the specified host is not available, the connection is established through one of the other hosts.
Instance Number
Enter a two-digit instance number.
Note: The communication port number is defined by: n <instance> xy, where n is either 3 or 5, <instance> is a two-digit number representing the instance number of the SAP HANA appliance, and xy represents a consecutive number. Toad users only enter the instance number.
Type of Authentication
Select:
Authentication by the current operating system user - connect using your operating system authentication
Authentication by the database user - connect using your database user authentication
User
Enter the user name to use when connecting.
Password
Enter the password to use when connecting.
Tip: After connecting, you can set a master password to further secure your connection in Tools | Options| Environment | Security.
Mode
Select the database mode. SAP HANA supports numerous isolated databases in a single HANA system. Although each database in a multiple-container system is isolated, cross-queries can be performed and all databases share the same installation, resources, and administration.
Single-container — Select for single-container systems. These can be converted to multiple-container systems.
Multiple-container — Select for multiple-container systems. These systems always have one system database, which is used for administration, and any number of tenant databases.
Select whether you want to connect to the System or Tenant database. Users connect to a specific tenant database within the system using its database name.
Current Schema
Select a database schema. Click
to create a temporary connection and display available schemas in the drop-down list.
Category
Select or create a category if you want to color code Editor tabs for a specific connection. This can help differentiate between development and production databases. You can also set an option to color code the Object Explorer pane and object editor windows (Create, Alter, Drop, etc.).
Options tab
Description
Isolation Level
(Optional) Select the default isolation level for this connection. Lifetime
(Optional) Specify a maximum value for connection lifetime by entering the length of time in seconds. The default value is 0, which specifies no maximum. -
Click Connect to connect immediately while saving the connection information. Optionally, click Save to save the connection without connecting.
Note: An SAP HANA ODBC driver is installed along with Toad Data Point and is required if using a HANA connection in a cross-connection query.
Tip: Connections are stored in the connections.xml file and can be found by clicking the Application Data Directory link in Help | About.
Create Snowflake Connections
Toad allows you to create a native Snowflake connection, which provides you with a full-featured Object Explorer, Query Builder and SQL Editor.
Note: You must have a Snowflake ODBC driver 2.24.2 (or later) installed before a native connection is created.
To install the Snowflake ODBC Driver
Download and install the ODBC Driver from the Snowflake Web site.
To create a Snowflake connection
- Click
- Select Snowflake from the Group list box.
-
Enter the connection information in the Create New Connection dialog. Review the following for additional information:
General tab Description Host
Enter the name of the server hosting the database to which you want to connect.
Authenticator There are four types of authentication that you can use to connect to Snowflake in Toad. The required Login fields will change according to the type of authentication you select. All the authenticators are located in a dropdown list:
- Snowflake – User account authentication
- SSO – Single Sign-On via external browser
- OAuth – Token-based authentication
- MFA - Multi-Factor Authentication
User Enter the username for your Snowflake account Password Enter the password for your Snowflake account Token Enter your authentication token (Only visible when connecting via OAuth) Port The default port number for Snowflake is 443
Optional A connection can be made without providing this information
Role Enter the User role that you would like to connect to Database Enter the name of the database you would like to connect to Warehouse Enter the name of the Warehouse you would like to connect to -
Click Connect to save the connection and immediately connect to the database
OR
Click Save to save the connection without connecting to the database.
Authentication Notes
When using SSO or MFA, there is a way to maintain continuous and secure connectivity without needing to enter login credentials for each connection attempt to Snowflake (as well as to prevent additional browser loading whenever a new module is started in Toad Data Point). To achieve this, check whether the correct parameters have been set in your account by executing the query below in your Snowflake cloud interface:
SHOW PARAMETERS IN ACCOUNT;
The output that will secure login credentials caching will have these values:
-
For SSO
allow_id_token = true;
-
For MFA
allow_client_mfa_caching = true;
If these values are set to false, then the following queries need to be executed:
-
For SSO:
ALTER ACCOUNT
SET allow_id_token = true;
-
For MFA:
ALTER ACCOUNT
SET allow_client_mfa_caching = true;
Note:
If a Role or Warehouse isn’t chosen, the default settings from the Snowflake User account will be applied (it is considered best practice that a user sets a default Role and a default Warehouse in their Snowflake user account).
Tip:
It is strongly advised to use only the Snowflake user account authentication when creating Automation scripts to avoid unnecessary workflow interruptions.
Limitations of Snowflake Native Connections
- Connecting to Snowflake through Programmatic SSO (Okta only) or by using key pair authentication with JSON Web Token (JWT) is not currently supported.
- Semi-structured data types can be used for storing and analyzing purposes in Snowflake connections, but are not supported in the Data Compare/Sync Wizard because Toad will not be able to generate valid sync scripts unless they are modified before execution
- At the moment, there is no support for Code Snippets in Snowflake connections
- Publishing Snapshots, Views, Automation scripts, and Workbooks to Toad Intelligence Central cannot be performed when using SSO, MFA, OAuth authentication
Tip: Connections are stored in the connections.xml file and can be found by clicking the Application Data Directory link in Help | About.
Create Teradata Connections
Toad allows you to create a full-featured, native Teradata connection. This type of connection provides complete Query Builder, Query Editor, and Database Explorer functionality.
Notes:
- You must have a Teradata .NET Data Provider installed before you can create a Teradata connection.
- To use a Teradata connection in a cross-connection query, you must have a Teradata ODBC driver installed.
To install the Teradata data provider
| » | Download and install the Teradata .NET Data Provider from the Teradata Web site. Use the version supported by your database version. |
To create a Teradata connection
- Click
- Select Teradata from the Group list.
-
Enter the connection information in the Create New Connection dialog. Review the following for additional information:
Login Server name
Enter the name of the server hosting the database to which you want to connect. Use Single Sign On
Select if the user is using a single sign-on authentication system. Password
Enter the password to use when connecting.
Tip: After connecting, you can set a master password to further secure your connection in Tools | Options| Environment | Security.
Session mode
Displays the session mode, which is always Teradata in a Toad Teradata connection.
Default database
(Optional) Enter a default Teradata database for the connection. Category
(Optional) Select an existing category or create a new one. Advanced
Mechanism
(Optional) Select an authentication mechanism from the list. Parameter
(Optional) Enter the parameters required by the selected authentication mechanism. See your system administrator for these values. Account string
(Optional) Enter a new account string. Character set
Select a character set.
Note: When querying or viewing data in a column defined with GRAPHIC or CHARACTER SET GRAPHIC data type, you must specify a Character set of UTF-16 for the session.
Use data encryption
Select if using data encryption. Response buffer size
Specify a Response Buffer Size (in bytes). This allows you to govern the number of rows returned in a single response. To increase the number of rows per response, increase the response buffer size. This strategy might help to improve performance with larger data sets.
The default value in Toad is set to the maximum, 1040000 bytes.
-
Click Connect to connect immediately while saving the connection information. Optionally, click Save to save the connection without connecting.
Tip: Connections are stored in the connections.xml file and can be found by clicking the Application Data Directory link in Help | About.
To install a Teradata ODBC driver
| » | Download and install a Teradata ODBC driver from the Teradata Web site. For a list of supported Teradata ODBC drivers, please see the Release Notes for your version of Toad Data Point. |
Notes:
- Toad does not support the Teradata multi-statement request.
- You can specify which Teradata Data Directory views to use, X views or Non-X views, in Tools | Options | Database | Teradata.