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)。