Metadata-Version: 2.1
Name: gbase8s-sqlalchemy
Version: 0.1.1
Summary: GBase 8s Dialect for SQLAlchemy
Home-page: https://gitee.com/GBase8s/sqlalchemy-gbase8s
Author: GBase 8s team
License: MIT
Keywords: GBase 8s,database,sqlalchemy
Platform: UNKNOWN
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: sqlalchemy>=2.0.0
Requires-Dist: gbase8sdb

# gbase8s-sqlalchemy

#### 介绍
GBase 8s数据库的SQLAlchemy方言，需要SQLAlchemy 2.0或更高版本，Python版本需要Python 3.7或更高版本, 支持GBase 8s V8.8_3.6.2版本及以上。

#### 安装教程

```python
pip install gbase8s-sqlalchemy
```

#### 使用说明

1.  方言使用python-gbase8sdb驱动连接数据库，安装sqlalchemy-gbase8s时会作为依赖进行安装，您也可以手动安装：
```python
pip install gbase8sdb
```
2.  python-gbase8sdb驱动连接数据库依赖GSDK 1.1版本，所以您需要联系GBase 8s技术支持或通过官方渠道获取相应版本的GSDK，并安装到您的机器上， 并设置如下环境变量：
```bash
GSDK_PATH=/path/to/gsdk
export LD_LIBRARY_PATH=${GSDK_PATH}/lib:$LD_LIBRARY_PATH
```

#### 入门
在您的Python应用程序中，可以通过以下方式连接到数据库：
```python
from sqlalchemy import create_engine
username = 'gbasedbt'
password = 'xxxxxx'
ip = '192.168.xxx.xxx'
port = 9088
dbname = 'testdb'
servername = 'gbase8s01'
url = f'gbase8s+gbase8sdb://{username}:{password}@{ip}:{port}/{dbname}?GBASEDBTSERVER={servername}&DB_LOCALE=zh_CN.utf8'
# 或使用sqlhosts文件连接
# url = f'gbase8s+gbase8sdb://{username}:{password}@{dbname}?GBASEDBTSERVER={servername}&DB_LOCALE=zh_CN.utf8&SQLH_FILE=/path/to/sqlhosts'
engine = create_engine(url, echo=True)
```



