From ed43dbb56ae7e3e52b590be32f933cea7656692b Mon Sep 17 00:00:00 2001 From: BohuTANG Date: Sun, 23 Nov 2025 13:19:21 +0800 Subject: [PATCH 01/12] docs: optimize Chinese guide titles and content --- docs/cn/guides/00-products/00-dce.md | 2 +- docs/cn/guides/00-products/01-dee/index.md | 2 +- docs/cn/guides/00-products/index.md | 42 +++++++++---------- .../01-non-production/_category_.json | 2 +- .../01-deploy/02-production/_category_.json | 2 +- .../01-deploy/04-manually/_category_.json | 2 +- .../10-deploy/01-deploy/_category_.json | 2 +- .../10-deploy/02-upgrade/_category_.json | 2 +- .../10-deploy/03-monitor/_category_.json | 2 +- .../03-monitor/tools/_category_.json | 2 +- .../10-deploy/04-references/_category_.json | 2 +- docs/cn/guides/10-deploy/_category_.json | 2 +- .../10-using-databend-cloud/_category_.json | 2 +- .../guides/20-cloud/20-manage/_category_.json | 2 +- .../02-private-link/_category_.json | 2 +- .../20-cloud/30-advanced/_category_.json | 2 +- docs/cn/guides/20-cloud/_category_.json | 2 +- .../30-sql-clients/01-jdbc/_category_.json | 2 +- .../02-developers/_category_.json | 2 +- docs/cn/guides/30-sql-clients/_category_.json | 2 +- docs/cn/guides/31-visualize/jupyter.md | 2 +- docs/cn/guides/31-visualize/mindsdb.md | 2 +- .../40-load-data/00-stage/_category_.json | 2 +- .../40-load-data/01-load/_category_.json | 2 +- .../40-load-data/02-load-db/_category_.json | 2 +- .../03-load-semistructured/_category_.json | 2 +- .../40-load-data/04-transform/_category_.json | 2 +- .../_category_.json | 2 +- docs/cn/guides/40-load-data/_category_.json | 2 +- .../50-unload-data/00-unload-parquet.md | 4 +- .../cn/guides/50-unload-data/01-unload-csv.md | 4 +- .../cn/guides/50-unload-data/02-unload-tsv.md | 4 +- .../guides/50-unload-data/03-unload-ndjson.md | 4 +- docs/cn/guides/50-unload-data/_category_.json | 2 +- .../51-ai-functions/01-external-functions.md | 4 +- docs/cn/guides/51-ai-functions/02-mcp.md | 8 +++- .../cn/guides/51-ai-functions/_category_.json | 2 +- docs/cn/guides/54-query/_category_.json | 2 +- docs/cn/guides/56-security/_category_.json | 2 +- .../access-control/_category_.json | 2 +- docs/cn/guides/56-security/audit-trail.md | 2 +- docs/cn/guides/56-security/index.md | 2 +- docs/cn/guides/56-security/masking-policy.md | 4 +- .../81-how-databend-works/_category_.json | 2 +- 44 files changed, 75 insertions(+), 71 deletions(-) diff --git a/docs/cn/guides/00-products/00-dce.md b/docs/cn/guides/00-products/00-dce.md index 741b79af1f..d34e12b848 100644 --- a/docs/cn/guides/00-products/00-dce.md +++ b/docs/cn/guides/00-products/00-dce.md @@ -1,5 +1,5 @@ --- -title: Databend 社区版（Community） +title: Databend 社区版 sidebar_position: 4 --- diff --git a/docs/cn/guides/00-products/01-dee/index.md b/docs/cn/guides/00-products/01-dee/index.md index 897618c885..d0165caefa 100644 --- a/docs/cn/guides/00-products/01-dee/index.md +++ b/docs/cn/guides/00-products/01-dee/index.md @@ -1,5 +1,5 @@ --- -title: Databend 企业版（Enterprise） +title: Databend 企业版 sidebar_position: 3 --- diff --git a/docs/cn/guides/00-products/index.md b/docs/cn/guides/00-products/index.md index f4dbd9ccf5..4f8a351b33 100644 --- a/docs/cn/guides/00-products/index.md +++ b/docs/cn/guides/00-products/index.md @@ -12,38 +12,38 @@ import Speaker from '@site/src/components/Speaker' -**核心主题概览：** +**核心功能概览：** **快速上手** -- **[快速开始](/guides/deploy/quickstart)**: 使用 Docker 快速启动 Databend，加载示例数据并体验核心功能。 -- **[Databend Cloud](/guides/cloud)**: 创建 Serverless 数仓，高效管理组织与数据资源。 -- **[连接 Databend](/guides/sql-clients)**: 支持主流 SQL 客户端及编程语言，连接并使用 Databend。 -- **[SQL 参考](/sql)**: 查阅 Databend 支持的 SQL 命令、函数及语法详情。 +- **[快速开始](/guides/deploy/quickstart)**: 使用 Docker 快速启动，轻松加载示例数据。 +- **[Databend Cloud](/guides/cloud)**: 启动 Serverless 数仓，轻松管理组织与数据。 +- **[连接 Databend](/guides/sql-clients)**: 使用各类 SQL 客户端及编程语言连接 Databend。 +- **[SQL 参考](/sql)**: 浏览 Databend SQL 命令、函数及语法。 **数据处理** -- **[数据加载](/guides/load-data)**: 支持从多种数据源高效导入数据。 -- **[数据卸载](/guides/unload-data)**: 将数据导出为多种格式，满足下游处理需求。 -- **[半结构化数据](/sql/sql-functions/semi-structured-functions)**: 利用 VARIANT 类型，高效处理 JSON、数组及嵌套数据。 +- **[数据导入](/guides/load-data)**: 从多种数据源将数据导入 Databend。 +- **[数据导出](/guides/unload-data)**: 将数据导出为不同格式，适配下游需求。 +- **[半结构化数据](/sql/sql-functions/semi-structured-functions)**: 使用 VARIANT 类型处理 JSON、数组及嵌套数据。 -**统一分析场景** +**多模态分析** -- **[SQL 分析指南](/guides/query/sql-analytics)**: 基于统一平台，处理分析、搜索、向量及地理空间任务。 -- **[JSON 与搜索指南](/guides/query/json-search)**: 结合倒排索引与 Elasticsearch 语法，实现 VARIANT 数据的高效检索。 -- **[向量数据库指南](/guides/query/vector-db)**: 原生存储向量数据（Embeddings），直接在 SQL 中进行语义相似度计算。 -- **[地理分析指南](/guides/query/geo-analytics)**: 利用地理空间 SQL 能力，进行地图绘制与位置分析。 -- **[湖仓 ETL 指南](/guides/query/lakehouse-etl)**: 将对象存储文件流式写入托管表，消除数据孤岛。 +- **[SQL 分析](/guides/query/sql-analytics)**: 基于共享会话表，统一处理分析、搜索、向量和地理空间任务。 +- **[JSON 与搜索](/guides/query/json-search)**: 利用倒排索引和 Elasticsearch 语法高效查询 VARIANT 数据。 +- **[向量数据库](/guides/query/vector-db)**: 存储向量数据（Embeddings）并进行语义相似度计算。 +- **[地理分析](/guides/query/geo-analytics)**: 使用地理空间 SQL 进行地图绘制与实时分析。 +- **[湖仓 ETL](/guides/query/lakehouse-etl)**: 将对象存储文件流式写入托管表，消除数据孤岛。 **性能与扩展** -- **[性能优化](/guides/performance)**: 了解核心优化策略，提升查询性能。 -- **[基准测试](/guides/benchmark)**: 查看 Databend 与其他数仓的性能对比报告。 -- **[数据湖仓](/sql/sql-reference/table-engines)**: 集成 Hive, Iceberg 和 Delta Lake，构建开放的数据湖仓。 +- **[性能优化](/guides/performance)**: 利用多种策略提升查询性能。 +- **[基准测试](/guides/benchmark)**: 查看 Databend 与其他数仓的性能对比。 +- **[数据湖仓](/sql/sql-reference/table-engines)**: 无缝集成 Hive、Iceberg 和 Delta Lake。 **社区与支持** -- **[加入 Slack](https://link.databend.com/join-slack)**: 加入社区，与核心开发团队及用户交流。 -- **[文档反馈](https://github.com/databendlabs/databend-docs/issues)**: 提交文档问题或改进建议。 -- **[路线图](https://github.com/databendlabs/databend/issues/14167)**: 关注开发计划，了解未来功能规划。 -- **[联系我们](mailto:hi@databend.com)**: 如需帮助，请邮件联系我们。 +- **[加入 Slack](https://link.databend.com/join-slack)**: 与核心团队及社区成员实时交流。 +- **[文档反馈](https://github.com/databendlabs/databend-docs/issues)**: 提交问题或改进建议。 +- **[路线图](https://github.com/databendlabs/databend/issues/14167)**: 跟踪功能规划与开发进度。 +- **[联系我们](mailto:hi@databend.com)**: 获取直接帮助与支持。 \ No newline at end of file diff --git a/docs/cn/guides/10-deploy/01-deploy/01-non-production/_category_.json b/docs/cn/guides/10-deploy/01-deploy/01-non-production/_category_.json index e0dfd646ea..bb3495169e 100644 --- a/docs/cn/guides/10-deploy/01-deploy/01-non-production/_category_.json +++ b/docs/cn/guides/10-deploy/01-deploy/01-non-production/_category_.json @@ -1,3 +1,3 @@ { - "label": "非生产环境部署" + "label": "非生产环境" } \ No newline at end of file diff --git a/docs/cn/guides/10-deploy/01-deploy/02-production/_category_.json b/docs/cn/guides/10-deploy/01-deploy/02-production/_category_.json index f0d7119b61..ffc4fe7bb2 100644 --- a/docs/cn/guides/10-deploy/01-deploy/02-production/_category_.json +++ b/docs/cn/guides/10-deploy/01-deploy/02-production/_category_.json @@ -1,3 +1,3 @@ { - "label": "生产环境部署" + "label": "生产环境" } \ No newline at end of file diff --git a/docs/cn/guides/10-deploy/01-deploy/04-manually/_category_.json b/docs/cn/guides/10-deploy/01-deploy/04-manually/_category_.json index 461de4aa7e..33b77b20e3 100644 --- a/docs/cn/guides/10-deploy/01-deploy/04-manually/_category_.json +++ b/docs/cn/guides/10-deploy/01-deploy/04-manually/_category_.json @@ -1,3 +1,3 @@ { - "label": "手动部署与维护" + "label": "手动部署" } \ No newline at end of file diff --git a/docs/cn/guides/10-deploy/01-deploy/_category_.json b/docs/cn/guides/10-deploy/01-deploy/_category_.json index eb105901ac..ba355c58c4 100644 --- a/docs/cn/guides/10-deploy/01-deploy/_category_.json +++ b/docs/cn/guides/10-deploy/01-deploy/_category_.json @@ -1,3 +1,3 @@ { - "label": "部署" + "label": "部署方式" } \ No newline at end of file diff --git a/docs/cn/guides/10-deploy/02-upgrade/_category_.json b/docs/cn/guides/10-deploy/02-upgrade/_category_.json index 02011ecdef..e9a3c51be1 100644 --- a/docs/cn/guides/10-deploy/02-upgrade/_category_.json +++ b/docs/cn/guides/10-deploy/02-upgrade/_category_.json @@ -1,3 +1,3 @@ { - "label": "升级" + "label": "版本升级" } \ No newline at end of file diff --git a/docs/cn/guides/10-deploy/03-monitor/_category_.json b/docs/cn/guides/10-deploy/03-monitor/_category_.json index 59e456c9c2..1c308aa20f 100644 --- a/docs/cn/guides/10-deploy/03-monitor/_category_.json +++ b/docs/cn/guides/10-deploy/03-monitor/_category_.json @@ -1,3 +1,3 @@ { - "label": "监控" + "label": "系统监控" } \ No newline at end of file diff --git a/docs/cn/guides/10-deploy/03-monitor/tools/_category_.json b/docs/cn/guides/10-deploy/03-monitor/tools/_category_.json index 232f18b8fc..f025246231 100644 --- a/docs/cn/guides/10-deploy/03-monitor/tools/_category_.json +++ b/docs/cn/guides/10-deploy/03-monitor/tools/_category_.json @@ -1,3 +1,3 @@ { - "label": "第三方工具" + "label": "监控集成" } \ No newline at end of file diff --git a/docs/cn/guides/10-deploy/04-references/_category_.json b/docs/cn/guides/10-deploy/04-references/_category_.json index 0599e2d7e8..dc4f9d16fa 100644 --- a/docs/cn/guides/10-deploy/04-references/_category_.json +++ b/docs/cn/guides/10-deploy/04-references/_category_.json @@ -1,3 +1,3 @@ { - "label": "参考" + "label": "参考信息" } \ No newline at end of file diff --git a/docs/cn/guides/10-deploy/_category_.json b/docs/cn/guides/10-deploy/_category_.json index b3ce29a30e..2a0976c4e0 100644 --- a/docs/cn/guides/10-deploy/_category_.json +++ b/docs/cn/guides/10-deploy/_category_.json @@ -1,3 +1,3 @@ { - "label": "私有化部署 Databend" + "label": "私有化部署" } \ No newline at end of file diff --git a/docs/cn/guides/20-cloud/10-using-databend-cloud/_category_.json b/docs/cn/guides/20-cloud/10-using-databend-cloud/_category_.json index 919fcdfd7a..c42b10a20e 100644 --- a/docs/cn/guides/20-cloud/10-using-databend-cloud/_category_.json +++ b/docs/cn/guides/20-cloud/10-using-databend-cloud/_category_.json @@ -1,3 +1,3 @@ { - "label": "基础知识" + "label": "核心概念" } \ No newline at end of file diff --git a/docs/cn/guides/20-cloud/20-manage/_category_.json b/docs/cn/guides/20-cloud/20-manage/_category_.json index ee2cd24b19..0228762b17 100644 --- a/docs/cn/guides/20-cloud/20-manage/_category_.json +++ b/docs/cn/guides/20-cloud/20-manage/_category_.json @@ -1,3 +1,3 @@ { - "label": "管理 Databend Cloud" + "label": "平台管理" } \ No newline at end of file diff --git a/docs/cn/guides/20-cloud/30-advanced/02-private-link/_category_.json b/docs/cn/guides/20-cloud/30-advanced/02-private-link/_category_.json index b735edc405..14bf87e56d 100644 --- a/docs/cn/guides/20-cloud/30-advanced/02-private-link/_category_.json +++ b/docs/cn/guides/20-cloud/30-advanced/02-private-link/_category_.json @@ -1,3 +1,3 @@ { - "label": "Private Link" + "label": "私网连接" } diff --git a/docs/cn/guides/20-cloud/30-advanced/_category_.json b/docs/cn/guides/20-cloud/30-advanced/_category_.json index a6a372c05d..4e9800b8fc 100644 --- a/docs/cn/guides/20-cloud/30-advanced/_category_.json +++ b/docs/cn/guides/20-cloud/30-advanced/_category_.json @@ -1,3 +1,3 @@ { - "label": "高级用法" + "label": "进阶指南" } diff --git a/docs/cn/guides/20-cloud/_category_.json b/docs/cn/guides/20-cloud/_category_.json index 2bcb3e0380..8b5ae6b3b9 100644 --- a/docs/cn/guides/20-cloud/_category_.json +++ b/docs/cn/guides/20-cloud/_category_.json @@ -1,3 +1,3 @@ { - "label": "使用 Databend Cloud" + "label": "Databend Cloud" } \ No newline at end of file diff --git a/docs/cn/guides/30-sql-clients/01-jdbc/_category_.json b/docs/cn/guides/30-sql-clients/01-jdbc/_category_.json index 03337dd630..fc55465d9d 100644 --- a/docs/cn/guides/30-sql-clients/01-jdbc/_category_.json +++ b/docs/cn/guides/30-sql-clients/01-jdbc/_category_.json @@ -1,3 +1,3 @@ { - "label": "DBeaver" + "label": "DBeaver (JDBC)" } \ No newline at end of file diff --git a/docs/cn/guides/30-sql-clients/02-developers/_category_.json b/docs/cn/guides/30-sql-clients/02-developers/_category_.json index 9bccb2cadc..e73efe5087 100644 --- a/docs/cn/guides/30-sql-clients/02-developers/_category_.json +++ b/docs/cn/guides/30-sql-clients/02-developers/_category_.json @@ -1,3 +1,3 @@ { - "label": "开发者" + "label": "语言 SDK" } \ No newline at end of file diff --git a/docs/cn/guides/30-sql-clients/_category_.json b/docs/cn/guides/30-sql-clients/_category_.json index 0075ec0047..442d6bc42f 100644 --- a/docs/cn/guides/30-sql-clients/_category_.json +++ b/docs/cn/guides/30-sql-clients/_category_.json @@ -1,3 +1,3 @@ { - "label": "连接" + "label": "连接 Databend" } \ No newline at end of file diff --git a/docs/cn/guides/31-visualize/jupyter.md b/docs/cn/guides/31-visualize/jupyter.md index fb29adabb0..a1e9f0da59 100644 --- a/docs/cn/guides/31-visualize/jupyter.md +++ b/docs/cn/guides/31-visualize/jupyter.md @@ -1,5 +1,5 @@ --- -title: Jupyter Notebook 集成指南 +title: Jupyter Notebook sidebar_position: 6 --- diff --git a/docs/cn/guides/31-visualize/mindsdb.md b/docs/cn/guides/31-visualize/mindsdb.md index f56514b527..05d340bddb 100644 --- a/docs/cn/guides/31-visualize/mindsdb.md +++ b/docs/cn/guides/31-visualize/mindsdb.md @@ -1,5 +1,5 @@ --- -title: MindsDB 集成指南 +title: MindsDB sidebar_position: 7 --- diff --git a/docs/cn/guides/40-load-data/00-stage/_category_.json b/docs/cn/guides/40-load-data/00-stage/_category_.json index cde7d5b4b5..62ad019c49 100644 --- a/docs/cn/guides/40-load-data/00-stage/_category_.json +++ b/docs/cn/guides/40-load-data/00-stage/_category_.json @@ -1,3 +1,3 @@ { - "label": "使用 Stage" + "label": "Stage 管理" } \ No newline at end of file diff --git a/docs/cn/guides/40-load-data/01-load/_category_.json b/docs/cn/guides/40-load-data/01-load/_category_.json index fa5957c7f5..f11e6fdba7 100644 --- a/docs/cn/guides/40-load-data/01-load/_category_.json +++ b/docs/cn/guides/40-load-data/01-load/_category_.json @@ -1,3 +1,3 @@ { - "label": "文件加载" + "label": "文件导入" } \ No newline at end of file diff --git a/docs/cn/guides/40-load-data/02-load-db/_category_.json b/docs/cn/guides/40-load-data/02-load-db/_category_.json index 6c7c0ad2f1..f154f3ea25 100644 --- a/docs/cn/guides/40-load-data/02-load-db/_category_.json +++ b/docs/cn/guides/40-load-data/02-load-db/_category_.json @@ -1,3 +1,3 @@ { - "label": "通过平台加载" + "label": "第三方工具集成" } \ No newline at end of file diff --git a/docs/cn/guides/40-load-data/03-load-semistructured/_category_.json b/docs/cn/guides/40-load-data/03-load-semistructured/_category_.json index 6aa273d4a9..e80944233b 100644 --- a/docs/cn/guides/40-load-data/03-load-semistructured/_category_.json +++ b/docs/cn/guides/40-load-data/03-load-semistructured/_category_.json @@ -1,3 +1,3 @@ { - "label": "加载半结构化格式" + "label": "半结构化数据" } \ No newline at end of file diff --git a/docs/cn/guides/40-load-data/04-transform/_category_.json b/docs/cn/guides/40-load-data/04-transform/_category_.json index 98a68e58d4..210d72daad 100644 --- a/docs/cn/guides/40-load-data/04-transform/_category_.json +++ b/docs/cn/guides/40-load-data/04-transform/_category_.json @@ -1,3 +1,3 @@ { - "label": "查询与转换" + "label": "数据转换" } \ No newline at end of file diff --git a/docs/cn/guides/40-load-data/05-continuous-data-pipelines/_category_.json b/docs/cn/guides/40-load-data/05-continuous-data-pipelines/_category_.json index 80dbc8552e..f09747feae 100644 --- a/docs/cn/guides/40-load-data/05-continuous-data-pipelines/_category_.json +++ b/docs/cn/guides/40-load-data/05-continuous-data-pipelines/_category_.json @@ -1,3 +1,3 @@ { - "label": "持续数据管道" + "label": "数据管道" } \ No newline at end of file diff --git a/docs/cn/guides/40-load-data/_category_.json b/docs/cn/guides/40-load-data/_category_.json index 74ffba068d..b630adfeb2 100644 --- a/docs/cn/guides/40-load-data/_category_.json +++ b/docs/cn/guides/40-load-data/_category_.json @@ -1,3 +1,3 @@ { - "label": "数据加载" + "label": "数据导入" } \ No newline at end of file diff --git a/docs/cn/guides/50-unload-data/00-unload-parquet.md b/docs/cn/guides/50-unload-data/00-unload-parquet.md index 1069e2310a..30904ffdd4 100644 --- a/docs/cn/guides/50-unload-data/00-unload-parquet.md +++ b/docs/cn/guides/50-unload-data/00-unload-parquet.md @@ -1,8 +1,8 @@ --- -title: 卸载 Parquet 文件 +title: 导出 Parquet --- -## 卸载 Parquet 文件 +## 导出 Parquet 语法： diff --git a/docs/cn/guides/50-unload-data/01-unload-csv.md b/docs/cn/guides/50-unload-data/01-unload-csv.md index eb0d62f83c..1fff8ec252 100644 --- a/docs/cn/guides/50-unload-data/01-unload-csv.md +++ b/docs/cn/guides/50-unload-data/01-unload-csv.md @@ -1,8 +1,8 @@ --- -title: 卸载 CSV 文件 +title: 导出 CSV --- -## 卸载 CSV 文件 +## 导出 CSV 语法： diff --git a/docs/cn/guides/50-unload-data/02-unload-tsv.md b/docs/cn/guides/50-unload-data/02-unload-tsv.md index ff2d4a9e08..264eb831eb 100644 --- a/docs/cn/guides/50-unload-data/02-unload-tsv.md +++ b/docs/cn/guides/50-unload-data/02-unload-tsv.md @@ -1,8 +1,8 @@ --- -title: 卸载 TSV 文件 +title: 导出 TSV --- -## 卸载 TSV 文件 +## 导出 TSV 语法： diff --git a/docs/cn/guides/50-unload-data/03-unload-ndjson.md b/docs/cn/guides/50-unload-data/03-unload-ndjson.md index 0314be3a13..65bade0162 100644 --- a/docs/cn/guides/50-unload-data/03-unload-ndjson.md +++ b/docs/cn/guides/50-unload-data/03-unload-ndjson.md @@ -1,8 +1,8 @@ --- -title: Unloading NDJSON File +title: 导出 NDJSON --- -## Unloading TSV File +## 导出 NDJSON 语法： diff --git a/docs/cn/guides/50-unload-data/_category_.json b/docs/cn/guides/50-unload-data/_category_.json index a5939f8ab6..a5540b6302 100644 --- a/docs/cn/guides/50-unload-data/_category_.json +++ b/docs/cn/guides/50-unload-data/_category_.json @@ -1,3 +1,3 @@ { - "label": "数据卸载" + "label": "数据导出" } \ No newline at end of file diff --git a/docs/cn/guides/51-ai-functions/01-external-functions.md b/docs/cn/guides/51-ai-functions/01-external-functions.md index 628dee3099..66376a03ba 100644 --- a/docs/cn/guides/51-ai-functions/01-external-functions.md +++ b/docs/cn/guides/51-ai-functions/01-external-functions.md @@ -1,8 +1,8 @@ --- -title: 使用外部函数（External Functions）实现自定义 AI/ML +title: 集成自定义 AI 模型 --- -# 使用外部函数（External Functions）实现自定义 AI/ML +# 集成自定义 AI 模型 通过将 Databend 与您自己的基础设施连接，构建强大的 AI/ML 能力。外部函数（External Functions）允许您部署自定义模型、利用 GPU 加速，并与任何 ML 框架集成，同时确保数据安全。 diff --git a/docs/cn/guides/51-ai-functions/02-mcp.md b/docs/cn/guides/51-ai-functions/02-mcp.md index aaaec51d96..7d12135bcd 100644 --- a/docs/cn/guides/51-ai-functions/02-mcp.md +++ b/docs/cn/guides/51-ai-functions/02-mcp.md @@ -1,6 +1,10 @@ +--- +title: 集成 MCP Server +--- + import DetailsWrap from '@site/src/components/DetailsWrap'; -# 适用于 Databend 的 MCP Server +# 集成 MCP Server [mcp-databend](https://github.com/databendlabs/mcp-databend) 是一个 MCP（Model Context Protocol）服务器，使 AI 助手能够使用自然语言直接与你的 Databend 数据库交互。 @@ -235,4 +239,4 @@ cd agent-ui && npm run dev - **GitHub 仓库**: [databendlabs/mcp-databend](https://github.com/databendlabs/mcp-databend) - **PyPI 包**: [mcp-databend](https://pypi.org/project/mcp-databend) - **Agno 框架**: [Agno MCP](https://docs.agno.com/tools/mcp/mcp) -- **Agent UI**: [Agent UI](https://docs.agno.com/agent-ui/introduction) \ No newline at end of file +- **Agent UI**: [Agent UI](https://docs.agno.com/agent-ui/introduction) diff --git a/docs/cn/guides/51-ai-functions/_category_.json b/docs/cn/guides/51-ai-functions/_category_.json index 11f9346364..f4583d05cd 100644 --- a/docs/cn/guides/51-ai-functions/_category_.json +++ b/docs/cn/guides/51-ai-functions/_category_.json @@ -1,3 +1,3 @@ { - "label": "Databend AI" + "label": "AI 与 ML" } diff --git a/docs/cn/guides/54-query/_category_.json b/docs/cn/guides/54-query/_category_.json index 01519dcab8..e577927f91 100644 --- a/docs/cn/guides/54-query/_category_.json +++ b/docs/cn/guides/54-query/_category_.json @@ -1,3 +1,3 @@ { - "label": "多模态数据分析" + "label": "多模态分析" } diff --git a/docs/cn/guides/56-security/_category_.json b/docs/cn/guides/56-security/_category_.json index d94b9ee64b..60290cb055 100644 --- a/docs/cn/guides/56-security/_category_.json +++ b/docs/cn/guides/56-security/_category_.json @@ -1,3 +1,3 @@ { - "label": "安全 & 可靠性" + "label": "安全" } \ No newline at end of file diff --git a/docs/cn/guides/56-security/access-control/_category_.json b/docs/cn/guides/56-security/access-control/_category_.json index dd77e03b85..87637e73f1 100644 --- a/docs/cn/guides/56-security/access-control/_category_.json +++ b/docs/cn/guides/56-security/access-control/_category_.json @@ -1,3 +1,3 @@ { - "label": "访问控制" + "label": "权限管理" } \ No newline at end of file diff --git a/docs/cn/guides/56-security/audit-trail.md b/docs/cn/guides/56-security/audit-trail.md index f9f388694d..2b5a8ca36a 100644 --- a/docs/cn/guides/56-security/audit-trail.md +++ b/docs/cn/guides/56-security/audit-trail.md @@ -1,5 +1,5 @@ --- -title: 审计追踪（Audit Trail） +title: 审计追踪 --- import EEFeature from '@site/src/components/EEFeature'; diff --git a/docs/cn/guides/56-security/index.md b/docs/cn/guides/56-security/index.md index f90d0820b7..de0db8bd70 100644 --- a/docs/cn/guides/56-security/index.md +++ b/docs/cn/guides/56-security/index.md @@ -7,7 +7,7 @@ Databend 提供**企业级的安全与可靠性功能**，在数据的整个生 | 安全功能 | 用途 | 使用场景 | |-----------------|---------|------------| | [**访问控制（Access Control）**](/guides/security/access-control) | 管理用户权限 | 当您需要通过基于角色的安全性和对象所有权来控制数据访问时 | -| [**审计追踪（Audit Trail）**](audit-trail.md) | 追踪数据库活动 | 当您需要全面的审计追踪来进行安全监控、合规性检查和性能分析时 | +| [**审计追踪**](audit-trail.md) | 追踪数据库活动 | 当您需要全面的审计追踪来进行安全监控、合规性检查和性能分析时 | | [**网络策略（Network Policy）**](/guides/security/network-policy) | 限制网络访问 | 当您希望即便拥有有效凭据，也只允许来自特定 IP 范围的连接时 | | [**密码策略（Password Policy）**](/guides/security/password-policy) | 设置密码要求 | 当您需要强制执行密码复杂度、轮换和账户锁定规则时 | | [**脱敏策略（Masking Policy）**](/guides/security/masking-policy) | 隐藏敏感数据 | 当您需要在保护机密数据的同时，仍然允许授权访问时 | diff --git a/docs/cn/guides/56-security/masking-policy.md b/docs/cn/guides/56-security/masking-policy.md index 3dc583a597..e7669600c0 100644 --- a/docs/cn/guides/56-security/masking-policy.md +++ b/docs/cn/guides/56-security/masking-policy.md @@ -1,12 +1,12 @@ --- -title: 动态脱敏策略（Masking Policy） +title: 动态脱敏 --- import IndexOverviewList from '@site/src/components/IndexOverviewList'; import EEFeature from '@site/src/components/EEFeature'; -动态脱敏策略（Masking Policy）在查询时对列值进行转换，帮助你按照角色控制谁能看到真实数据、谁只能看到脱敏后的结果。 +动态脱敏策略在查询时对列值进行转换，帮助你按照角色控制谁能看到真实数据、谁只能看到脱敏后的结果。 ## 脱敏策略如何工作 diff --git a/docs/cn/guides/81-how-databend-works/_category_.json b/docs/cn/guides/81-how-databend-works/_category_.json index ecc0332eaa..fb6c68d550 100644 --- a/docs/cn/guides/81-how-databend-works/_category_.json +++ b/docs/cn/guides/81-how-databend-works/_category_.json @@ -1,3 +1,3 @@ { - "label": "Databend 工作原理" + "label": "原理解析" } \ No newline at end of file From 4e81279aa53b632701507e04cb01f1a99ddbc0c4 Mon Sep 17 00:00:00 2001 From: BohuTANG Date: Sun, 23 Nov 2025 13:41:10 +0800 Subject: [PATCH 02/12] docs: further refine Chinese titles and content consistency --- .../guides/40-load-data/01-load/00-stage.md | 40 ++++++++----------- docs/cn/guides/40-load-data/01-load/01-s3.md | 12 +++--- .../guides/40-load-data/01-load/02-local.md | 8 ++-- .../cn/guides/40-load-data/01-load/03-http.md | 12 +++--- docs/cn/guides/40-load-data/01-load/index.md | 12 +++--- .../50-unload-data/00-unload-parquet.md | 6 +-- .../cn/guides/50-unload-data/01-unload-csv.md | 12 +++--- .../cn/guides/50-unload-data/02-unload-tsv.md | 10 ++--- .../guides/50-unload-data/03-unload-ndjson.md | 18 ++++----- docs/cn/guides/56-security/audit-trail.md | 6 +-- 10 files changed, 64 insertions(+), 72 deletions(-) diff --git a/docs/cn/guides/40-load-data/01-load/00-stage.md b/docs/cn/guides/40-load-data/01-load/00-stage.md index 5184a70d29..8ca13bea60 100644 --- a/docs/cn/guides/40-load-data/01-load/00-stage.md +++ b/docs/cn/guides/40-load-data/01-load/00-stage.md @@ -1,13 +1,13 @@ --- -title: 从 Stage 加载数据 +title: 从 Stage 导入数据 sidebar_label: Stage --- -Databend 允许您轻松导入从用户 Stage 或内部/外部 Stage 上传的文件数据。为此，您可以先使用 [BendSQL](../../30-sql-clients/00-bendsql/index.md) 将文件上传至 Stage，然后使用 [COPY INTO](/sql/sql-commands/dml/dml-copy-into-table) 命令从暂存文件加载数据。请注意，文件格式必须是 Databend 支持的格式，否则无法导入数据。有关 Databend 支持的文件格式的更多信息，请参阅 [输入输出文件格式](/sql/sql-reference/file-format-options)。 +Databend 允许您轻松导入从用户 Stage 或内部/外部 Stage 上传的文件数据。为此，您可以先使用 [BendSQL](../../30-sql-clients/00-bendsql/index.md) 将文件上传至 Stage，然后使用 [COPY INTO](/sql/sql-commands/dml/dml-copy-into-table) 命令从暂存文件导入数据。请注意，文件格式必须是 Databend 支持的格式，否则无法导入数据。有关 Databend 支持的文件格式的更多信息，请参阅 [输入输出文件格式](/sql/sql-reference/file-format-options)。 ![image](/img/load/load-data-from-stage.jpeg) -以下教程提供了详细的分步指南，帮助您高效完成从 Stage 文件加载数据的过程。 +以下教程提供了详细的分步指南，帮助您高效完成导入数据的过程。 ## 开始之前 @@ -32,9 +32,9 @@ CREATE TABLE books ); ``` -## 教程 1：从用户 Stage 加载 +## 教程 1：从用户 Stage 导入 -本教程将指导您将示例文件上传至用户 Stage，并从暂存文件加载数据到 Datab###### 步骤 1：上传示例文件 +本教程将指导您将示例文件上传至用户 Stage，并从暂存文件导入数据到 Databend。 1. 使用 [BendSQL](../../30-sql-clients/00-bendsql/index.md) 上传示例文件： @@ -59,15 +59,7 @@ name |size|md5 |last_modified books.parquet| 998|"88432bf90aadb79073682988b39d461c"|2023-06-27 16:03:51.000 +0000| | ``` -### 步骤 2：将数据复制到表 - -1. 使用 [COPY INTO](/sql/sql-commands/dml/dml-copy-into-table) 命令将数据加载到目标表： - -```sql -COPY INTO books FROM @~ files=('books.parquet') FILE_FORMAT = (TYPE = PARQUET); -``` - -2. 验证加载的数据： +验证导入的数据 ```sql SELECT * FROM books; @@ -79,9 +71,9 @@ Transaction Processing |Jim Gray |1992| Readings in Database Systems|Michael Stonebraker|2004| ``` -## 教程 2：从内部 Stage 加载 +## 教程 2：从内部 Stage 导入 -本教程将指导您将示例文件上传至内部 Stage，并从暂存文件加载数据到 Databend。 +本教程将指导您将示例文件上传至从暂存文件导入数据到 Databend。 ### 步骤 1：创建内部 Stage @@ -127,9 +119,9 @@ name |size |md5 |la books.parquet | 998|"88432bf90aadb79073682988b39d461c"|2023-06-28 02:32:15.000 +0000| | ``` -### 步骤 3：将数据复制到表 +### 步骤 3：将数据导入到表 -1. 使用 [COPY INTO](/sql/sql-commands/dml/dml-copy-into-table) 命令将数据加载到目标表： +1. 使用 [COPY INTO](/sql/sql-commands/dml/dml-copy-into-table) 命令将数据导入到目标表： ```sql COPY INTO books @@ -139,7 +131,7 @@ FILE_FORMAT = ( TYPE = 'PARQUET' ); ``` -2. 验证加载的数据： +2. 验证导入的数据： ```sql SELECT * FROM books; @@ -151,9 +143,9 @@ Transaction Processing |Jim Gray |1992| Readings in Database Systems|Michael Stonebraker|2004| ``` -## 教程 3：从外部 Stage 加载 +## 教程 3：从外部 Stage 导入 -本教程将指导您将示例文件上传至外部 Stage，并从暂存文件加载数据到 Databend。 +本教程将指导您将示例文件上传至外部 Stage，并从暂存文件导入数据到 Databend。 ### 步骤 1：创建外部 Stage @@ -204,9 +196,9 @@ name |size|md5 |last_modified books.parquet| 998|"88432bf90aadb79073682988b39d461c"|2023-06-28 04:13:15.178 +0000| | ``` -### 步骤 3：将数据复制到表 +### 步骤 3：将数据导入到表 -1. 使用 [COPY INTO](/sql/sql-commands/dml/dml-copy-into-table) 命令将数据加载到目标表： +1. 使用 [COPY INTO](/sql/sql-commands/dml/dml-copy-into-table) 命令将数据导入到目标表： ```sql COPY INTO books @@ -216,7 +208,7 @@ FILE_FORMAT = ( TYPE = 'PARQUET' ); ``` -2. 验证加载的数据： +2. 验证导入的数据： ```sql SELECT * FROM books; diff --git a/docs/cn/guides/40-load-data/01-load/01-s3.md b/docs/cn/guides/40-load-data/01-load/01-s3.md index 2d4fa8895f..cf9d0e8523 100644 --- a/docs/cn/guides/40-load-data/01-load/01-s3.md +++ b/docs/cn/guides/40-load-data/01-load/01-s3.md @@ -1,5 +1,5 @@ --- -title: 从存储桶加载数据 +title: 从存储桶导入数据 sidebar_label: 存储桶 --- @@ -7,9 +7,9 @@ sidebar_label: 存储桶 ![image](/img/load/load-data-from-s3.jpeg) -本教程以 Amazon S3 存储桶为例，提供详细的分步指南，帮助您高效完成从存储桶中的文件加载数据的过程。 +本教程以 Amazon S3 存储桶为例，提供详细的分步指南，帮助您高效完成从存储桶中的文件导入数据的过程。 -## 教程：从 Amazon S3 存储桶加载数据 +## 教程：从 Amazon S3 存储桶导入数据 ### 准备工作 @@ -45,9 +45,9 @@ CREATE TABLE books ); ``` -### 步骤 2. 将数据复制到表中 +### 步骤 2. 将数据导入到表中 -1. 使用 [COPY INTO](/sql/sql-commands/dml/dml-copy-into-table) 命令将数据加载到目标表： +1. 使用 [COPY INTO](/sql/sql-commands/dml/dml-copy-into-table) 命令将数据导入到目标表： ```sql COPY INTO books @@ -62,7 +62,7 @@ FILE_FORMAT = ( ); ``` -2. 检查已加载的数据： +2. 检查已导入的数据： ```sql SELECT * FROM books; diff --git a/docs/cn/guides/40-load-data/01-load/02-local.md b/docs/cn/guides/40-load-data/01-load/02-local.md index ad83d478c2..b40b137a53 100644 --- a/docs/cn/guides/40-load-data/01-load/02-local.md +++ b/docs/cn/guides/40-load-data/01-load/02-local.md @@ -1,5 +1,5 @@ --- -title: 从本地文件加载数据 +title: 从本地文件导入数据 sidebar_label: 本地文件 --- @@ -7,7 +7,7 @@ sidebar_label: 本地文件 请注意，文件必须是 Databend 支持的格式，否则无法导入数据。有关 Databend 支持的文件格式的更多信息，请参阅 [输入输出文件格式](/sql/sql-reference/file-format-options)。 -## 教程 1 - 从本地文件加载 +## 教程 1 - 从本地文件导入 本教程以 CSV 文件为例，演示如何使用 [BendSQL](../../30-sql-clients/00-bendsql/index.md) 从本地源将数据导入 Databend。 @@ -69,9 +69,9 @@ root@localhost:8000/book_db> SELECT * FROM books; └───────────────────────────────────────────────────────────────────────┘ ``` -## 教程 2 - 加载到指定列 +## 教程 2 - 导入到指定列 -在 [教程 1](#tutorial-1---load-from-a-csv-file) 中，您创建了一个包含三列的表，这些列与示例文件中的数据完全匹配。您也可以将数据加载到表的指定列中，这样只要指定列能匹配，表就不需要具有与要加载数据相同的列。本教程展示如何实现这一点。 +在 [教程 1](#tutorial-1---load-from-a-csv-file) 中，您创建了一个包含三列的表，这些列与示例文件中的数据完全匹配。您也可以将数据加载到表的指定列中，这样只要指定列能匹配，表就不需要具有与要导入数据相同的列。本教程展示如何实现这一点。 ### 准备工作 diff --git a/docs/cn/guides/40-load-data/01-load/03-http.md b/docs/cn/guides/40-load-data/01-load/03-http.md index c79b49f5d7..e185a77f0d 100644 --- a/docs/cn/guides/40-load-data/01-load/03-http.md +++ b/docs/cn/guides/40-load-data/01-load/03-http.md @@ -1,17 +1,17 @@ --- -title: 从远程文件加载数据 +从远程文件导入数据 sidebar_label: 远程文件 --- 要将远程文件数据加载到 Databend 中，可以使用 [COPY INTO](/sql/sql-commands/dml/dml-copy-into-table) 命令。该命令支持从多种数据源（包括远程文件）轻松地将数据复制到 Databend。通过 COPY INTO 命令，您可以指定源文件位置、文件格式等相关参数来定制导入过程。请注意，文件必须是 Databend 支持的格式，否则无法导入数据。有关 Databend 支持的文件格式的更多信息，请参阅 [输入输出文件格式](/sql/sql-reference/file-format-options)。 -## 使用通配模式加载数据 +## 使用通配模式导入数据 Databend 通过通配模式简化了从远程文件加载数据的过程。这些模式可以高效灵活地从符合特定命名规则的多个文件中导入数据。Databend 支持以下通配模式： ### 集合模式 -通配表达式中的集合模式可以匹配集合中的任意一个字符。例如，对于名为 `data_file_a.csv`、`data_file_b.csv` 和 `data_file_c.csv` 的文件，可以使用集合模式加载这三个文件的数据： +通配表达式中的集合模式可以匹配集合中的任意一个字符。例如，对于名为 `data_file_a.csv`、`data_file_b.csv` 和 `data_file_c.csv` 的文件，可以使用集合模式导入这三个文件的数据： ```sql COPY INTO your_table @@ -20,7 +20,7 @@ FROM 'https://your-remote-location/data_file_{a,b,c}.csv' ... ### 范围模式 -当处理诸如 `data_file_001.csv`、`data_file_002.csv` 和 `data_file_003.csv` 等按序号命名的文件时，范围模式非常有用。使用范围模式加载这一系列文件数据的示例如下： +当处理诸如 `data_file_001.csv`、`data_file_002.csv` 和 `data_file_003.csv` 等按序号命名的文件时，范围模式非常有用。使用范围模式导入这一系列文件数据的示例如下： ```sql COPY INTO your_table @@ -47,7 +47,7 @@ CREATE TABLE books ); ``` -### 步骤 2. 加载数据到表 +### 步骤 2. 导入数据到表 ```sql COPY INTO books @@ -60,7 +60,7 @@ FILE_FORMAT = ( ); ``` -### 步骤 3. 验证加载的数据 +### 步骤 3. 验证导入的数据 ```sql SELECT * FROM books; diff --git a/docs/cn/guides/40-load-data/01-load/index.md b/docs/cn/guides/40-load-data/01-load/index.md index 64492238ed..dc981b04a2 100644 --- a/docs/cn/guides/40-load-data/01-load/index.md +++ b/docs/cn/guides/40-load-data/01-load/index.md @@ -1,8 +1,8 @@ --- -title: 从文件加载数据 +title: 文件导入 --- -Databend 提供了简单而强大的命令，可将数据文件加载到表中。大多数操作只需一条命令即可完成。您的数据必须采用[支持的格式](/sql/sql-reference/file-format-options)。 +Databend 提供了简单而强大的命令，可将数据文件导入到表中。大多数操作只需一条命令即可完成。您的数据必须采用[支持的格式](/sql/sql-reference/file-format-options)。 ![数据加载与卸载概览](/img/load/load-unload.jpeg) @@ -22,7 +22,7 @@ Databend 提供了简单而强大的命令，可将数据文件加载到表中 | 数据源 | 推荐工具 | 描述 | 文档 | |-------------|-----------------|-------------|---------------| -| **暂存数据文件** | **COPY INTO** | 从内部/外部 stage 或用户 stage 快速高效加载 | [从 Stage 加载](stage) | -| **云存储** | **COPY INTO** | 从 Amazon S3、Google 云存储、Microsoft Azure 加载 | [从存储桶加载](s3) | -| **本地文件** | [**BendSQL**](https://github.com/databendlabs/BendSQL) | Databend 原生 CLI 工具，用于本地文件加载 | [从本地文件加载](local) | -| **远程文件** | **COPY INTO** | 从远程 HTTP/HTTPS 位置加载数据 | [从远程文件加载](http) | \ No newline at end of file +| **暂存数据文件** | **COPY INTO** | 从内部/外部 stage 或用户 stage 快速高效导入 | [从 Stage 加载](stage) | +| **云存储** | **COPY INTO** | 从 Amazon S3、Google 云存储、Microsoft Azure 导入 | [从存储桶加载](s3) | +| **本地文件** | [**BendSQL**](https://github.com/databendlabs/BendSQL) | Databend 原生 CLI 工具，用于本地文件导入 | [从本地文件加载](local) | +| **远程文件** | **COPY INTO** | 从远程 HTTP/HTTPS 位置导入数据 | [从远程文件加载](http) | \ No newline at end of file diff --git a/docs/cn/guides/50-unload-data/00-unload-parquet.md b/docs/cn/guides/50-unload-data/00-unload-parquet.md index 30904ffdd4..1930b6ee0e 100644 --- a/docs/cn/guides/50-unload-data/00-unload-parquet.md +++ b/docs/cn/guides/50-unload-data/00-unload-parquet.md @@ -15,7 +15,7 @@ FILE_FORMAT = (TYPE = PARQUET) ``` - 更多 Parquet 选项请参考 [Parquet File Format Options](/sql/sql-reference/file-format-options#parquet-options) -- 卸载到多个文件请使用 [MAX_FILE_SIZE Copy Option](/sql/sql-commands/dml/dml-copy-into-location#copyoptions) +- 导出到多个文件请使用 [MAX_FILE_SIZE Copy Option](/sql/sql-commands/dml/dml-copy-into-location#copyoptions) - 更多关于语法的细节可以在 [COPY INTO location](/sql/sql-commands/dml/dml-copy-into-location) 中找到 ## 教程 @@ -39,7 +39,7 @@ CREATE FILE FORMAT parquet_unload_format ; ``` -### Step 3. 卸载到 Parquet 文件 +### Step 3. 导出到 Parquet 文件 ```sql COPY INTO @parquet_unload_stage @@ -62,7 +62,7 @@ DETAILED_OUTPUT = true; └───────────────────────────────────────────────────────────────────────────────────────────┘ ``` -### Step 4. 验证卸载的 Parquet 文件 +### Step 4. 验证导出的 Parquet 文件 ```sql SELECT COUNT($1) diff --git a/docs/cn/guides/50-unload-data/01-unload-csv.md b/docs/cn/guides/50-unload-data/01-unload-csv.md index 1fff8ec252..6570ce0d76 100644 --- a/docs/cn/guides/50-unload-data/01-unload-csv.md +++ b/docs/cn/guides/50-unload-data/01-unload-csv.md @@ -14,14 +14,14 @@ FILE_FORMAT = ( RECORD_DELIMITER = '', FIELD_DELIMITER = '', COMPRESSION = gzip, - OUTPUT_HEADER = true -- 卸载时带表头 + OUTPUT_HEADER = true -- 导出时带表头 ) [MAX_FILE_SIZE = ] [DETAILED_OUTPUT = true | false] ``` - 更多 CSV 选项请参考 [CSV 文件格式选项](/sql/sql-reference/file-format-options#csv-options) -- 卸载到多个文件请使用 [MAX_FILE_SIZE Copy 选项](/sql/sql-commands/dml/dml-copy-into-location#copyoptions) +- 导出到多个文件请使用 [MAX_FILE_SIZE Copy 选项](/sql/sql-commands/dml/dml-copy-into-location#copyoptions) - 更多关于语法的细节可以在 [COPY INTO location](/sql/sql-commands/dml/dml-copy-into-location) 中找到 ## 教程 @@ -44,12 +44,12 @@ CREATE FILE FORMAT csv_unload_format TYPE = CSV, RECORD_DELIMITER = '\n', FIELD_DELIMITER = ',', - COMPRESSION = gzip, -- 卸载时使用 gzip 压缩 - OUTPUT_HEADER = true, -- 卸载时带表头 + COMPRESSION = gzip, -- 导出时使用 gzip 压缩 + OUTPUT_HEADER = true, -- 导出时带表头 SKIP_HEADER = 1; -- 仅用于加载，如果 CSV 文件有表头，查询时跳过第一行 ``` -### Step 3. 卸载到 CSV 文件 +### Step 3. 导出到 CSV 文件 ```sql COPY INTO @csv_unload_stage @@ -71,7 +71,7 @@ DETAILED_OUTPUT = true; └──────────────────────────────────────────────────────────────────────────────────────────┘ ``` -### Step 4. 验证卸载的 CSV 文件 +### Step 4. 验证导出的 CSV 文件 ```sql SELECT COUNT($1) diff --git a/docs/cn/guides/50-unload-data/02-unload-tsv.md b/docs/cn/guides/50-unload-data/02-unload-tsv.md index 264eb831eb..bd203edb66 100644 --- a/docs/cn/guides/50-unload-data/02-unload-tsv.md +++ b/docs/cn/guides/50-unload-data/02-unload-tsv.md @@ -14,17 +14,17 @@ FILE_FORMAT = ( RECORD_DELIMITER = '', FIELD_DELIMITER = '', COMPRESSION = gzip, - OUTPUT_HEADER = true -- Unload with header + OUTPUT_HEADER = true -- 导出时带表头 ) [MAX_FILE_SIZE = ] [DETAILED_OUTPUT = true | false] ``` - 更多 TSV 选项请参考 [TSV File Format Options](/sql/sql-reference/file-format-options#tsv-options) -- 卸载到多个文件请使用 [MAX_FILE_SIZE Copy Option](/sql/sql-commands/dml/dml-copy-into-location#copyoptions) +- 导出到请使用 [MAX_FILE_SIZE Copy Option](/sql/sql-commands/dml/dml-copy-into-location#copyoptions) - 更多关于语法的细节可以在 [COPY INTO location](/sql/sql-commands/dml/dml-copy-into-location) 中找到。 -## Tutorial +## 教程 ### Step 1. 创建一个 External Stage @@ -42,7 +42,7 @@ CONNECTION = ( ```sql CREATE FILE FORMAT tsv_unload_format TYPE = TSV, - COMPRESSION = gzip; -- Unload with gzip compression + COMPRESSION = gzip; -- 导出时使用 gzip 压缩 ``` ### Step 3. 卸载到 TSV 文件 @@ -67,7 +67,7 @@ DETAILED_OUTPUT = true; └──────────────────────────────────────────────────────────────────────────────────────────┘ ``` -### Step 4. 验证卸载的 TSV 文件 +### Step 4. 验证导出的 TSV 文件 ``` SELECT COUNT($1) diff --git a/docs/cn/guides/50-unload-data/03-unload-ndjson.md b/docs/cn/guides/50-unload-data/03-unload-ndjson.md index 65bade0162..4c6b7d22cd 100644 --- a/docs/cn/guides/50-unload-data/03-unload-ndjson.md +++ b/docs/cn/guides/50-unload-data/03-unload-ndjson.md @@ -19,12 +19,12 @@ FILE_FORMAT = ( ``` - 更多 NDJSON 选项请参考 [NDJSON File Format Options](/sql/sql-reference/file-format-options#ndjson-options) -- 卸载到多个文件请使用 [MAX_FILE_SIZE Copy Option](/sql/sql-commands/dml/dml-copy-into-location#copyoptions) +- 导出到多个文件请使用 [MAX_FILE_SIZE Copy Option](/sql/sql-commands/dml/dml-copy-into-location#copyoptions) - 更多关于该语法的细节可以在 [COPY INTO location](/sql/sql-commands/dml/dml-copy-into-location) 中找到。 -## Tutorial +## 教程 -### Step 1. Create an External Stage +### Step 1. 创建一个 External Stage ```sql CREATE STAGE ndjson_unload_stage @@ -35,15 +35,15 @@ CONNECTION = ( ); ``` -### Step 2. Create Custom NDJSON File Format +### Step 2. 创建自定义 NDJSON 文件格式 ``` CREATE FILE FORMAT ndjson_unload_format TYPE = NDJSON, - COMPRESSION = gzip; -- Unload with gzip compression + COMPRESSION = gzip; -- 导出时使用 gzip 压缩 ``` -### Step 3. Unload into NDJSON File +### Step 3. 导出为 NDJSON 文件 ```sql COPY INTO @ndjson_unload_stage @@ -55,7 +55,7 @@ FILE_FORMAT = (FORMAT_NAME = 'ndjson_unload_format') DETAILED_OUTPUT = true; ``` -Result: +结果： ```text ┌─────────────────────────────────────────────────────────────────────────────────────────────┐ @@ -65,7 +65,7 @@ Result: └─────────────────────────────────────────────────────────────────────────────────────────────┘ ``` -### Step 4. Verify the Unloaded NDJSON Files +### Step 4. 验证导出的 NDJSON 文件 ```sql SELECT COUNT($1) @@ -76,7 +76,7 @@ FROM @ndjson_unload_stage ); ``` -Result: +结果： ```text ┌───────────┐ diff --git a/docs/cn/guides/56-security/audit-trail.md b/docs/cn/guides/56-security/audit-trail.md index 2b5a8ca36a..1413b40ce9 100644 --- a/docs/cn/guides/56-security/audit-trail.md +++ b/docs/cn/guides/56-security/audit-trail.md @@ -6,7 +6,7 @@ import EEFeature from '@site/src/components/EEFeature'; -Databend 的系统历史表 (System History Tables) 会自动捕获数据库活动的详细记录，为合规性 (Compliance) 和安全监控 (Security Monitoring) 提供完整的审计追踪 (Audit Trail)。 +Databend 的系统历史表会自动捕获数据库活动的详细记录，为合规性和安全监控提供完整的审计追踪。 支持对用户以下活动进行审计： - **查询执行** - 完整的 SQL 执行审计追踪 (`query_history`) @@ -20,7 +20,7 @@ Databend 提供了五个系统历史表，用于捕获数据库活动的不同 | 表 | 用途 | 关键用例 | |-------|---------|---------------| | [query_history](/sql/sql-reference/system-history-tables/query-history) | 完整的 SQL 执行审计追踪 | 性能监控、安全审计、合规报告 | -| [access_history](/sql/sql-reference/system-history-tables/access-history) | 数据库对象访问和修改 | 数据血缘 (Data Lineage) 追踪、合规审计、变更管理 (Change Management) | +| [access_history](/sql/sql-reference/system-history-tables/access-history) | 数据库对象访问和修改 | 数据血缘追踪、合规审计、变更管理 | | [login_history](/sql/sql-reference/system-history-tables/login-history) | 身份验证尝试和会话 | 安全监控、失败登录检测、访问模式分析 | ## 审计用例与示例 @@ -49,7 +49,7 @@ error_message: UnknownUser. Code: 2201, Text = User 'root1'@'%' does not exist. ### 合规报告 -**跟踪数据库模式 (Schema) 变更** +**跟踪数据库模式变更** 监控 DDL 操作，以满足合规性和变更管理要求。 From d074d96b14401b0e77fec035c916b0cad7e88b59 Mon Sep 17 00:00:00 2001 From: BohuTANG Date: Sun, 23 Nov 2025 13:45:54 +0800 Subject: [PATCH 03/12] docs: optimize Chinese SQL reference titles --- .../10-sql-commands/00-ddl/07-virtual-column/_category_.json | 2 +- .../10-sql-commands/00-ddl/12-mask-policy/_category_.json | 2 +- docs/cn/sql-reference/10-sql-commands/00-ddl/_category_.json | 2 +- docs/cn/sql-reference/10-sql-commands/10-dml/_category_.json | 2 +- .../10-sql-commands/40-explain-cmds/_category_.json | 2 +- .../20-sql-functions/10-search-functions/_category_.json | 2 +- .../10-semi-structured-functions/_category_.json | 2 +- .../sql-reference/30-stored-procedure-scripting/_category_.json | 2 +- docs/cn/sql-reference/30-stored-procedure-scripting/index.md | 2 +- 9 files changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/07-virtual-column/_category_.json b/docs/cn/sql-reference/10-sql-commands/00-ddl/07-virtual-column/_category_.json index 2b7cb9584d..f983e879ca 100644 --- a/docs/cn/sql-reference/10-sql-commands/00-ddl/07-virtual-column/_category_.json +++ b/docs/cn/sql-reference/10-sql-commands/00-ddl/07-virtual-column/_category_.json @@ -1,4 +1,4 @@ { - "label": "Virtual Column", + "label": "虚拟列", "position": 12 } \ No newline at end of file diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/12-mask-policy/_category_.json b/docs/cn/sql-reference/10-sql-commands/00-ddl/12-mask-policy/_category_.json index 59d52ee41f..7b301e0645 100644 --- a/docs/cn/sql-reference/10-sql-commands/00-ddl/12-mask-policy/_category_.json +++ b/docs/cn/sql-reference/10-sql-commands/00-ddl/12-mask-policy/_category_.json @@ -1,4 +1,4 @@ { - "label": "Masking Policy", + "label": "动态脱敏策略", "position": 14 } \ No newline at end of file diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/_category_.json b/docs/cn/sql-reference/10-sql-commands/00-ddl/_category_.json index 949683f3ef..51db49674f 100644 --- a/docs/cn/sql-reference/10-sql-commands/00-ddl/_category_.json +++ b/docs/cn/sql-reference/10-sql-commands/00-ddl/_category_.json @@ -1,3 +1,3 @@ { - "label": "DDL 命令" + "label": "DDL", } \ No newline at end of file diff --git a/docs/cn/sql-reference/10-sql-commands/10-dml/_category_.json b/docs/cn/sql-reference/10-sql-commands/10-dml/_category_.json index e766f21407..51fe5bc5e8 100644 --- a/docs/cn/sql-reference/10-sql-commands/10-dml/_category_.json +++ b/docs/cn/sql-reference/10-sql-commands/10-dml/_category_.json @@ -1,3 +1,3 @@ { - "label": "DML 命令" + "label": "DML", } \ No newline at end of file diff --git a/docs/cn/sql-reference/10-sql-commands/40-explain-cmds/_category_.json b/docs/cn/sql-reference/10-sql-commands/40-explain-cmds/_category_.json index ce03b6ad54..f532afb003 100644 --- a/docs/cn/sql-reference/10-sql-commands/40-explain-cmds/_category_.json +++ b/docs/cn/sql-reference/10-sql-commands/40-explain-cmds/_category_.json @@ -1,3 +1,3 @@ { - "label": "Explain 命令" + "label": "Explain" } \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/10-search-functions/_category_.json b/docs/cn/sql-reference/20-sql-functions/10-search-functions/_category_.json index bc031b90f2..ba68955c5a 100644 --- a/docs/cn/sql-reference/20-sql-functions/10-search-functions/_category_.json +++ b/docs/cn/sql-reference/20-sql-functions/10-search-functions/_category_.json @@ -1,3 +1,3 @@ { - "label": "全文搜索函数" + "label": "全文检索函数" } \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/10-semi-structured-functions/_category_.json b/docs/cn/sql-reference/20-sql-functions/10-semi-structured-functions/_category_.json index e06feccbc0..0f9b568d7f 100644 --- a/docs/cn/sql-reference/20-sql-functions/10-semi-structured-functions/_category_.json +++ b/docs/cn/sql-reference/20-sql-functions/10-semi-structured-functions/_category_.json @@ -1,4 +1,4 @@ { - "label": "结构化与半结构化", + "label": "半结构化函数", "position": 9 } \ No newline at end of file diff --git a/docs/cn/sql-reference/30-stored-procedure-scripting/_category_.json b/docs/cn/sql-reference/30-stored-procedure-scripting/_category_.json index 9623e9f285..1e6344ef03 100644 --- a/docs/cn/sql-reference/30-stored-procedure-scripting/_category_.json +++ b/docs/cn/sql-reference/30-stored-procedure-scripting/_category_.json @@ -1,4 +1,4 @@ { - "label": "存储过程与脚本（Stored Procedure & Scripting）", + "label": "存储过程与脚本", "position": 30 } \ No newline at end of file diff --git a/docs/cn/sql-reference/30-stored-procedure-scripting/index.md b/docs/cn/sql-reference/30-stored-procedure-scripting/index.md index 05cb2712a8..22dfc1e04e 100644 --- a/docs/cn/sql-reference/30-stored-procedure-scripting/index.md +++ b/docs/cn/sql-reference/30-stored-procedure-scripting/index.md @@ -1,5 +1,5 @@ --- -title: 存储过程（Stored Procedure）与 SQL 脚本 +title: 存储过程与 SQL 脚本 slug: /stored-procedure-scripting/ --- From 9983e2558a0b3f5b656ad4ef3469480944a42b11 Mon Sep 17 00:00:00 2001 From: BohuTANG Date: Sun, 23 Nov 2025 14:07:41 +0800 Subject: [PATCH 04/12] docs: refine Chinese SQL reference content and titles --- .../50-file-format-options.md | 54 +++++++++---------- .../00-sql-reference/99-ansi-sql.md | 4 +- .../sql-reference/00-sql-reference/index.md | 10 ++-- .../cn/sql-reference/10-sql-commands/index.md | 4 +- .../sql-reference/20-sql-functions/index.md | 6 +-- .../30-stored-procedure-scripting/index.md | 28 +++++----- 6 files changed, 53 insertions(+), 53 deletions(-) diff --git a/docs/cn/sql-reference/00-sql-reference/50-file-format-options.md b/docs/cn/sql-reference/00-sql-reference/50-file-format-options.md index 1a2e29c210..2f2681c05a 100644 --- a/docs/cn/sql-reference/00-sql-reference/50-file-format-options.md +++ b/docs/cn/sql-reference/00-sql-reference/50-file-format-options.md @@ -1,15 +1,15 @@ --- -title: 输入 & 输出文件格式 +title: 文件格式选项 --- import FunctionDescription from '@site/src/components/FunctionDescription'; -Databend 接受多种文件格式作为数据加载或卸载的源和目标。本页介绍了支持的文件格式及其可用选项。 +Databend 支持多种文件格式用于数据导入与导出。本页介绍支持的文件格式及其相关选项。 ## 语法 -要在语句中指定文件格式，请使用以下语法： +在语句中指定文件格式的语法如下： ```sql -- 指定标准文件格式 @@ -19,7 +19,7 @@ Databend 接受多种文件格式作为数据加载或卸载的源和目标。 ... FILE_FORMAT = ( FORMAT_NAME = '' ) ``` -- Databend 目前仅支持 ORC 和 AVRO 作为数据源。尚不支持将数据卸载到 ORC 或 AVRO 文件中。 +- Databend 目前仅支持 ORC 和 AVRO 作为数据源。尚不支持将数据导出到 ORC 或 AVRO 文件中。 - 如果在执行 COPY INTO 或 SELECT 操作时未指定 FILE_FORMAT，Databend 将使用您在最初创建 Stage 时为该 Stage 定义的文件格式。如果您在创建 Stage 期间未显式指定文件格式，Databend 默认使用 PARQUET 格式。如果您指定的 FILE_FORMAT 与创建 Stage 时定义的 FILE_FORMAT 不同，Databend 将优先使用操作期间指定的 FILE_FORMAT。 - 有关在 Databend 中管理自定义文件格式的信息，请参阅 [文件格式](../10-sql-commands/00-ddl/13-file-format/index.md)。 @@ -41,7 +41,7 @@ formatTypeOptions ::= ## CSV 选项 -Databend 接受符合 [RFC 4180](https://www.rfc-editor.org/rfc/rfc4180) 的 CVS 文件，并受以下条件约束： +Databend 支持符合 [RFC 4180](https://www.rfc-editor.org/rfc/rfc4180) 标准的 CSV 文件，并遵循以下规则： - 如果字符串包含 [QUOTE](#quote)、[ESCAPE](#escape)、[RECORD_DELIMITER](#record_delimiter) 或 [FIELD_DELIMITER](#field_delimiter) 的字符，则必须引用该字符串。 - 除了 [QUOTE](#quote) 之外，在带引号的字符串中不会转义任何字符。 @@ -72,9 +72,9 @@ Databend 接受符合 [RFC 4180](https://www.rfc-editor.org/rfc/rfc4180) 的 CVS **默认值**: `,` (逗号) -### QUOTE (仅加载) +### QUOTE (仅导入) -引用 CSV 文件中的字符串。对于数据加载，除非字符串包含 [QUOTE](#quote)、[ESCAPE](#escape)、[RECORD_DELIMITER](#record_delimiter) 或 [FIELD_DELIMITER](#field_delimiter) 的字符，否则不需要引号。 +引用 CSV 文件中的字符串。对于数据导入，除非字符串包含 [QUOTE](#quote)、[ESCAPE](#escape)、[RECORD_DELIMITER](#record_delimiter) 或 [FIELD_DELIMITER](#field_delimiter) 的字符，否则不需要引号。 **可用值**: `'`、`"` 或 `(反引号) @@ -88,13 +88,13 @@ Databend 接受符合 [RFC 4180](https://www.rfc-editor.org/rfc/rfc4180) 的 CVS **默认值**: `''` -### SKIP_HEADER (仅加载) +### SKIP_HEADER (仅导入) 指定从文件开头跳过的行数。 **默认值**: `0` -### NAN_DISPLAY (仅加载) +### NAN_DISPLAY (仅导入) 指定如何在查询结果中显示 "NaN"（非数字）值。 @@ -102,21 +102,21 @@ Databend 接受符合 [RFC 4180](https://www.rfc-editor.org/rfc/rfc4180) 的 CVS **默认值**: `'NaN'` -### NULL_DISPLAY (仅加载) +### NULL_DISPLAY (仅导入) 指定如何在查询结果中显示 NULL 值。 **默认值**: `'\N'` -### ERROR_ON_COLUMN_COUNT_MISMATCH (仅加载) +### ERROR_ON_COLUMN_COUNT_MISMATCH (仅导入) ERROR_ON_COLUMN_COUNT_MISMATCH 是一个布尔选项，当设置为 true 时，指定如果数据文件中的列数与目标表中的列数不匹配，则应引发错误。将其设置为 true 有助于确保加载过程中的数据完整性和一致性。 **默认值**: `true` -### EMPTY_FIELD_AS (仅加载) +### EMPTY_FIELD_AS (仅导入) -指定在 CSV 数据加载到表中时，遇到空字段（包括 `,,` 和 `,"",`）时应使用的值。 +指定在 CSV 数据导入到表中时，遇到空字段（包括 `,,` 和 `,"",`）时应使用的值。 | 可用值 | 描述 | |------------------|-----------------------------------------------------------------------------------| @@ -124,7 +124,7 @@ ERROR_ON_COLUMN_COUNT_MISMATCH 是一个布尔选项，当设置为 true 时， | `string` | 将空字段解释为空字符串 ('')。仅适用于 String 列。 | | `field_default` | 对空字段使用列的默认值。 | -### OUTPUT_HEADER (仅卸载) +### OUTPUT_HEADER (仅导出) 指定在使用 `COPY INTO ` 命令导出数据时，是否在 CSV 文件中包含标题行。默认为 `false`。 @@ -142,7 +142,7 @@ ERROR_ON_COLUMN_COUNT_MISMATCH 是一个布尔选项，当设置为 true 时， | `AUTO` | 通过文件扩展名自动检测压缩 | | `GZIP` | | | `BZ2` | | -| `BROTLI` | 如果加载/卸载 Brotli 压缩文件，则必须指定。 | +| `BROTLI` | 如果导入/导出 Brotli 压缩文件，则必须指定。 | | `ZSTD` | 支持 Zstandard v0.8（及更高版本）。 | | `DEFLATE` | Deflate 压缩文件（带有 zlib 标头，RFC1950）。 | | `RAW_DEFLATE` | Deflate 压缩文件（没有任何标头，RFC1951）。 | @@ -150,7 +150,7 @@ ERROR_ON_COLUMN_COUNT_MISMATCH 是一个布尔选项，当设置为 true 时， ## TSV 选项 -Databend 在处理 TSV 文件时受以下条件约束： +Databend 处理 TSV 文件时遵循以下规则： - TSV 文件中的这些字符将被转义：`\b`、`\f`、`\r`、`\n`、`\t`、`\0`、`\\`、`\'`、[RECORD_DELIMITER](#record_delimiter-1)、[FIELD_DELIMITER](#field_delimiter-1)。 - 目前不支持引用或封闭。 @@ -195,18 +195,18 @@ Databend 在处理 TSV 文件时受以下条件约束： ## NDJSON 选项 -### NULL_FIELD_AS (仅加载) +### NULL_FIELD_AS (仅导入) -指定在数据加载期间如何处理 null 值。有关可能的配置，请参阅下表中的选项。 +指定在数据导入期间如何处理 null 值。有关可能的配置，请参阅下表中的选项。 | 可用值 | 描述 | |-----------------------|---------------------------------------------------------------------------------------------------| | `NULL` (默认) | 将 null 值解释为可为空字段的 NULL。将为不可为空字段生成错误。 | | `FIELD_DEFAULT` | 对 null 值使用字段的默认值。 | -### MISSING_FIELD_AS (仅加载) +### MISSING_FIELD_AS (仅导入) -确定在数据加载期间遇到缺失字段时的行为。有关可能的配置，请参阅下表中的选项。 +确定在数据导入期间遇到缺失字段时的行为。有关可能的配置，请参阅下表中的选项。 | 可用值 | 描述 | |-----------------|-------------------------------------------------------------------------------------------| @@ -220,16 +220,16 @@ Databend 在处理 TSV 文件时受以下条件约束： ## PARQUET 选项 -### MISSING_FIELD_AS (仅加载) +### MISSING_FIELD_AS (仅导入) -确定在数据加载期间遇到缺失字段时的行为。有关可能的配置，请参阅下表中的选项。 +确定在数据导入期间遇到缺失字段时的行为。有关可能的配置，请参阅下表中的选项。 | 可用值 | 描述 | |-----------------|-------------------------------------------------------------------------------------------| | `ERROR` (默认) | 如果遇到缺失字段，则生成错误。 | | `FIELD_DEFAULT` | 对缺失字段使用字段的默认值。 | -### COMPRESSION (仅卸载) +### COMPRESSION ### OUTPUT_HEADER (仅导出) 指定压缩算法，该算法用于压缩文件的内部块，而不是整个文件，因此输出仍为 Parquet 格式。 @@ -240,9 +240,9 @@ Databend 在处理 TSV 文件时受以下条件约束： ## ORC 选项 -### MISSING_FIELD_AS (仅加载) +### MISSING_FIELD_AS (仅导入) -确定在数据加载期间遇到缺失字段时的行为。有关可能的配置，请参阅下表中的选项。 +确定在数据导入期间遇到缺失字段时的行为。有关可能的配置，请参阅下表中的选项。 | 可选值 | 描述 | |------------------|----------------------------------------------------------------------------------------------------| @@ -251,9 +251,9 @@ Databend 在处理 TSV 文件时受以下条件约束： ## AVRO 选项 -### MISSING_FIELD_AS (仅加载) +### MISSING_FIELD_AS (仅导入) -确定在数据加载期间遇到缺失字段时的行为。请参考下表中的选项以获取可能的配置。 +确定在数据导入期间遇到缺失字段时的行为。请参考下表中的选项以获取可能的配置。 | 可选值 | 描述 | |------------------|----------------------------------------------------------------------------------------------------| diff --git a/docs/cn/sql-reference/00-sql-reference/99-ansi-sql.md b/docs/cn/sql-reference/00-sql-reference/99-ansi-sql.md index bc7cac180e..964f3ec719 100644 --- a/docs/cn/sql-reference/00-sql-reference/99-ansi-sql.md +++ b/docs/cn/sql-reference/00-sql-reference/99-ansi-sql.md @@ -1,8 +1,8 @@ --- -title: SQL 方言 & 兼容性 +title: SQL 方言与兼容性 --- -本页详细介绍了 Databend 支持的 SQL 方言，以及其与 SQL 标准的兼容性，特别是关注 SQL:2011 的特性以及 Databend 对这些特性的支持状态。 +本页详细介绍了 Databend 支持的 SQL 方言及其与 SQL 标准（特别是 SQL:2011）的兼容性。 ## 支持的 SQL 方言 diff --git a/docs/cn/sql-reference/00-sql-reference/index.md b/docs/cn/sql-reference/00-sql-reference/index.md index a544ab45b4..be002e293b 100644 --- a/docs/cn/sql-reference/00-sql-reference/index.md +++ b/docs/cn/sql-reference/00-sql-reference/index.md @@ -3,12 +3,12 @@ title: SQL 参考 slug: '/' --- -欢迎使用 SQL 参考 – 您快速查阅 Databend 核心要点的指南！ +欢迎使用 SQL 参考指南！ -- **通用参考：** 提供对基础元素的深入解析，如数据类型（Data Types）、系统表（System Tables）和表引擎（Table Engines），帮助您扎实掌握 Databend 的结构体系。 +- **通用参考：** 深入解析数据类型、系统表和表引擎等基础元素，助您掌握 Databend 的核心结构。 -- **SQL 命令：** 提供详细的命令信息、语法说明及实用示例，助您在 Databend 中自信地进行数据管理。 +- **SQL 命令：** 提供详细的命令信息、语法说明及实用示例，助您自信地进行数据管理。 -- **SQL 函数：** Databend 函数的简明指南，深入解析其多样化功能，助力高效的数据管理与分析。 +- **SQL 函数：** 涵盖各类 Databend 函数，深入解析其功能，助力高效的数据管理与分析。 -- **存储过程与脚本：** 涵盖 SQL 脚本语言，包括变量、控制流、结果处理及存储过程中的动态执行。 \ No newline at end of file +- **存储过程与脚本：** 介绍 SQL 脚本语言，包括变量、控制流、结果处理及存储过程中的动态执行。 \ No newline at end of file diff --git a/docs/cn/sql-reference/10-sql-commands/index.md b/docs/cn/sql-reference/10-sql-commands/index.md index 5b53fbe4f0..427b2beb2b 100644 --- a/docs/cn/sql-reference/10-sql-commands/index.md +++ b/docs/cn/sql-reference/10-sql-commands/index.md @@ -8,8 +8,8 @@ title: SQL 命令参考 | 类别 | 描述 | |----------|-------------| -| **[DDL 命令](00-ddl/index.md)** | 数据定义语言（Data Definition Language）——创建、修改和删除数据库对象 | -| **[DML 命令](10-dml/index.md)** | 数据操作语言（Data Manipulation Language）——插入、更新、删除和复制数据 | +| **[DDL 命令](00-ddl/index.md)** | 数据定义语言——创建、修改和删除数据库对象 | +| **[DML 命令](10-dml/index.md)** | 数据操作语言——插入、更新、删除和复制数据 | | **[查询语法](20-query-syntax/index.md)** | SELECT 语句组件——FROM、WHERE、GROUP BY、JOIN 等 | | **[查询运算符](30-query-operators/index.md)** | 算术、比较、逻辑及其他运算符 | | **[EXPLAIN 命令](40-explain-cmds/index.md)** | 查询分析与优化工具 | diff --git a/docs/cn/sql-reference/20-sql-functions/index.md b/docs/cn/sql-reference/20-sql-functions/index.md index 4e32955ba4..1625bd1162 100644 --- a/docs/cn/sql-reference/20-sql-functions/index.md +++ b/docs/cn/sql-reference/20-sql-functions/index.md @@ -21,17 +21,17 @@ Databend 为各类数据处理提供了全面的 SQL 函数。函数按重要性 | [聚合函数](./07-aggregate-functions/index.md) | 跨多行的统计计算 | | [窗口函数](./08-window-functions/index.md) | 基于窗口操作的高级分析 | -## 结构化和半结构化数据 +## 半结构化数据 | 类别 | 描述 | |----------|-------------| -| [结构化和半结构化函数](./10-semi-structured-functions/index.md) | JSON、数组、对象及嵌套数据处理 | +| [半结构化函数](./10-semi-structured-functions/index.md) | JSON、数组、对象及嵌套数据处理 | ## 搜索函数 | 类别 | 描述 | |----------|-------------| -| [全文搜索函数](./10-search-functions/index.md) | 全文搜索与相关性评分 | +| [全文检索函数](./10-search-functions/index.md) | 全文搜索与相关性评分 | ## 向量函数 diff --git a/docs/cn/sql-reference/30-stored-procedure-scripting/index.md b/docs/cn/sql-reference/30-stored-procedure-scripting/index.md index 22dfc1e04e..373ccab556 100644 --- a/docs/cn/sql-reference/30-stored-procedure-scripting/index.md +++ b/docs/cn/sql-reference/30-stored-procedure-scripting/index.md @@ -7,7 +7,7 @@ import FunctionDescription from '@site/src/components/FunctionDescription'; -Databend 中的存储过程（Stored Procedure）允许您将 SQL 逻辑打包在服务器上运行，并支持控制流（Control Flow）、变量（Variable）、游标（Cursor）和动态语句（Dynamic Statement）。本页面介绍如何创建存储过程以及编写驱动它们的内联脚本。 +Databend 中的存储过程允许您将 SQL 逻辑打包在服务器上运行，并支持控制流、变量、游标和动态语句。本页介绍如何创建存储过程以及编写驱动它们的内联脚本。 ## 定义存储过程 @@ -29,7 +29,7 @@ $$; | 组件 | 描述 | |-----------|-------------| | `` | 存储过程的标识符。模式限定是可选的。 | -| ` ` | 使用 Databend 标量类型定义的输入参数（Parameter）。参数按值传递。 | +| ` ` | 使用 Databend 标量类型定义的输入参数。参数按值传递。 | | `RETURNS [NOT NULL]` | 声明逻辑返回类型。`NOT NULL` 强制返回非空响应。 | | `LANGUAGE SQL` | Databend 目前仅接受 `SQL`。 | | `RETURN` / `RETURN TABLE` | 结束执行并提供标量或表格结果。 | @@ -56,7 +56,7 @@ CALL PROCEDURE convert_kg_to_lb(10); ### 声明部分 -存储过程可以以可选的 `DECLARE` 块开始，在可执行部分之前初始化变量（Variable）。每个条目遵循与 `LET` 相同的语法：`name [] [:= | DEFAULT ]`。如果省略初始化器，变量必须在读取之前被赋值；过早引用会触发错误 3129。 +存储过程可以以可选的 `DECLARE` 块开始，在可执行部分之前初始化变量。每个条目遵循与 `LET` 相同的语法：`name [] [:= | DEFAULT ]`。如果省略初始化器，变量必须在读取之前被赋值；过早引用会触发错误 3129。 ```sql CREATE OR REPLACE PROCEDURE sp_with_declare() @@ -78,7 +78,7 @@ CALL PROCEDURE sp_with_declare(); ### 变量与赋值 -使用 `LET` 声明变量（Variable）或常量（Constant）。可以选择添加类型标注，并使用 `:=` 或 `DEFAULT` 关键字指定初始值。如果省略初始化器，变量必须在读取之前被赋值；提前引用会触发错误 3129。通过省略 `LET` 进行重新赋值。 +使用 `LET` 声明变量或常量。可以选择添加类型标注，并使用 `:=` 或 `DEFAULT` 关键字指定初始值。如果省略初始化器，变量必须在读取之前被赋值；提前引用会触发错误 3129。通过省略 `LET` 进行重新赋值。 ```sql CREATE OR REPLACE PROCEDURE sp_demo_variables() @@ -106,7 +106,7 @@ CALL PROCEDURE sp_demo_variables(); ### 变量作用域 -变量（Variable）的作用域限定在封闭块内。内部块可以遮蔽外部绑定，当块退出时恢复外部值。 +变量的作用域限定在封闭块内。内部块可以遮蔽外部绑定，当块退出时恢复外部值。 ```sql CREATE OR REPLACE PROCEDURE sp_demo_scope() @@ -157,7 +157,7 @@ CALL PROCEDURE sp_demo_comments(); ### Lambda 表达式 -Lambda 表达式定义可以传递给数组函数或在查询（Query）中调用的内联逻辑。它们遵循 ` -> ` 形式（当提供多个参数时，将参数包装在括号中）。表达式可以包括类型转换、条件逻辑，甚至引用存储过程变量。 +Lambda 表达式定义可以传递给数组函数或在查询中调用的内联逻辑。它们遵循 ` -> ` 形式（当提供多个参数时，将参数包装在括号中）。表达式可以包括类型转换、条件逻辑，甚至引用存储过程变量。 - 在 SQL 语句中运行 Lambda 时，使用 `:variable_name` 引用存储过程变量。 - `ARRAY_TRANSFORM` 和 `ARRAY_FILTER` 等函数会为输入数组中的每个元素评估 Lambda。 @@ -177,7 +177,7 @@ $$; CALL PROCEDURE sp_demo_lambda_array(); ``` -Lambda 也可以出现在存储过程执行的查询（Query）中。 +Lambda 也可以出现在存储过程执行的查询中。 ```sql CREATE OR REPLACE PROCEDURE sp_demo_lambda_query() @@ -326,7 +326,7 @@ CALL PROCEDURE sp_reverse_count(1, 5); #### `FOR ... IN` 查询 -直接迭代查询（Query）的结果。循环变量将列公开为字段。 +直接迭代查询的结果。循环变量将列公开为字段。 ```sql CREATE OR REPLACE PROCEDURE sp_sum_query(limit_rows INT) @@ -345,7 +345,7 @@ $$; CALL PROCEDURE sp_sum_query(5); ``` -`FOR` 也可以迭代先前声明的结果集变量或游标（Cursor）（参见[处理查询结果](#处理查询结果)）。 +`FOR` 也可以迭代先前声明的结果集变量或游标（参见[处理查询结果](#处理查询结果)）。 ### `WHILE` @@ -450,7 +450,7 @@ CALL PROCEDURE sp_break_example(5); ### 结果集变量 -使用 `RESULTSET` 将查询（Query）结果具体化以供后续迭代。 +使用 `RESULTSET` 将查询结果具体化以供后续迭代。 ```sql CREATE OR REPLACE PROCEDURE sp_total_active_salary() @@ -475,7 +475,7 @@ CALL PROCEDURE sp_total_active_salary(); ### 游标 -当需要按需获取行时声明游标（Cursor）。 +当需要按需获取行时声明游标。 ```sql CREATE OR REPLACE PROCEDURE sp_fetch_two() @@ -501,7 +501,7 @@ $$; CALL PROCEDURE sp_fetch_two(); ``` -或者，从 `RESULTSET` 派生游标（Cursor）。 +或者，从 `RESULTSET` 派生游标。 ```sql CREATE OR REPLACE PROCEDURE sp_first_number() @@ -526,7 +526,7 @@ CALL PROCEDURE sp_first_number(); ### 迭代行 -结果集变量和游标（Cursor）可以使用 `FOR ... IN` 循环遍历。 +结果集变量和游标可以使用 `FOR ... IN` 循环遍历。 ```sql CREATE OR REPLACE PROCEDURE sp_low_stock_count() @@ -622,7 +622,7 @@ CALL PROCEDURE sp_dynamic_resultset(); ## 注意事项和限制 -- 存储过程（Stored Procedure）在单个事务（Transaction）中执行；任何错误都会回滚存储过程内执行的工作。 +- 存储过程在单个事务中执行；任何错误都会回滚存储过程内执行的工作。 - 返回值在客户端显示为字符串，即使声明了数字类型。 - 没有 `TRY ... CATCH` 结构；显式验证输入并预测错误条件。 - 在将标识符连接到动态 SQL 文本之前验证它们，以避免执行意外语句。 From aa5a1698a27d003673a78f35bd158ce33456b553 Mon Sep 17 00:00:00 2001 From: BohuTANG Date: Sun, 23 Nov 2025 14:15:07 +0800 Subject: [PATCH 05/12] docs: unify Chinese SQL reference titles and categories --- .../00-sql-reference/30-table-engines/_category_.json | 2 +- .../10-sql-commands/00-ddl/02-user/_category_.json | 2 +- .../10-sql-commands/00-ddl/04-sequence/_category_.json | 2 +- .../10-sql-commands/00-ddl/04-stream/_category_.json | 2 +- .../10-sql-commands/00-ddl/19-warehouse/_category_.json | 3 +++ .../10-sql-commands/00-ddl/20-workload-group/_category_.json | 3 +++ .../20-sql-functions/01-bitmap-functions/_category_.json | 2 +- 7 files changed, 11 insertions(+), 5 deletions(-) create mode 100644 docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/_category_.json create mode 100644 docs/cn/sql-reference/10-sql-commands/00-ddl/20-workload-group/_category_.json diff --git a/docs/cn/sql-reference/00-sql-reference/30-table-engines/_category_.json b/docs/cn/sql-reference/00-sql-reference/30-table-engines/_category_.json index 310aa6c26e..acac46f52c 100644 --- a/docs/cn/sql-reference/00-sql-reference/30-table-engines/_category_.json +++ b/docs/cn/sql-reference/00-sql-reference/30-table-engines/_category_.json @@ -1,4 +1,4 @@ { - "label": "表", + "label": "表引擎", "key": "table-engines" } diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/02-user/_category_.json b/docs/cn/sql-reference/10-sql-commands/00-ddl/02-user/_category_.json index 9b4cd544a3..77b07948e0 100644 --- a/docs/cn/sql-reference/10-sql-commands/00-ddl/02-user/_category_.json +++ b/docs/cn/sql-reference/10-sql-commands/00-ddl/02-user/_category_.json @@ -1,4 +1,4 @@ { - "label": "用户 & 角色", + "label": "用户与角色", "position": 5 } \ No newline at end of file diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/04-sequence/_category_.json b/docs/cn/sql-reference/10-sql-commands/00-ddl/04-sequence/_category_.json index 3a85f36386..532aeada37 100644 --- a/docs/cn/sql-reference/10-sql-commands/00-ddl/04-sequence/_category_.json +++ b/docs/cn/sql-reference/10-sql-commands/00-ddl/04-sequence/_category_.json @@ -1,4 +1,4 @@ { - "label": "Sequence", + "label": "序列", "position": 7 } \ No newline at end of file diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/04-stream/_category_.json b/docs/cn/sql-reference/10-sql-commands/00-ddl/04-stream/_category_.json index 06c55f7a37..13e8e534e8 100644 --- a/docs/cn/sql-reference/10-sql-commands/00-ddl/04-stream/_category_.json +++ b/docs/cn/sql-reference/10-sql-commands/00-ddl/04-stream/_category_.json @@ -1,4 +1,4 @@ { - "label": "Stream", + "label": "流", "position": 7 } \ No newline at end of file diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/_category_.json b/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/_category_.json new file mode 100644 index 0000000000..fbc88e4dfd --- /dev/null +++ b/docs/cn/sql-reference/10-sql-commands/00-ddl/19-warehouse/_category_.json @@ -0,0 +1,3 @@ +{ + "label": "计算集群" +} \ No newline at end of file diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/20-workload-group/_category_.json b/docs/cn/sql-reference/10-sql-commands/00-ddl/20-workload-group/_category_.json new file mode 100644 index 0000000000..399c6ef345 --- /dev/null +++ b/docs/cn/sql-reference/10-sql-commands/00-ddl/20-workload-group/_category_.json @@ -0,0 +1,3 @@ +{ + "label": "工作负载组" +} \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/01-bitmap-functions/_category_.json b/docs/cn/sql-reference/20-sql-functions/01-bitmap-functions/_category_.json index 07d85ef83c..73478ed6f4 100644 --- a/docs/cn/sql-reference/20-sql-functions/01-bitmap-functions/_category_.json +++ b/docs/cn/sql-reference/20-sql-functions/01-bitmap-functions/_category_.json @@ -1,3 +1,3 @@ { - "label": "Bitmap 函数" + "label": "位图函数" } \ No newline at end of file From 3b7a92ccf2538514928e20d7f191eeb865196e30 Mon Sep 17 00:00:00 2001 From: BohuTANG Date: Sun, 23 Nov 2025 14:18:17 +0800 Subject: [PATCH 06/12] docs: unify mixed language titles in Chinese SQL reference --- .../20-information-schema-tables/_category_.json | 2 +- .../10-sql-commands/00-ddl/03-stage/_category_.json | 2 +- .../10-sql-commands/00-ddl/07-ngram-index/_category_.json | 2 +- .../sql-reference/10-sql-commands/00-ddl/10-udf/_category_.json | 2 +- .../10-sql-commands/40-explain-cmds/_category_.json | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/cn/sql-reference/00-sql-reference/20-information-schema-tables/_category_.json b/docs/cn/sql-reference/00-sql-reference/20-information-schema-tables/_category_.json index 544b3c6539..d6a061dc53 100644 --- a/docs/cn/sql-reference/00-sql-reference/20-information-schema-tables/_category_.json +++ b/docs/cn/sql-reference/00-sql-reference/20-information-schema-tables/_category_.json @@ -1,3 +1,3 @@ { - "label": "Information Schema" + "label": "信息模式" } diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/03-stage/_category_.json b/docs/cn/sql-reference/10-sql-commands/00-ddl/03-stage/_category_.json index 3bf9a7314c..52a0e8ab74 100644 --- a/docs/cn/sql-reference/10-sql-commands/00-ddl/03-stage/_category_.json +++ b/docs/cn/sql-reference/10-sql-commands/00-ddl/03-stage/_category_.json @@ -1,4 +1,4 @@ { - "label": "Stage", + "label": "Stage 暂存区", "position": 6 } \ No newline at end of file diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/07-ngram-index/_category_.json b/docs/cn/sql-reference/10-sql-commands/00-ddl/07-ngram-index/_category_.json index 3e2f57a4f7..dd5b74512a 100644 --- a/docs/cn/sql-reference/10-sql-commands/00-ddl/07-ngram-index/_category_.json +++ b/docs/cn/sql-reference/10-sql-commands/00-ddl/07-ngram-index/_category_.json @@ -1,4 +1,4 @@ { - "label": "Ngram 索引", + "label": "N-gram 索引", "position": 11 } \ No newline at end of file diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/10-udf/_category_.json b/docs/cn/sql-reference/10-sql-commands/00-ddl/10-udf/_category_.json index 146768818b..439163e7e0 100644 --- a/docs/cn/sql-reference/10-sql-commands/00-ddl/10-udf/_category_.json +++ b/docs/cn/sql-reference/10-sql-commands/00-ddl/10-udf/_category_.json @@ -1,4 +1,4 @@ { - "label": "用户自定义函数", + "label": "UDF", "position": 12 } \ No newline at end of file diff --git a/docs/cn/sql-reference/10-sql-commands/40-explain-cmds/_category_.json b/docs/cn/sql-reference/10-sql-commands/40-explain-cmds/_category_.json index f532afb003..051b66f045 100644 --- a/docs/cn/sql-reference/10-sql-commands/40-explain-cmds/_category_.json +++ b/docs/cn/sql-reference/10-sql-commands/40-explain-cmds/_category_.json @@ -1,3 +1,3 @@ { - "label": "Explain" + "label": "Explain 分析" } \ No newline at end of file From 543df740d1da5ef43dee345bb271b9b49c81562b Mon Sep 17 00:00:00 2001 From: BohuTANG Date: Sun, 23 Nov 2025 14:20:26 +0800 Subject: [PATCH 07/12] docs: remove dictionary commands and functions --- .../00-ddl/17-dictionary/_category_.json | 3 - .../00-ddl/17-dictionary/create-dictionary.md | 114 ------------------ .../00-ddl/17-dictionary/drop-dictionary.md | 22 ---- .../00-ddl/17-dictionary/index.md | 23 ---- .../17-dictionary/show-create-dictionary.md | 32 ----- .../00-ddl/17-dictionary/show-dictionaries.md | 52 -------- .../19-dictionary-functions/_category_.json | 3 - .../19-dictionary-functions/dict-get.md | 29 ----- .../19-dictionary-functions/index.md | 18 --- .../sql-reference/20-sql-functions/index.md | 2 +- 10 files changed, 1 insertion(+), 297 deletions(-) delete mode 100644 docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/_category_.json delete mode 100644 docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/create-dictionary.md delete mode 100644 docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/drop-dictionary.md delete mode 100644 docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/index.md delete mode 100644 docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/show-create-dictionary.md delete mode 100644 docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/show-dictionaries.md delete mode 100644 docs/cn/sql-reference/20-sql-functions/19-dictionary-functions/_category_.json delete mode 100644 docs/cn/sql-reference/20-sql-functions/19-dictionary-functions/dict-get.md delete mode 100644 docs/cn/sql-reference/20-sql-functions/19-dictionary-functions/index.md diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/_category_.json b/docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/_category_.json deleted file mode 100644 index 8cbcf7ea08..0000000000 --- a/docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/_category_.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "label": "字典" -} \ No newline at end of file diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/create-dictionary.md b/docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/create-dictionary.md deleted file mode 100644 index edc2ea7494..0000000000 --- a/docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/create-dictionary.md +++ /dev/null @@ -1,114 +0,0 @@ ---- -title: CREATE DICTIONARY ---- -import FunctionDescription from '@site/src/components/FunctionDescription'; - - - -创建一个字典，支持从外部源实时访问数据。字典允许 Databend 直接从 MySQL 和 Redis 等外部系统查询数据，而无需传统的 ETL 流程，从而确保数据一致性并提高查询性能。 - -## 语法 - -```sql -CREATE [ OR REPLACE ] DICTIONARY [ IF NOT EXISTS ] -( - [ DEFAULT ], - [ DEFAULT ], - ... -) -PRIMARY KEY -SOURCE(()) -``` - -创建字典时，Databend 会建立与指定外部数据源的连接。然后可以使用 `dict_get()` 函数查询字典，以在查询时直接从源检索数据。 - -| 参数 | 描述 | -|------------------------|--------------------------------------------------------------------------------------------------------------------------------------------| -| `` | 字典的名称，在查询中被引用。 | -| `` | 字典中列的名称。这些列定义了可以从外部源检索的数据的结构。 | -| `` | 每列的数据类型。对于 MySQL 源，Databend 支持 boolean、string 和 numeric 类型（包括 int、bigint、float32、float64）。对于 Redis 源，仅支持 string 类型。 | -| `` | 当在外部源中找不到值时，列的可选默认值。这确保了即使缺少数据，查询也能返回有意义的结果。 | -| `` | 查询字典时用作查找键的列。这应对应于外部数据源中的唯一标识符。 | -| `` | 外部数据源的类型。当前支持：`MYSQL` 或 `REDIS`。未来版本将支持其他源。 | -| `` | 特定于所选源类型的连接和配置参数。 | - -### MySQL 参数 - -下表列出了配置 MySQL 数据源所需的和可选的参数： - -| 参数 | 是否必需？ | 描述 | -|-----------|-----------|----------------------------------------------------------------------------------| -| host | 是 | MySQL 服务器的 IP 地址或主机名。 | -| port | 是 | MySQL 服务器正在侦听的端口。 | -| username | 是 | 用于连接到 MySQL 服务器的用户名。 | -| password | 是 | 与用户名关联的用于访问 MySQL 服务器的密码。 | -| db | 是 | 要从中提取数据的 MySQL 服务器上的数据库的名称。 | -| table | 是 | 数据库中数据所在的表的名称。 | - -### Redis 参数 - -下表列出了配置 Redis 数据源所需的和可选的参数： - -| 参数 | 是否必需？ | 描述 | -|-----------|-----------|---------------------------------------------------------------------------------------------------------------------------------------------| -| host | 是 | Redis 服务器的主机名或 IP 地址。 | -| port | 是 | Redis 服务器的端口号。 | -| username | 否 | 如果 Redis 服务器需要用户身份验证，则为用户名。 | -| password | 否 | 用于用户身份验证的密码。 | -| db_index | 否 | 指定 Redis 数据库索引，默认为 0。索引范围为 0 到 15，因为 Redis 支持 16 个从 0 到 15 索引的数据库。 | - -## 示例 - -### MySQL 字典示例 - -以下示例使用来自 MySQL 数据库的数据创建一个名为 `courses_dict` 的字典： - -```sql -CREATE DICTIONARY courses_dict -( - course_id INT, - course_name STRING -) -PRIMARY KEY course_id -SOURCE(MYSQL( - host='localhost' - port='3306' - username='root' - password='123456' - db='test' - table='courses' -)); -``` - -### Redis 字典示例 - -以下示例使用来自 Redis 数据源的数据创建一个名为 `student_name_dict` 的字典： - -```sql -CREATE DICTIONARY student_name_dict -( - student_id STRING, - student_name STRING -) -PRIMARY KEY student_id -SOURCE(REDIS( - host='127.0.0.1' - port='6379' -)); -``` - -## 与 dict_get() 一起使用 - -创建字典后，可以使用 `dict_get()` 函数查询它： - -```sql --- 使用字典查询学生信息 -SELECT - student_id, - dict_get(student_name_dict, 'student_name', to_string(student_id)) as student_name, - course_id, - dict_get(courses_dict, 'course_name', course_id) as course_name -FROM student_scores; -``` - -这种方法支持跨多个源的实时数据集成，而无需复杂的 ETL 流程。 \ No newline at end of file diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/drop-dictionary.md b/docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/drop-dictionary.md deleted file mode 100644 index 34c51a31fe..0000000000 --- a/docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/drop-dictionary.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: DROP DICTIONARY ---- -import FunctionDescription from '@site/src/components/FunctionDescription'; - - - -删除指定的 dictionary。 - -## 语法 - -```sql -DROP DICTIONARY [ IF EXISTS ] -``` - -## 示例 - -以下示例删除 `courses_dict` dictionary： - -```sql -DROP DICTIONARY courses_dict; -``` \ No newline at end of file diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/index.md b/docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/index.md deleted file mode 100644 index 448caf22f9..0000000000 --- a/docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/index.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: 字典（Dictionary） ---- - -本页面提供了 Databend 中字典操作的全面概述，按功能组织以便于参考。 - -## 字典管理 - -| 命令 | 描述 | -|---------|-------------| -| [CREATE DICTIONARY](create-dictionary.md) | 创建新的字典以访问外部数据源 | -| [DROP DICTIONARY](drop-dictionary.md) | 删除字典 | - -## 字典信息 - -| 命令 | 描述 | -|---------|-------------| -| [SHOW DICTIONARIES](show-dictionaries.md) | 列出当前数据库中的所有字典 | -| [SHOW CREATE DICTIONARY](show-create-dictionary.md) | 显示现有字典的 CREATE 语句 | - -:::note -Databend 中的字典允许您直接实时查询外部数据源（如 MySQL、Redis）的数据，无需 ETL 过程。这有助于解决数据一致性问题，提高查询（Query）性能，并简化数据管理。您可以使用 `dict_get` 函数查询外部数据。 -::: \ No newline at end of file diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/show-create-dictionary.md b/docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/show-create-dictionary.md deleted file mode 100644 index 0d13a4a5f1..0000000000 --- a/docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/show-create-dictionary.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: SHOW CREATE DICTIONARY ---- -import FunctionDescription from '@site/src/components/FunctionDescription'; - - - -检索并显示用于创建指定 dictionary 的 SQL 语句。 - -## 语法 - -```sql -SHOW CREATE DICTIONARY -``` - -## 示例 - -以下示例检索用于创建 `courses_dict` dictionary 的 SQL 语句： - -```sql -SHOW CREATE DICTIONARY courses_dict; - --[ RECORD 1 ]----------------------------------- - Dictionary: courses_dict -Create Dictionary: CREATE DICTIONARY courses_dict -( - course_id INT NULL, - course_name VARCHAR NULL -) -PRIMARY KEY course_id -SOURCE(mysql(db='test' host='localhost' password='[HIDDEN]' port='3306' table='courses' username='root')) -``` \ No newline at end of file diff --git a/docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/show-dictionaries.md b/docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/show-dictionaries.md deleted file mode 100644 index f8f4017eba..0000000000 --- a/docs/cn/sql-reference/10-sql-commands/00-ddl/17-dictionary/show-dictionaries.md +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: SHOW DICTIONARIES ---- -import FunctionDescription from '@site/src/components/FunctionDescription'; - - - -列出指定数据库中的 dictionaries，显示它们的名称、列详细信息和源信息。 - -## 语法 - -```sql -SHOW DICTIONARIES [FROM ｜ IN ] [LIKE ''] [WHERE ] -``` - -## 示例 - -此示例列出当前数据库中的所有 dictionaries： - -```sql -SHOW DICTIONARIES; - -┌────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ -│ database │ dictionary │ key_names │ key_types │ attribute_names │ attribute_types │ source │ comment │ -├──────────┼────────────┼───────────────┼───────────────┼─────────────────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────────────────────────────────┼─────────┤ -│ default │ order_dict │ ['order_id'] │ ['INT NULL'] │ ['customer_name','order_total'] │ ['VARCHAR NULL','INT NULL'] │ mysql(db=dict host=mysql password=[hidden] port=3306 table=orders username=root) │ │ -└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ -``` - -此示例使用 LIKE 子句来筛选名称以 'order' 开头的 dictionaries： - -```sql -SHOW DICTIONARIES LIKE 'order%'; - -┌────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ -│ database │ dictionary │ key_names │ key_types │ attribute_names │ attribute_types │ source │ comment │ -├──────────┼────────────┼───────────────┼───────────────┼─────────────────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────────────────────────────────┼─────────┤ -│ default │ order_dict │ ['order_id'] │ ['INT NULL'] │ ['customer_name','order_total'] │ ['VARCHAR NULL','INT NULL'] │ mysql(db=dict host=mysql password=[hidden] port=3306 table=orders username=root) │ │ -└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ -``` - -此示例使用 WHERE 子句显示具有完全名称 'order_dict' 的 dictionaries： - -```sql -SHOW DICTIONARIES WHERE name = 'order_dict'; - -┌────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐ -│ database │ dictionary │ key_names │ key_types │ attribute_names │ attribute_types │ source │ comment │ -├──────────┼────────────┼───────────────┼───────────────┼─────────────────────────────────┼─────────────────────────────┼──────────────────────────────────────────────────────────────────────────────────┼─────────┤ -│ default │ order_dict │ ['order_id'] │ ['INT NULL'] │ ['customer_name','order_total'] │ ['VARCHAR NULL','INT NULL'] │ mysql(db=dict host=mysql password=[hidden] port=3306 table=orders username=root) │ │ -└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘ -``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/19-dictionary-functions/_category_.json b/docs/cn/sql-reference/20-sql-functions/19-dictionary-functions/_category_.json deleted file mode 100644 index 1a2c2bae82..0000000000 --- a/docs/cn/sql-reference/20-sql-functions/19-dictionary-functions/_category_.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "label": "Dictionary Functions" -} \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/19-dictionary-functions/dict-get.md b/docs/cn/sql-reference/20-sql-functions/19-dictionary-functions/dict-get.md deleted file mode 100644 index de066a6957..0000000000 --- a/docs/cn/sql-reference/20-sql-functions/19-dictionary-functions/dict-get.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: DICT_GET ---- -import FunctionDescription from '@site/src/components/FunctionDescription'; - - - -使用提供的键表达式（Key Expression）从字典（Dictionary）中检索指定属性（Attribute）的值。 - -## 语法 - -```sql -DICT_GET([db_name.], '', ) -``` - -| 参数 | 描述 | -|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| dict_name | 字典（Dictionary）的名称。 | -| attr_name | 要检索其值的字典（Dictionary）中的属性（Attribute）名称。 | -| key_expr | 用于在字典（Dictionary）中定位特定条目的键表达式（Key Expression）。它代表字典（Dictionary）主键（Primary Key）的值，用于检索相应的数据。 | - -## 示例 - -此示例演示如何使用 DICT_GET 从字典（Dictionary）中检索值： - -```sql --- 假设我们有一个名为 'user_info' 的字典，其中 'user_id' 是键，'name' 是一个属性 -SELECT DICT_GET('user_info', 'name', 12345); -``` \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/19-dictionary-functions/index.md b/docs/cn/sql-reference/20-sql-functions/19-dictionary-functions/index.md deleted file mode 100644 index f44b8e39b8..0000000000 --- a/docs/cn/sql-reference/20-sql-functions/19-dictionary-functions/index.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -title: 字典函数（Dictionary Functions） ---- - -本节提供 Databend 中字典函数（Dictionary Functions）的参考信息。字典函数允许您直接从 MySQL 和 Redis 等外部数据源实时查询数据，无需 ETL 过程。 - -## 字典函数的优势 - -- **实时数据访问**：直接查询外部数据源，无需数据同步 -- **数据一致性**：确保 Databend 与外部系统之间的数据一致性 -- **性能提升**：减少对频繁访问参考数据的查询延迟 -- **简化数据管理**：消除对复杂 ETL 管道的需求 - -## 可用的字典函数 - -| 函数 | 描述 | 示例 | -|----------|-------------|--------| -| [DICT_GET](dict-get) | 使用键从字典中检索值 | `DICT_GET(my_dict, 'attribute', key_value)` | \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/index.md b/docs/cn/sql-reference/20-sql-functions/index.md index 1625bd1162..6ee0cb905b 100644 --- a/docs/cn/sql-reference/20-sql-functions/index.md +++ b/docs/cn/sql-reference/20-sql-functions/index.md @@ -68,6 +68,6 @@ Databend 为各类数据处理提供了全面的 SQL 函数。函数按重要性 |----------|-------------| | [间隔函数](./05-interval-functions/index.md) | 时间单位转换与间隔创建 | | [序列函数](./18-sequence-functions/index.md) | 自增序列值生成 | -| [字典函数](./19-dictionary-functions/index.md) | 实时外部数据源查询（MySQL、Redis） | + | [测试函数](./19-test-functions/index.md) | 测试与调试工具 | | [其他函数](./20-other-functions/index.md) | 杂项辅助与实用工具 | \ No newline at end of file From 899cd2fd37c5a4f3fc462c678ab9e455aa4ef5c2 Mon Sep 17 00:00:00 2001 From: BohuTANG Date: Sun, 23 Nov 2025 14:28:48 +0800 Subject: [PATCH 08/12] docs: simplify sql reference titles --- .../20-information-schema-tables/_category_.json | 2 +- .../10-sql-commands/40-explain-cmds/_category_.json | 2 +- .../20-sql-functions/04-numeric-functions/_category_.json | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/cn/sql-reference/00-sql-reference/20-information-schema-tables/_category_.json b/docs/cn/sql-reference/00-sql-reference/20-information-schema-tables/_category_.json index d6a061dc53..544b3c6539 100644 --- a/docs/cn/sql-reference/00-sql-reference/20-information-schema-tables/_category_.json +++ b/docs/cn/sql-reference/00-sql-reference/20-information-schema-tables/_category_.json @@ -1,3 +1,3 @@ { - "label": "信息模式" + "label": "Information Schema" } diff --git a/docs/cn/sql-reference/10-sql-commands/40-explain-cmds/_category_.json b/docs/cn/sql-reference/10-sql-commands/40-explain-cmds/_category_.json index 051b66f045..f532afb003 100644 --- a/docs/cn/sql-reference/10-sql-commands/40-explain-cmds/_category_.json +++ b/docs/cn/sql-reference/10-sql-commands/40-explain-cmds/_category_.json @@ -1,3 +1,3 @@ { - "label": "Explain 分析" + "label": "Explain" } \ No newline at end of file diff --git a/docs/cn/sql-reference/20-sql-functions/04-numeric-functions/_category_.json b/docs/cn/sql-reference/20-sql-functions/04-numeric-functions/_category_.json index 16965fa2d5..2ccb64883e 100644 --- a/docs/cn/sql-reference/20-sql-functions/04-numeric-functions/_category_.json +++ b/docs/cn/sql-reference/20-sql-functions/04-numeric-functions/_category_.json @@ -1,4 +1,4 @@ { - "label": "数值函数（Numeric Functions）", + "label": "数值函数", "position": 1 } \ No newline at end of file From b7eece7eae15522268c5f386bf9bf424687261a1 Mon Sep 17 00:00:00 2001 From: BohuTANG Date: Sun, 23 Nov 2025 14:40:11 +0800 Subject: [PATCH 09/12] docs: refine Chinese tutorial titles and content --- docs/cn/tutorials/01-taobao.md | 2 +- docs/cn/tutorials/connect/_category_.json | 2 +- docs/cn/tutorials/connect/connect-to-databend-bendsql.md | 4 ++-- docs/cn/tutorials/connect/connect-to-databend-dbeaver.md | 4 ++-- .../tutorials/connect/connect-to-databendcloud-bendsql.md | 4 ++-- .../tutorials/connect/connect-to-databendcloud-dbeaver.md | 4 ++-- docs/cn/tutorials/databend-cloud/aws-billing.md | 2 +- docs/cn/tutorials/databend-cloud/dashboard.md | 4 ++-- docs/cn/tutorials/databend-cloud/link-tables.md | 4 ++-- docs/cn/tutorials/integrate/access-mysql-and-redis.md | 4 ++-- docs/cn/tutorials/load/_category_.json | 2 +- .../load/automating-json-log-loading-with-vector.md | 2 +- docs/cn/tutorials/load/kafka-bend-ingest-kafka.md | 2 +- docs/cn/tutorials/load/kafka-databend-kafka-connect.md | 2 +- docs/cn/tutorials/migrate/_category_.json | 2 +- .../cn/tutorials/migrate/migrating-from-mysql-with-addax.md | 6 +++--- .../cn/tutorials/migrate/migrating-from-mysql-with-datax.md | 6 +++--- .../migrate/migrating-from-mysql-with-db-archiver.md | 6 +++--- .../tutorials/migrate/migrating-from-mysql-with-debezium.md | 6 +++--- .../migrate/migrating-from-mysql-with-flink-cdc.md | 6 +++--- .../migrate/migrating-from-mysql-with-kafka-connect.md | 6 +++--- docs/cn/tutorials/migrate/migrating-from-snowflake.md | 6 +++--- ...integrating-with-databend-cloud-using-databend-driver.md | 4 ++-- ...grating-with-databend-cloud-using-databend-sqlalchemy.md | 4 ++-- .../python/integrating-with-self-hosted-databend.md | 4 ++-- docs/cn/tutorials/recovery/_category_.json | 2 +- docs/cn/tutorials/recovery/bendsave.md | 4 ++-- 27 files changed, 52 insertions(+), 52 deletions(-) diff --git a/docs/cn/tutorials/01-taobao.md b/docs/cn/tutorials/01-taobao.md index 9fbc278c42..57837e0acc 100644 --- a/docs/cn/tutorials/01-taobao.md +++ b/docs/cn/tutorials/01-taobao.md @@ -1,5 +1,5 @@ --- -title: 淘宝用户购物行为分析 +title: 淘宝用户行为分析 slug: /taobao-tutorial --- diff --git a/docs/cn/tutorials/connect/_category_.json b/docs/cn/tutorials/connect/_category_.json index 171b5e791b..0075ec0047 100644 --- a/docs/cn/tutorials/connect/_category_.json +++ b/docs/cn/tutorials/connect/_category_.json @@ -1,3 +1,3 @@ { - "label": "客户端连接" + "label": "连接" } \ No newline at end of file diff --git a/docs/cn/tutorials/connect/connect-to-databend-bendsql.md b/docs/cn/tutorials/connect/connect-to-databend-bendsql.md index 10af51dc53..bb20afae76 100644 --- a/docs/cn/tutorials/connect/connect-to-databend-bendsql.md +++ b/docs/cn/tutorials/connect/connect-to-databend-bendsql.md @@ -1,6 +1,6 @@ --- -title: "使用 BendSQL 连接到自托管 Databend" -sidebar_label: "连接到自托管 Databend (BendSQL)" +title: "连接 Databend (BendSQL)" +sidebar_label: "BendSQL" slug: / --- diff --git a/docs/cn/tutorials/connect/connect-to-databend-dbeaver.md b/docs/cn/tutorials/connect/connect-to-databend-dbeaver.md index 67cfff48ff..eaa3cd931b 100644 --- a/docs/cn/tutorials/connect/connect-to-databend-dbeaver.md +++ b/docs/cn/tutorials/connect/connect-to-databend-dbeaver.md @@ -1,6 +1,6 @@ --- -title: "使用 DBeaver 连接到私有化部署 Databend" -sidebar_label: "连接到私有化部署 Databend (DBeaver)" +title: "连接 Databend (DBeaver)" +sidebar_label: "DBeaver" --- import StepsWrap from '@site/src/components/StepsWrap'; diff --git a/docs/cn/tutorials/connect/connect-to-databendcloud-bendsql.md b/docs/cn/tutorials/connect/connect-to-databendcloud-bendsql.md index 15182c4e5a..db8e05b1de 100644 --- a/docs/cn/tutorials/connect/connect-to-databendcloud-bendsql.md +++ b/docs/cn/tutorials/connect/connect-to-databendcloud-bendsql.md @@ -1,6 +1,6 @@ --- -title: "使用 BendSQL 连接到 Databend Cloud" -sidebar_label: "连接到 Databend Cloud (BendSQL)" +title: "连接 Databend Cloud (BendSQL)" +sidebar_label: "Cloud (BendSQL)" --- import StepsWrap from '@site/src/components/StepsWrap'; diff --git a/docs/cn/tutorials/connect/connect-to-databendcloud-dbeaver.md b/docs/cn/tutorials/connect/connect-to-databendcloud-dbeaver.md index f2c2e51f20..5d80aea74e 100644 --- a/docs/cn/tutorials/connect/connect-to-databendcloud-dbeaver.md +++ b/docs/cn/tutorials/connect/connect-to-databendcloud-dbeaver.md @@ -1,6 +1,6 @@ --- -title: '使用 DBeaver 连接 Databend Cloud' -sidebar_label: '连接 Databend Cloud (DBeaver)' +title: "连接 Databend Cloud (DBeaver)" +sidebar_label: "Cloud (DBeaver)" --- import StepsWrap from '@site/src/components/StepsWrap'; import StepContent from '@site/src/components/Steps/step-content'; diff --git a/docs/cn/tutorials/databend-cloud/aws-billing.md b/docs/cn/tutorials/databend-cloud/aws-billing.md index d13470d73c..fd25029507 100644 --- a/docs/cn/tutorials/databend-cloud/aws-billing.md +++ b/docs/cn/tutorials/databend-cloud/aws-billing.md @@ -2,7 +2,7 @@ title: 分析 AWS 账单 --- -在本教程中，我们将引导你完成导入 AWS 账单数据并使用 SQL 进行成本分析的过程。你将学习如何将 AWS 账单数据加载到 Databend Cloud 中，查询它以查找关键的成本驱动因素，并深入了解你的 AWS 使用情况。 +在本教程中，我们将介绍如何导入 AWS 账单数据并使用 SQL 进行成本分析。你将学习如何将 AWS 账单数据加载到 Databend Cloud 中，查询它以查找关键的成本驱动因素，并深入了解你的 AWS 使用情况。 AWS 账单数据提供了你的云服务使用情况和相关成本的全面细分，可以直接从 AWS Billing Console 中的 AWS Cost and Usage Reports (CUR) 服务中以 Parquet 格式导出。在本教程中，我们将使用 Parquet 格式的示例数据集，该数据集可在 [https://datasets.databend.com/aws-billing.parquet](https://datasets.databend.com/aws-billing.parquet) 获得。该数据集遵循 CUR 标准，其中包括服务名称、使用类型和定价详细信息等字段。有关完整的架构参考，你可以参考 [AWS Cost and Usage Report Data Dictionary](https://docs.aws.amazon.com/cur/latest/userguide/data-dictionary.html)。 diff --git a/docs/cn/tutorials/databend-cloud/dashboard.md b/docs/cn/tutorials/databend-cloud/dashboard.md index 25efbace8c..2ac1866fe4 100644 --- a/docs/cn/tutorials/databend-cloud/dashboard.md +++ b/docs/cn/tutorials/databend-cloud/dashboard.md @@ -1,10 +1,10 @@ --- -title: 为 COVID-19 数据构建仪表盘（Dashboard） +title: COVID-19 仪表盘 --- import StepsWrap from '@site/src/components/StepsWrap'; import StepContent from '@site/src/components/Steps/step-content'; -在本教程中，我们将加载、分析名为“Covid-19 Data from New York Times”的数据集，并为其创建仪表盘（Dashboard）。该数据集包含美国全境每日更新的 Covid-19 病例、死亡及相关统计信息，可全面展示 2022 年全年疫情在全国、州、县各级的影响与细节。 +本教程演示如何加载和分析 Covid-19 数据集，并为其创建仪表盘。该数据集包含美国全境每日更新的 Covid-19 病例、死亡及相关统计信息，可全面展示 2022 年全年疫情在全国、州、县各级的影响与细节。 | 字段 | 描述 | |---------|----------------------------------------------| diff --git a/docs/cn/tutorials/databend-cloud/link-tables.md b/docs/cn/tutorials/databend-cloud/link-tables.md index c62672e878..7683315a20 100644 --- a/docs/cn/tutorials/databend-cloud/link-tables.md +++ b/docs/cn/tutorials/databend-cloud/link-tables.md @@ -1,8 +1,8 @@ --- -title: 使用 ATTACH TABLE 链接表 +title: 使用 ATTACH TABLE --- -在本教程中，我们将引导您了解如何使用 [ATTACH TABLE](/sql/sql-commands/ddl/table/attach-table) 命令将 Databend Cloud 中的表与存储在 S3 bucket 中的现有 Databend 表链接起来。 +本教程介绍如何使用 [ATTACH TABLE](/sql/sql-commands/ddl/table/attach-table) 命令将 Databend Cloud 中的表链接到 S3 中的现有表。 ## 准备工作 diff --git a/docs/cn/tutorials/integrate/access-mysql-and-redis.md b/docs/cn/tutorials/integrate/access-mysql-and-redis.md index 750bdc55a7..6c06cddf14 100644 --- a/docs/cn/tutorials/integrate/access-mysql-and-redis.md +++ b/docs/cn/tutorials/integrate/access-mysql-and-redis.md @@ -1,8 +1,8 @@ --- -title: 使用字典访问 MySQL 和 Redis +title: 访问 MySQL 和 Redis --- -在本教程中，我们将指导您如何使用 Databend 中的字典访问 MySQL 和 Redis 数据。您将学习如何创建映射到这些外部数据源的字典，从而实现无缝的数据查询和集成。 +本教程介绍如何使用 Databend 字典访问 MySQL 和 Redis 数据，实现无缝的数据查询和集成。 ## 开始之前 diff --git a/docs/cn/tutorials/load/_category_.json b/docs/cn/tutorials/load/_category_.json index 74ffba068d..b630adfeb2 100644 --- a/docs/cn/tutorials/load/_category_.json +++ b/docs/cn/tutorials/load/_category_.json @@ -1,3 +1,3 @@ { - "label": "数据加载" + "label": "数据导入" } \ No newline at end of file diff --git a/docs/cn/tutorials/load/automating-json-log-loading-with-vector.md b/docs/cn/tutorials/load/automating-json-log-loading-with-vector.md index 25b15df612..fb1b63f034 100644 --- a/docs/cn/tutorials/load/automating-json-log-loading-with-vector.md +++ b/docs/cn/tutorials/load/automating-json-log-loading-with-vector.md @@ -1,5 +1,5 @@ --- -title: 使用 Vector 自动加载 JSON 日志 +title: 自动导入 JSON 日志 --- 在本教程中，我们将模拟在本地生成日志，使用 [Vector](https://vector.dev/) 收集日志，将其存储到 S3，并通过定时任务自动将其摄取到 Databend Cloud。 diff --git a/docs/cn/tutorials/load/kafka-bend-ingest-kafka.md b/docs/cn/tutorials/load/kafka-bend-ingest-kafka.md index fd1d4f7502..077a87d823 100644 --- a/docs/cn/tutorials/load/kafka-bend-ingest-kafka.md +++ b/docs/cn/tutorials/load/kafka-bend-ingest-kafka.md @@ -1,5 +1,5 @@ --- -title: 使用 bend-ingest-kafka 从 Kafka 加载数据 +title: 从 Kafka 导入 (bend-ingest-kafka) --- 在本教程中，我们将指导您使用 Docker 设置 Kafka 环境，并使用 [bend-ingest-kafka](https://github.com/databendcloud/bend-ingest-kafka) 将消息从 Kafka 加载到 Databend Cloud。 diff --git a/docs/cn/tutorials/load/kafka-databend-kafka-connect.md b/docs/cn/tutorials/load/kafka-databend-kafka-connect.md index 1aa13569d1..78f107addf 100644 --- a/docs/cn/tutorials/load/kafka-databend-kafka-connect.md +++ b/docs/cn/tutorials/load/kafka-databend-kafka-connect.md @@ -1,5 +1,5 @@ --- -title: Loading from Kafka with databend-kafka-connect +title: 从 Kafka 导入 (Kafka Connect) --- 在本教程中，我们将使用 Kafka Connect sink connector 插件 [databend-kafka-connect](https://github.com/databendcloud/databend-kafka-connect) 建立 Confluent Cloud 中 Kafka 和 Databend Cloud 之间的连接。然后，我们将演示如何生成消息并将其加载到 Databend Cloud 中。 diff --git a/docs/cn/tutorials/migrate/_category_.json b/docs/cn/tutorials/migrate/_category_.json index a596d6c0ce..b31a3fc068 100644 --- a/docs/cn/tutorials/migrate/_category_.json +++ b/docs/cn/tutorials/migrate/_category_.json @@ -1,3 +1,3 @@ { - "label": "从数据库迁移" + "label": "数据迁移" } \ No newline at end of file diff --git a/docs/cn/tutorials/migrate/migrating-from-mysql-with-addax.md b/docs/cn/tutorials/migrate/migrating-from-mysql-with-addax.md index 849578ebb7..f61ebdde04 100644 --- a/docs/cn/tutorials/migrate/migrating-from-mysql-with-addax.md +++ b/docs/cn/tutorials/migrate/migrating-from-mysql-with-addax.md @@ -1,9 +1,9 @@ --- -title: 使用 Addax 从 MySQL 迁移 -sidebar_label: 'MySQL → Databend: Addax' +title: 使用 Addax 迁移 MySQL +sidebar_label: 'Addax' --- -> **功能**: 全量加载, 增量 +> **功能**: 全量导入, 增量导入 在本教程中，您将使用 Addax 将数据从 MySQL 加载到 Databend。在开始之前，请确保您已在环境中成功设置 Databend、MySQL 和 Addax。 diff --git a/docs/cn/tutorials/migrate/migrating-from-mysql-with-datax.md b/docs/cn/tutorials/migrate/migrating-from-mysql-with-datax.md index b7faf64398..7c2ce8e2b5 100644 --- a/docs/cn/tutorials/migrate/migrating-from-mysql-with-datax.md +++ b/docs/cn/tutorials/migrate/migrating-from-mysql-with-datax.md @@ -1,9 +1,9 @@ --- -title: 使用 DataX 从 MySQL 迁移 -sidebar_label: 'MySQL → Databend: DataX' +title: 使用 DataX 迁移 MySQL +sidebar_label: 'DataX' --- -> **能力**: 全量加载, 增量 +> **功能**: 全量导入, 增量导入 在本教程中，您将使用 DataX 将数据从 MySQL 加载到 Databend。在开始之前，请确保您已在您的环境中成功设置了 Databend、MySQL 和 DataX。 diff --git a/docs/cn/tutorials/migrate/migrating-from-mysql-with-db-archiver.md b/docs/cn/tutorials/migrate/migrating-from-mysql-with-db-archiver.md index ce857e4f3d..aa4f0a4bd6 100644 --- a/docs/cn/tutorials/migrate/migrating-from-mysql-with-db-archiver.md +++ b/docs/cn/tutorials/migrate/migrating-from-mysql-with-db-archiver.md @@ -1,9 +1,9 @@ --- -title: 使用 db-archiver 从 MySQL 迁移 -sidebar_label: 'MySQL → Databend: db-archiver' +title: 使用 db-archiver 迁移 MySQL +sidebar_label: 'db-archiver' --- -> **能力**：全量加载 (Full Load)、增量加载 (Incremental) +> **功能**：全量导入 (Full Load)、增量导入 (Incremental) > **✅ 推荐**用于历史数据的批量迁移 在本教程中，我们将引导你完成使用 db-archiver 从 MySQL 迁移到 Databend Cloud 的过程。 diff --git a/docs/cn/tutorials/migrate/migrating-from-mysql-with-debezium.md b/docs/cn/tutorials/migrate/migrating-from-mysql-with-debezium.md index 0db96a903d..95d1290440 100644 --- a/docs/cn/tutorials/migrate/migrating-from-mysql-with-debezium.md +++ b/docs/cn/tutorials/migrate/migrating-from-mysql-with-debezium.md @@ -1,9 +1,9 @@ --- -title: 使用 Debezium 从 MySQL 迁移 -sidebar_label: 'MySQL → Databend: Debezium' +title: 使用 Debezium 迁移 MySQL +sidebar_label: 'Debezium' --- -> **功能**: CDC, 全量加载 +> **功能**: CDC, 全量导入 > **✅ 推荐** 用于实时迁移，具有完整变更数据捕获 在本教程中，您将使用 Debezium 将数据从 MySQL 加载到 Databend。在开始之前，请确保您已在环境中成功设置 Databend、MySQL 和 Debezium。 diff --git a/docs/cn/tutorials/migrate/migrating-from-mysql-with-flink-cdc.md b/docs/cn/tutorials/migrate/migrating-from-mysql-with-flink-cdc.md index 270ce56f62..c0b120d446 100644 --- a/docs/cn/tutorials/migrate/migrating-from-mysql-with-flink-cdc.md +++ b/docs/cn/tutorials/migrate/migrating-from-mysql-with-flink-cdc.md @@ -1,9 +1,9 @@ --- -title: 使用 Flink CDC 从 MySQL 迁移 -sidebar_label: 'MySQL → Databend: Flink CDC' +title: 使用 Flink CDC 迁移 MySQL +sidebar_label: 'Flink CDC' --- -> **功能**: CDC, 全量加载, 转换 +> **功能**: CDC, 全量导入, 转换 在本教程中，我们将引导您完成使用 Apache Flink CDC 从 MySQL 迁移到 Databend Cloud 的过程。 diff --git a/docs/cn/tutorials/migrate/migrating-from-mysql-with-kafka-connect.md b/docs/cn/tutorials/migrate/migrating-from-mysql-with-kafka-connect.md index 6aff6e0cbf..03680363e1 100644 --- a/docs/cn/tutorials/migrate/migrating-from-mysql-with-kafka-connect.md +++ b/docs/cn/tutorials/migrate/migrating-from-mysql-with-kafka-connect.md @@ -1,9 +1,9 @@ --- -title: 使用 Kafka Connect 从 MySQL 迁移 -sidebar_label: 'MySQL → Databend: Kafka Connect' +title: 使用 Kafka Connect 迁移 MySQL +sidebar_label: 'Kafka Connect' --- -> **功能**: CDC, 增量, 全量加载 +> **功能**: CDC, 增量导入, 全量导入 本教程展示了如何使用 Kafka Connect 构建从 MySQL 到 Databend 的实时数据管道。 diff --git a/docs/cn/tutorials/migrate/migrating-from-snowflake.md b/docs/cn/tutorials/migrate/migrating-from-snowflake.md index 2163c830eb..67ea0cd8b7 100644 --- a/docs/cn/tutorials/migrate/migrating-from-snowflake.md +++ b/docs/cn/tutorials/migrate/migrating-from-snowflake.md @@ -1,10 +1,10 @@ --- -title: 从 Snowflake 迁移 -sidebar_label: Snowflake → Databend +title: 迁移 Snowflake +sidebar_label: 'Snowflake' --- -> **功能**: 全量加载 +> **功能**: 全量导入 本教程将指导您完成从 Snowflake 迁移数据到 Databend 的过程。迁移过程包括将数据从 Snowflake 导出到 Amazon S3 存储桶，然后将其加载到 Databend 中。该过程分为三个主要步骤： diff --git a/docs/cn/tutorials/programming/python/integrating-with-databend-cloud-using-databend-driver.md b/docs/cn/tutorials/programming/python/integrating-with-databend-cloud-using-databend-driver.md index ad493f4b9b..0cf0cbcd7d 100644 --- a/docs/cn/tutorials/programming/python/integrating-with-databend-cloud-using-databend-driver.md +++ b/docs/cn/tutorials/programming/python/integrating-with-databend-cloud-using-databend-driver.md @@ -1,8 +1,8 @@ --- -title: 使用 databend-driver 集成 Databend Cloud +title: 集成 (databend-driver) --- -在本教程中，我们将引导您了解如何使用 `databend-driver` 连接到 Databend Cloud，创建表，插入数据以及使用 Python 检索结果。 +本教程介绍如何使用 `databend-driver` 连接 Databend Cloud，并使用 Python 进行数据操作。 ## 开始之前 diff --git a/docs/cn/tutorials/programming/python/integrating-with-databend-cloud-using-databend-sqlalchemy.md b/docs/cn/tutorials/programming/python/integrating-with-databend-cloud-using-databend-sqlalchemy.md index e6d1d8049d..06e67f12c0 100644 --- a/docs/cn/tutorials/programming/python/integrating-with-databend-cloud-using-databend-sqlalchemy.md +++ b/docs/cn/tutorials/programming/python/integrating-with-databend-cloud-using-databend-sqlalchemy.md @@ -1,8 +1,8 @@ --- -title: 使用 databend-sqlalchemy 集成 Databend Cloud +title: 集成 (SQLAlchemy) --- -在本教程中，我们将引导你使用 `databend-sqlalchemy` 库连接 Databend Cloud，并通过 Python 创建表、插入数据及查询结果。 +本教程介绍如何使用 `databend-sqlalchemy` 连接 Databend Cloud，并使用 Python 进行数据操作。 ## 在开始之前 diff --git a/docs/cn/tutorials/programming/python/integrating-with-self-hosted-databend.md b/docs/cn/tutorials/programming/python/integrating-with-self-hosted-databend.md index 0d3be907bd..cf3c2af9ad 100644 --- a/docs/cn/tutorials/programming/python/integrating-with-self-hosted-databend.md +++ b/docs/cn/tutorials/programming/python/integrating-with-self-hosted-databend.md @@ -1,8 +1,8 @@ --- -title: 与私有化部署 Databend 集成 +title: 集成私有化 Databend --- -本教程演示了如何使用 Python 连接到本地部署的 Databend 实例。我们将介绍三种方法——`databend-driver`、带有连接器的 `databend-sqlalchemy` 以及带有引擎的 `databend-sqlalchemy`——来执行基本操作，例如创建数据库、添加表、插入数据、查询和清理资源。 +本教程演示如何使用 Python 连接私有化部署的 Databend，涵盖三种连接方法：`databend-driver`、使用连接器的 `databend-sqlalchemy` 以及使用引擎的 `databend-sqlalchemy`。 ## 开始之前 diff --git a/docs/cn/tutorials/recovery/_category_.json b/docs/cn/tutorials/recovery/_category_.json index 4f58bae568..8ed819ceb1 100644 --- a/docs/cn/tutorials/recovery/_category_.json +++ b/docs/cn/tutorials/recovery/_category_.json @@ -1,3 +1,3 @@ { - "label": "恢复" + "label": "数据恢复" } diff --git a/docs/cn/tutorials/recovery/bendsave.md b/docs/cn/tutorials/recovery/bendsave.md index 58ff50d5f1..e8908ab750 100644 --- a/docs/cn/tutorials/recovery/bendsave.md +++ b/docs/cn/tutorials/recovery/bendsave.md @@ -1,8 +1,8 @@ --- -title: 使用 BendSave 备份和恢复数据 +title: 备份与恢复 (BendSave) --- -本教程将引导你了解如何使用 BendSave 备份和恢复数据。我们将使用一个本地 MinIO 实例，它既作为 Databend 兼容 S3 的存储后端，也作为存储备份的目标位置。 +本教程介绍如何使用 BendSave 进行数据备份和恢复。我们将使用本地 MinIO 实例作为存储后端和备份目标。 ## 在开始之前 From 3780f998f6afc732c6f2e7a3e74517060d7f84a7 Mon Sep 17 00:00:00 2001 From: BohuTANG Date: Sun, 23 Nov 2025 14:43:07 +0800 Subject: [PATCH 10/12] docs: refine Chinese developer documentation titles and content --- docs/cn/developer/00-drivers/00-golang.md | 2 +- docs/cn/developer/00-drivers/01-python.md | 2 +- docs/cn/developer/00-drivers/02-nodejs.md | 2 +- docs/cn/developer/00-drivers/03-jdbc.md | 2 +- docs/cn/developer/00-drivers/04-rust.md | 2 +- docs/cn/developer/10-apis/_category_.json | 2 +- docs/cn/developer/10-apis/http.md | 12 +++++++----- docs/cn/developer/20-community/_category_.json | 3 +++ docs/cn/developer/20-community/index.md | 8 ++++---- 9 files changed, 20 insertions(+), 15 deletions(-) create mode 100644 docs/cn/developer/20-community/_category_.json diff --git a/docs/cn/developer/00-drivers/00-golang.md b/docs/cn/developer/00-drivers/00-golang.md index 278681116a..7c8b21fefe 100644 --- a/docs/cn/developer/00-drivers/00-golang.md +++ b/docs/cn/developer/00-drivers/00-golang.md @@ -2,7 +2,7 @@ title: Go --- -# Databend Go 驱动 +# Go 驱动 官方 Go 驱动，提供标准的 `database/sql` 接口，可与现有 Go 应用程序无缝集成。 diff --git a/docs/cn/developer/00-drivers/01-python.md b/docs/cn/developer/00-drivers/01-python.md index 8dbd23e01b..bdc963f8bf 100644 --- a/docs/cn/developer/00-drivers/01-python.md +++ b/docs/cn/developer/00-drivers/01-python.md @@ -2,7 +2,7 @@ title: Python --- -# Databend Python 驱动 +# Python 驱动 使用我们的官方驱动通过 Python 连接 Databend，支持同步与异步操作。 diff --git a/docs/cn/developer/00-drivers/02-nodejs.md b/docs/cn/developer/00-drivers/02-nodejs.md index ec29a99285..ca8e39bc11 100644 --- a/docs/cn/developer/00-drivers/02-nodejs.md +++ b/docs/cn/developer/00-drivers/02-nodejs.md @@ -2,7 +2,7 @@ title: Node.js --- -# Databend Node.js 驱动 +# Node.js 驱动 官方 Node.js 驱动，为现代 JavaScript 应用程序提供 TypeScript 支持和基于 Promise 的 API。 diff --git a/docs/cn/developer/00-drivers/03-jdbc.md b/docs/cn/developer/00-drivers/03-jdbc.md index 10adb12dd0..a3cf09c7ed 100644 --- a/docs/cn/developer/00-drivers/03-jdbc.md +++ b/docs/cn/developer/00-drivers/03-jdbc.md @@ -2,7 +2,7 @@ title: Java (JDBC) --- -# Databend Java JDBC 驱动 +# Java (JDBC) 驱动 官方 JDBC 驱动，提供标准 JDBC 4.0 兼容性，可与 Java 应用程序无缝集成。 diff --git a/docs/cn/developer/00-drivers/04-rust.md b/docs/cn/developer/00-drivers/04-rust.md index 7f78cbba99..e91ad0b464 100644 --- a/docs/cn/developer/00-drivers/04-rust.md +++ b/docs/cn/developer/00-drivers/04-rust.md @@ -2,7 +2,7 @@ title: Rust --- -# Databend Rust 驱动 +# Rust 驱动 官方 Rust 驱动，为 Rust 应用程序提供原生连接、async/await 支持和全面的类型安全。 diff --git a/docs/cn/developer/10-apis/_category_.json b/docs/cn/developer/10-apis/_category_.json index 2bfd371b34..6d9c304f29 100644 --- a/docs/cn/developer/10-apis/_category_.json +++ b/docs/cn/developer/10-apis/_category_.json @@ -1,3 +1,3 @@ { - "label": "APIs" + "label": "API" } \ No newline at end of file diff --git a/docs/cn/developer/10-apis/http.md b/docs/cn/developer/10-apis/http.md index 7794a1f633..3db1472f00 100644 --- a/docs/cn/developer/10-apis/http.md +++ b/docs/cn/developer/10-apis/http.md @@ -1,17 +1,19 @@ --- -title: HTTP Handler -sidebar_label: REST API +title: HTTP API +sidebar_label: HTTP API --- -Databend HTTP Handler 是一个 REST API，用于发送查询语句在服务器上执行，并将结果返回给客户端。 +# HTTP API -HTTP Handler 由 databend-query 托管，可以通过使用 `--http_handler_host` 和 `--http_handler_port` 来指定（默认为 8000）。 +Databend HTTP API 是一个 REST API，用于发送查询语句在服务器上执行，并将结果返回给客户端。 + +HTTP API 由 databend-query 托管，可以通过使用 `--http_handler_host` 和 `--http_handler_port` 来指定（默认为 8000）。 ## HTTP 方法 ### 概述 -此 Handler 以 `pages` 形式返回结果，并支持长轮询。 +此 API 以 `pages` 形式返回结果，并支持长轮询。 1. 首先，通过 `POST` 方法向 `/v1/query` 发送一个类型为 `QueryRequest` 的 JSON，其中包含要执行的 SQL 语句，返回一个类型为 `QueryResponse` 的 JSON。 2. 使用 `QueryResponse` 的字段进行进一步处理： diff --git a/docs/cn/developer/20-community/_category_.json b/docs/cn/developer/20-community/_category_.json new file mode 100644 index 0000000000..cae767bb42 --- /dev/null +++ b/docs/cn/developer/20-community/_category_.json @@ -0,0 +1,3 @@ +{ + "label": "社区" +} \ No newline at end of file diff --git a/docs/cn/developer/20-community/index.md b/docs/cn/developer/20-community/index.md index 9a473b4303..6f9f2f9dd8 100644 --- a/docs/cn/developer/20-community/index.md +++ b/docs/cn/developer/20-community/index.md @@ -1,10 +1,10 @@ --- -title: 社区 +title: Databend 社区 --- # 欢迎来到 Databend 社区！ -加入我们，为 Databend 项目的成长贡献力量。以下是您可以参与的方式： +加入我们，为 Databend 项目的成长贡献力量。参与方式如下： - **[RFCs](/developer/community/rfcs)**: 分享您对提议的功能和更改的见解。 @@ -14,9 +14,9 @@ title: 社区 - **[贡献者指南](/developer/community/contributor)**: 了解如何为我们的成功做出贡献。 -# 与我们联系 +# 联系我们 -成为我们充满活力的社区的一员，向所有数据爱好者开放。通过以下方式与我们联系： +加入我们充满活力的社区，通过以下方式与我们互动： - **Slack**: [加入我们的频道](https://link.databend.com/join-slack) 进行实时讨论。 - **GitHub**: [访问我们的代码仓库](https://github.com/databendlabs/databend) 并帮助开发 Databend。 From 923355f209a99a545944217dc43655a0ff6a361d Mon Sep 17 00:00:00 2001 From: BohuTANG Date: Sun, 23 Nov 2025 14:45:17 +0800 Subject: [PATCH 11/12] docs: refine community documentation titles --- .../20-community/00-contributor/00-building-from-source.md | 4 ++-- docs/cn/developer/20-community/00-contributor/01-good-pr.md | 4 ++-- .../00-contributor/02-how-to-write-scalar-functions.md | 4 ++-- .../00-contributor/03-how-to-write-aggregate-functions.md | 4 ++-- .../20-community/00-contributor/04-how-to-profiling.md | 2 +- docs/cn/developer/20-community/00-contributor/05-pgo.md | 4 ++-- docs/cn/developer/20-community/00-contributor/_category_.json | 2 +- docs/cn/developer/20-community/02-rfcs/_category_.json | 2 +- 8 files changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/cn/developer/20-community/00-contributor/00-building-from-source.md b/docs/cn/developer/20-community/00-contributor/00-building-from-source.md index e85e4abc84..e6142f5578 100644 --- a/docs/cn/developer/20-community/00-contributor/00-building-from-source.md +++ b/docs/cn/developer/20-community/00-contributor/00-building-from-source.md @@ -1,6 +1,6 @@ --- -title: 构建 Databend -sidebar_label: 构建 Databend +title: 从源码构建 +sidebar_label: 从源码构建 description: 从源代码获取和构建 Databend --- diff --git a/docs/cn/developer/20-community/00-contributor/01-good-pr.md b/docs/cn/developer/20-community/00-contributor/01-good-pr.md index fd0b2c36ab..c25eb45dc3 100644 --- a/docs/cn/developer/20-community/00-contributor/01-good-pr.md +++ b/docs/cn/developer/20-community/00-contributor/01-good-pr.md @@ -1,6 +1,6 @@ --- -title: 你的第一个 Databend PR -sidebar_label: 第一个 Pull Request +title: 提交 PR 指南 +sidebar_label: 提交 PR 指南 description: 你的第一个好的 Databend pull request --- diff --git a/docs/cn/developer/20-community/00-contributor/02-how-to-write-scalar-functions.md b/docs/cn/developer/20-community/00-contributor/02-how-to-write-scalar-functions.md index 5671e89907..3dfb3dddc0 100644 --- a/docs/cn/developer/20-community/00-contributor/02-how-to-write-scalar-functions.md +++ b/docs/cn/developer/20-community/00-contributor/02-how-to-write-scalar-functions.md @@ -1,6 +1,6 @@ --- -title: 如何编写标量函数 -sidebar_label: 如何编写标量函数 +title: 编写标量函数 +sidebar_label: 编写标量函数 --- ## 什么是标量函数 diff --git a/docs/cn/developer/20-community/00-contributor/03-how-to-write-aggregate-functions.md b/docs/cn/developer/20-community/00-contributor/03-how-to-write-aggregate-functions.md index 8bcfee287b..cf66d4414e 100644 --- a/docs/cn/developer/20-community/00-contributor/03-how-to-write-aggregate-functions.md +++ b/docs/cn/developer/20-community/00-contributor/03-how-to-write-aggregate-functions.md @@ -1,6 +1,6 @@ --- -title: 如何编写聚合函数 -sidebar_label: 如何编写聚合函数 +title: 编写聚合函数 +sidebar_label: 编写聚合函数 --- 聚合函数是一种将多行数据的值组合成单个汇总值的函数。常见的聚合函数包括 sum、count、avg 等。 diff --git a/docs/cn/developer/20-community/00-contributor/04-how-to-profiling.md b/docs/cn/developer/20-community/00-contributor/04-how-to-profiling.md index b80947e8c0..952c640a16 100644 --- a/docs/cn/developer/20-community/00-contributor/04-how-to-profiling.md +++ b/docs/cn/developer/20-community/00-contributor/04-how-to-profiling.md @@ -1,5 +1,5 @@ --- -title: 如何对 Databend 进行性能分析 +title: 性能分析 --- ## CPU 性能分析 diff --git a/docs/cn/developer/20-community/00-contributor/05-pgo.md b/docs/cn/developer/20-community/00-contributor/05-pgo.md index f052c8077f..12367d3d85 100644 --- a/docs/cn/developer/20-community/00-contributor/05-pgo.md +++ b/docs/cn/developer/20-community/00-contributor/05-pgo.md @@ -1,6 +1,6 @@ --- -title: Profile Guided Optimization (PGO) -sidebar_label: Profile Guided Optimization (PGO) +title: PGO 优化 +sidebar_label: PGO 优化 description: Building an optimized Databend with Profile Guided Optimization. --- diff --git a/docs/cn/developer/20-community/00-contributor/_category_.json b/docs/cn/developer/20-community/00-contributor/_category_.json index fbf39db5cc..565fd5f4d8 100644 --- a/docs/cn/developer/20-community/00-contributor/_category_.json +++ b/docs/cn/developer/20-community/00-contributor/_category_.json @@ -1,5 +1,5 @@ { - "label": "Contributor's Guide", + "label": "贡献指南", "link": { "type": "generated-index", "slug": "/community/contributor" diff --git a/docs/cn/developer/20-community/02-rfcs/_category_.json b/docs/cn/developer/20-community/02-rfcs/_category_.json index e84b98a87d..6b8d135cd8 100644 --- a/docs/cn/developer/20-community/02-rfcs/_category_.json +++ b/docs/cn/developer/20-community/02-rfcs/_category_.json @@ -1,5 +1,5 @@ { - "label": "RFCs", + "label": "RFC 文档", "link": { "type": "generated-index", "slug": "/community/rfcs" From d5cb7f631df817b387e2b205870ee498bbf62586 Mon Sep 17 00:00:00 2001 From: BohuTANG Date: Sun, 23 Nov 2025 14:48:48 +0800 Subject: [PATCH 12/12] docs: refine RFC titles --- docs/cn/developer/20-community/02-rfcs/00000000-example.md | 2 +- .../developer/20-community/02-rfcs/20210815-data-shuffle.md | 2 +- .../20-community/02-rfcs/20210913-join-framework-design.md | 2 +- .../02-rfcs/20210914-new-sql-planner-framework.md | 2 +- .../20-community/02-rfcs/20211202-plan-expression.md | 2 +- .../20-community/02-rfcs/20211203-performance-test.md | 2 +- .../20-community/02-rfcs/20220117-new-datavalues-system.md | 2 +- .../02-rfcs/20220304-semi-structured-data-types.md | 4 +--- .../02-rfcs/20220425-new_sql_logic_test_framework.md | 2 +- .../20-community/02-rfcs/20220530-user-friendly-releases.md | 2 +- docs/cn/developer/20-community/02-rfcs/20220704-presign.md | 2 +- .../cn/developer/20-community/02-rfcs/20220721-new-logging.md | 2 +- .../cn/developer/20-community/02-rfcs/20220728-metasrv-txn.md | 2 +- .../developer/20-community/02-rfcs/20220728-metasrv-watch.md | 2 +- docs/cn/developer/20-community/02-rfcs/20220729-recluster.md | 2 +- .../02-rfcs/20220805-deprecate-clickhouse-tcp-support.md | 2 +- docs/cn/developer/20-community/02-rfcs/20221028-user-stage.md | 2 +- .../20-community/02-rfcs/20230307-stage-with-schema.md | 2 +- 18 files changed, 18 insertions(+), 20 deletions(-) diff --git a/docs/cn/developer/20-community/02-rfcs/00000000-example.md b/docs/cn/developer/20-community/02-rfcs/00000000-example.md index 2fc5933710..5979cbbdf0 100644 --- a/docs/cn/developer/20-community/02-rfcs/00000000-example.md +++ b/docs/cn/developer/20-community/02-rfcs/00000000-example.md @@ -1,5 +1,5 @@ --- -title: +title: RFC 模板 description: <此 RFC 的简短描述> --- diff --git a/docs/cn/developer/20-community/02-rfcs/20210815-data-shuffle.md b/docs/cn/developer/20-community/02-rfcs/20210815-data-shuffle.md index 1527ac7398..2a8bd66b4e 100644 --- a/docs/cn/developer/20-community/02-rfcs/20210815-data-shuffle.md +++ b/docs/cn/developer/20-community/02-rfcs/20210815-data-shuffle.md @@ -1,4 +1,4 @@ -## 概述 +title: 分布式查询设计 (Data Shuffle) 分布式查询是分布式数据库的必要功能。 本文档旨在解释分布式查询及其数据流设计。 diff --git a/docs/cn/developer/20-community/02-rfcs/20210913-join-framework-design.md b/docs/cn/developer/20-community/02-rfcs/20210913-join-framework-design.md index 13b539554d..64fc50f122 100644 --- a/docs/cn/developer/20-community/02-rfcs/20210913-join-framework-design.md +++ b/docs/cn/developer/20-community/02-rfcs/20210913-join-framework-design.md @@ -1,4 +1,4 @@ -## 背景 +title: Join 框架设计 Join 是 SQL 中的主要功能之一。同时，它也是最复杂的部分。 diff --git a/docs/cn/developer/20-community/02-rfcs/20210914-new-sql-planner-framework.md b/docs/cn/developer/20-community/02-rfcs/20210914-new-sql-planner-framework.md index 489b586a9a..3ab4c5286e 100644 --- a/docs/cn/developer/20-community/02-rfcs/20210914-new-sql-planner-framework.md +++ b/docs/cn/developer/20-community/02-rfcs/20210914-new-sql-planner-framework.md @@ -1,5 +1,5 @@ --- -title: 新的 SQL Planner 框架设计 +title: 新 SQL Planner 框架设计 description: 新的 SQL planner 框架设计 RFC --- diff --git a/docs/cn/developer/20-community/02-rfcs/20211202-plan-expression.md b/docs/cn/developer/20-community/02-rfcs/20211202-plan-expression.md index 0eefd9432a..b168b10de8 100644 --- a/docs/cn/developer/20-community/02-rfcs/20211202-plan-expression.md +++ b/docs/cn/developer/20-community/02-rfcs/20211202-plan-expression.md @@ -1,5 +1,5 @@ --- -title: Expression and Plan Builder +title: 表达式与 Plan Builder description: Expression and plan builder RFC --- diff --git a/docs/cn/developer/20-community/02-rfcs/20211203-performance-test.md b/docs/cn/developer/20-community/02-rfcs/20211203-performance-test.md index 7e8b8da58d..76a621977b 100644 --- a/docs/cn/developer/20-community/02-rfcs/20211203-performance-test.md +++ b/docs/cn/developer/20-community/02-rfcs/20211203-performance-test.md @@ -1,5 +1,5 @@ --- -title: 性能测试测试基础设施 +title: 性能测试基础设施 description: 性能测试 RFC 的测试基础设施 --- diff --git a/docs/cn/developer/20-community/02-rfcs/20220117-new-datavalues-system.md b/docs/cn/developer/20-community/02-rfcs/20220117-new-datavalues-system.md index d710962495..b716c72b4f 100644 --- a/docs/cn/developer/20-community/02-rfcs/20220117-new-datavalues-system.md +++ b/docs/cn/developer/20-community/02-rfcs/20220117-new-datavalues-system.md @@ -1,5 +1,5 @@ --- -title: 新的 DataValues 系统 +title: 新 DataValues 系统 description: 新的 DataValues 系统设计 RFC --- diff --git a/docs/cn/developer/20-community/02-rfcs/20220304-semi-structured-data-types.md b/docs/cn/developer/20-community/02-rfcs/20220304-semi-structured-data-types.md index 2f652eca3d..5852cf8196 100644 --- a/docs/cn/developer/20-community/02-rfcs/20220304-semi-structured-data-types.md +++ b/docs/cn/developer/20-community/02-rfcs/20220304-semi-structured-data-types.md @@ -1,6 +1,4 @@ -## 概述 - -### 当前 `DataType` 的不足 +title: 半结构化数据类型 - `DataType` 是一个枚举类型，我们必须在使用前进行类型匹配。例如，如果我们想通过 `DataType` 创建反序列化器/序列化器，我们总是需要进行匹配。这并不意味着匹配是不必要的。如果我们想向 `DataType` 添加越来越多的函数，匹配可能会非常麻烦。 diff --git a/docs/cn/developer/20-community/02-rfcs/20220425-new_sql_logic_test_framework.md b/docs/cn/developer/20-community/02-rfcs/20220425-new_sql_logic_test_framework.md index 7e51957b07..33c7293405 100644 --- a/docs/cn/developer/20-community/02-rfcs/20220425-new_sql_logic_test_framework.md +++ b/docs/cn/developer/20-community/02-rfcs/20220425-new_sql_logic_test_framework.md @@ -1,4 +1,4 @@ -## 背景 +title: 新 SQL 逻辑测试框架 基本上，所有强大的数据库系统都需要在以下范围内进行测试。 diff --git a/docs/cn/developer/20-community/02-rfcs/20220530-user-friendly-releases.md b/docs/cn/developer/20-community/02-rfcs/20220530-user-friendly-releases.md index 2f7eb03ae0..f266b382bc 100644 --- a/docs/cn/developer/20-community/02-rfcs/20220530-user-friendly-releases.md +++ b/docs/cn/developer/20-community/02-rfcs/20220530-user-friendly-releases.md @@ -1,5 +1,5 @@ --- -title: 用户友好的发布 +title: 用户友好发布 description: 关于用户友好的发布的 RFC --- diff --git a/docs/cn/developer/20-community/02-rfcs/20220704-presign.md b/docs/cn/developer/20-community/02-rfcs/20220704-presign.md index 0d85b8011d..d999202891 100644 --- a/docs/cn/developer/20-community/02-rfcs/20220704-presign.md +++ b/docs/cn/developer/20-community/02-rfcs/20220704-presign.md @@ -1,5 +1,5 @@ --- -title: Presign +title: Presign 预签名 description: 为 PRESIGN 添加新的 SQL 语句 --- diff --git a/docs/cn/developer/20-community/02-rfcs/20220721-new-logging.md b/docs/cn/developer/20-community/02-rfcs/20220721-new-logging.md index 8b7c4ec096..db6b0e4520 100644 --- a/docs/cn/developer/20-community/02-rfcs/20220721-new-logging.md +++ b/docs/cn/developer/20-community/02-rfcs/20220721-new-logging.md @@ -1,5 +1,5 @@ --- -title: 全新的日志记录 +title: 全新日志系统 description: 让 Databend 的日志记录更上一层楼！ --- diff --git a/docs/cn/developer/20-community/02-rfcs/20220728-metasrv-txn.md b/docs/cn/developer/20-community/02-rfcs/20220728-metasrv-txn.md index a9aeac2302..b3d3e91e47 100644 --- a/docs/cn/developer/20-community/02-rfcs/20220728-metasrv-txn.md +++ b/docs/cn/developer/20-community/02-rfcs/20220728-metasrv-txn.md @@ -1,5 +1,5 @@ --- -title: databend-meta 中的事务支持 +title: MetaSrv 事务支持 description: databend-meta 中的事务支持 --- diff --git a/docs/cn/developer/20-community/02-rfcs/20220728-metasrv-watch.md b/docs/cn/developer/20-community/02-rfcs/20220728-metasrv-watch.md index e277765697..c978260758 100644 --- a/docs/cn/developer/20-community/02-rfcs/20220728-metasrv-watch.md +++ b/docs/cn/developer/20-community/02-rfcs/20220728-metasrv-watch.md @@ -1,5 +1,5 @@ --- -title: databend-meta 中的 Watch key 支持 +title: MetaSrv Watch Key 支持 description: Databend-meta 中的 Watch key 支持 --- diff --git a/docs/cn/developer/20-community/02-rfcs/20220729-recluster.md b/docs/cn/developer/20-community/02-rfcs/20220729-recluster.md index 871aa94fcd..44d02d474b 100644 --- a/docs/cn/developer/20-community/02-rfcs/20220729-recluster.md +++ b/docs/cn/developer/20-community/02-rfcs/20220729-recluster.md @@ -1,5 +1,5 @@ --- -title: recluster table +title: 表重新聚簇 (Recluster) description: RFC for recluster a clustered table --- diff --git a/docs/cn/developer/20-community/02-rfcs/20220805-deprecate-clickhouse-tcp-support.md b/docs/cn/developer/20-community/02-rfcs/20220805-deprecate-clickhouse-tcp-support.md index 2ed23d024d..9d237ee4bc 100644 --- a/docs/cn/developer/20-community/02-rfcs/20220805-deprecate-clickhouse-tcp-support.md +++ b/docs/cn/developer/20-community/02-rfcs/20220805-deprecate-clickhouse-tcp-support.md @@ -1,4 +1,4 @@ -## 概要 +title: 弃用 ClickHouse TCP 支持 Databend 现在支持 ClickHouse 的 tcp 协议，但实现有限。许多用户反馈 `clickhouse-client` 与 databend 配合不佳。通常，我们会告诉他们改用 MySQL。 diff --git a/docs/cn/developer/20-community/02-rfcs/20221028-user-stage.md b/docs/cn/developer/20-community/02-rfcs/20221028-user-stage.md index 4db7f8fed7..a53305de5c 100644 --- a/docs/cn/developer/20-community/02-rfcs/20221028-user-stage.md +++ b/docs/cn/developer/20-community/02-rfcs/20221028-user-stage.md @@ -1,5 +1,5 @@ --- -title: User Stage +title: 用户 Stage --- - RFC PR: [datafuselabs/databend#8519](https://github.com/databendlabs/databend/pull/8519) diff --git a/docs/cn/developer/20-community/02-rfcs/20230307-stage-with-schema.md b/docs/cn/developer/20-community/02-rfcs/20230307-stage-with-schema.md index c694a31e72..270149311a 100644 --- a/docs/cn/developer/20-community/02-rfcs/20230307-stage-with-schema.md +++ b/docs/cn/developer/20-community/02-rfcs/20230307-stage-with-schema.md @@ -1,4 +1,4 @@ -## 概述 +title: Stage Schema 选项 Stage 支持 `schema` 选项。