DESC USER

Author: soyeric128

docs/en/sql-reference/10-sql-commands/00-ddl/02-user/01-user-desc-user.md

@@ -0,0 +1,44 @@
+---
+title: DESC USER
+---
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced or updated: v1.2.644"/>
+
+Displays detailed information about a specific SQL user, including authentication type, roles, network policy, password policy, and other user-related settings.
+
+## Syntax
+
+```sql
+DESC[RIBE] USER <username>
+```
+
+## Examples
+
+```sql
+CREATE NETWORK POLICY my_network_policy ALLOWED_IP_LIST=('192.168.100.0/24');
+
+CREATE PASSWORD POLICY my_password_policy
+    PASSWORD_MIN_LENGTH = 12
+    PASSWORD_MAX_LENGTH = 24
+    PASSWORD_MIN_UPPER_CASE_CHARS = 2
+    PASSWORD_MIN_LOWER_CASE_CHARS = 2
+    PASSWORD_MIN_NUMERIC_CHARS = 2
+    PASSWORD_MIN_SPECIAL_CHARS = 2
+    PASSWORD_MIN_AGE_DAYS = 1
+    PASSWORD_MAX_AGE_DAYS = 30
+    PASSWORD_MAX_RETRIES = 3
+    PASSWORD_LOCKOUT_TIME_MINS = 30
+    PASSWORD_HISTORY = 5
+    COMMENT = 'test comment';
+
+CREATE USER eric IDENTIFIED BY '123ABCabc$$123' WITH SET PASSWORD POLICY='my_password_policy', SET NETWORK POLICY='my_network_policy';
+
+DESC USER eric;
+
+┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
+│  name  │ hostname │       auth_type      │ default_role │  roles │ disabled │   network_policy  │   password_policy  │ must_change_password │
+├────────┼──────────┼──────────────────────┼──────────────┼────────┼──────────┼───────────────────┼────────────────────┼──────────────────────┤
+│ eric   │ %        │ double_sha1_password │              │        │ false    │ my_network_policy │ my_password_policy │ NULL                 │
+└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
+```

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

@@ -2,6 +2,9 @@
 title: SHOW USERS
 sidebar_position: 3
 ---
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced or updated: v1.2.644"/>
 
 Lists all SQL users in the system. If you're using Databend Cloud, this command also shows the user accounts (email addresses) within your organization that are used to log in to Databend Cloud.
 
@@ -14,14 +17,30 @@ SHOW USERS
 ## Examples
 
 ```sql
-CREATE USER eric IDENTIFIED BY 'abc123';
+CREATE NETWORK POLICY my_network_policy ALLOWED_IP_LIST=('192.168.100.0/24');
+
+CREATE PASSWORD POLICY my_password_policy
+    PASSWORD_MIN_LENGTH = 12
+    PASSWORD_MAX_LENGTH = 24
+    PASSWORD_MIN_UPPER_CASE_CHARS = 2
+    PASSWORD_MIN_LOWER_CASE_CHARS = 2
+    PASSWORD_MIN_NUMERIC_CHARS = 2
+    PASSWORD_MIN_SPECIAL_CHARS = 2
+    PASSWORD_MIN_AGE_DAYS = 1
+    PASSWORD_MAX_AGE_DAYS = 30
+    PASSWORD_MAX_RETRIES = 3
+    PASSWORD_LOCKOUT_TIME_MINS = 30
+    PASSWORD_HISTORY = 5
+    COMMENT = 'test comment';
+
+CREATE USER eric IDENTIFIED BY '123ABCabc$$123' WITH SET PASSWORD POLICY='my_password_policy', SET NETWORK POLICY='my_network_policy';
 
 SHOW USERS;
 
-┌─────────────────────────────────────────────────────────────────────────────────────────────────────┐
-│  name  │ hostname │       auth_type      │ is_configured │  default_role │     roles     │ disabled │
-├────────┼──────────┼──────────────────────┼───────────────┼───────────────┼───────────────┼──────────┤
-│ eric   │ %        │ double_sha1_password │ NO            │               │               │ false    │
-│ root   │ %        │ no_password          │ YES           │ account_admin │ account_admin │ false    │
-└─────────────────────────────────────────────────────────────────────────────────────────────────────┘
+┌─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
+│  name  │ hostname │       auth_type      │ is_configured │  default_role │     roles     │ disabled │   network_policy  │   password_policy  │ must_change_password │
+├────────┼──────────┼──────────────────────┼───────────────┼───────────────┼───────────────┼──────────┼───────────────────┼────────────────────┼──────────────────────┤
+│ eric   │ %        │ double_sha1_password │ NO            │               │               │ false    │ my_network_policy │ my_password_policy │ NULL                 │
+│ root   │ %        │ no_password          │ YES           │ account_admin │ account_admin │ false    │ NULL              │ NULL               │ NULL                 │
+└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
 ```

docs/en/sql-reference/10-sql-commands/00-ddl/02-user/index.md

@@ -19,6 +19,7 @@ This page provides reference information for the user and role related commands
 
 ## Information Retrieval:
 
+- [DESC USER](01-user-desc-user.md)
 - [SHOW USERS](02-user-show-users.md)
 - [SHOW ROLES](04-user-show-roles.md)
 - [SHOW GRANTS](22-show-grants.md)