pycubrid

Pure Python DB-API 2.0 driver for CUBRID database with no C extensions.

한국어: 문서 홈

Key features

• Full PEP 249 (DB-API 2.0) compliant connection and cursor interface
• Direct CUBRID CAS wire protocol implementation in pure Python
• Typed package support (py.typed) for modern IDEs and static analysis
• LOB support for CLOB and BLOB operations

Start here

pycubrid lets a Python program talk to a CUBRID database, a separate server that must already be running; installing pycubrid does not install CUBRID. Your First CUBRID Connection is the first of five short lessons: it prepares a database (your own, or a disposable local one in Docker) and Python, and the next lessons run a first query, save a row, commit and roll back, and finish safely.

Quick install

pip install pycubrid

Minimal example

import pycubrid

conn = pycubrid.connect(host="localhost", port=33000, database="testdb", user="dba", password="")
cur = conn.cursor()
cur.execute("SELECT 1")
print(cur.fetchone())
conn.close()

Documentation

• Learn: Your First CUBRID Connection, then the lessons it links.
• Look up: API Reference, Connection Options, Passing Values Safely (Parameter Binding Contract), Type Mapping and Support Matrix.
• Go deeper: CAS Architecture and Protocol Concepts, how pycubrid talks to the CUBRID Broker and CAS.
• Get help: Troubleshooting, FAQ, and for a security problem the private reporting route in SECURITY.md.
• Contribute: Development, Architecture and Protocol.

Project links

• GitHub
• PyPI
• Changelog
• Contributing

Ecosystem

Part of the cubrid-lab Python ecosystem:

• pycubrid — Pure-Python DB-API 2.0 driver for CUBRID (sync + native asyncio)
• sqlalchemy-cubrid — SQLAlchemy 2.0–2.1 dialect + Alembic
• cubrid-cookbook-python — 68 runnable examples and application templates
• cubrid-mcp-server — MCP server — natural-language access for LLM clients