💬Generate LLM translations

databendlabs · Jan 22, 2025 · f321b59 · f321b59
1 parent 6074a10
commit f321b59
Show file tree

Hide file tree

Showing 4 changed files with 279 additions and 239 deletions.
diff --git a/docs/cn/developer/00-drivers/01-python.md b/docs/cn/developer/00-drivers/01-python.md
@@ -4,22 +4,22 @@ title: Python
 
 Databend 提供了以下 Python 包，使您能够开发与 Databend 交互的 Python 应用程序：
 
-- [databend-py (**推荐**)](https://github.com/databendcloud/databend-py): 提供直接与 Databend 数据库交互的接口。它允许您执行标准的 Databend 操作，如用户登录、数据库和表的创建、数据插入/加载和查询。
-- [databend-sqlalchemy](https://github.com/databendcloud/databend-sqlalchemy): 提供了一个 SQL 工具包和 [对象关系映射](https://en.wikipedia.org/wiki/Object%E2%80%93relational_mapping) 以与 Databend 数据库接口。[SQLAlchemy](https://www.sqlalchemy.org/) 是一个流行的 Python SQL 工具包和 ORM，而 databend-SQLAlchemy 是 SQLAlchemy 的一个方言，允许您使用 SQLAlchemy 与 Databend 交互。
+- [databend-driver (**推荐**)](https://pypi.org/project/databend-driver/)：一个用于 Databend 的 Python 驱动，提供同步和异步接口来与 Databend 交互、执行 SQL 查询和处理数据操作。
+- [databend-sqlalchemy](https://github.com/databendcloud/databend-sqlalchemy)：提供了一个 SQL 工具包和[对象关系映射](https://en.wikipedia.org/wiki/Object%E2%80%93relational_mapping)来与 Databend 数据库交互。[SQLAlchemy](https://www.sqlalchemy.org/) 是一个流行的 SQL 工具包和 Python 的 ORM，而 databend-SQLAlchemy 是 SQLAlchemy 的一个方言，允许您使用 SQLAlchemy 与 Databend 交互。
 
-这两个包都需要 Python 3.5 或更高版本。要检查您的 Python 版本，请在命令提示符中运行 `python --version`。要安装最新的 `databend-py` 或 `databend-sqlalchemy` 包：
+这两个包都需要 Python 3.7 或更高版本。要检查您的 Python 版本，请在命令提示符中运行 `python --version`。要安装最新的 `databend-driver` 或 `databend-sqlalchemy` 包：
 
 ```bash
-# 安装 databend-py
-pip install databend-py
+# 安装 databend-driver
+pip install databend-driver
 
 # 安装 databend-sqlalchemy
 pip install databend-sqlalchemy
 ```
 
 ## 数据类型映射
 
-下表展示了 Databend 通用数据类型与其对应的 Python 数据类型的对应关系：
+下表展示了 Databend 通用数据类型与其对应的 Python 数据类型之间的对应关系：
 
 | Databend  | Python            |
 | --------- | ----------------- |
@@ -36,7 +36,7 @@ pip install databend-sqlalchemy
 | VARCHAR   | str               |
 | BINARY    | bytes             |
 
-下表展示了 Databend 半结构化数据类型与其对应的 Python 数据类型的对应关系：
+下表展示了 Databend 半结构化数据类型与其对应的 Python 数据类型之间的对应关系：
 
 | Databend | Python |
 | -------- | ------ |
@@ -47,236 +47,8 @@ pip install databend-sqlalchemy
 | BITMAP   | str    |
 | GEOMETRY | str    |
 
-在以下教程中，您将学习如何利用上述包来开发您的 Python 应用程序。教程将引导您在 Databend 中创建一个 SQL 用户，然后编写 Python 代码来创建表、插入数据和执行数据查询。
+## 教程
 
-## 教程 -1：使用 Python 与 Databend 集成
-
-在开始之前，请确保您已成功安装本地 Databend。有关详细说明，请参阅 [本地和 Docker 部署](/guides/deploy/deploy/non-production/deploying-local)。
-
-### 步骤 1. 准备一个 SQL 用户账户
-
-要将您的程序连接到 Databend 并执行 SQL 操作，您必须在代码中提供一个具有适当权限的 SQL 用户账户。如果需要，请在 Databend 中创建一个，并确保该 SQL 用户仅具有必要的权限以确保安全。
-
-本教程使用名为 'user1' 且密码为 'abc123' 的 SQL 用户作为示例。由于程序将向 Databend 写入数据，该用户需要 ALL 权限。有关如何管理 SQL 用户及其权限，请参阅 [用户与角色](/sql/sql-commands/ddl/user/)。
-
-```sql
-CREATE USER user1 IDENTIFIED BY 'abc123';
-GRANT ALL on *.* TO user1;
-```
-
-### 步骤 2. 配置连接字符串（针对 databend-py）
-
-`databend-py` 支持多种参数，这些参数可以作为 URL 参数或作为传递给 Client 的属性进行配置。下面提供的两个示例展示了设置这些参数的等效方式，适用于常见的 DSN：
-
-示例 1：使用 URL 参数
-
-```python
-# 格式：<schema>://<username>:<password>@<host_port>/<database>?<connection_params>
-client = Client.from_url('http://root@localhost:8000/db?secure=False&copy_purge=True&debug=True')
-```
-
-示例 2：使用 Client 参数
-
-```python
-client = Client(
-    host='tenant--warehouse.ch.datafusecloud.com',
-    database="default",
-    user="user",
-    port="443",
-    password="password", settings={"copy_purge": True, "force": True})
-```
-
-要创建有效的 DSN，请根据您的需求选择适当的连接参数，详见 [这里](https://github.com/databendcloud/databend-py/blob/main/docs/connection.md)。
-
-### 步骤 3. 编写一个 Python 程序
-
-在这一步中，您将创建一个简单的 Python 程序，该程序与 Databend 通信。程序将涉及创建表、插入数据和执行数据查询等任务。
-
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
-
-<Tabs groupId="python">
-<TabItem value="databend-py" label="databend-py">
-
-您将使用 databend-py 库来创建客户端实例并直接执行 SQL 查询。
-
-1. 安装 databend-py。
-
-```shell
-pip install databend-py
-```
-
-2. 将以下代码复制并粘贴到文件 `main.py` 中：
-
-```python title='main.py'
-from databend_py import Client
-
-# 以名为 'user1' 且密码为 'abc123' 的 SQL 用户连接到本地 Databend 为例。
-# 请根据实际情况使用您自己的值，同时保持相同的格式。
-# 设置 secure=False 表示客户端将使用 HTTP 而非 HTTPS 连接到 Databend。
-client = Client('user1:[email protected]', port=8000, secure=False)
-client.execute("CREATE DATABASE IF NOT EXISTS bookstore")
-client.execute("USE bookstore")
-client.execute("CREATE TABLE IF NOT EXISTS booklist(title VARCHAR, author VARCHAR, date VARCHAR)")
-client.execute("INSERT INTO booklist VALUES('Readings in Database Systems', 'Michael Stonebraker', '2004')")
-
-_, results = client.execute("SELECT * FROM booklist")
-for (title, author, date) in results:
-  print("{} {} {}".format(title, author, date))
-client.execute('drop table booklist')
-client.execute('drop database bookstore')
-
-# 关闭连接。
-client.disconnect()
-```
-
-3. 运行 `python main.py`：
-
-```text
-Readings in Database Systems Michael Stonebraker 2004
-```
-
-</TabItem>
-
-<TabItem value="databend-sqlalchemy with Object" label="databend-sqlalchemy (Connector)">
-
-您将使用 databend-sqlalchemy 库来创建连接器实例，并通过游标对象执行 SQL 查询。
-
-1. 安装 databend-sqlalchemy。
-
-```shell
-pip install databend-sqlalchemy
-```
-
-2. 将以下代码复制并粘贴到文件 `main.py` 中：
-
-```python title='main.py'
-from databend_sqlalchemy import connector
-
-# 以名为 'user1' 且密码为 'abc123' 的 SQL 用户连接到本地 Databend 为例。
-# 请根据实际情况使用您自己的值，同时保持相同的格式。
-conn = connector.connect(f"http://user1:[email protected]:8000").cursor()
-conn.execute("CREATE DATABASE IF NOT EXISTS bookstore")
-conn.execute("USE bookstore")
-conn.execute("CREATE TABLE IF NOT EXISTS booklist(title VARCHAR, author VARCHAR, date VARCHAR)")
-conn.execute("INSERT INTO booklist VALUES('Readings in Database Systems', 'Michael Stonebraker', '2004')")
-conn.execute('SELECT * FROM booklist')
-
-results = conn.fetchall()
-for (title, author, date) in results:
-  print("{} {} {}".format(title, author, date))
-conn.execute('drop table booklist')
-conn.execute('drop database bookstore')
-
-# 关闭连接。
-conn.close()
-```
-
-3. 运行 `python main.py`：
-
-```text
-Readings in Database Systems Michael Stonebraker 2004
-```
-
-</TabItem>
-
-<TabItem value="databend-sqlalchemy with Engine" label="databend-sqlalchemy (Engine)">
-
-您将使用 databend-sqlalchemy 库来创建引擎实例，并通过 connect 方法创建可执行查询的连接。
-
-1. 安装 databend-sqlalchemy。
-
-```shell
-pip install databend-sqlalchemy
-```
-
-2. 将以下代码复制并粘贴到文件 `main.py` 中：
-
-```python title='main.py'
-from sqlalchemy import create_engine, text
-
-# 以名为 'user1' 且密码为 'abc123' 的 SQL 用户连接到本地 Databend 为例。
-# 请根据实际情况使用您自己的值，同时保持相同的格式。
-# 设置 secure=False 表示客户端将使用 HTTP 而非 HTTPS 连接到 Databend。
-engine = create_engine("databend://user1:[email protected]:8000/default?secure=False")
-
-connection1 = engine.connect()
-connection2 = engine.connect()
-
-with connection1.begin() as trans:
-    connection1.execute(text("CREATE DATABASE IF NOT EXISTS bookstore"))
-    connection1.execute(text("USE bookstore"))
-    connection1.execute(text("CREATE TABLE IF NOT EXISTS booklist(title VARCHAR, author VARCHAR, date VARCHAR)"))
-    connection1.execute(text("INSERT INTO booklist VALUES('Readings in Database Systems', 'Michael Stonebraker', '2004')"))
-
-result = connection2.execute(text("SELECT * FROM booklist"))
-results = result.fetchall()
-
-for (title, author, date) in results:
-    print("{} {} {}".format(title, author, date))
-
-# 关闭连接。
-connection1.close()
-connection2.close()
-engine.dispose()
-```
-
-3. 运行 `python main.py`：
-
-```text
-Readings in Database Systems Michael Stonebraker 2004
-```
-
-</TabItem>
-</Tabs>
-
-## 教程 -2：使用 Python 与 Databend Cloud 集成（databend-py）
-
-在开始之前，请确保您已成功创建计算集群并获取连接信息。有关如何操作，请参阅 [连接到计算集群](/guides/cloud/using-databend-cloud/warehouses#connecting)。
-
-### 步骤 1. 使用 pip 安装依赖
-
-```shell
-pip install databend-py
-```
-
-### 步骤 2. 使用 databend-py 连接
-
-```python
-from databend_py import Client
-
-client = Client.from_url(f"databend://{USER}:{PASSWORD}@${HOST}:443/{DATABASE}?&warehouse={WAREHOUSE_NAME}&secure=True)
-client.execute('DROP TABLE IF EXISTS data')
-client.execute('CREATE TABLE if not exists data (x Int32,y VARCHAR)')
-client.execute('DESC  data')
-client.execute("INSERT INTO data (Col1,Col2) VALUES ", [1, 'yy', 2, 'xx'])
-_, res = client.execute('select * from data')
-print(res)
-```
-
-## 教程 -3：使用 Python 与 Databend Cloud 集成（databend-sqlalchemy）
-
-在开始之前，请确保您已成功创建计算集群并获取连接信息。有关如何操作，请参阅 [连接到计算集群](/guides/cloud/using-databend-cloud/warehouses#connecting)。
-
-### 步骤 1. 使用 pip 安装依赖
-
-```shell
-pip install databend-sqlalchemy
-```
-
-### 步骤 2. 使用 Databend SQLAlchemy 连接
-
-```python
-from databend_sqlalchemy import connector
-
-cursor = connector.connect(f"databend://{USER}:{PASSWORD}@${HOST}:443/{DATABASE}?&warehouse={WAREHOUSE_NAME}).cursor()
-cursor.execute('DROP TABLE IF EXISTS data')
-cursor.execute('CREATE TABLE IF NOT EXISTS  data( Col1 TINYINT, Col2 VARCHAR )')
-cursor.execute("INSERT INTO data (Col1,Col2) VALUES ", [1, 'yy', 2, 'xx'])
-cursor.execute("SELECT * FROM data")
-print(cursor.fetchall())
-```
-
-:::tip
-请将代码中的 `{USER}, {PASSWORD}, {HOST}, {WAREHOUSE_NAME} 和 {DATABASE}` 替换为您的连接信息。有关如何获取连接信息，请参阅 [连接到仓库](/guides/cloud/using-databend-cloud/warehouses#connecting)。
-:::
+- [使用 databend-driver 与 Databend Cloud 集成](/tutorials/programming/python/integrating-with-databend-cloud-using-databend-driver)
+- [使用 databend-sqlalchemy 与 Databend Cloud 集成](/tutorials/programming/python/integrating-with-databend-cloud-using-databend-sqlalchemy)
+- [与自托管的 Databend 集成](/tutorials/programming/python/integrating-with-self-hosted-databend)
diff --git a/...als/programming/python/integrating-with-databend-cloud-using-databend-driver.md b/...als/programming/python/integrating-with-databend-cloud-using-databend-driver.md
@@ -0,0 +1,56 @@
+---
+title: 使用 databend-driver 与 Databend Cloud 集成
+---
+
+在本教程中，我们将指导您如何使用 `databend-driver` 连接到 Databend Cloud，创建表，插入数据，并使用 Python 检索结果。
+
+## 开始之前
+
+在开始之前，请确保您已成功创建计算集群并获取了连接信息。有关如何操作，请参阅[连接到计算集群](/guides/cloud/using-databend-cloud/warehouses#connecting)。
+
+## 第一步：使用 pip 安装依赖项
+
+```shell
+pip install databend-driver
+```
+
+## 第二步：使用 databend-driver 连接
+
+1. 将以下代码复制并粘贴到文件 `main.py` 中：
+
+```python
+from databend_driver import BlockingDatabendClient
+
+# 使用您的凭据连接到 Databend Cloud（替换 PASSWORD、HOST、DATABASE 和 WAREHOUSE_NAME）
+client = BlockingDatabendClient(f"databend://cloudapp:{PASSWORD}@{HOST}:443/{DATABASE}?warehouse={WAREHOUSE_NAME}")
+
+# 从客户端获取游标以执行查询
+cursor = client.cursor()
+
+# 如果表存在则删除
+cursor.execute('DROP TABLE IF EXISTS data')
+
+# 如果表不存在则创建
+cursor.execute('CREATE TABLE IF NOT EXISTS data (x Int32, y String)')          
+
+# 向表中插入数据
+cursor.execute("INSERT INTO data (x, y) VALUES (1, 'yy'), (2, 'xx')")
+
+# 从表中选择所有数据
+cursor.execute('SELECT * FROM data')
+
+# 从结果中获取所有行
+rows = cursor.fetchall()
+
+# 打印结果
+for row in rows:
+    print(row.values())
+```
+
+2. 运行 `python main.py`：
+
+```bash
+python main.py
+(1, 'yy')
+(2, 'xx')
+```
diff --git a/...programming/python/integrating-with-databend-cloud-using-databend-sqlalchemy.md b/...programming/python/integrating-with-databend-cloud-using-databend-sqlalchemy.md
@@ -0,0 +1,38 @@
+---
+title: 使用 databend-sqlalchemy 与 Databend Cloud 集成
+---
+
+在本教程中，我们将指导您如何使用 `databend-sqlalchemy` 库连接到 Databend Cloud，创建表，插入数据，并使用 Python 查询结果。
+
+## 开始之前
+
+在开始之前，请确保您已成功创建计算集群并获取了连接信息。有关如何操作，请参阅 [连接到计算集群](/guides/cloud/using-databend-cloud/warehouses#connecting)。
+
+## 第一步：使用 pip 安装依赖项
+
+```shell
+pip install databend-sqlalchemy
+```
+
+## 第二步：使用 databend_sqlalchemy 连接
+
+1. 将以下代码复制并粘贴到文件 `main.py` 中：
+
+```python
+from databend_sqlalchemy import connector
+
+# 使用您的凭据连接到 Databend Cloud（替换 PASSWORD、HOST、DATABASE 和 WAREHOUSE_NAME）
+cursor = connector.connect(f"databend://cloudapp:{PASSWORD}@{HOST}:443/{DATABASE}?warehouse={WAREHOUSE_NAME}").cursor()
+cursor.execute('DROP TABLE IF EXISTS data')
+cursor.execute('CREATE TABLE IF NOT EXISTS  data( Col1 TINYINT, Col2 VARCHAR )')
+cursor.execute("INSERT INTO data (Col1, Col2) VALUES (%s, %s), (%s, %s)", [1, 'yy', 2, 'xx'])
+cursor.execute("SELECT * FROM data")
+print(cursor.fetchall())
+```
+
+2. 运行 `python main.py`：
+
+```bash
+python main.py
+[(1, 'yy'), (2, 'xx')]
+```