YugabyteDB Python YCQL驱动使用指南-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00877/article/details/148440674

YugabyteDB Python YCQL驱动使用指南

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

概述

YugabyteDB是一个高性能、云原生的分布式SQL数据库，兼容PostgreSQL（YSQL）和Cassandra（YCQL）两种API。本文将重点介绍如何使用Python语言通过YCQL接口连接和操作YugabyteDB数据库。

驱动介绍

YugabyteDB为YCQL接口提供了基于DataStax Python Driver的增强版驱动，该驱动具有以下特点：

完全兼容Cassandra Query Language(CQL)
支持智能负载均衡特性
针对YugabyteDB分布式架构进行了优化

环境准备

安装驱动

安装Yugabyte Python YCQL驱动非常简单，只需执行以下命令：

pip3 install yb-cassandra-driver --install-option="--no-cython"

注意：在MacOS Catalina及更高版本上，必须添加--no-cython参数以避免构建失败。

前置条件

在开始编写应用前，请确保：

已安装并运行YugabyteDB
已创建数据库集群
能够使用YCQL shell与数据库交互

基础应用开发

连接数据库

以下是连接YugabyteDB的基本代码示例：

from cassandra.cluster import Cluster

# 创建集群连接
cluster = Cluster(['127.0.0.1'])  # 使用实际节点IP替换
session = cluster.connect()

创建Keyspace和表

# 创建Keyspace
session.execute('CREATE KEYSPACE IF NOT EXISTS ybdemo;')

# 创建表
session.execute("""
  CREATE TABLE IF NOT EXISTS ybdemo.employee (
    id int PRIMARY KEY,
    name varchar,
    age int,
    language varchar
  );
""")

数据操作

# 插入数据
session.execute("""
  INSERT INTO ybdemo.employee (id, name, age, language)
  VALUES (1, 'John', 35, 'Python');
""")

# 查询数据
rows = session.execute('SELECT name, age, language FROM ybdemo.employee WHERE id = 1;')
for row in rows:
  print(f"员工信息: 姓名={row.name}, 年龄={row.age}, 编程语言={row.language}")

# 关闭连接
cluster.shutdown()

高级配置

SSL连接配置

在生产环境中，建议使用SSL加密连接：

from ssl import SSLContext, PROTOCOL_TLS_CLIENT, CERT_REQUIRED
from cassandra.auth import PlainTextAuthProvider

# 配置SSL上下文
ssl_context = SSLContext(PROTOCOL_TLS_CLIENT)
ssl_context.load_verify_locations('/path/to/ca.crt')  # CA证书路径
ssl_context.verify_mode = CERT_REQUIRED

# 创建安全连接
cluster = Cluster(
    contact_points=['your.server.ip'],
    ssl_context=ssl_context,
    ssl_options={'server_hostname': 'your.server.ip'},
    auth_provider=PlainTextAuthProvider(
        username='your_username',
        password='your_password'
    )
)
session = cluster.connect()