跳至主要内容

clickhouse-odbc-bridge

一个简单的 HTTP 服务器,充当 ODBC 驱动程序的代理。主要动机是 ODBC 实现中可能出现的段错误或其他故障,这些故障可能导致整个 clickhouse-server 进程崩溃。

此工具通过 HTTP 工作,而不是通过管道、共享内存或 TCP,因为

  • 实现起来更简单
  • 调试起来更简单
  • jdbc-bridge 可以以相同的方式实现

用法

clickhouse-server 在 odbc 表函数和 StorageODBC 内部使用此工具。但是,它可以作为独立工具从命令行使用,并在 POST 请求 URL 中使用以下参数

  • connection_string -- ODBC 连接字符串。
  • sample_block -- 以 ClickHouse NamesAndTypesList 格式表示的列描述,名称用反引号括起来,类型为字符串。名称和类型之间用空格分隔,行之间用换行符分隔。
  • max_block_size -- 可选参数,设置单个块的最大大小。查询以 POST 请求正文发送。响应以 RowBinary 格式返回。

示例:

$ clickhouse-odbc-bridge --http-port 9018 --daemon

$ curl -d "query=SELECT PageID, ImpID, AdType FROM Keys ORDER BY PageID, ImpID" --data-urlencode "connection_string=DSN=ClickHouse;DATABASE=stat" --data-urlencode "sample_block=columns format version: 1
3 columns:
\`PageID\` String
\`ImpID\` String
\`AdType\` String
" "https://127.0.0.1:9018/" > result.txt

$ cat result.txt
12246623837185725195925621517