Windows icon On Windows, data sources are stored in the Windows Registry. You can configure and modify data sources through the ODBC Administrator using a driver Setup dialog box, as described in this section.

This information pertains to UNIX and Linux. On UNIX and Linux, data sources are stored in the odbc.ini file. See Data Source Configuration Through the System Information (odbc.ini) File for detailed information about the specific steps necessary to configure a data source.

When the driver is first installed, the values of its connection options are set by default. These values appear on the driver Setup dialog box tabs when you create a new data source. You can change these default values by modifying the data source. In the following procedure, the description of each tab is followed by a table that lists the connection options for that tab and their initial default values. This table links you to a complete description of the options and their connection string attribute equivalents. The connection string attributes are used to override the default values of the data source if you want to change these values at connection time.

To configure a Greenplum data source:

  1. Start the ODBC Administrator by selecting its icon from the Progress DataDirect program group.
  2. Select a tab:
    • User DSN: If you are configuring an existing user data source, select the 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 driver and click Finish to display the driver Setup dialog box.
    • System DSN: If you are configuring an existing system data source, select the data source name and click Configure to display the driver Setup dialog box.

      If you are configuring a new system data source, click Add to display a list of installed drivers. Select the driver and click Finish to display the driver Setup dialog box.

    • File DSN: If you are configuring an existing file data source, select the data source file and click Configure to display the driver Setup dialog box.

      If you are configuring a new file data source, click Add to display a list of installed drivers; then, select a driver. Click Advanced if you want 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.

    The General tab of the Setup dialog box appears.

    Figure 1. General tab

    The General tab of the ODBC Greenplum Wire Protocol Driver Setup dialog box

    Note: The General tab displays only fields that are required for creating a data source. The fields on all other tabs are optional, unless noted otherwise.
  3. On this tab, provide values for any of the options in the following table; then, click Apply. The table provides links to descriptions of the connection options.
    Connection Options: General Default
    Data Source Name None
    Description None
    Host Name None
    Port Number 5432
    Database Name None
  4. Optionally, click the Advanced tab to specify additional data source settings.
    Figure 2. Advanced tab

    The Advanced tab of the ODBC Greenplum Wire Protocol Driver Setup dialog box

    On this tab, provide values for any of the options in the following table; then, click Apply. The table provides links to descriptions of the connection options.

    Connection Options: Advanced Default
    Application Using Threads Enabled
    Enable SQLDescribeParam Enabled
    Fetch TSWTZ as Timestamp Disabled
    Fetch TWFS as Time Disabled
    TCP Keep Alive Disabled
    Fetch RefCursors Enabled
    Batch Mechanism 1 - SingleRowInsert
    Extended Column MetaData Disabled
    Enable Keyset Cursors Disabled
    Keyset Cursor Options 0 - RowID Columns
    Transaction Error Behavior 1 - Rollback
    XML Describe Type -10 - SQL_WLONGVARCHAR
    Initialization String None
    Report Codepage Conversion Errors 0 - Ignore Errors
    Unbounded Numeric Precision 1000
    Unbounded Numeric Scale 6
    Login Timeout 15
    Query Timeout 0
    Max Char Size None
    Max Long Varchar Size None
    Max Varchar Size None
    IANAAppCodePageUNIX ONLY 4 (ISO 8559-1 Latin-1)

    Extended Options: Type a semi-colon separated list of connection options and their values. Use this configuration option to set the value of undocumented connection options that are provided by Progress DataDirect customer support. You can include any valid connection option in the Extended Options string, for example:

    Database=Server1;UndocumentedOption1=value[;UndocumentedOption2=value;]

    If the Extended Options string contains option values that are also set in the setup dialog or data source, the values of the options specified in the Extended Options string take precedence. However, connection options that are specified on a connection string override any option value specified in the Extended Options string.

    Note: Do not specify the Extended Options configuration option in a connection string, or the driver will return an error. Instead, applications should specify the individual undocumented connection options in the connection string.

    Translate: Click Translate to display the Select Translator dialog box, which lists the translators specified in the ODBC Translators section of the Registry. Progress DataDirect provides a translator named OEM to ANSI that translates your data from the IBM PC character set to the ANSI character set.

    Select a translator; then, click OK to close this dialog box.

  5. Optionally, click the Security tab to specify security data source settings.

    The Security tab of the ODBC Greenplum Wire Protocol Driver Setup dialog box

    See Using Security for a general description of authentication and encryption and their configuration requirements.

    On this tab, provide values for any of the options in the following table; then, click Apply. The table provides links to descriptions of the connection options.

    Connection Options: Security Default
    User Name None
    Authentication Method 0 - No Encryption
    Service Principal Name None
    GSS Client Library native
    Encryption Method 0 - No Encryption
    Crypto Protocol Version TLSv1.2, TLSv1.1, TLSv1, SSLv3
    Validate Server Certificate 1 (Enabled)
    Enable FIPS Disabled
    Truststore None
    Truststore Password None
    Keystore None
    Keystore Password None
    Key Password None
    Keystore None
    Host Name In Certificate None
  6. Optionally, click the Failover tab to specify failover data source settings.
    Figure 3. Failover tab

    The Failover tab of the ODBC Greenplum Wire Protocol Driver Setup dialog box

    See Using Failover for a general description of failover and its related connection options.

    On this tab, provide values for any of the options in the following table; then, click Apply. The table provides links to descriptions of the connection options.

    Connection Options: Failover Default
    Load Balancing Disabled
    Connection Retry Count 0
    Connection Retry Delay 3
    Alternate Servers None
    Failover Mode 0 - Connection
    Failover Granularity 0 - Non-Atomic
    Failover Preconnect Disabled
  7. Optionally, click. the Pooling tab to specif pooling data source settings.
    Figure 4. Pooling tab

    The Pooling tab of the ODBC Greenplum Wire Protocol Driver Setup dialog box

    See Using DataDirect Connection Pooling for a general description of connection pooling.

    On this tab, provide values for any of the options in the following table; then, click Apply. The table provides links to descriptions of the connection options.

    Connection Options: Pooling Default
    Connection Pooling Disabled
    Connection Reset Disabled
    Max Pool Size 100
    Min Pool Size 0
    Load Balance Timeout 0
  8. At any point during the configuration process, you can click Test Connect to attempt to connect to the data source using the connection options specified in the driver Setup dialog box. A logon dialog box appears (see Using a Logon Dialog Box (Greenplum) for details). Note that the information you enter in the logon dialog box during a test connect is not saved.
    • If the driver can connect, it releases the connection and displays a Connection Established message. Click OK.
    • If the driver cannot connect because of an incorrect environment or connection value, it displays an appropriate error message. Click OK.
    Note: If you are configuring alternate servers for use with the connection failover feature, be aware that the Test Connect button tests only the primary server, not the alternate servers.
  9. Click OK or Cancel. If you click OK, the values you have specified become the defaults when you connect to the data source. You can change these defaults by using this procedure to reconfigure your data source. You can override these defaults by connecting to the data source using a connection string with alternate values.