C# 连接ClickHouse 数据库

Favor_Yang2024-12-21 22:00

在 C# 中连接 ClickHouse 数据库，您可以使用 ClickHouse.Client 库。这个库提供了对 ClickHouse 数据库的高效访问。以下是详细的步骤指南，帮助您在 C# 项目中连接和操作 ClickHouse 数据库。

  1. 安装 ClickHouse.Client 包

首先，您需要在您的项目中安装 ClickHouse.Client 包。您可以使用 NuGet 包管理器来完成此操作。

使用 NuGet 包管理器控制台

cs 复制代码 
Install-Package ClickHouse.Client -Version 1.4.1

使用 .NET CLI

cs 复制代码 
dotnet add package ClickHouse.Client --version 1.4.1
  1. 配置 ClickHouse 客户端

接下来，您需要配置 ClickHouse 客户端以连接到您的 ClickHouse 实例。以下是一个基本的配置示例。

cs 复制代码 
using ClickHouse.Client;
using ClickHouse.Client.ADO;
using System;
using System.Data;

namespace ClickHouseExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // 配置 ClickHouse 连接字符串
            string connectionString = "Host=127.0.0.1;Port=9000;Username=default;Password=;Database=default";

            using (var connection = new ClickHouseConnection(connectionString))
            {
                try
                {
                    connection.Open();
                    Console.WriteLine("Connected to ClickHouse!");

                    // 执行查询
                    using (var command = new ClickHouseCommand("SELECT * FROM system.numbers LIMIT 10", connection))
                    {
                        using (var reader = command.ExecuteReader())
                        {
                            while (reader.Read())
                            {
                                Console.WriteLine(reader[0]);
                            }
                        }
                    }
                }
                catch (Exception ex)
                {
                    Console.WriteLine($"Error connecting to ClickHouse: {ex.Message}");
                }
            }
        }
    }
}
  1. 创建表

如果您还没有创建表，可以使用 ClickHouse.Client 创建一个新的表。

cs 复制代码 
using ClickHouse.Client;
using ClickHouse.Client.ADO;
using System;

namespace ClickHouseExample
{
    class Program
    {
        static void Main(string[] args)
        {
            string connectionString = "Host=127.0.0.1;Port=9000;Username=default;Password=;Database=default";

            using (var connection = new ClickHouseConnection(connectionString))
            {
                try
                {
                    connection.Open();
                    Console.WriteLine("Connected to ClickHouse!");

                    // 创建表
                    string createTableQuery = @"
                        CREATE TABLE IF NOT EXISTS my_table
                        (
                            id UInt32,
                            name String,
                            description String
                        ) ENGINE = MergeTree() ORDER BY id;
                    ";

                    using (var command = new ClickHouseCommand(createTableQuery, connection))
                    {
                        command.ExecuteNonQuery();
                        Console.WriteLine("Table created successfully.");
                    }
                }
                catch (Exception ex)
                {
                    Console.WriteLine($"Error connecting to ClickHouse: {ex.Message}");
                }
            }
        }
    }
}
  1. 插入数据

您可以使用 ClickHouse.Client 将数据插入到 ClickHouse 中。

cs 复制代码 
using ClickHouse.Client;
using ClickHouse.Client.ADO;
using System;

namespace ClickHouseExample
{
    class Program
    {
        static void Main(string[] args)
        {
            string connectionString = "Host=127.0.0.1;Port=9000;Username=default;Password=;Database=default";

            using (var connection = new ClickHouseConnection(connectionString))
            {
                try
                {
                    connection.Open();
                    Console.WriteLine("Connected to ClickHouse!");

                    // 插入数据
                    string insertQuery = @"
                        INSERT INTO my_table (id, name, description) VALUES
                        (1, 'Sample Document', 'This is a sample document.'),
                        (2, 'Another Document', 'This is another sample document.');
                    ";

                    using (var command = new ClickHouseCommand(insertQuery, connection))
                    {
                        command.ExecuteNonQuery();
                        Console.WriteLine("Data inserted successfully.");
                    }
                }
                catch (Exception ex)
                {
                    Console.WriteLine($"Error connecting to ClickHouse: {ex.Message}");
                }
            }
        }
    }
}
  1. 查询数据

您可以使用 ClickHouse.Client 执行查询以检索数据。

cs 复制代码 
using ClickHouse.Client;
using ClickHouse.Client.ADO;
using System;
using System.Data;

namespace ClickHouseExample
{
    class Program
    {
        static void Main(string[] args)
        {
            string connectionString = "Host=127.0.0.1;Port=9000;Username=default;Password=;Database=default";

            using (var connection = new ClickHouseConnection(connectionString))
            {
                try
                {
                    connection.Open();
                    Console.WriteLine("Connected to ClickHouse!");

                    // 查询数据
                    string selectQuery = "SELECT * FROM my_table";

                    using (var command = new ClickHouseCommand(selectQuery, connection))
                    {
                        using (var reader = command.ExecuteReader())
                        {
                            while (reader.Read())
                            {
                                Console.WriteLine($"Id: {reader["id"]}, Name: {reader["name"]}, Description: {reader["description"]}");
                            }
                        }
                    }
                }
                catch (Exception ex)
                {
                    Console.WriteLine($"Error connecting to ClickHouse: {ex.Message}");
                }
            }
        }
    }
}
  1. 更新数据

ClickHouse 不直接支持 UPDATE 操作，但您可以使用 ALTER TABLE ... UPDATE 语句来更新数据。不过，这种操作相对复杂且性能较低，通常建议使用 INSERT 和 DELETE 组合来实现类似的效果。

cs 复制代码 
using ClickHouse.Client;
using ClickHouse.Client.ADO;
using System;

namespace ClickHouseExample
{
    class Program
    {
        static void Main(string[] args)
        {
            string connectionString = "Host=127.0.0.1;Port=9000;Username=default;Password=;Database=default";

            using (var connection = new ClickHouseConnection(connectionString))
            {
                try
                {
                    connection.Open();
                    Console.WriteLine("Connected to ClickHouse!");

                    // 更新数据
                    string updateQuery = @"
                        ALTER TABLE my_table UPDATE name = 'Updated Document' WHERE id = 1;
                    ";

                    using (var command = new ClickHouseCommand(updateQuery, connection))
                    {
                        command.ExecuteNonQuery();
                        Console.WriteLine("Data updated successfully.");
                    }
                }
                catch (Exception ex)
                {
                    Console.WriteLine($"Error connecting to ClickHouse: {ex.Message}");
                }
            }
        }
    }
}
  1. 删除数据

您可以使用 ClickHouse.Client 删除数据。

cs 复制代码 
using ClickHouse.Client;
using ClickHouse.Client.ADO;
using System;

namespace ClickHouseExample
{
    class Program
    {
        static void Main(string[] args)
        {
            string connectionString = "Host=127.0.0.1;Port=9000;Username=default;Password=;Database=default";

            using (var connection = new ClickHouseConnection(connectionString))
            {
                try
                {
                    connection.Open();
                    Console.WriteLine("Connected to ClickHouse!");

                    // 删除数据
                    string deleteQuery = @"
                        ALTER TABLE my_table DELETE WHERE id = 2;
                    ";

                    using (var command = new ClickHouseCommand(deleteQuery, connection))
                    {
                        command.ExecuteNonQuery();
                        Console.WriteLine("Data deleted successfully.");
                    }
                }
                catch (Exception ex)
                {
                    Console.WriteLine($"Error connecting to ClickHouse: {ex.Message}");
                }
            }
        }
    }
}

总结

通过以上步骤，您可以在 C# 项目中成功连接和操作 ClickHouse 数据库。ClickHouse.Client 提供了丰富的 API 来执行各种操作，如创建表、插入数据、查询数据、更新数据和删除数据。确保您的 ClickHouse 实例正在运行，并且客户端配置正确，以便顺利进行这些操作。如果遇到任何问题，可以参考 ClickHouse.Client 的官方文档或社区资源以获取更多帮助。

参考资料：

• ClickHouse 官方文档 https://clickhouse.com/docs/zh/getting-started/install

• ClickHouse.Client https://github.com/yandex/ClickHouse.Client

相关推荐
adinnet20266 小时前
预算管控：预算执行与偏差问数
大数据·数据库
Behavior6 小时前
Unity 手游动态更换 App 图标 — Android 与 iOS 双端技术方案
c#·unity3d·游戏开发
周杰伦fans6 小时前
构建真正智能的CAD AI绘图代理
开发语言·人工智能·c#
Omics Pro8 小时前
Cell封面｜衰老生物学开源AI工具包
数据库·人工智能·算法·机器学习·自然语言处理
UIU11410 小时前
递归算法与汉诺塔
c++·学习·算法·c#·递归
IT枫斗者枫哥15 小时前
MyBatis一对多分页：LIMIT 20，为什么凑不齐20个订单？
java·数据库
Y0015 小时前
PostgreSQL 的锁：为什么你的 ALTER TABLE 会卡住，以及怎么查
数据库·postgresql
CSharp精选营15 小时前
我用 ASP.NET Core 做了个水稻病虫害检查系统
c#·毕业设计·.net core·码农刚子
唐青枫15 小时前
我用 C# 开发了一款电子发票自动整理工具
c#·.net
下页、再停留15 小时前
【C#桌面客户端系列学习-2】在原来窗口基础上打开新窗口
c#·visual studio
热门推荐
01Telegram APK 下载安装完整指南 — 2026年最新02国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）03GitHub 镜像站点04历年考研数学一、数学二、数学三真题试卷及答案PDF052026 爱知・名古屋亚运会怎么看？直播平台+赛程安排分享06蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接07给AI一张“业务概念地图“：本体如何从哲学走向企业智能08微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新09jev-ultrafast 深度解析：7 秒订机票的浏览器 Agent 是如何炼成的102026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？