Skip to content

Commit 32beec0

Browse files
🌐 Add LLM Translations (#864)
* 💬Generate LLM translations * docs: minor update Signed-off-by: Chojan Shang <[email protected]> --------- Signed-off-by: Chojan Shang <[email protected]> Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Chojan Shang <[email protected]>
1 parent f61474b commit 32beec0

13 files changed

+294
-133
lines changed

docs/cn/sql-reference/10-sql-commands/00-ddl/02-user/01-user-create-user.md

Lines changed: 50 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,11 +5,11 @@ sidebar_position: 1
55

66
import FunctionDescription from '@site/src/components/FunctionDescription';
77

8-
<FunctionDescription description="引入或更新版本:v1.2.339"/>
8+
<FunctionDescription description="引入或更新版本:v1.2.424"/>
99

10-
创建一个 SQL 用户,提供用户的名称、认证类型和密码等详细信息。可选地,您可以为用户设置密码策略、网络策略和默认角色
10+
创建一个 SQL 用户。
1111

12-
另见
12+
相关内容
1313

1414
- [创建密码策略](../12-password-policy/create-password-policy.md)
1515
- [创建网络策略](../12-network-policy/ddl-create-policy.md)
@@ -22,10 +22,12 @@ CREATE [ OR REPLACE ] USER <name> IDENTIFIED [ WITH <auth_type> ] BY '<password>
2222
[ WITH SET PASSWORD POLICY = '<policy_name>' ] -- 设置密码策略
2323
[ WITH SET NETWORK POLICY = '<policy_name>' ] -- 设置网络策略
2424
[ WITH DEFAULT_ROLE = '<role_name>' ] -- 设置默认角色
25+
[ WITH DISABLED = true | false ] -- 用户创建时是否禁用
2526
```
2627

2728
- _auth_type_ 可以是 `double_sha1_password`(默认)、`sha256_password``no_password`
28-
- 使用 CREATE USER 或 [ALTER USER](03-user-alter-user.md) 为用户设置默认角色时,Databend 不会验证角色的存在或自动将角色授予用户。您必须明确地将角色授予用户,角色才会生效。
29+
- 当您使用 CREATE USER 或 [ALTER USER](03-user-alter-user.md) 为用户设置默认角色时,Databend 不会验证角色的存在或自动将角色授予用户。您必须明确地将角色授予用户,该角色才会生效。
30+
-`DISABLED` 设置为 `true` 时,新用户创建时处于禁用状态。处于此状态的用户无法登录 Databend,直到他们被启用。要启用或禁用已创建的用户,请使用 [ALTER USER](03-user-alter-user.md) 命令。
2931

3032
## 示例
3133

@@ -70,7 +72,7 @@ SHOW USERS;
7072

7173
### 示例 4:创建带有默认角色的用户
7274

73-
1. 创建一个名为 'user1' 的用户,将默认角色设置为 'manager':
75+
1. 创建一个名为 'user1' 的用户,其默认角色设置为 'manager':
7476

7577
```sql title='以用户 "root" 连接:'
7678
SHOW ROLES;
@@ -110,3 +112,46 @@ SHOW ROLES
110112
└───────────────────────────────────────────────────────┘
111113
2 rows read in 0.015 sec. Processed 0 rows, 0 B (0 rows/s, 0 B/s)
112114
```
115+
116+
### 示例 5:创建处于禁用状态的用户
117+
118+
本示例创建一个名为 'u1' 的用户,处于禁用状态,阻止登录访问。使用 [ALTER USER](03-user-alter-user.md) 命令启用用户后,登录访问恢复。
119+
120+
1. 创建一个名为 'u1' 的用户,处于禁用状态:
121+
122+
```sql
123+
CREATE USER u1 IDENTIFIED BY '123' WITH DISABLED = TRUE;
124+
125+
SHOW USERS;
126+
127+
┌─────────────────────────────────────────────────────────────────────────────────────┐
128+
│ name │ hostname │ auth_type │ is_configured │ default_role │ disabled │
129+
├────────┼──────────┼──────────────────────┼───────────────┼───────────────┼──────────┤
130+
│ root │ % │ no_password │ YES │ account_admin │ false │
131+
│ u1 │ % │ double_sha1_password │ NO │ │ true │
132+
└─────────────────────────────────────────────────────────────────────────────────────┘
133+
```
134+
135+
2. 尝试以用户 'u1' 使用 BendSQL 连接 Databend,将导致认证错误:
136+
137+
```shell
138+
~ bendsql --user u1 --password 123
139+
Welcome to BendSQL 0.16.0-homebrew.
140+
Connecting to localhost:8000 as user u1.
141+
Error: APIError: RequestError: Start Query failed with status 401 Unauthorized: {"error":{"code":"401","message":"AuthenticateFailure: user u1 is disabled. Not allowed to login"}}
142+
```
143+
144+
3. 使用 [ALTER USER](03-user-alter-user.md) 命令启用用户 'u1':
145+
146+
```sql
147+
ALTER USER u1 WITH DISABLED = FALSE;
148+
```
149+
150+
4. 重新尝试以用户 'u1' 连接 Databend,确认登录访问成功:
151+
152+
```shell
153+
~ bendsql --user u1 --password 123
154+
Welcome to BendSQL 0.16.0-homebrew.
155+
Connecting to localhost:8000 as user u1.
156+
Connected to Databend Query v1.2.424-nightly-d3a89f708d(rust-1.77.0-nightly-2024-04-17T22:11:59.304509266Z)
157+
```

docs/cn/sql-reference/10-sql-commands/00-ddl/02-user/02-user-show-users.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -16,9 +16,11 @@ SHOW USERS
1616
```sql
1717
SHOW USERS;
1818

19-
---
20-
| name | hostname | auth_type | is_configured |
21-
|---------------------------|----------|----------------------|---------------|
22-
| sqluser_johnappleseed | % | double_sha1_password | NO |
23-
| johnappleseed@example.com | % | jwt | NO |
19+
┌─────────────────────────────────────────────────────────────────────────────────────┐
20+
│ name │ hostname │ auth_type │ is_configured │ default_role │ disabled │
21+
├────────┼──────────┼──────────────────────┼───────────────┼───────────────┼──────────┤
22+
│ root │ % │ no_password │ YES │ account_admin │ false │
23+
│ u1 │ % │ double_sha1_password │ NO │ │ true │
24+
│ u2 │ % │ double_sha1_password │ NO │ │ false │
25+
└─────────────────────────────────────────────────────────────────────────────────────┘
2426
```

docs/cn/sql-reference/10-sql-commands/00-ddl/02-user/03-user-alter-user.md

Lines changed: 20 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -5,43 +5,47 @@ sidebar_position: 2
55

66
import FunctionDescription from '@site/src/components/FunctionDescription';
77

8-
<FunctionDescription description="引入或更新于:v1.2.283"/>
8+
<FunctionDescription description="引入或更新: v1.2.424"/>
99

1010
修改用户账户,包括:
1111

1212
- 更改用户的密码和认证类型。
13-
- 设置或取消设置密码策略
14-
- 设置或取消设置网络策略
15-
- 设置或修改默认角色。如果没有明确设置,默认情况下,Databend 会使用内置角色`public`作为默认角色。
13+
- 设置或取消密码策略
14+
- 设置或取消网络策略
15+
- 设置或修改默认角色。如未明确设置,Databend 将默认使用内置角色 `public` 作为默认角色。
1616

1717
## 语法
1818

1919
```sql
20-
-- 修改密码 / 认证类型
20+
-- 修改密码/认证类型
2121
ALTER USER <name> IDENTIFIED [ WITH auth_type ] BY '<password>'
2222

2323
-- 设置密码策略
2424
ALTER USER <name> WITH SET PASSWORD POLICY = '<policy_name>'
2525

26-
-- 取消设置密码策略
26+
-- 取消密码策略
2727
ALTER USER <name> WITH UNSET PASSWORD POLICY
2828

2929
-- 设置网络策略
3030
ALTER USER <name> WITH SET NETWORK POLICY = '<policy_name>'
3131

32-
-- 取消设置网络策略
32+
-- 取消网络策略
3333
ALTER USER <name> WITH UNSET NETWORK POLICY
3434

3535
-- 设置默认角色
3636
ALTER USER <name> WITH DEFAULT_ROLE = '<role_name>'
37+
38+
-- 启用或禁用用户
39+
ALTER USER <name> WITH DISABLED = true | false
3740
```
3841

3942
- _auth_type_ 可以是 `double_sha1_password`(默认)、`sha256_password``no_password`
40-
- 当你使用 [CREATE USER](01-user-create-user.md) 或 ALTER USER 为用户设置默认角色时,Databend 不会验证角色的存在或自动将角色授予用户。你必须明确地将角色授予用户,角色才会生效。
43+
- 当您为使用 [CREATE USER](01-user-create-user.md) 或 ALTER USER 创建的用户设置默认角色时,Databend 不会验证角色的存在或自动将角色授予用户。您必须明确将角色授予用户,该角色才会生效。
44+
- `DISABLED` 允许您启用或禁用用户。禁用的用户无法登录 Databend,直到他们被启用。点击[这里](01-user-create-user.md#example-5-creating-user-in-disabled-state)查看示例。
4145

4246
## 示例
4347

44-
### 示例 1:更改密码和认证类型
48+
### 示例 1: 更改密码 & 认证类型
4549

4650
```sql
4751
CREATE USER user1 IDENTIFIED BY 'abc123';
@@ -72,7 +76,7 @@ show users;
7276
+-------+----------+-------------+---------------+
7377
```
7478

75-
### 示例 2:设置和取消设置网络策略
79+
### 示例 2: 设置 & 取消网络策略
7680

7781
```sql
7882
SHOW NETWORK POLICIES;
@@ -91,11 +95,12 @@ ALTER USER user1 WITH SET NETWORK POLICY='test_policy1';
9195
ALTER USER user1 WITH UNSET NETWORK POLICY;
9296
```
9397

94-
### 示例 3:设置默认角色
98+
### 示例 3: 设置默认角色
99+
100+
1. 创建名为 "user1" 的用户并设置默认角色为 "writer":
95101

96-
1. 创建一个名为"user1"的用户,并将默认角色设置为"writer":
102+
```sql title='以用户 "root" 连接:'
97103

98-
```sql title='以用户 "root" 连接:'
99104
root@localhost:8000/default> CREATE USER user1 IDENTIFIED BY 'abc123';
100105

101106
CREATE USER user1 IDENTIFIED BY 'abc123'
@@ -121,9 +126,9 @@ ALTER user user1 WITH DEFAULT_ROLE = 'writer'
121126
0 row written in 0.019 sec. Processed 0 row, 0 B (0 row/s, 0 B/s)
122127
```
123128

124-
2. 使用 [SHOW ROLES](04-user-show-roles.md) 命令验证用户"user1"的默认角色:
129+
2. 使用 [SHOW ROLES](04-user-show-roles.md) 命令验证用户 "user1" 的默认角色:
125130

126-
```sql title='以用户 "user1" 连接:'
131+
```sql title='以用户 "user1" 连接'
127132
eric@Erics-iMac ~ % bendsql --user user1 --password abc123
128133
Welcome to BendSQL 0.9.3-db6b232(2023-10-26T12:36:55.578667000Z).
129134
Connecting to localhost:8000 as user user1.

docs/cn/sql-reference/10-sql-commands/00-ddl/02-user/04-user-create-role.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,11 @@ title: 创建角色
33
sidebar_position: 5
44
---
55

6-
创建一个新角色
6+
创建一个新的角色
77

8-
创建角色后,您可以将对象权限授予角色,为系统中的对象启用访问控制安全性
8+
创建角色后,您可以向该角色授予对象权限,为系统中的对象启用访问控制安全
99

10-
另见[GRANT](10-grant.md)
10+
另请参阅[GRANT](10-grant.md)
1111

1212
## 语法
1313

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
---
2+
title: 启用辅助角色
3+
sidebar_position: 6
4+
---
5+
6+
激活当前会话中的所有辅助角色。这意味着用户被授予的所有辅助角色都将处于活动状态,从而扩展用户的权限。关于活动角色和辅助角色的更多信息,请参阅[活动角色与辅助角色](/guides/security/access-control/roles#活动角色--辅助角色)
7+
8+
另请参阅:[SET ROLE](04-user-set-role.md)
9+
10+
## 语法
11+
12+
```sql
13+
SET SECONDARY ROLES { ALL | NONE }
14+
```
15+
16+
| 参数 | 默认值 | 描述 |
17+
| ---- | ------ | ------------------------------------------------------------------------------------------------------------ |
18+
| ALL || 激活当前会话中用户被授予的所有辅助角色,除了活动角色。这使得用户能够利用所有辅助角色关联的权限。 |
19+
| NONE || 停用当前会话中的所有辅助角色,意味着只有活动角色的权限是活动的。这限制了用户的权限仅为活动角色所授予的权限。 |
20+
21+
## 示例
22+
23+
本示例展示了辅助角色的工作原理以及如何激活/停用它们。
24+
25+
1. 以 root 用户创建角色。
26+
27+
首先,创建两个角色,`admin``analyst`
28+
29+
```sql
30+
CREATE ROLE admin;
31+
32+
CREATE ROLE analyst;
33+
```
34+
35+
2. 授予权限。
36+
37+
接下来,为每个角色授予一些权限。例如,我们将授予`admin`角色创建数据库的能力,以及`analyst`角色从表中选择的能力:
38+
39+
```sql
40+
GRANT CREATE DATABASE ON *.* TO ROLE admin;
41+
42+
GRANT SELECT ON *.* TO ROLE analyst;
43+
```
44+
45+
3. 创建用户。
46+
47+
现在,创建一个用户:
48+
49+
```sql
50+
CREATE USER 'user1' IDENTIFIED BY 'password';
51+
```
52+
53+
4. 分配角色。
54+
55+
将两个角色分配给用户:
56+
57+
```sql
58+
GRANT ROLE admin TO 'user1';
59+
60+
GRANT ROLE analyst TO 'user1';
61+
```
62+
63+
5. 设置活动角色。
64+
65+
现在,以`user1`身份登录 Databend,并将活动角色设置为`analyst`
66+
67+
```sql
68+
SET ROLE analyst;
69+
```
70+
71+
默认情况下,所有辅助角色都是激活的,因此我们可以创建一个新数据库:
72+
73+
```sql
74+
CREATE DATABASE my_db;
75+
```
76+
77+
6. 停用辅助角色。
78+
79+
活动角色`analyst`没有 CREATE DATABASE 权限。当所有辅助角色被停用时,创建新数据库将失败。
80+
81+
```sql
82+
SET SECONDARY ROLES NONE;
83+
84+
CREATE DATABASE my_db2;
85+
error: APIError: ResponseError with 1063: Permission denied: privilege [CreateDatabase] is required on *.* for user 'user1'@'%' with roles [analyst,public]
86+
```

docs/cn/sql-reference/10-sql-commands/00-ddl/02-user/04-user-set-role.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,9 @@ title: 设置角色
33
sidebar_position: 5
44
---
55

6-
切换会话的活动角色,可以使用 [SHOW ROLES](04-user-show-roles.md) 命令查看当前活动角色,其中 `is_current` 字段表示活动角色。
6+
切换当前会话的活动角色,当前活动角色可通过[SHOW ROLES](04-user-show-roles.md)命令查看,其中`is_current`字段指示当前活动角色。关于活动角色和辅助角色的更多信息,请参阅[活动角色与辅助角色](/guides/security/access-control/roles#活动角色--辅助角色)
7+
8+
另请参见:[SET SECONDARY ROLES](04-user-set-2nd-roles.md)
79

810
## 语法
911

@@ -35,4 +37,4 @@ SHOW ROLES;
3537
│ public │ 0 │ false │ false │
3638
│ writer │ 0 │ false │ true │
3739
└───────────────────────────────────────────────────────┘
38-
```
40+
```

docs/cn/sql-reference/10-sql-commands/00-ddl/02-user/04-user-show-roles.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: 显示角色
33
sidebar_position: 6
44
---
55

6-
列出分配给当前用户的所有角色
6+
列出当前用户被分配的所有角色
77

88
## 语法
99

@@ -13,14 +13,14 @@ SHOW ROLES
1313

1414
## 输出
1515

16-
该命令返回一个表格,包含以下列:
16+
该命令返回的结果以表格形式展示,包含以下列:
1717

18-
| Column | Description |
19-
| --------------- | -------------------------------- |
20-
| name | 角色名称 |
21-
| inherited_roles | 当前角色继承的角色数量 |
22-
| is_current | 指示该角色是否当前处于激活状态 |
23-
| is_default | 指示该角色是否为用户的默认角色。 |
18+
| 列名 | 描述 |
19+
| --------------- | ------------------------------ |
20+
| name | 角色名称 |
21+
| inherited_roles | 当前角色继承的角色数量 |
22+
| is_current | 指示该角色是否当前处于激活状态 |
23+
| is_default | 指示该角色是否为用户默认角色 |
2424

2525
## 示例
2626

docs/cn/sql-reference/10-sql-commands/00-ddl/02-user/05-user-drop-role.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ DROP ROLE [ IF EXISTS ] <role_name>
1313

1414
## 使用说明
1515

16-
- 如果一个角色被授予给用户,Databend 无法自动从该角色中删除这些授权
16+
- 如果角色已被授权给用户,Databend 不会自动从角色中移除这些授权
1717

1818
## 示例
1919

0 commit comments

Comments
 (0)