To configure a basic data source to test your connection:
1. From the Progress DataDirect program group, start the ODBC Administrator.
2. Click either the User DSN, System DSN, or File DSN tab to display a list of data sources.
User DSN: If you installed a default DataDirect ODBC user data source as part of the installation, select the appropriate data source name and click Configure to display the driver Setup dialog box.
If you are configuring a new user data source, click Add to display a list of installed drivers. Select the Apache Hive Wire Protocol driver and click Finish to display the driver Setup dialog box.
System DSN: To configure a new system data source, click Add to display a list of installed drivers. Select the Apache Hive Wire Protocol driver and click Finish to display the driver Setup dialog box.
File DSN: To configure a new file data source, click Add to display a list of installed drivers. Select the Apache Hive Wire Protocol driver and click Advanced to specify attributes; otherwise, click Next to proceed. Specify a name for the data source and click Next. Verify the data source information; then, click Finish to display the driver Setup dialog box.
3. The General tab of the Setup dialog box appears by default.
Note: The General tab displays the fields that are required for creating a data source. The fields on all other tabs are optional.
On the General tab, provide the following information; then, click Apply.
Data Source Name: Type a string that identifies this data source configuration, such as Accounting.
Description: Type an optional long description of a data source name, such as My Accounting Database.
Host: Type either the name or the IP address of the server to which you want to connect.
Port Number: Type the port number of the server listener. The default port number for the Apache Hive server is 10000. Because of reported concurrency issues, you might want to use a different port number.
Database Name: Type the name of the Apache Hive database to which you want to connect by default. The database must exist, or the connection attempt will fail.
Transport Mode: If you are connecting to an HTTP endpoint, set to 1 - HTTP. By default, the driver attempts to establish a binary connection (TCP mode).
HTTPPath: If Transport Mode is set to 1 - HTTP, type the path of the HTTP/HTTPS endpoint used for connections. The default is cliservice.
4. If your database configuration requires a user name, on the Security tab, provide the following information; then, click Apply.
User Name: Type the default user ID that is used to connect to your database.
5. For Microsoft Access and Tableau users, click on the Advanced tab. Provide the following required value for the Max String Size option; then, click Apply.
For Microsoft Access: Type 255.
For Tableau: Type a value from 255 to 4000 that suits your environment.
6. Your driver is now configured with the basic settings necessary to connect your driver. Choose from the following:
If you would like to test the connection, proceed to "Testing the Connection."
If you would like to tune your driver for performance, proceed to "Tuning for Performance."
If you would like to save the values you have specified and close the setup dialog, click OK. These values will be used as the default settings when you connect to a data source.
User DSN: If you installed a default DataDirect ODBC user data source as part of the installation, select the appropriate data source name and click Configure to display the driver Setup dialog box.
