Odbc driver

CMakeLists.txt

@@ -10,6 +10,7 @@ project(YDB-CPP-SDK VERSION ${YDB_SDK_VERSION} LANGUAGES C CXX ASM)
 option(YDB_SDK_INSTALL "Install YDB C++ SDK" Off)
 option(YDB_SDK_TESTS "Build YDB C++ SDK tests" Off)
 option(YDB_SDK_EXAMPLES "Build YDB C++ SDK examples" On)
+option(YDB_SDK_ODBC "Build YDB ODBC driver" On)
 set(YDB_SDK_GOOGLE_COMMON_PROTOS_TARGET "" CACHE STRING "Name of cmake target preparing google common proto library")
 option(YDB_SDK_USE_RAPID_JSON "Search for rapid json library in system" ON)
 
@@ -61,6 +62,10 @@ add_subdirectory(util)
 
 #_ydb_sdk_validate_public_headers()
 
+if (YDB_SDK_ODBC)
+  add_subdirectory(odbc)
+endif()
+
 if (YDB_SDK_EXAMPLES)
   add_subdirectory(examples)
 endif()

CMakePresets.json

@@ -55,6 +55,7 @@
       "cacheVariables": {
         "YDB_SDK_TESTS": "TRUE",
         "YDB_SDK_EXAMPLES": "TRUE",
+        "YDB_SDK_ODBC": "TRUE",
         "ARCADIA_ROOT": "..",
         "ARCADIA_BUILD_ROOT": "."
       }

cmake/common.cmake

@@ -115,7 +115,7 @@ function(generate_enum_serilization Tgt Input)
 endfunction()
 
 function(add_global_library_for TgtName MainName)
-  add_library(${TgtName} STATIC ${ARGN})
+  _ydb_sdk_add_library(${TgtName} STATIC ${ARGN})
   if(APPLE)
     target_link_options(${MainName} INTERFACE "SHELL:-Wl,-force_load,$<TARGET_FILE:$<INSTALL_INTERFACE:YDB-CPP-SDK::>${TgtName}>")
   else()
@@ -182,7 +182,7 @@ endfunction()
 
 function(_ydb_sdk_add_library Tgt)
   cmake_parse_arguments(ARG
-    "INTERFACE" "" ""
+    "INTERFACE;OBJECT;SHARED" "" ""
     ${ARGN}
   )
 
@@ -192,6 +192,12 @@ function(_ydb_sdk_add_library Tgt)
     set(libraryMode "INTERFACE")
     set(includeMode "INTERFACE")
   endif()
+  if (ARG_OBJECT)
+    set(libraryMode "OBJECT")
+  endif()
+  if (ARG_SHARED)
+    set(libraryMode "SHARED")
+  endif()
   add_library(${Tgt} ${libraryMode})
   target_include_directories(${Tgt} ${includeMode}
     $<BUILD_INTERFACE:${YDB_SDK_SOURCE_DIR}>
@@ -201,6 +207,7 @@ function(_ydb_sdk_add_library Tgt)
   target_compile_definitions(${Tgt} ${includeMode}
     YDB_SDK_USE_STD_STRING
   )
+  set_property(TARGET ${Tgt} PROPERTY POSITION_INDEPENDENT_CODE ON)
 endfunction()
 
 function(_ydb_sdk_validate_public_headers)
@@ -255,4 +262,3 @@ function(_ydb_sdk_validate_public_headers)
   )
   target_include_directories(validate_public_interface PUBLIC ${YDB_SDK_BINARY_DIR}/__validate_headers_dir/include)
 endfunction()
-

cmake/external_libs.cmake

@@ -14,6 +14,10 @@ find_package(Brotli 1.1.0 REQUIRED)
 find_package(jwt-cpp REQUIRED)
 find_package(double-conversion REQUIRED)
 
+if (YDB_SDK_ODBC)
+  find_package(ODBC REQUIRED)
+endif()
+
 # RapidJSON
 if (YDB_SDK_USE_RAPID_JSON)
   find_package(RapidJSON REQUIRED)

cmake/testing.cmake

@@ -103,3 +103,35 @@ function(add_ydb_test)
 
   vcs_info(${YDB_TEST_NAME})
 endfunction()
+
+if (YDB_SDK_ODBC)
+  function(add_odbc_test)
+    set(opts "")
+    set(oneval_args NAME WORKING_DIRECTORY OUTPUT_DIRECTORY)
+    set(multival_args SOURCES LINK_LIBRARIES LABELS)
+    cmake_parse_arguments(ODBC_TEST
+      "${opts}"
+      "${oneval_args}"
+      "${multival_args}"
+      ${ARGN}
+    )
+
+    add_ydb_test(GTEST
+      NAME ${ODBC_TEST_NAME}
+      SOURCES ${ODBC_TEST_SOURCES}
+      LINK_LIBRARIES
+        ${ODBC_TEST_LINK_LIBRARIES}
+        ODBC::ODBC
+      LABELS
+        integration
+        ${ODBC_TEST_LABELS}
+    )
+
+    target_compile_definitions(${ODBC_TEST_NAME} 
+      PRIVATE 
+        ODBC_DRIVER_PATH="$<TARGET_FILE:ydb-odbc>"
+    )
+
+    add_dependencies(${ODBC_TEST_NAME} ydb-odbc)
+  endfunction()
+endif()

odbc/CMakeLists.txt

@@ -0,0 +1,55 @@
+add_library(ydb-odbc SHARED
+  src/utils/cursor.cpp
+  src/utils/types.cpp
+  src/utils/util.cpp
+  src/utils/convert.cpp
+  src/utils/error_manager.cpp
+  src/odbc_driver.cpp
+  src/connection.cpp
+  src/statement.cpp
+  src/environment.cpp
+)
+
+target_include_directories(ydb-odbc
+  PRIVATE
+    ${CMAKE_CURRENT_SOURCE_DIR}/include
+    ${CMAKE_CURRENT_SOURCE_DIR}/src
+    ${ODBC_INCLUDE_DIRS}
+)
+
+target_link_libraries(ydb-odbc
+  PRIVATE
+    YDB-CPP-SDK::Query
+    YDB-CPP-SDK::Table
+    YDB-CPP-SDK::Scheme
+    YDB-CPP-SDK::Driver
+    ODBC::ODBC
+)
+
+set_target_properties(ydb-odbc PROPERTIES
+  POSITION_INDEPENDENT_CODE ON
+)
+
+install(TARGETS ydb-odbc
+  LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
+)
+
+install(DIRECTORY include/
+  DESTINATION include/ydb-odbc
+)
+
+add_subdirectory(examples)
+add_subdirectory(tests)
+
+include(GNUInstallDirs)
+
+install(FILES 
+  odbcinst.ini
+  DESTINATION ${CMAKE_INSTALL_SYSCONFDIR}/odbcinst.d
+  RENAME ydb-odbc.ini
+)
+
+install(FILES
+  odbc.ini
+  DESTINATION ${CMAKE_INSTALL_SYSCONFDIR}
+)

odbc/README.md

@@ -0,0 +1,80 @@
+# YDB ODBC Driver
+
+ODBC driver for YDB.
+
+## Requirements
+
+- CMake 3.10 or higher
+- C/C++ compiler with C11 and C++20 support
+- YDB C++ SDK
+- unixODBC (for Linux/macOS)
+
+## Build
+
+```bash
+cmake -DYDB_SDK_ODBC=1 --preset release-clang
+cmake --build --preset default
+```
+
+## Configuration
+
+1. Make sure the driver is registered:
+```bash
+odbcinst -q -d
+```
+
+2. Check available data sources:
+```bash
+odbcinst -q -s
+```
+
+3. Edit `/etc/odbc.ini` to configure the connection:
+```ini
+[YDB]
+Driver=YDB
+Description=YDB Database Connection
+Server=your-server:port
+Database=/path/to/database
+```
+
+## Usage
+
+Example of connecting via isql:
+```bash
+isql -v YDB
+```
+
+Example usage in C:
+```c
+SQLHENV env;
+SQLHDBC dbc;
+SQLHSTMT stmt;
+
+// Initialize environment
+SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &env);
+SQLSetEnvAttr(env, SQL_ATTR_ODBC_VERSION, (void*)SQL_OV_ODBC3, 0);
+
+// Connect
+SQLAllocHandle(SQL_HANDLE_DBC, env, &dbc);
+SQLConnect(dbc, (SQLCHAR*)"YDB", SQL_NTS,
+          (SQLCHAR*)"", SQL_NTS,
+          (SQLCHAR*)"", SQL_NTS);
+
+// Execute query
+SQLAllocHandle(SQL_HANDLE_STMT, dbc, &stmt);
+SQLExecDirect(stmt, (SQLCHAR*)"SELECT * FROM mytable", SQL_NTS);
+
+// Cleanup
+SQLFreeHandle(SQL_HANDLE_STMT, stmt);
+SQLDisconnect(dbc);
+SQLFreeHandle(SQL_HANDLE_DBC, dbc);
+SQLFreeHandle(SQL_HANDLE_ENV, env);
+```
+
+## Parameters
+
+Use names $p1, $p2, ... for parameter names
+
+## License
+
+Apache License 2.0

odbc/examples/CMakeLists.txt

@@ -0,0 +1,2 @@
+add_subdirectory(basic)
+add_subdirectory(scheme)

odbc/examples/basic/CMakeLists.txt

@@ -0,0 +1,14 @@
+add_executable(odbc_basic
+  main.cpp
+)
+
+target_link_libraries(odbc_basic
+  PRIVATE
+    ODBC::ODBC
+)
+target_compile_definitions(odbc_basic 
+  PRIVATE 
+    ODBC_DRIVER_PATH="$<TARGET_FILE:ydb-odbc>"
+)
+
+add_dependencies(odbc_basic ydb-odbc)