SQLAlchemy是一个Python SQL工具包和对象关系映射器（ORM）。详情请参考SQLAlchemy官方网站 (opens new window)。

yashandb_sqlalchemy是适配SQLAlchemy框架的YashanDB方言库，已通过SQLAlchemy社区用例集。

运行环境

支持在Linux和Windows系统下运行。

建议使用python3以上的python版本。

建议使用1.4.50版本的 SQLAlchemy。安装命令如下：

pip3 install sqlalchemy==1.4.50

SQLAlchemy运行依赖

YashanDB Python驱动（python-yasdb）。安装python-yasdb请参考相应文档安装YashanDB Python驱动。

yashandb_sqlalchemy方言库。安装包请与YashanDB数据库技术支持人员获取。

方言库安装

下载yashandb_sqlalchemy包后使用以下命令安装：

pip3 install --force-reinstall  yashandb_sqlalchemy-1.0.0-py3-none-any.whl

使用方法

1、安装SQLAlchemy。

2、安装python-yasdb和yashandb_sqlalchemy。

3、将YashanDB数据库切换为open状态。

4、创建一个YashanDB数据库连接引擎，开始使用。

>>> import yashandb_sqlalchemy
>>> import sqlalchemy as sa

# 默认采用yasdb驱动包
>>> sa.create_engine('yashandb://username:password@host:port/database_name')
# 或
>>> sa.create_engine('yashandb+yasdb://username:password@host:port/database_name')
# 如选用yaspy驱动包
>>> sa.create_engine('yashandb+yaspy://username:password@host:port/database_name')

5、随后的操作与SQLAlchemy正常的一般操作无异，详情请参考SQLAlchemy官方网站 (opens new window)。