OceanBase
English日本語简体中文
Docs Home
Products
Integrations
Release Notes

Databases

OceanBase DatabaseOceanBase Cloud OceanBase Best Practices

Tools

OceanBase Cloud PlatformOceanBase Migration ServiceOceanBase Developer CenterOceanBase Migration AssessmentOceanBase Admin ToolOceanBase Loader and DumperOceanBase DeployerKubernetes operator for OceanBaseOceanBase Diagnostic Tool OceanBase Binlog ServiceOceanBase DataPilot

Connectors and Middleware

OceanBase Database Proxy OceanBase Connector/C OceanBase Connector/J OceanBase Connector/ODBC OceanBase Connector/NETOceanBase Command-Line Client

Databases

OceanBase DatabaseOceanBase Cloud OceanBase Best Practices

Connectors and Middleware

OceanBase Database Proxy OceanBase Connector/C OceanBase Connector/J OceanBase Connector/ODBC OceanBase Connector/NETOceanBase Command-Line Client

Tools

OceanBase Cloud PlatformOceanBase Migration ServiceOceanBase Developer CenterOceanBase Migration AssessmentOceanBase Admin ToolOceanBase Loader and DumperOceanBase DeployerKubernetes operator for OceanBaseOceanBase Diagnostic Tool OceanBase Binlog ServiceOceanBase DataPilot
OceanBase DatabaseOceanBase Cloud ToolsConnectors and MiddlewareLifecycle Support Policy

OceanBase Connector/ODBC

V2.0.9
  • Overview
  • Driver installation and configuration
    • Prepare for the installation
    • Install and configure the ODBC driver for Linux
    • Install and configure OceanBase Connector/ODBC for Windows
  • User guide
    • Basic operations
    • Enable logging
    • Get REF CURSOR data type
    • Scalar function escape
    • Call Function
  • Reference information
    • API functions in OceanBase Connector/ODBC
    • Data types in OceanBase Connector/ODBC
    • Error codes in OceanBase Connector/ODBC
  • FAQ
    • Query timeout
    • Chinese garbled characters
    • Common OceanBase ODBC installation and configuration issues and solutions
  • 600.version-release-records
    • 9900.V2.0
      • OceanBase Connector/ODBC V2.0.9
      • OceanBase Connector/ODBC V2.0.8
      • OceanBase Connector/ODBC V2.0.7
      • OceanBase Connector/ODBC V2.0.6

Download PDF

Document Feedback
  1. Documentation Center
  2. OceanBase Connector/ODBC
  3. V2.0.9

Common OceanBase ODBC installation and configuration issues and solutions

Last Updated:2026-09-04 08:24:40

Issue 1: Missing shared library libreadline.so.6
Error message
Solution
Issue 2: Data source name not found
Error message
Solution
Issue 3: Unable to open the libobodbc.so library file
Error message
Solution
Issue 4: Access denied or cluster does not exist
Error message
Solution
Issue 5: C++ program cannot load the libobodbc.so shared library
Error message
Solution
Issue 6: C++ program reports an error SQLDriverConnect retcode is SQL_ERROR
Error message
Solution
References

Issue 1: Missing shared library libreadline.so.6

Error message

error while loading shared libraries: libreadline.so.6
#/u01/unix-odbc/bin/isql -v OBDSN
/u01/unix-odbc/bin/isql: error while loading shared libraries: libreadline.so.6: cannot open shared object file: No such file or directory

Solution

Please refer to the Check and install libreadline section in the documentation.

Issue 2: Data source name not found

Error message

[IM002][unixODBC][Driver Manager]Data source name not found and no default driver specified
[ISQL]ERROR: Could not SQLConnect

Solution

Check the configuration file /etc/odbcinst.ini and ensure that there are no spaces or other invalid characters before the [Oceanbase] configuration section.

Issue 3: Unable to open the libobodbc.so library file

Error message

# sudo /u01/unix-odbc/bin/isql -v OBDSN
[01000][unixODBC][Driver Manager]Can't open lib '/u01/ob-connector-odbc/lib64/mariadb/libobodbc.so' : file not found
[ISQL]ERROR: Could not SQLConnect

Solution

Remove the sudo from the above command.

Issue 4: Access denied or cluster does not exist

Error message

[37000][unixODBC][ob-2.0.8]Access denied for user 'ALVIN'@'xxx.xxx.xxx.xxx' (using password: YES)
[ISQL]ERROR: Could not SQLConnect
[S1000][unixODBC][ob-2.0.8]cluster not exist
[ISQL]ERROR: Could not SQLConnect

Solution

Check the database configuration information in /etc/odbc.ini, such as whether the user password is correct. It is recommended to try to connect to the database using the command-line tool to confirm the validity of the configuration.

Issue 5: C++ program cannot load the libobodbc.so shared library

Error message

./test: error while loading shared libraries: libobodbc.so: cannot open shared object file: No such file or directory

Solution

Ensure that the LD_LIBRARY_PATH environment variable includes the /u01/ob-connector-odbc/lib64/mariadb path. You can set the environment variable using the following command:

export LD_LIBRARY_PATH=/u01/ob-connector-odbc/lib64/mariadb:$LD_LIBRARY_PATH

Issue 6: C++ program reports an error SQLDriverConnect retcode is SQL_ERROR

Error message

SQLDriverConnect retcode is SQL_ERROR
Segmentation fault (core dumped)

Solution

Run the following command to check whether OceanBase ODBC can connect normally.

/u01/unix-odbc/bin/isql -v OBDSN

References

  • Install and configure the ODBC driver for Linux

Previous topic

Chinese garbled characters
Last

Next topic

OceanBase Connector/ODBC V2.0.9
Next
on this page
Issue 1: Missing shared library libreadline.so.6
Error message
Solution
Issue 2: Data source name not found
Error message
Solution
Issue 3: Unable to open the libobodbc.so library file
Error message
Solution
Issue 4: Access denied or cluster does not exist
Error message
Solution
Issue 5: C++ program cannot load the libobodbc.so shared library
Error message
Solution
Issue 6: C++ program reports an error SQLDriverConnect retcode is SQL_ERROR
Error message
Solution
References