Merge pull request #29067 from qianmoQ/translation-docs-zh

pr commercial
2024-11-21 15:12:02 +00:00 · 2021-09-16 16:25:41 +03:00 · 2021-09-16 16:25:41 +03:00 · 63acdcc85e
commit 63acdcc85e
parent 6b13f8b70a 35c1e38835
6 changed files with 220 additions and 57 deletions
--- a/docs/en/interfaces/third-party/gui.md
+++ b/docs/en/interfaces/third-party/gui.md
@ -113,6 +113,22 @@ Features:

 [MindsDB](https://mindsdb.com/) is an open-source AI layer for databases including ClickHouse that allows you to effortlessly develop, train and deploy state-of-the-art machine learning models. MindsDB Studio(GUI) allows you to train new models from database, interpret predictions made by the model, identify potential data biases, and evaluate and visualize model accuracy using the Explainable AI function to adapt and tune your Machine Learning models faster.

+### DBM {#dbm}
+
+[DBM](https://dbm.incubator.edurt.io/) DBM is a visual management tool for ClickHouse!
+
+Features:
+
+-   Support query history (pagination, clear all, etc.)
+-   Support selected sql clauses query
+-   Support terminating query
+-   Support table management (metadata, delete, preview)
+-   Support database management (delete, create)
+-   Support custom query
+-   Support multiple data sources management(connection test, monitoring)
+-   Support monitor (processor, connection, query)
+-   Support migrate data
+
 ## Commercial {#commercial}

 ### DataGrip {#datagrip}
@ -190,20 +206,4 @@ SeekTable is [free](https://www.seektable.com/help/cloud-pricing) for personal/i

 [Chadmin](https://github.com/bun4uk/chadmin) is a simple UI where you can visualize your currently running queries on your ClickHouse cluster and info about them and kill them if you want.

-### DBM {#dbm}
-
-[DBM](https://dbm.incubator.edurt.io/) DBM is a visual management tool for ClickHouse!
-
-Features:
-
-   Support query history (pagination, clear all, etc.)
-   Support selected sql clauses query
-   Support terminating query
-   Support table management (metadata, delete, preview)
-   Support database management (delete, create)
-   Support custom query
-   Support multiple data sources management(connection test, monitoring)
-   Support monitor (processor, connection, query)
-   Support migrate data
-
 [Original article](https://clickhouse.tech/docs/en/interfaces/third-party/gui/) <!--hide-->
--- a/docs/zh/commercial/cloud.md
+++ b/docs/zh/commercial/cloud.md
@ -6,13 +6,13 @@ toc_title: 云
 # ClickHouse 云服务提供商 {#clickhouse-cloud-service-providers}

 !!! info "注意"
-    如果您已经推出具有托管 ClickHouse 服务的公共云，请随时[提交一个 pull request](https://github.com/ClickHouse/ClickHouse/edit/master/docs/en/commercial/cloud.md) 将其添加到以下列表。
+    如果您已经推出具有托管ClickHouse服务的公共云，请随时[提交一个 pull request](https://github.com/ClickHouse/ClickHouse/edit/master/docs/en/commercial/cloud.md)将其添加到以下列表。

 ## Yandex 云 {#yandex-cloud}

-[Yandex的 ClickHouse 托管服务](https://cloud.yandex.com/services/managed-clickhouse?utm_source=referrals&utm_medium=clickhouseofficialsite&utm_campaign=link3) 提供以下主要功能:
+[Yandex ClickHouse托管服务](https://cloud.yandex.com/services/managed-clickhouse?utm_source=referrals&utm_medium=clickhouseofficialsite&utm_campaign=link3)提供以下主要功能:

-   用于 ClickHouse 复制的完全托管的 ZooKeeper 服务 [ClickHouse复制](../engines/table-engines/mergetree-family/replication.md)
+-   用于[ClickHouse replication](../engines/table-engines/mergetree-family/replication.md)的完全托管的ZooKeeper服务
 -   多种存储类型选择
 -   不同可用区副本
 -   加密与隔离
@ -20,34 +20,43 @@ toc_title: 云

 ## Altinity.Cloud {#altinity.cloud}

-[Altinity.Cloud](https://altinity.com/cloud-database/) 是针对 Amazon 公共云的完全托管的 ClickHouse-as-a-Service
+[Altinity.Cloud](https://altinity.com/cloud-database/)是针对Amazon公共云的完全托管的ClickHouse-as-a-Service

-   在 Amazon 资源上快速部署 ClickHouse 集群
+-   在Amazon资源上快速部署ClickHouse集群
 -   轻松进行横向扩展/纵向扩展以及节点的垂直扩展
 -   具有公共端点或VPC对等的租户隔离
 -   可配置存储类型以及卷配置
 -   跨可用区扩展以实现性能和高可用性
 -   内置监控和SQL查询编辑器

-## 阿里云 {#alibaba-cloud}
+## 阿里云{#alibaba-cloud}

-[阿里云的 ClickHouse 托管服务](https://www.alibabacloud.com/zh/product/clickhouse) 提供以下主要功能：
+[阿里云ClickHouse托管服务](https://www.alibabacloud.com/zh/product/clickhouse)提供以下主要功能：

-   基于阿里飞天分布式系统的高可靠云盘存储引擎
-   按需扩容，无需手动进行数据搬迁
-   支持单节点、单副本、多节点、多副本多种架构，支持冷热数据分层
-   支持访问白名单和一键恢复，多层网络安全防护，云盘加密
-   与云上日志系统、数据库、数据应用工具无缝集成
-   内置监控和数据库管理平台
-   专业的数据库专家技术支持和服务
+- 基于阿里飞天分布式系统的高可靠云盘存储引擎
+- 按需扩容，无需手动进行数据搬迁
+- 支持单节点、单副本、多节点、多副本多种架构，支持冷热数据分层
+- 支持访问白名单和一键恢复，多层网络安全防护，云盘加密
+- 与云上日志系统、数据库、数据应用工具无缝集成
+- 内置监控和数据库管理平台
+- 专业的数据库专家技术支持和服务
+
+## SberCloud {#sbercloud}
+
+[SberCloud.Advanced](https://sbercloud.ru/en/advanced)提供[MapReduce Service (MRS)](https://docs.sbercloud.ru/mrs/ug/topics/ug__clickhouse.html), 一个可靠、安全且易于使用的企业级平台，用于存储、处理和分析大数据。MRS允许您快速创建和管理ClickHouse集群。
+
+-   一个ClickHouse实例由三个ZooKeeper节点和多个ClickHouse节点组成。 Dedicated Replica模式用于保证双数据副本的高可靠性。
+-   MRS提供平滑弹性伸缩能力，快速满足集群存储容量或CPU计算资源不足场景下的业务增长需求。当您扩展集群中ClickHouse节点的容量时，MRS提供一键式数据平衡工具，让您主动进行数据平衡。 您可以根据业务特点确定数据均衡方式和时间，保证业务的可用性，实现平滑扩展。
+-   MRS采用弹性负载均衡保障高可用部署架构，自动将用户访问流量分配到多个后端节点，将服务能力扩展到外部系统，提高容错能力。 通过ELB轮询机制，数据写入本地表，从不同节点的分布式表中读取。 这样就保证了数据读写负载和应用访问的高可用。

 ## 腾讯云 {#tencent-cloud}

-[腾讯云的 ClickHouse 托管服务](https://cloud.tencent.com/product/cdwch)提供以下主要功能：
+[腾讯云ClickHouse托管服务](https://cloud.tencent.com/product/cdwch)提供以下主要功能：

-   易于部署和管理, 集成监控与警报服务
-   高可用高扩展
-   通过集群级别的 VPC 保证安全可靠
-   按需定价，无需前期成本或长期承诺
+-   易于在腾讯云上部署和管理
+-   高度可扩展和可用
+-   集成监控和警报服务
+-   每个集群VPC隔离的高安全性
+-   按需定价，无前期成本或长期承诺

 {## [原始文章](https://clickhouse.tech/docs/en/commercial/cloud/) ##}
--- a/docs/zh/commercial/index.md
+++ b/docs/zh/commercial/index.md
@ -6,7 +6,7 @@ toc_title: 简介

 # ClickHouse 商业服务 {#clickhouse-commercial-services}

-本节是专门从事 ClickHouse 的服务提供商的目录，它们是一些独立的公司，不一定与 Yandex 有关系。
+此部分是专门从事ClickHouse的商业服务提供商的目录。 他们是独立的公司，不一定隶属于Yandex。

 服务类别：

@ -14,4 +14,4 @@ toc_title: 简介
 -	[支持](../commercial/support.md)

 !!! note "对于服务提供商"
-如果您碰巧是其中之一，可以随时提交一个 pull request，将您的公司添加到对应的章节（如果服务不属于现有的任何目录，也可以添加新的章节）。提交关于文档的 pull request 最简单的方式是点击右上角的“铅笔”编辑按钮。如果您的服务在某些本地市场上有售，请确保在本地化的文档界面中也提及它（或至少在 pull request 请求描述中指出）。
+    如果您碰巧代表其中之一，请随时提交一个pull request，将您的公司添加到相应部分（如果服务不适合现有类别，甚至可以添加新部分）。 提交关于文档的pull request最简单的方式是点击右上角的“铅笔”编辑按钮。 如果您的服务在某些本地市场可用，请确保也在本地化文档页面中提及它（或至少在pull request请求描述中指出）。
--- a/docs/zh/commercial/support.md
+++ b/docs/zh/commercial/support.md
@ -6,16 +6,20 @@ toc_title: 支持
 # ClickHouse 商业支持服务提供商 {#clickhouse-commercial-support-service-providers}

 !!! info "注意"
-    如果您已经推出 ClickHouse 商业支持服务，请随时[提交一个 pull request](https://github.com/ClickHouse/ClickHouse/edit/master/docs/en/commercial/support.md) 将其添加到以下列表。
+    如果您已经推出ClickHouse商业支持服务，请随时[提交一个pull request](https://github.com/ClickHouse/ClickHouse/edit/master/docs/en/commercial/support.md)将其添加到以下列表。
+
+## Yandex.Cloud
+
+来自ClickHouse作者的ClickHouse全球支持。 支持内部部署和云部署。 在clickhouse-support@yandex-team.com上询问详细信息

 ## Altinity {#altinity}

- Altinity 自从 2017 年开始为企业提供 ClickHouse 支持服务。Altinity 的客户范围包含百强企业到初创企业等。访问 [www.altinity.com](https://www.altinity.com/) 了解更多信息。
+Altinity自2017年以来一直为企业ClickHouse提供支持和服务。 Altinity的客户范围从财富100强企业到初创公司。访问 [www.altinity.com](https://www.altinity.com/)了解更多信息。

 ## Mafiree {#mafiree}

-[服务说明](http://mafiree.com/clickhouse-analytics-services.php)
+[Service description](http://mafiree.com/clickhouse-analytics-services.php)

 ## MinervaDB {#minervadb}

-[服务说明](https://minervadb.com/index.php/clickhouse-consulting-and-support-by-minervadb/)
+[Service description](https://minervadb.com/index.php/clickhouse-consulting-and-support-by-minervadb/)
--- a/docs/zh/development/adding_test_queries.md
+++ b/docs/zh/development/adding_test_queries.md
@ -0,0 +1,150 @@
+# 如何将测试查询添加到 ClickHouse CI
+
+ClickHouse有数百个（甚至数千个）功能。 每个提交都由包含数千个测试用例的一组复杂测试进行检查。
+
+核心功能经过了很多的测试，但是ClickHouse CI可以发现一些极端情况和不同的功能组合。
+
+我们看到的大多数错误/回归都发生在测试覆盖率较差的`灰色区域`中。
+
+我们非常有兴趣通过测试涵盖实现生活中使用的大多数可能的场景和功能组合。
+
+## 为什么要添加测试
+
+为什么/何时应将测试用例添加到ClickHouse代码中：
+1) 您使用了一些复杂的场景/功能组合/您有一些可能未被广泛使用的情况
+2) 您会看到更改日志中没有通知的版本之间的某些行为发生了变化
+3) 您只是想帮助提高ClickHouse的质量并确保您使用的功能在未来的版本中不会被破坏
+4) 一旦测试被添加/接受，您可以确保您检查的角落案例永远不会被意外损坏。
+5) 你将成为伟大的开源社区的一份子
+6) 您的名字将出现在`system.contributors`表中！
+7) 你会让世界变得更好。
+
+### 要做的步骤
+
+#### 先决条件
+
+我假设你运行一些Linux机器（你可以在其他操作系统上使用 docker/虚拟机）和任何现代浏览器/互联网连接，并且你有一些基本的Linux和SQL技能。
+
+不需要任何高度专业化的知识（因此您不需要了解 C++ 或了解ClickHouse CI的工作原理）。
+
+#### 准备
+
+1) [create GitHub account](https://github.com/join) (如果你还没有)
+2) [setup git](https://docs.github.com/en/free-pro-team@latest/github/getting-started-with-github/set-up-git)
+```bash
+# for Ubuntu
+sudo apt-get update
+sudo apt-get install git
+
+git config --global user.name "John Doe" # fill with your name
+git config --global user.email "email@example.com" # fill with your email
+
+```
+3) [fork ClickHouse project](https://docs.github.com/en/free-pro-team@latest/github/getting-started-with-github/fork-a-repo) - 打开 [https://github.com/ClickHouse/ClickHouse](https://github.com/ClickHouse/ClickHouse) and press fork button in the top right corner:
+   ![fork repo](https://github-images.s3.amazonaws.com/help/bootcamp/Bootcamp-Fork.png)
+
+4) 例如，将代码fork克隆到PC上的某个文件夹, `~/workspace/ClickHouse`
+```
+mkdir ~/workspace && cd ~/workspace
+git clone https://github.com/< your GitHub username>/ClickHouse
+cd ClickHouse
+git remote add upstream https://github.com/ClickHouse/ClickHouse
+```
+
+#### 测试的新分支
+
+1) 从最新的clickhouse master创建一个新分支
+```
+cd ~/workspace/ClickHouse
+git fetch upstream
+git checkout -b name_for_a_branch_with_my_test upstream/master
+```
+
+#### 安装并运行 clickhouse
+
+1) 安装`clickhouse-server` (参考[离线文档](https://clickhouse.tech/docs/en/getting-started/install/))
+2) 安装测试配置（它将使用Zookeeper模拟实现并调整一些设置）
+```
+cd ~/workspace/ClickHouse/tests/config
+sudo ./install.sh
+```
+3) 运行clickhouse-server
+```
+sudo systemctl restart clickhouse-server
+```
+
+#### 创建测试文件
+
+
+1) 找到测试的编号 - 在`tests/queries/0_stateless/`中找到编号最大的文件
+
+```sh
+$ cd ~/workspace/ClickHouse
+$ ls tests/queries/0_stateless/[0-9]*.reference | tail -n 1
+tests/queries/0_stateless/01520_client_print_query_id.reference
+```
+目前，测试的最后一个数字是`01520`，所以我的测试将有数字`01521`
+
+2) 使用您测试的功能的下一个编号和名称创建一个SQL文件
+
+```sh
+touch tests/queries/0_stateless/01521_dummy_test.sql
+```
+
+3) 使用您最喜欢的编辑器编辑SQL文件（请参阅下面的创建测试提示）
+```sh
+vim tests/queries/0_stateless/01521_dummy_test.sql
+```
+
+
+4) 运行测试，并将其结果放入参考文件中：
+```
+clickhouse-client -nmT < tests/queries/0_stateless/01521_dummy_test.sql | tee tests/queries/0_stateless/01521_dummy_test.reference
+```
+
+5) 确保一切正确，如果测试输出不正确（例如由于某些错误），请使用文本编辑器调整参考文件。
+
+#### 如何创建一个好的测试
+
+- 测试应该是
+    - 最小 - 仅创建与测试功能相关的表，删除不相关的列和部分查询
+    - 快速 - 不应超过几秒钟（更好的亚秒）
+    - 正确 - 失败则功能不起作用
+        - 确定性的
+    - 隔离/无状态
+        - 不要依赖一些环境的东西
+        - 尽可能不要依赖时间
+- 尝试覆盖极端情况(zeros / Nulls / empty sets / throwing exceptions)
+- 要测试该查询返回错误，您可以在查询后添加特殊注释：`-- { serverError 60 }`或`-- { clientError 20 }`
+- 不要切换数据库（除非必要）
+- 如果需要，您可以在同一节点上创建多个表副本
+- 您可以在需要时使用测试集群定义之一（请参阅 system.clusters）
+- 使用 `number` / `numbers_mt` / `zeros` / `zeros_mt`和类似的查询要在适用时初始化数据
+- 在测试之后和测试之前清理创建的对象（DROP IF EXISTS） - 在有一些脏状态的情况下
+- 优先选择同步操作模式 (mutations, merges)
+- 以`0_stateless`文件夹中的其他SQL文件为例
+- 确保您想要测试的特性/特性组合尚未被现有测试覆盖
+
+#### 测试命名规则
+
+正确地命名测试非常重要，因此可以在clickhouse-test调用中关闭一些测试子集。
+
+| Tester flag| 测试名称中应该包含什么 | 什么时候应该添加标志 |
+|---|---|---|---|
+| `--[no-]zookeeper`| "zookeeper"或"replica" | 测试使用来自ReplicatedMergeTree家族的表 |
+| `--[no-]shard` | "shard"或"distributed"或"global"| 使用到127.0.0.2或类似的连接进行测试 |
+| `--[no-]long` | "long"或"deadlock"或"race" | 测试运行时间超过60秒 |
+
+#### Commit / push / 创建PR.
+
+1) commit & push您的修改
+```sh
+cd ~/workspace/ClickHouse
+git add tests/queries/0_stateless/01521_dummy_test.sql
+git add tests/queries/0_stateless/01521_dummy_test.reference
+git commit # use some nice commit message when possible
+git push origin HEAD
+```
+2) 使用一个在推送过程中显示的链接，创建一个到master的PR
+3) 调整PR标题和内容，在`Changelog category (leave one)`中保留
+   `Build/Testing/Packaging Improvement`，如果需要，请填写其余字段。
--- a/docs/zh/interfaces/third-party/gui.md
+++ b/docs/zh/interfaces/third-party/gui.md
@ -72,6 +72,22 @@ ClickHouse Web 界面 [Tabix](https://github.com/tabixio/tabix).

    [clickhouse-flamegraph](https://github.com/Slach/clickhouse-flamegraph) 是一个可视化的专业工具`system.trace_log`如[flamegraph](http://www.brendangregg.com/flamegraphs.html).

+### DBM {#dbm}
+
+[DBM](https://dbm.incubator.edurt.io/) DBM是一款ClickHouse可视化管理工具!
+
+特征：
+
+-   支持查询历史（分页、全部清除等）
+-   支持选中的sql子句查询(多窗口等)
+-   支持终止查询
+-   支持表管理
+-   支持数据库管理
+-   支持自定义查询
+-   支持多数据源管理（连接测试、监控）
+-   支持监控（处理进程、连接、查询）
+-   支持迁移数据
+
 ## 商业 {#shang-ye}

 ### Holistics {#holistics-software}
@ -99,20 +115,4 @@ ClickHouse Web 界面 [Tabix](https://github.com/tabixio/tabix).
 -   重构。
 -   搜索和导航。

-### DBM {#dbm}
-
-[DBM](https://dbm.incubator.edurt.io/) DBM是一款ClickHouse可视化管理工具!
-
-特征：
-
-   支持查询历史（分页、全部清除等）
-   支持选中的sql子句查询(多窗口等)
-   支持终止查询
-   支持表管理
-   支持数据库管理
-   支持自定义查询
-   支持多数据源管理（连接测试、监控）
-   支持监控（处理进程、连接、查询）
-   支持迁移数据
-
 [来源文章](https://clickhouse.tech/docs/zh/interfaces/third-party/gui/) <!--hide-->