YugabyteDB C应用开发实战教程：使用Npgsql驱动构建分布式应用-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00683/article/details/148419192

YugabyteDB C#应用开发实战教程：使用Npgsql驱动构建分布式应用

yugabyte-db yugabyte/yugabyte-db: 是 YugaByte DB 的官方仓库，一个高性能、高可扩展、分布式的 SQL 数据库，支持 PostgreSQL 兼容性。适合对分布式数据库、SQL 数据库和云原生应用的开发者。项目地址: https://gitcode.com/gh_mirrors/yu/yugabyte-db

前言

作为一款高性能的分布式SQL数据库，YugabyteDB完美兼容PostgreSQL协议，这使得我们可以使用各种常见的PostgreSQL驱动来构建应用程序。本教程将详细介绍如何使用C#语言和Npgsql驱动来开发基于YugabyteDB的应用程序。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

安装.NET 6.0 SDK或更高版本
准备一个可用的YugabyteDB集群（本地或云端）

项目初始化

创建一个新的C#控制台应用程序项目，并在项目文件中添加Npgsql驱动依赖：

<PackageReference Include="npgsql" Version="6.0.3" />

连接配置

连接YugabyteDB集群需要正确配置以下参数：

var urlBuilder = new NpgsqlConnectionStringBuilder
{
    Host = "集群主机地址",
    Port = 5433,  // 默认YSQL端口
    Database = "yugabyte",  // 默认数据库
    Username = "用户名",
    Password = "密码",
    SslMode = SslMode.VerifyFull,  // 云端集群需要SSL
    RootCertificate = "CA证书路径",
    ServerCompatibilityMode = ServerCompatibilityMode.NoTypeLoading  // 优化性能
};

对于本地开发集群，可以使用默认用户名/密码(yugabyte/yugabyte)，并禁用SSL。

核心功能实现

数据库连接

using var conn = new NpgsqlConnection(urlBuilder.ConnectionString);
conn.Open();

表创建与数据初始化

var cmd = new NpgsqlCommand(@"
    DROP TABLE IF EXISTS DemoAccount;
    CREATE TABLE DemoAccount (
        id int PRIMARY KEY,
        name varchar,
        age int,
        country varchar,
        balance int
    );
    INSERT INTO DemoAccount VALUES
        (1, 'Jessica', 28, 'USA', 10000),
        (2, 'John', 28, 'Canada', 9000);", conn);
cmd.ExecuteNonQuery();

数据查询

var cmd = new NpgsqlCommand("SELECT name, age, country, balance FROM DemoAccount", conn);
using var reader = cmd.ExecuteReader();

while (reader.Read())
{
    Console.WriteLine($"name = {reader.GetString(0)}, " +
                     $"age = {reader.GetInt32(1)}, " +
                     $"country = {reader.GetString(2)}, " +
                     $"balance = {reader.GetInt32(3)}");
}

分布式事务处理

YugabyteDB支持完整的ACID事务，以下示例展示如何在账户间转账：

try
{
    using var tx = conn.BeginTransaction();
    
    var updateCmd = new NpgsqlCommand(
        "UPDATE DemoAccount SET balance = balance - @amount WHERE name = 'Jessica'", 
        conn, tx);
    updateCmd.Parameters.AddWithValue("amount", 800);
    updateCmd.ExecuteNonQuery();

    updateCmd = new NpgsqlCommand(
        "UPDATE DemoAccount SET balance = balance + @amount WHERE name = 'John'", 
        conn, tx);
    updateCmd.Parameters.AddWithValue("amount", 800);
    updateCmd.ExecuteNonQuery();

    tx.Commit();
}
catch (NpgsqlException ex) when (ex.SqlState == "40001")
{
    Console.WriteLine("事务冲突，建议在生产环境中添加重试逻辑");
    throw;
}