快速开始

pyseekdb

pyseekdb 是 OceanBase 提供的 Python 客户端。实现了基于一套 API 接口，提供两种数据库连接模式，支持连接到嵌入式模式的 seekdb 和连接到远程服务器（支持服务器模式的 seekdb 和 OceanBase 数据库）。

提示

OceanBase 数据库是 OceanBase 提供的一款完全自研的企业级原生分布式数据库，在普通硬件上实现金融级高可用，首创“三地五中心”城市级故障自动无损容灾新标准，刷新 TPC-C 标准测试，单集群规模超过 1500 节点，具有云原生、强一致性、高度兼容 Oracle/MySQL 等特性。有关 OceanBase 数据库的更多信息，参见 OceanBase 数据库。

pyseekdb 目前支持在 Linux、macOS、Windows 系统下使用。不同操作系统下支持的数据库连接模式有些不同，参见下表。

系统	嵌入式 seekdb	服务器模式 seekdb	服务器模式 OceanBase 数据库
Linux	支持	支持	支持
macOS	暂不支持	支持	支持
Windows	暂不支持	支持	支持

在 Linux 系统下安装此客户端，会同时安装嵌入式模式的 seekdb，使您可以直接连接到嵌入式 seekdb 执行创建数据库等操作。您也可以选择远程连接到已经部署好的服务器模式的 seekdb 或者 OceanBase 数据库。

安装 pyseekdb

前提条件

请确保您的环境需要满足以下要求：

• 操作系统：Linux（glibc >= 2.28）、macOS、Windows
• Python 版本：Python 3.11 及之后版本
• 系统架构：x86_64，aarch64

安装

使用 pip 安装，会自动识别默认的 Python 版本和平台。

pip install pyseekdb

如果您的 pip 版本比较低，请先升级 pip 后再安装。

pip install --upgrade pip

后续操作

• 安装完 pyseekdb 之后，可以连接到 seekdb 执行操作。关于 pyseekdb 支持的 API 接口，参见 API 参考。

• 您也可以参考我们提供的 SDK 示例，来快速体验 pyseekdb。

  • Simple 示例

  • Complete 示例

  • 混合搜索示例