Skip to content

Commit 8f6b05a

Browse files
Chasen-ZhangChasen-Zhang
committed
fix: format
1 parent ddc01b3 commit 8f6b05a

File tree

60 files changed

+688
-711
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

60 files changed

+688
-711
lines changed

‎docs/cn/developer/00-drivers/00-golang.md‎

Lines changed: 13 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,3 @@
1-
```markdown
21
---
32
title: Golang
43
---
@@ -39,14 +38,14 @@ Databend 提供了一个用 Golang 编写的驱动程序 (databend-go)，它有
3938

4039
Databend Go 驱动程序与 ["database/sql"](https://pkg.go.dev/database/sql) 接口规范兼容。以下是一些常见的行为，以及涉及的关键函数及其背后的原理。
4140

42-
| 基本行为 | 涉及的关键函数 | 原理 |
43-
| --------------------------- | -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
44-
| 创建连接 | `DB.Open` | 使用 DSN 字符串和 `DB.Open` 方法建立与 Databend 的连接。<br /><br />DSN 字符串格式为 `https://user:password@host/database?<query_option>=<value>`。 |
45-
| 执行语句 | `DB.Exec` | `DB.Exec` 方法使用 `v1/query` 接口执行 SQL 语句，用于创建、删除表和插入数据。 |
46-
| 批量插入 | `DB.Begin`, `Tx.Prepare`, `Stmt.Exec`, `Tx.Commit` | 批量插入/替换数据（`INSERT INTO` 和 `REPLACE INTO`）通过事务处理。<br /><br />使用 `Stmt.Exec` 将尽可能多的数据添加到预处理语句对象；数据将附加到文件中。<br /><br />执行 `Tx.Commit()` 最终会将数据上传到内置的 Stage 并执行插入/替换操作，使用 [Stage Attachment](/developer/apis/http#stage-attachment)。 |
47-
| 查询单行 | `DB.QueryRow`, `Row.Scan` | 使用 `DB.QueryRow` 方法查询单行数据并返回 `*sql.Row`，然后调用 `Row.Scan` 将列数据映射到变量。 |
48-
| 迭代行 | `DB.Query`, `Rows.Next`, `Rows.Scan` | 使用 `DB.Query` 方法查询多行数据并返回 `*sql.Rows` 结构，使用 `Rows.Next` 方法迭代行，并使用 `Rows.Scan` 将数据映射到变量。 |
49-
| 上传到内部 Stage | `APIClient.UploadToStage` | 将数据上传到 Stage。默认情况下，使用 `PRESIGN UPLOAD` 获取 URL，如果禁用 PRESIGN，则使用 `v1/upload_to_stage` API。 |
41+
| 基本行为 | 涉及的关键函数 | 原理 |
42+
| ---------------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
43+
| 创建连接 | `DB.Open` | 使用 DSN 字符串和 `DB.Open` 方法建立与 Databend 的连接。<br /><br />DSN 字符串格式为 `https://user:password@host/database?<query_option>=<value>`。 |
44+
| 执行语句 | `DB.Exec` | `DB.Exec` 方法使用 `v1/query` 接口执行 SQL 语句，用于创建、删除表和插入数据。 |
45+
| 批量插入 | `DB.Begin`, `Tx.Prepare`, `Stmt.Exec`, `Tx.Commit` | 批量插入/替换数据（`INSERT INTO` 和 `REPLACE INTO`）通过事务处理。<br /><br />使用 `Stmt.Exec` 将尽可能多的数据添加到预处理语句对象；数据将附加到文件中。<br /><br />执行 `Tx.Commit()` 最终会将数据上传到内置的 Stage 并执行插入/替换操作，使用 [Stage Attachment](/developer/apis/http#stage-attachment)。 |
46+
| 查询单行 | `DB.QueryRow`, `Row.Scan` | 使用 `DB.QueryRow` 方法查询单行数据并返回 `*sql.Row`，然后调用 `Row.Scan` 将列数据映射到变量。 |
47+
| 迭代行 | `DB.Query`, `Rows.Next`, `Rows.Scan` | 使用 `DB.Query` 方法查询多行数据并返回 `*sql.Rows` 结构，使用 `Rows.Next` 方法迭代行，并使用 `Rows.Scan` 将数据映射到变量。 |
48+
| 上传到内部 Stage | `APIClient.UploadToStage` | 将数据上传到 Stage。默认情况下，使用 `PRESIGN UPLOAD` 获取 URL，如果禁用 PRESIGN，则使用 `v1/upload_to_stage` API。 |
5049

5150
## 教程 1：使用 Golang 与 Databend 集成
5251

@@ -175,7 +174,7 @@ func main() {
175174

176175
<StepContent number="2">
177176

178-
### 安装依赖.
177+
### 安装依赖。
179178

180179
```shell
181180
go mod init databend-golang
@@ -202,7 +201,7 @@ require (
202201

203202
<StepContent number="3">
204203

205-
### 运行程序.
204+
### 运行程序。
206205

207206
```shell
208207
go run main.go
@@ -222,7 +221,7 @@ go run main.go
222221

223222
## Tutorial-2: 使用 Golang 与 Databend Cloud 集成
224223

225-
在开始之前，请确保您已成功创建计算集群并获得连接信息。 有关如何执行此操作，请参见 [连接到计算集群](/guides/cloud/using-databend-cloud/warehouses#connecting)。
224+
在开始之前，请确保您已成功创建计算集群并获得连接信息。有关如何执行此操作，请参见 [连接到计算集群](/guides/cloud/using-databend-cloud/warehouses#connecting)。
226225

227226
### Step 1. 创建一个 Go Module
228227

@@ -299,7 +298,7 @@ func main() {
299298
```
300299

301300
:::tip
302-
将代码中的 `{USER}, {PASSWORD}, {HOST}, {WAREHOUSE_NAME} and {DATABASE}` 替换为您的连接信息。 有关如何
301+
将代码中的 `{USER}, {PASSWORD}, {HOST}, {WAREHOUSE_NAME} and {DATABASE}` 替换为您的连接信息。有关如何
303302
获取连接信息，
304303
请参见 [连接到计算集群](/guides/cloud/using-databend-cloud/warehouses#connecting)。
305304
:::
@@ -308,4 +307,4 @@ func main() {
308307

309308
```shell
310309
$ go run main.go
311-
```
310+
```

‎docs/cn/developer/index.md‎

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,3 @@
1-
```markdown
21
---
32
title: 开发者资源
43
sidebar_position: -2
@@ -8,19 +7,18 @@ sidebar_position: -2
87

98
学习使用 Go、Python、Node.js、Java 和 Rust 等编程语言来开发与 Databend 交互的应用程序。下表描述的驱动程序可用于从这些应用程序访问 Databend 或 Databend Cloud，从而实现从支持的语言与 Databend 的通信。
109

11-
| 语言 | 驱动程序 | Native? | 描述 |
12-
| -------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
13-
| Go | [ databend-go ](https://github.com/databendlabs/databend-go) | Yes | 通过为 Go 编程语言设计的原生接口连接 Databend 或 Databend Cloud 并与之交互。[点击此处](00-drivers/00-golang.md) 了解有关驱动程序安装、教程和代码示例的更多信息。 |
14-
| Python | [databend-driver](https://pypi.org/project/databend-driver/) & [ databend-sqlalchemy ](https://github.com/databendcloud/databend-py) | Yes | 通过为 Python 编程语言开发的原生接口连接 Databend 或 Databend Cloud 并与之交互。[点击此处](00-drivers/01-python.md) 了解有关驱动程序安装、教程和代码示例的更多信息。 |
15-
| Node.js | [databend-driver](https://www.npmjs.com/package/databend-driver) | Yes | 使用 Databend Driver Node.js Binding 连接 Databend 或 Databend Cloud 并与之交互。[点击此处](00-drivers/02-nodejs.md) 了解有关驱动程序安装、教程和代码示例的更多信息。 |
16-
| Java | [databend-jdbc](https://github.com/databendcloud/databend-jdbc) | Yes | 通过为 Java 编程语言设计的原生接口，从各种客户端工具和应用程序连接 Databend 或 Databend Cloud 并与之交互。[点击此处](00-drivers/03-jdbc.md) 了解有关驱动程序安装、教程和代码示例的更多信息。 |
17-
| Rust | [databend-driver](https://github.com/databendlabs/BendSQL/tree/main/driver) | Yes | 通过为 Rust 编程语言开发的原生接口连接 Databend 或 Databend Cloud 并与之交互。[点击此处](00-drivers/04-rust.md) 了解有关驱动程序安装、教程和代码示例的更多信息。 |
10+
| 语言 | 驱动程序 | Native? | 描述 |
11+
| ------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
12+
| Go | [ databend-go ](https://github.com/databendlabs/databend-go) | Yes | 通过为 Go 编程语言设计的原生接口连接 Databend 或 Databend Cloud 并与之交互。[点击此处](00-drivers/00-golang.md) 了解有关驱动程序安装、教程和代码示例的更多信息。 |
13+
| Python | [databend-driver](https://pypi.org/project/databend-driver/) & [ databend-sqlalchemy ](https://github.com/databendcloud/databend-py) | Yes | 通过为 Python 编程语言开发的原生接口连接 Databend 或 Databend Cloud 并与之交互。[点击此处](00-drivers/01-python.md) 了解有关驱动程序安装、教程和代码示例的更多信息。 |
14+
| Node.js | [databend-driver](https://www.npmjs.com/package/databend-driver) | Yes | 使用 Databend Driver Node.js Binding 连接 Databend 或 Databend Cloud 并与之交互。[点击此处](00-drivers/02-nodejs.md) 了解有关驱动程序安装、教程和代码示例的更多信息。 |
15+
| Java | [databend-jdbc](https://github.com/databendcloud/databend-jdbc) | Yes | 通过为 Java 编程语言设计的原生接口，从各种客户端工具和应用程序连接 Databend 或 Databend Cloud 并与之交互。[点击此处](00-drivers/03-jdbc.md) 了解有关驱动程序安装、教程和代码示例的更多信息。 |
16+
| Rust | [databend-driver](https://github.com/databendlabs/BendSQL/tree/main/driver) | Yes | 通过为 Rust 编程语言开发的原生接口连接 Databend 或 Databend Cloud 并与之交互。[点击此处](00-drivers/04-rust.md) 了解有关驱动程序安装、教程和代码示例的更多信息。 |
1817

1918
## APIs
2019

2120
Databend 提供了各种强大的 API，允许您无缝地与系统交互、与外部数据库集成、启用实时数据提取以及简化文件上传。在支持的语言中进行开发时，请随时利用这些 API 来充分利用 Databend 的潜力。
2221

23-
| API | 描述 |
24-
| ------------------------------- | -------------------------------------------- |
22+
| API | 描述 |
23+
| ------------------------------- | ---------------------------------------- |
2524
| [HTTP Handler](10-apis/http.md) | 允许通过 HTTP 请求与 Databend 进行交互。 |
26-
```

‎docs/cn/guides/00-products/02-dc/01-platforms.md‎

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,3 @@
1-
```markdown
21
---
32
title: 平台和区域
43
---
@@ -11,4 +10,3 @@ import PlatformsEN from '@site/docs/fragment/01-platforms-en.md'
1110
en={<PlatformsEN />}
1211
cn={<PlatformsCN />}
1312
/>
14-
```

‎docs/cn/guides/00-products/02-dc/03-pricing.md‎

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,3 @@
1-
```markdown
21
---
32
title: 定价与账单
43
---
@@ -11,4 +10,3 @@ import PricingCN from '@site/docs/fragment/03-pricing-cn.md'
1110
en={<PricingEN />}
1211
cn={<PricingCN />}
1312
/>
14-
```

0 commit comments

Comments
 (0)