update zh-docs-operations (#11192)

2024-11-21 15:12:02 +00:00 · 2020-05-26 13:43:19 +08:00 · 2020-05-26 13:43:19 +08:00 · 7fac670657
commit 7fac670657
parent c858f4d89c
7 changed files with 170 additions and 116 deletions
--- a/docs/en/operations/troubleshooting.md
+++ b/docs/en/operations/troubleshooting.md
@ -116,7 +116,7 @@ Check:
    Check:

    -   The [tcp\_port\_secure](server-configuration-parameters/settings.md#server_configuration_parameters-tcp_port_secure) setting.
-    -   Settings for [SSL sertificates](server-configuration-parameters/settings.md#server_configuration_parameters-openssl).
+    -   Settings for [SSL certificates](server-configuration-parameters/settings.md#server_configuration_parameters-openssl).

    Use proper parameters while connecting. For example, use the `port_secure` parameter with `clickhouse_client`.

--- a/docs/zh/operations/access-rights.md
+++ b/docs/zh/operations/access-rights.md
@ -1,101 +1,146 @@
-# 访问权限 {#access-rights}
+---
+toc_priority: 48
+toc_title: "访问权限和账户管理"
+---

-用户和访问权限在用户配置中设置。 这通常是 `users.xml`.
+# 访问权限和账户管理 {#access-rights}
+ClickHouse支持基于[RBAC](https://en.wikipedia.org/wiki/Role-based_access_control)的访问控制管理。

-用户被记录在 `users` 科。 这里是一个片段 `users.xml` 文件:
+ClickHouse权限实体包括：
+- [用户账户](#user-account-management)
+- [角色](#role-management)
+- [行策略](#row-policy-management)
+- [设置描述](#settings-profiles-management)
+- [配额](#quotas-management)

-``` xml
-<!-- Users and ACL. -->
-<users>
-    <!-- If the user name is not specified, the 'default' user is used. -->
-    <default>
-        <!-- Password could be specified in plaintext or in SHA256 (in hex format).
+你可以通过如下方式配置权限实体：

-             If you want to specify password in plaintext (not recommended), place it in 'password' element.
-             Example: <password>qwerty</password>.
-             Password could be empty.
+- 通过SQL驱动的工作流方式.

-             If you want to specify SHA256, place it in 'password_sha256_hex' element.
-             Example: <password_sha256_hex>65e84be33532fb784c48129675f9eff3a682b27168c0ea744b2cf58ee02337c5</password_sha256_hex>
+    你需要[开启](#enabling-access-control)这个功能.

-             How to generate decent password:
-             Execute: PASSWORD=$(base64 < /dev/urandom | head -c8); echo "$PASSWORD"; echo -n "$PASSWORD" | sha256sum | tr -d '-'
-             In first line will be password and in second - corresponding SHA256.
-        -->
-        <password></password>
+- 服务端[配置文件](configuration-files.md) `users.xml` 和 `config.xml`.

-        <!-- A list of networks that access is allowed from.
-            Each list item has one of the following forms:
-            <ip> The IP address or subnet mask. For example: 198.51.100.0/24 or 2001:DB8::/32.
-            <host> Host name. For example: example01. A DNS query is made for verification, and all addresses obtained are compared with the address of the customer.
-            <host_regexp> Regular expression for host names. For example, ^example\d\d-\d\d-\d\.yandex\.ru$
-                To check it, a DNS PTR request is made for the client's address and a regular expression is applied to the result.
-                Then another DNS query is made for the result of the PTR query, and all received address are compared to the client address.
-                We strongly recommend that the regex ends with \.yandex\.ru$.
+我们建议你使用SQL工作流的方式。当然配置的方式也可以同时起作用, 所以如果你正在用服务端配置的方式来管理权限和账户，你可以平滑的切换到SQL驱动的工作流方式。

-            If you are installing ClickHouse yourself, specify here:
-                <networks>
-                        <ip>::/0</ip>
-                </networks>
-        -->
-        <networks incl="networks" />
+!!! note "警告"
+    你无法同时使用两个配置的方式来管理同一个权限实体。

-        <!-- Settings profile for the user. -->
-        <profile>default</profile>

-        <!-- Quota for the user. -->
-        <quota>default</quota>
-    </default>
+## 用法 {#access-control-usage}

-    <!-- For requests from the Yandex.Metrica user interface via the API for data on specific counters. -->
-    <web>
-        <password></password>
-        <networks incl="networks" />
-        <profile>web</profile>
-        <quota>default</quota>
-        <allow_databases>
-           <database>test</database>
-        </allow_databases>
-    </web>
-```
+默认ClickHouse提供了一个 `default` 账号，这个账号有所有的权限，但是不能使用SQL驱动方式的访问权限和账户管理。`default`主要用在用户名还未设置的情况，比如从客户端登录或者执行分布式查询。在分布式查询中如果服务端或者集群没有指定[用户名密码](../engines/table-engines/special/distributed.md)那默认的账户就会被使用。

-您可以看到两个用户的声明: `default`和`web`. 我们添加了 `web` 用户分开。
+如果你刚开始使用ClickHouse，考虑如下场景：

-该 `default` 在用户名未通过的情况下选择用户。 该 `default` 如果服务器或群集的配置没有指定分布式查询处理，则user也用于分布式查询处理 `user` 和 `password` （见上的部分 [分布](../engines/table-engines/special/distributed.md) 发动机）。
+1. 为 `default` 用户[开启SQL驱动方式的访问权限和账户管理](#enabling-access-control) .
+2. 使用 `default` 用户登录并且创建所需要的所有用户。 不要忘记创建管理员账户 (`GRANT ALL ON *.* WITH GRANT OPTION TO admin_user_account`)。
+3. [限制](settings/permissions-for-queries.md#permissions_for_queries) `default` 用户的权限并且禁用SQL驱动方式的访问权限和账户管理。

-The user that is used for exchanging information between servers combined in a cluster must not have substantial restrictions or quotas – otherwise, distributed queries will fail.
+### 当前解决方案的特性 {#access-control-properties}

-密码以明文（不推荐）或SHA-256形式指定。 哈希没有腌制。 在这方面，您不应将这些密码视为提供了针对潜在恶意攻击的安全性。 相反，他们是必要的保护员工。
+- 你甚至可以在数据库和表不存在的时候授予权限。
+- 如果表被删除，和这张表关联的特权不会被删除。这意味着如果你创建一张同名的表，所有的特权仍旧有效。如果想删除这张表关联的特权，你可以执行 `REVOKE ALL PRIVILEGES ON db.table FROM ALL`  查询。
+- 特权没有生命周期。

-指定允许访问的网络列表。 在此示例中，将从单独的文件加载两个用户的网络列表 (`/etc/metrika.xml`）包含 `networks` 替代。 这里是它的一个片段:
+## 用户账户 {#user-account-management}

-``` xml
-<yandex>
-    ...
-    <networks>
-        <ip>::/64</ip>
-        <ip>203.0.113.0/24</ip>
-        <ip>2001:DB8::/32</ip>
-        ...
-    </networks>
-</yandex>
-```
+用户账户是权限实体，用来授权操作ClickHouse，用户账户包含：

-您可以直接在以下内容中定义此网络列表 `users.xml`，或在文件中 `users.d` directory (for more information, see the section «[配置文件](configuration-files.md#configuration_files)»).
+- 标识符信息。
+- [特权](../sql-reference/statements/grant.md#grant-privileges)用来定义用户可以执行的查询的范围。
+- 可以连接到ClickHouse的主机。
+- 指定或者默认的角色。
+- 用户登录的时候默认的限制设置。
+- 指定的设置描述。

-该配置包括解释如何从任何地方打开访问的注释。
+特权可以通过[GRANT](../sql-reference/statements/grant.md)查询授权给用户或者通过[角色](#role-management)授予。如果想撤销特权，可以使用[REVOKE](../sql-reference/statements/revoke.md)查询。查询用户所有的特权，使用[SHOW GRANTS](../sql-reference/statements/show.md#show-grants-statement)语句。

-对于在生产中使用，仅指定 `ip` 元素（IP地址及其掩码），因为使用 `host` 和 `hoost_regexp` 可能会导致额外的延迟。
+查询管理：

-Next the user settings profile is specified (see the section «[设置配置文件](settings/settings-profiles.md)»). You can specify the default profile, `default'`. 配置文件可以有任何名称。 您可以为不同的用户指定相同的配置文件。 您可以在设置配置文件中编写的最重要的事情是 `readonly=1`，这确保只读访问。
-Then specify the quota to be used (see the section «[配额](quotas.md#quotas)»). You can specify the default quota: `default`. It is set in the config by default to only count resource usage, without restricting it. The quota can have any name. You can specify the same quota for different users – in this case, resource usage is calculated for each user individually.
+- [CREATE USER](../sql-reference/statements/create.md#create-user-statement)
+- [ALTER USER](../sql-reference/statements/alter.md#alter-user-statement)
+- [DROP USER](../sql-reference/statements/misc.md#drop-user-statement)
+- [SHOW CREATE USER](../sql-reference/statements/show.md#show-create-user-statement)

-在可选 `<allow_databases>` 您还可以指定用户可以访问的数据库列表。 默认情况下，所有数据库都可供用户使用。 您可以指定 `default` 数据库。 在这种情况下，默认情况下，用户将接收对数据库的访问权限。
+### 设置应用规则 {#access-control-settings-applying}

-访问 `system` 始终允许数据库（因为此数据库用于处理查询）。
+对于一个用户账户来说，设置可以通过多种方式配置：通过角色扮演和设置描述。对于一个登陆的账号来说，如果一个设置对应了多个不同的权限实体，这些设置的应用规则如下（优先权从高到底）：

-用户可以通过以下方式获取其中所有数据库和表的列表 `SHOW` 查询或系统表，即使不允许访问单个数据库。
+1. 用户账户设置。
+2. 用户账号默认的角色设置。如果这个设置配置了多个角色，那设置的应用是没有规定的顺序。
+3. 从设置描述分批给用户或者角色的设置。如果这个设置配置了多个角色，那设置的应用是没有规定的顺序。
+4. 对所有服务器有效的默认或者[default profile](server-configuration-parameters/settings.md#default-profile)的设置。

-数据库访问是不相关的 [只读](settings/permissions-for-queries.md#settings_readonly) 设置。 您不能授予对一个数据库的完全访问权限，并 `readonly` 进入另一个。

-[原始文章](https://clickhouse.tech/docs/en/operations/access_rights/) <!--hide-->
+## 角色 {#role-management}
+
+角色是权限实体的集合，可以被授予用户账号。
+
+角色包括：
+
+- [特权](../sql-reference/statements/grant.md#grant-privileges)
+- 设置和限制
+- 分配的角色列表
+
+查询管理:
+
+- [CREATE ROLE](../sql-reference/statements/create.md#create-role-statement)
+- [ALTER ROLE](../sql-reference/statements/alter.md#alter-role-statement)
+- [DROP ROLE](../sql-reference/statements/misc.md#drop-role-statement)
+- [SET ROLE](../sql-reference/statements/misc.md#set-role-statement)
+- [SET DEFAULT ROLE](../sql-reference/statements/misc.md#set-default-role-statement)
+- [SHOW CREATE ROLE](../sql-reference/statements/show.md#show-create-role-statement)
+
+使用[GRANT](../sql-reference/statements/grant.md) 查询可以把特权授予给角色。用[REVOKE](../sql-reference/statements/revoke.md)来撤回特权。
+
+## 行策略 {#row-policy-management}
+
+行策略是一个过滤器，用来定义哪些行数据可以被账户或者角色访问。对一个特定的表来说，行策略包括过滤器和使用这个策略的账户和角色。
+
+查询管理：
+
+- [CREATE ROW POLICY](../sql-reference/statements/create.md#create-row-policy-statement)
+- [ALTER ROW POLICY](../sql-reference/statements/alter.md#alter-row-policy-statement)
+- [DROP ROW POLICY](../sql-reference/statements/misc.md#drop-row-policy-statement)
+- [SHOW CREATE ROW POLICY](../sql-reference/statements/show.md#show-create-row-policy-statement)
+
+
+## 设置描述 {#settings-profiles-management}
+
+设置描述是[设置](settings/index.md)的汇总。设置汇总包括设置和限制，当然也包括这些描述的对象：角色和账户。
+
+查询管理:
+
+- [CREATE SETTINGS PROFILE](../sql-reference/statements/create.md#create-settings-profile-statement)
+- [ALTER SETTINGS PROFILE](../sql-reference/statements/alter.md#alter-settings-profile-statement)
+- [DROP SETTINGS PROFILE](../sql-reference/statements/misc.md#drop-settings-profile-statement)
+- [SHOW CREATE SETTINGS PROFILE](../sql-reference/statements/show.md#show-create-settings-profile-statement)
+
+
+## 配额 {#quotas-management}
+
+配额用来限制资源的使用情况。参考[配额](quotas.md).
+
+配额包括特定时间的限制条件和使用这个配额的账户和角色。
+
+Management queries:
+
+- [CREATE QUOTA](../sql-reference/statements/create.md#create-quota-statement)
+- [ALTER QUOTA](../sql-reference/statements/alter.md#alter-quota-statement)
+- [DROP QUOTA](../sql-reference/statements/misc.md#drop-quota-statement)
+- [SHOW CREATE QUOTA](../sql-reference/statements/show.md#show-create-quota-statement)
+
+
+## 开启SQL驱动方式的访问权限和账户管理 {#enabling-access-control}
+
+- 为配置的存储设置一个目录.
+
+    ClickHouse把访问实体的相关配置存储在[访问控制目录](server-configuration-parameters/settings.md#access_control_path)，而这个目录可以通过服务端进行配置.
+
+- 为至少一个账户开启SQL驱动方式的访问权限和账户管理.
+
+     默认情况，SQL驱动方式的访问权限和账户管理对所有用户都是关闭的。你需要在 `users.xml` 中配置至少一个用户，并且把[权限管理](settings/settings-users.md#access_management-user-setting)的值设置为1。
+
+
+[Original article](https://clickhouse.tech/docs/en/operations/access_rights/) <!--hide-->
--- a/docs/zh/operations/index.md
+++ b/docs/zh/operations/index.md
@ -1,3 +1,13 @@
+---
+toc_priority: 43
+toc_title: "操作"
+---
+
 # 操作 {#operations}

+Clickhouse运维手册主要包含下面几部分：
+
+- 安装要求
+
+
 [原始文章](https://clickhouse.tech/docs/en/operations/) <!--hide-->
--- a/docs/zh/operations/monitoring.md
+++ b/docs/zh/operations/monitoring.md
@ -1,3 +1,8 @@
+---
+toc_priority: 45
+toc_title: "监控"
+---
+
 # 监控 {#jian-kong}

 可以监控到：
@ -13,7 +18,7 @@ ClickHouse 本身不会去监控硬件资源的状态。

 -   处理器上的负载和温度。

-        可以使用 [dmesg](https://en.wikipedia.org/wiki/Dmesg), [turbostat](https://www.linux.org/docs/man8/turbostat.html) 或者其他工具。
+       可以使用[dmesg](https://en.wikipedia.org/wiki/Dmesg), [turbostat](https://www.linux.org/docs/man8/turbostat.html)或者其他工具。

 -   磁盘存储，RAM和网络的使用率。

@ -21,17 +26,17 @@ ClickHouse 本身不会去监控硬件资源的状态。

 ClickHouse服务本身具有用于自我状态监视指标。

-要跟踪服务器事件，请观察服务器日志。 请参阅配置文件的\[logger\]（server\_settings/settings.md\#server\_settings-logger）部分。
+要跟踪服务器事件，请观察服务器日志。 请参阅配置文件的 [logger](server-configuration-parameters/settings.md#server_configuration_parameters-logger)部分。

 ClickHouse 收集的指标项：

 -   服务用于计算的资源占用的各种指标。
 -   关于查询处理的常见统计信息。

-可以在 [系统。指标](system-tables.md#system_tables-metrics) ，[系统。活动](system-tables.md#system_tables-events) 以及[系统。asynchronous\_metrics](system-tables.md#system_tables-asynchronous_metrics) 等系统表查看所有的指标项。
+可以在 [系统指标](system-tables.md#system_tables-metrics) ，[系统事件](system-tables.md#system_tables-events) 以及[系统异步指标](system-tables.md#system_tables-asynchronous_metrics) 等系统表查看所有的指标项。

 可以配置ClickHouse 往 [石墨](https://github.com/graphite-project)导入指标。 参考 [石墨部分](server-configuration-parameters/settings.md#server_configuration_parameters-graphite) 配置文件。在配置指标导出之前，需要参考Graphite[官方教程](https://graphite.readthedocs.io/en/latest/install.html)搭建服务。

 此外，您可以通过HTTP API监视服务器可用性。 将HTTP GET请求发送到 `/ping`。 如果服务器可用，它将以 `200 OK` 响应。

-要监视服务器集群的配置中，应设置[max\_replica\_delay\_for\_distributed\_queries](settings/settings.md#settings-max_replica_delay_for_distributed_queries)参数并使用HTTP资源`/replicas_status`。 如果副本可用，并且不延迟在其他副本之后，则对`/replicas_status`的请求将返回200 OK。 如果副本滞后，请求将返回 `503 HTTP_SERVICE_UNAVAILABLE`，包括有关待办事项大小的信息。
+要监视服务器集群的配置，应设置[max\_replica\_delay\_for\_distributed\_queries](settings/settings.md#settings-max_replica_delay_for_distributed_queries)参数并使用HTTP资源`/replicas_status`。 如果副本可用，并且不延迟在其他副本之后，则对`/replicas_status`的请求将返回200 OK。 如果副本滞后，请求将返回 `503 HTTP_SERVICE_UNAVAILABLE`，包括有关待办事项大小的信息。
--- a/docs/zh/operations/requirements.md
+++ b/docs/zh/operations/requirements.md
@ -1,8 +1,6 @@
 ---
-machine_translated: true
-machine_translated_rev: 72537a2d527c63c07aa5d2361a8829f3895cf2bd
 toc_priority: 44
-toc_title: "\u8981\u6C42"
+toc_title: "要求"
 ---

 # 要求 {#requirements}
@ -13,20 +11,20 @@ toc_title: "\u8981\u6C42"

 ClickHouse实现并行数据处理并使用所有可用的硬件资源。 在选择处理器时，考虑到ClickHouse在具有大量内核但时钟速率较低的配置中的工作效率要高于具有较少内核和较高时钟速率的配置。 例如，具有2600MHz的16核心优于具有3600MHz的8核心。

-建议使用 **涡轮增压** 和 **超线程** 技术。 它显着提高了典型工作负载的性能。
+建议使用 **睿频加速** 和 **超线程** 技术。 它显着提高了典型工作负载的性能。

 ## RAM {#ram}

-我们建议使用至少4GB的RAM来执行非平凡的查询。 ClickHouse服务器可以使用少得多的RAM运行，但它需要处理查询的内存。
+我们建议使用至少4GB的RAM来执行重要的查询。 ClickHouse服务器可以使用少得多的RAM运行，但它需要处理查询的内存。

 RAM所需的体积取决于:

 -   查询的复杂性。
-   在查询中处理的数据量。
+-   查询中处理的数据量。

 要计算所需的RAM体积，您应该估计临时数据的大小 [GROUP BY](../sql-reference/statements/select/group-by.md#select-group-by-clause), [DISTINCT](../sql-reference/statements/select/distinct.md#select-distinct), [JOIN](../sql-reference/statements/select/join.md#select-join) 和您使用的其他操作。

-ClickHouse可以使用外部存储器来存储临时数据。 看 [在外部存储器中分组](../sql-reference/statements/select/group-by.md#select-group-by-in-external-memory) 有关详细信息。
+ClickHouse可以使用外部存储器来存储临时数据。看 [在外部存储器中分组](../sql-reference/statements/select/group-by.md#select-group-by-in-external-memory) 有关详细信息。

 ## 交换文件 {#swap-file}

@ -42,20 +40,20 @@ ClickHouse可以使用外部存储器来存储临时数据。 看 [在外部存

    您可以采取数据的样本并从中获取行的平均大小。 然后将该值乘以计划存储的行数。

-   的数据压缩系数。
+-   数据压缩系数。

-    要估计数据压缩系数，请将数据的样本加载到ClickHouse中，并将数据的实际大小与存储的表的大小进行比较。 例如，点击流数据通常被压缩6-10次。
+    要估计数据压缩系数，请将数据的样本加载到ClickHouse中，并将数据的实际大小与存储的表的大小进行比较。 例如，点击流数据通常被压缩6-10倍。

-要计算要存储的最终数据量，请将压缩系数应用于估计的数据量。 如果计划将数据存储在多个副本中，则将估计的卷乘以副本数。
+要计算要存储的最终数据量，请将压缩系数应用于估计的数据量。 如果计划将数据存储在多个副本中，则将估计的量乘以副本数。

 ## 网络 {#network}

 如果可能的话，使用10G或更高级别的网络。

-网络带宽对于处理具有大量中间数据的分布式查询至关重要。 此外，网络速度会影响复制过程。
+网络带宽对于处理具有大量中间结果数据的分布式查询至关重要。 此外，网络速度会影响复制过程。

 ## 软件 {#software}

-ClickHouse主要是为Linux系列操作系统开发的。 推荐的Linux发行版是Ubuntu。 该 `tzdata` 软件包应安装在系统中。
+ClickHouse主要是为Linux系列操作系统开发的。 推荐的Linux发行版是Ubuntu。 `tzdata` 软件包应安装在系统中。

 ClickHouse也可以在其他操作系统系列中工作。 查看详细信息 [开始](../getting-started/index.md) 文档的部分。
--- a/docs/zh/operations/troubleshooting.md
+++ b/docs/zh/operations/troubleshooting.md
@ -1,23 +1,21 @@
 ---
-machine_translated: true
-machine_translated_rev: 72537a2d527c63c07aa5d2361a8829f3895cf2bd
 toc_priority: 46
-toc_title: "\u7591\u96BE\u89E3\u7B54"
+toc_title: "常见问题"
 ---

-# 疑难解答 {#troubleshooting}
+# 常见问题 {#troubleshooting}

-   [安装方式](#troubleshooting-installation-errors)
+-   [安装](#troubleshooting-installation-errors)
 -   [连接到服务器](#troubleshooting-accepts-no-connections)
 -   [查询处理](#troubleshooting-does-not-process-queries)
 -   [查询处理效率](#troubleshooting-too-slow)

-## 安装方式 {#troubleshooting-installation-errors}
+## 安装 {#troubleshooting-installation-errors}

 ### 您无法使用Apt-get从ClickHouse存储库获取Deb软件包 {#you-cannot-get-deb-packages-from-clickhouse-repository-with-apt-get}

 -   检查防火墙设置。
-   如果出于任何原因无法访问存储库，请按照以下文件中的描述下载软件包 [开始](../getting-started/index.md) 文章并使用手动安装它们 `sudo dpkg -i <packages>` 指挥部 您还需要 `tzdata` 包。
+-   如果出于任何原因无法访问存储库，请按照[开始](../getting-started/index.md)中的描述下载软件包，并使用命令 `sudo dpkg -i <packages>` 手动安装它们。除此之外你还需要 `tzdata` 包。

 ## 连接到服务器 {#troubleshooting-accepts-no-connections}

@ -44,7 +42,7 @@ $ sudo service clickhouse-server start

 **检查日志**

-主日志 `clickhouse-server` 是在 `/var/log/clickhouse-server/clickhouse-server.log` 默认情况下。
+主日志 `clickhouse-server` 默认情况是在 `/var/log/clickhouse-server/clickhouse-server.log` 下。

 如果服务器成功启动，您应该看到字符串:

@ -57,13 +55,13 @@ $ sudo service clickhouse-server start
 2019.01.11 15:23:25.549505 [ 45 ] {} <Error> ExternalDictionaries: Failed reloading 'event2id' external dictionary: Poco::Exception. Code: 1000, e.code() = 111, e.displayText() = Connection refused, e.what() = Connection refused
 ```

-如果在文件末尾没有看到错误，请从字符串开始查看整个文件:
+如果在文件末尾没有看到错误，请从如下字符串开始查看整个文件:

 ``` text
 <Information> Application: starting up.
 ```

-如果您尝试启动第二个实例 `clickhouse-server` 在服务器上，您将看到以下日志:
+如果您尝试在服务器上启动第二个实例 `clickhouse-server` ，您将看到以下日志:

 ``` text
 2019.01.11 15:25:11.151730 [ 1 ] {} <Information> : Starting ClickHouse 19.1.0 with revision 54413
@ -79,9 +77,9 @@ Revision: 54413
 2019.01.11 15:25:11.156716 [ 2 ] {} <Information> BaseDaemon: Stop SignalListener thread
 ```

-**请参阅系统。d日志**
+**查看系统日志**

-如果你没有找到任何有用的信息 `clickhouse-server` 日志或没有任何日志，您可以查看 `system.d` 使用命令记录:
+如果你在 `clickhouse-server` 没有找到任何有用的信息或根本没有任何日志，您可以使用命令查看 `system.d` :

 ``` bash
 $ sudo journalctl -u clickhouse-server
@ -99,9 +97,9 @@ $ sudo -u clickhouse /usr/bin/clickhouse-server --config-file /etc/clickhouse-se

 检查:

-   码头工人设置。
+-   Docker设置。

-    如果您在IPv6网络中的Docker中运行ClickHouse，请确保 `network=host` 已设置。
+    如果您在IPv6网络中的Docker中运行ClickHouse，请确保 `network=host` 被设置。

 -   端点设置。

@ -117,10 +115,10 @@ $ sudo -u clickhouse /usr/bin/clickhouse-server --config-file /etc/clickhouse-se

    检查:

-    -   该 [tcp\_port\_secure](server-configuration-parameters/settings.md#server_configuration_parameters-tcp_port_secure) 设置。
-    -   设置 [SSL序列](server-configuration-parameters/settings.md#server_configuration_parameters-openssl).
+    -   [tcp\_port\_secure](server-configuration-parameters/settings.md#server_configuration_parameters-tcp_port_secure) 设置。
+    -   [SSL证书](server-configuration-parameters/settings.md#server_configuration_parameters-openssl) 设置.

-    连接时使用正确的参数。 例如，使用 `port_secure` 参数 `clickhouse_client`.
+    连接时使用正确的参数。 例如，使用 `clickhouse_client` 的时候使用 `port_secure` 参数 .

 -   用户设置。

@ -135,7 +133,7 @@ $ curl 'http://localhost:8123/' --data-binary "SELECT a"
 Code: 47, e.displayText() = DB::Exception: Unknown identifier: a. Note that there are no tables (FROM clause) in your query, context: required_names: 'a' source_tables: table_aliases: private_aliases: column_aliases: public_columns: 'a' masked_columns: array_join_columns: source_columns: , e.what() = DB::Exception
 ```

-如果你开始 `clickhouse-client` 与 `stack-trace` 参数，ClickHouse返回包含错误描述的服务器堆栈跟踪。
+如果你使用 `clickhouse-client` 时设置了 `stack-trace` 参数，ClickHouse返回包含错误描述的服务器堆栈跟踪信息。

 您可能会看到一条关于连接中断的消息。 在这种情况下，可以重复查询。 如果每次执行查询时连接中断，请检查服务器日志中是否存在错误。

--- a/docs/zh/operations/update.md
+++ b/docs/zh/operations/update.md
@ -1,11 +1,9 @@
 ---
-machine_translated: true
-machine_translated_rev: 72537a2d527c63c07aa5d2361a8829f3895cf2bd
 toc_priority: 47
-toc_title: "\u70B9\u51FB\u66F4\u65B0"
+toc_title: "更新"
 ---

-# 点击更新 {#clickhouse-update}
+# 更新 {#clickhouse-update}

 如果从deb包安装ClickHouse，请在服务器上执行以下命令:

@ -15,6 +13,6 @@ $ sudo apt-get install clickhouse-client clickhouse-server
 $ sudo service clickhouse-server restart
 ```

-如果您使用除推荐的deb包之外的其他内容安装ClickHouse，请使用适当的更新方法。
+如果您使用除推荐的deb包之外的其他方式安装ClickHouse，请使用适当的更新方法。

-ClickHouse不支持分布式更新。 该操作应在每个单独的服务器上连续执行。 不要同时更新群集上的所有服务器，否则群集将在一段时间内不可用。
+ClickHouse不支持分布式更新。该操作应在每个单独的服务器上连续执行。不要同时更新群集上的所有服务器，否则群集将在一段时间内不可用。