The following is a sample odbc.ini file that Setup installs in the installation directory. All occurrences of ODBCHOME are replaced with your installation directory path during installation of the file. Values that you must supply are enclosed by angle brackets (< >). If you are using the installed odbc.ini file, you must supply the values and remove the angle brackets before that data source section will operate properly. Commented lines are denoted by the # symbol. This sample shows a 32-bit driver with the driver file name beginning with iv. A 64-bit driver file would be identical except that driver name would begin with dd and the list of data sources would include only the 64-bit drivers.

[ODBC Data Sources]
Spark SQL=DataDirect 8.0 Apache Spark SQL Wire Protocol

[Spark SQL]
Driver=ODBCHOME/lib/ivspark28.so
Description=DataDirect 8.0 Apache Spark SQL Wire Protocol
ArraySize=150000
AuthenticationMethod=0
CookieName=
CryptoLibName=
CryptoProtocolVersion=TLSv1.2, TLSv1.1, TLSv1
Database=<sparksql_database>
DataSourceName=
DefaultLongDataBuffLen=1024
EnableCookieAuthentication=1
EnableDescribeParam=0
EnableFIPS=1
EncryptionMethod=0
GSSClient=native 
HostName=<sparksql_host>
HostNameInCertificate=
HTTPPath=cliservice
KeepAlive=0
KeyPassword=
Keystore=
KeystorePassword=
LoginTimeout=30
LogonID=
MaxStringSize=2147483647
MinLongVarcharSize=
PortNumber=10000
PRNGSeedFile=/dev/random
PRNGSeedSource=0
ProxyUser=
RemoveColumnQualifiers=0
ServicePrincipalName=
SSLLibName= 
StringDescribeType=9
TransactionMode=0
TransportMode=0
Truststore=
TruststorePassword= 
UseCurrentSchema=0
UseNativeCatalogFunctions=1
UserAgent=
ValidateServerCertificate=1
VarcharThreshold=

[ODBC]
IANAAppCodePage=4
InstallDir=ODBCHOME
Trace=0
TraceFile=odbctrace.out
TraceDll=ODBCHOME/lib/ivtrc28.so
ODBCTraceMaxFileSize=102400
ODBCTraceMaxNumFiles=10
[ODBC File DSN]
DefaultDSNDir=
UseCursorLib=0

To modify or create data sources in the odbc.ini file, use the following procedures.

  • To modify a data source:
    1. Using a text editor, open the odbc.ini file.
    2. Modify the default attributes in the data source definitions as necessary based on your system specifics, for example, enter the host name and port number of your system in the appropriate location.

      Consult the Attribute Names for Apache Spark table in the Connection Options chapter for other specific attribute values.

    3. After making all modifications, save the odbc.ini file and close the text editor.
      Important: The Connection option descriptions section lists both the long and short names of the attribute. When entering attribute names into odbc.ini, you must use the long name of the attribute. The short name is not valid in the odbc.ini file.
  • To create a new data source:
    1. Using a text editor, open the odbc.ini file.
    2. Copy an appropriate existing default data source definition and paste it to another location in the file.
    3. Change the data source name in the copied data source definition to a new name. The data source name is between square brackets at the beginning of the definition, for example, [Spark SQL].
    4. Modify the attributes in the new definition as necessary based on your system specifics, for example, enter the host name and port number of your system in the appropriate location.

      Consult the Attribute Names for Apache Spark SQL table in the Connection Options chapter for other specific attribute values.

    5. In the [ODBC] section at the beginning of the file, add a new data_source_name=installed-driver pair containing the new data source name and the appropriate installed driver name.
    6. After making all modifications, save the odbc.ini file and close the text editor.
      Important: The Attribute Names for Apache Spark SQL table in the Connection Options chapter lists both the long and short name of the attribute. When entering attribute names into odbc.ini, you must use the long name of the attribute. The short name is not valid in the odbc.ini file.