Add Date32 support and promote it as the primary date type

ClickHouse's Date type covers only 1970-01-01 to 2149-06-06. Date32
extends that range to 1900-01-01 – 2299-12-31, matching what ODBC
clients typically expect. By routing all SQL_TYPE_DATE bindings through
Date32, the driver avoids silent truncation/failures for out-of-range
dates.

Author: slabko

driver/escaping/escape_sequences.cpp

@@ -422,7 +422,7 @@ std::optional<std::string> processDate(const StringView seq, Lexer & lex) {
     if (data.isInvalid()) {
         return std::nullopt;
     } else {
-        return std::string("toDate(") + data.literal.to_string() + ")";
+        return std::string("toDate32(") + data.literal.to_string() + ")";
     }
 }
 

driver/test/datetime_it.cpp

@@ -155,6 +155,10 @@ INSTANTIATE_TEST_SUITE_P(
             "toDate('2020-03-25')", SQL_TYPE_DATE,
             "2020-03-25", SQL_TIMESTAMP_STRUCT{2020, 3, 25, 0, 0, 0, 0}
         },
+        DateTimeParams{"Date32", "ODBCDriver2", "UTC",
+            "toDate32('2299-12-31')", SQL_TYPE_DATE,
+            "2299-12-31", SQL_TIMESTAMP_STRUCT{2299, 12, 31, 0, 0, 0, 0}
+        },
         DateTimeParams{"DateTime", "ODBCDriver2", "UTC",
             "toDateTime('2020-03-25 12:11:22')", SQL_TYPE_TIMESTAMP,
             "2020-03-25 12:11:22", SQL_TIMESTAMP_STRUCT{2020, 3, 25, 12, 11, 22, 0}
@@ -210,6 +214,31 @@ INSTANTIATE_TEST_SUITE_P(
     }
 );
 
+TEST_F(DateTime, DateAndDate32Compatibility)
+{
+    auto query = fromUTF8<PTChar>(R"""(
+        SELECT date FROM (
+            SELECT CAST('2006-01-02' AS Date) AS date
+        )
+        WHERE date = ?
+    )""");
+    STMT_OK(SQLPrepare(hstmt, ptcharCast(query.data()), SQL_NTS));
+    SQL_DATE_STRUCT expect = {
+        .year = 2006,
+        .month = 1,
+        .day = 2,
+    };
+    SQLLEN indicator = sizeof(expect);
+    STMT_OK(SQLBindParameter(hstmt, 1, SQL_PARAM_INPUT, SQL_C_TYPE_DATE, SQL_TYPE_DATE, 0, 0, &expect, 0, &indicator));
+    STMT_OK(SQLExecute(hstmt));
+    STMT_OK(SQLFetch(hstmt));
+
+    SQL_DATE_STRUCT date = {0};
+    indicator = 0;
+    STMT_OK(SQLGetData(hstmt, 1, SQL_C_TYPE_DATE, &date, sizeof(date), &indicator));
+    EXPECT_EQ(date, expect);
+}
+
 TEST_F(DateTime, TimeAsTimestamp)
 {
     auto query = fromUTF8<PTChar>("SELECT CAST('15:04:05' AS Time) AS col SETTINGS enable_time_time64_type = 1");

driver/test/escape_sequences_ut.cpp

@@ -287,7 +287,7 @@ TEST(EscapeSequencesCase, ParameterizedFunctionCalls) {
 TEST(EscapeSequencesCase, DateTime) {
     ASSERT_EQ(replaceEscapeSequences("SELECT {t '15:04:05'}"), "SELECT cast('15:04:05' as Time)");
 
-    ASSERT_EQ(replaceEscapeSequences("SELECT {d '2017-01-01'}"), "SELECT toDate('2017-01-01')");
+    ASSERT_EQ(replaceEscapeSequences("SELECT {d '2017-01-01'}"), "SELECT toDate32('2017-01-01')");
 
     ASSERT_EQ(replaceEscapeSequences("SELECT {ts '2017-01-01 10:01:01'}"), "SELECT toDateTime64('2017-01-01 10:01:01', 9)");
     ASSERT_EQ(replaceEscapeSequences("SELECT {ts '2017-01-01 10:01:01.555'}"), "SELECT toDateTime64('2017-01-01 10:01:01.555', 9)");

driver/test/statement_parameter_binding_ut.cpp

@@ -92,7 +92,7 @@ TEST_F(StatementBindingTest, FromCCharToOtherTypes) {
         "select "
         "{odbc_positional_1:Int32}, "
         "{odbc_positional_2:Decimal(10, 2)}, "
-        "{odbc_positional_3:Date}, "
+        "{odbc_positional_3:Date32}, "
         "{odbc_positional_4:LowCardinality(String)}, "
         "{odbc_positional_5:DateTime64(9)}, "
         "{odbc_positional_6:UUID}");
@@ -184,7 +184,7 @@ TEST_F(StatementBindingTest, FromCDateTime) {
     auto [query, params] = execute();
     ASSERT_EQ(query,
         "select "
-        "{odbc_positional_1:Nullable(Date)}, "
+        "{odbc_positional_1:Nullable(Date32)}, "
         "{odbc_positional_2:LowCardinality(String)}, "
         "{odbc_positional_3:Nullable(DateTime64(9))}");
     ASSERT_EQ(params.size(), 3);

driver/test/type_info_it.cpp

@@ -55,7 +55,7 @@ TEST_F(TypeInfoTest, ClickhouseToSQLTypeMapping)
         {"String", "0", SQL_VARCHAR},
         {"FixedString(1)", "'0'", SQL_VARCHAR},
         {"Date", "0", SQL_TYPE_DATE},
-        {"Date32", "0", SQL_VARCHAR},
+        {"Date32", "0", SQL_TYPE_DATE},
         {"DateTime", "0", SQL_TYPE_TIMESTAMP},
         {"DateTime64", "0", SQL_TYPE_TIMESTAMP},
         {"UUID", "'00000000-0000-0000-0000-000000000000'", SQL_GUID},
@@ -237,7 +237,7 @@ TEST_F(TypeInfoTest, SQLGetTypeInfoResultSet)
         {{"String",     SQL_WVARCHAR      }, {max_size, "'", "'",  na,     na,    na, na,  SQL_VARCHAR,   na,  na,  }},
         {{"FixedString",SQL_VARCHAR       }, {max_size, "'", "'",  length, na,    na, na,  SQL_VARCHAR,   na,  na,  }},
         {{"Time",       SQL_TYPE_TIME     }, {8,        na,  na,   na,     na,    na, na,  SQL_DATE,      2,   na,  }},
-        {{"Date",       SQL_TYPE_DATE     }, {10,       na,  na,   na,     na,    na, na,  SQL_DATE,      1,   na,  }},
+        {{"Date32",     SQL_TYPE_DATE     }, {10,       na,  na,   na,     na,    na, na,  SQL_DATE,      1,   na,  }},
         {{"DateTime64", SQL_TYPE_TIMESTAMP}, {29,       na,  na,   scale,  na,    0,  9,   SQL_DATE,      3,   na,  }},
         {{"DateTime",   SQL_TYPE_TIMESTAMP}, {19,       na,  na,   na,     na,    na, na,  SQL_DATE,      3,   na,  }},
         {{"UUID",       SQL_GUID          }, {35,       na,  na,   na,     na,    na, na,  SQL_GUID,      na,  na,  }},
@@ -396,6 +396,7 @@ TEST_F(TypeInfoTest, AllTypesColumns)
     {"FixedString(42)",{SQL_VARCHAR,       "FixedString", 42,  0,   na,   na,    false, SQL_VARCHAR,  na,  msz }},
     {"Time",           {SQL_TYPE_TIME,     "Time",        8,   0,   na,   na,    false, SQL_DATE,     2,   6   }},
     {"Date",           {SQL_TYPE_DATE,     "Date",        10,  0,   na,   na,    false, SQL_DATE,     1,   6   }},
+    {"Date32",         {SQL_TYPE_DATE,     "Date32",      10,  0,   na,   na,    false, SQL_DATE,     1,   6   }},
     {"DateTime",       {SQL_TYPE_TIMESTAMP,"DateTime",    19,  0,   0,    na,    false, SQL_DATE,     3,   16  }},
     {"DateTime64",     {SQL_TYPE_TIMESTAMP,"DateTime64",  29,  0,   3,    na,    false, SQL_DATE,     3,   16  }},
     {"DateTime64(9)",  {SQL_TYPE_TIMESTAMP,"DateTime64",  29,  0,   9,    na,    false, SQL_DATE,     3,   16  }},

driver/utils/type_info.cpp

@@ -405,7 +405,7 @@ std::string convertCTypeToDataSourceType(const BoundTypeInfo & type_info) {
 
         case SQL_C_DATE:
         case SQL_C_TYPE_DATE:
-            type_name = set_nullability("Date");
+            type_name = set_nullability("Date32");
             break;
 
         case SQL_C_TIME:
@@ -519,7 +519,7 @@ std::string convertSQLTypeToDataSourceType(const BoundTypeInfo & type_info) {
             break;
 
         case SQL_TYPE_DATE:
-            type_name = set_nullability("Date");
+            type_name = set_nullability("Date32");
             break;
 
         case SQL_TYPE_TIME:

driver/utils/type_info.h

@@ -34,6 +34,7 @@ enum class DataSourceTypeId {
     String,
     FixedString,
     Date,
+    Date32,
     Time,
     DateTime64,
     DateTime,
@@ -189,6 +190,8 @@ class TypeInfoCatalog
         {.type_id=FixedString, .type_name="FixedString", .data_type=SQL_VARCHAR, .column_size=string_max_size,
             .literal_wrapper="'", .create_params="length", .octet_length=string_max_size},
         {.type_id=Date, .type_name="Date", .data_type=SQL_TYPE_DATE, .column_size=10,
+            .sql_data_type=SQL_DATE, .sql_datetime_sub=SQL_CODE_DATE, .octet_length=6, .hidden=true},
+        {.type_id=Date32, .type_name="Date32", .data_type=SQL_TYPE_DATE, .column_size=10,
             .sql_data_type=SQL_DATE, .sql_datetime_sub=SQL_CODE_DATE, .octet_length=6},
         {.type_id=Time, .type_name="Time", .data_type=SQL_TYPE_TIME, .column_size=8,
             .sql_data_type=SQL_DATE, .sql_datetime_sub=SQL_CODE_TIME, .octet_length=6},