💬Generate LLM translations

docs/cn/guides/54-query/07-dictionary.md

@@ -14,9 +14,15 @@ Databend的字典功能提供了一种高效的方式，可以直接在Databend
 
 Databend目前支持MySQL和Redis作为字典的外部源。
 
+## 教程
+
+- [使用字典访问MySQL和Redis](/tutorials/integrate/access-mysql-and-redis)
+
+    > 在本教程中，我们将指导您使用Databend中的字典访问MySQL和Redis数据。您将学习如何创建映射到这些外部数据源的字典，从而实现无缝的数据查询和集成。
+
 ## 使用示例
 
-以下示例演示了如何通过使用字典将MySQL与Databend集成，从而允许您直接从Databend查询存储在MySQL中的数据。此过程涉及在MySQL中创建一个表，在Databend中设置相应的表，创建一个字典来映射数据，并使用[DICT_GET](/sql/sql-functions/dictionary-functions/dict-get)函数在查询中从字典中检索值。
+以下示例演示了如何通过使用字典将MySQL与Databend集成，从而允许您直接从Databend查询存储在MySQL中的数据。此过程涉及在MySQL中创建表，在Databend中设置相应的表，创建字典以映射数据，并使用[DICT_GET](/sql/sql-functions/dictionary-functions/dict-get)函数在查询中从字典中检索值。
 
 ### 步骤1：在MySQL中创建表
 

docs/cn/tutorials/integrate/access-mysql-and-redis.md

@@ -0,0 +1,230 @@
+---
+title: 使用字典访问 MySQL 和 Redis
+---
+
+在本教程中，我们将指导您使用 Databend 中的字典访问 MySQL 和 Redis 数据。您将学习如何创建映射到这些外部数据源的字典，从而实现无缝的数据查询和集成。
+
+## 开始之前
+
+在开始之前，请确保您的本地机器上已安装 [Docker](https://www.docker.com/)。我们需要 Docker 来设置 Databend、MySQL 和 Redis 所需的容器。您还需要一个 SQL 客户端来连接到 MySQL；我们推荐使用 [BendSQL](/guides/sql-clients/bendsql/) 来连接 Databend。
+
+## 步骤 1：设置环境
+
+在这一步中，我们将在您的本地机器上使用 Docker 启动 Databend、MySQL 和 Redis 的实例。
+
+1. 创建一个名为 `mynetwork` 的 Docker 网络，以实现 Databend、MySQL 和 Redis 容器之间的通信：
+
+```bash
+docker network create mynetwork
+```
+
+2. 运行以下命令，在 `mynetwork` 网络中启动一个名为 `mysql` 的 MySQL 容器：
+
+```bash
+docker run -d \
+  --name=mysql \
+  --network=mynetwork \
+  -e MYSQL_ROOT_PASSWORD=admin \
+  -p 3306:3306 \
+  mysql:latest
+```
+
+3. 运行以下命令，在 `mynetwork` 网络中启动一个名为 `databend` 的 Databend 容器：
+
+```bash
+docker run -d \
+  --name=databend \
+  --network=mynetwork \
+  -p 3307:3307 \
+  -p 8000:8000 \
+  -p 8124:8124 \
+  -p 8900:8900 \
+  datafuselabs/databend:nightly
+```
+
+4. 运行以下命令，在 `mynetwork` 网络中启动一个名为 `redis` 的 Redis 容器：
+
+```bash
+docker run -d \
+  --name=redis \
+  --network=mynetwork \
+  -p 6379:6379 \
+  redis:latest
+```
+
+5. 通过检查 `mynetwork` Docker 网络，验证 Databend、MySQL 和 Redis 容器是否连接到同一网络：
+
+```bash
+docker network inspect mynetwork
+
+[
+    {
+        "Name": "mynetwork",
+        "Id": "ba8984e9ca07f49dd6493fd7c8be9831bda91c44595fc54305fc6bc241a77485",
+        "Created": "2024-09-23T21:24:34.59324771Z",
+        "Scope": "local",
+        "Driver": "bridge",
+        "EnableIPv6": false,
+        "IPAM": {
+            "Driver": "default",
+            "Options": {},
+            "Config": [
+                {
+                    "Subnet": "172.18.0.0/16",
+                    "Gateway": "172.18.0.1"
+                }
+            ]
+        },
+        "Internal": false,
+        "Attachable": false,
+        "Ingress": false,
+        "ConfigFrom": {
+            "Network": ""
+        },
+        "ConfigOnly": false,
+        "Containers": {
+            "14d50cc4d075158a6d5fa4e6c8b7db60960f8ba1f64d6bceff0692c7e99f37b5": {
+                "Name": "redis",
+                "EndpointID": "e1d1015fea745bbbb34c6a9fb11010b6960a139914b7cc2c6a20fbca4f3b77d8",
+                "MacAddress": "02:42:ac:12:00:04",
+                "IPv4Address": "172.18.0.4/16",
+                "IPv6Address": ""
+            },
+            "276bc1023f0ea999afc41e063f1f3fe7404cb6fbaaf421005d5c05be343ce5e5": {
+                "Name": "databend",
+                "EndpointID": "ac915b9df2fef69c5743bf16b8f07e0bb8c481ca7122b171d63fb9dc2239f873",
+                "MacAddress": "02:42:ac:12:00:03",
+                "IPv4Address": "172.18.0.3/16",
+                "IPv6Address": ""
+            },
+            "95c21de94d27edc5e6fa8e335e0fd5bff12557fa30889786de9f483b8d111dbc": {
+                "Name": "mysql",
+                "EndpointID": "44fdf40de8c3d4c8fec39eb03ef1219c9cf1548e9320891694a9758dd0540ce3",
+                "MacAddress": "02:42:ac:12:00:02",
+                "IPv4Address": "172.18.0.2/16",
+                "IPv6Address": ""
+            }
+        },
+        "Options": {},
+        "Labels": {}
+    }
+]
+```
+
+## 步骤 2：填充示例数据
+
+在这一步中，我们将向 MySQL 和 Redis 以及 Databend 中添加示例数据。
+
+1. 在 Databend 中，创建一个名为 `users_databend` 的表并插入示例用户数据：
+
+```sql
+CREATE TABLE users_databend (
+    id INT,
+    name VARCHAR(100) NOT NULL
+);
+
+INSERT INTO users_databend (id, name) VALUES
+(1, 'Alice'),
+(2, 'Bob'),
+(3, 'Charlie');
+```
+
+2. 在 MySQL 中，创建一个名为 `dict` 的数据库，创建一个 `users` 表并插入示例数据：
+
+```sql
+CREATE DATABASE dict;
+USE dict;
+
+CREATE TABLE users (
+    id INT AUTO_INCREMENT PRIMARY KEY,
+    name VARCHAR(100) NOT NULL,
+    email VARCHAR(100) NOT NULL
+);
+
+INSERT INTO users (name, email) VALUES
+('Alice', '[email protected]'),
+('Bob', '[email protected]'),
+('Charlie', '[email protected]');
+```
+
+3. 在 Docker Desktop 或通过在终端中运行 `docker ps` 找到您的 Redis 容器 ID：
+
+![alt text](../../../../static/img/documents/tutorials/redis-container-id.png)
+
+4. 使用您的 Redis 容器 ID 访问 Redis CLI（将 `14d50cc4d075` 替换为您的实际容器 ID）：
+
+```bash
+docker exec -it 14d50cc4d075 redis-cli
+```
+
+5. 在 Redis CLI 中运行以下命令，将示例用户数据插入 Redis：
+
+```bash
+SET user:1 '{"notifications": "enabled", "theme": "dark"}'
+SET user:2 '{"notifications": "disabled", "theme": "light"}'
+SET user:3 '{"notifications": "enabled", "theme": "dark"}'
+```
+
+## 步骤 3：创建字典
+
+在这一步中，我们将在 Databend 中为 MySQL 和 Redis 创建字典，然后从这些外部数据源查询数据。
+
+1. 在 Databend 中，创建一个名为 `mysql_users` 的字典，连接到 MySQL 实例：
+
+```sql
+CREATE DICTIONARY mysql_users
+(
+    id INT,
+    name STRING,
+    email STRING
+)
+PRIMARY KEY id
+SOURCE(MySQL(
+    host='mysql'
+    port=3306
+    username='root'
+    password='admin'
+    db='dict'
+    table='users'
+));
+```
+
+2. 创建一个名为 `mysql_users` 的字典，连接到 Redis 实例：
+
+```sql
+CREATE DICTIONARY redis_user_preferences
+(
+    user_id STRING,
+    preferences STRING
+)
+PRIMARY KEY user_id
+SOURCE(Redis(
+    host='redis'
+    port=6379
+));
+```
+
+3. 查询我们之前创建的 MySQL 和 Redis 字典中的数据。
+
+```sql
+SELECT 
+    u.id,
+    u.name,
+    DICT_GET(mysql_users, 'email', u.id) AS email,
+    DICT_GET(redis_user_preferences, 'preferences', CONCAT('user:', TO_STRING(u.id))) AS user_preferences
+FROM 
+    users_databend AS u;
+```
+
+上述查询从 `users_databend` 表中检索用户信息，包括他们的 ID 和姓名，以及从 MySQL 字典中获取的电子邮件和从 Redis 字典中获取的用户偏好。
+
+```sql title='结果：'
+┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
+│        id       │   name  │ dict_get(default.mysql_users, 'email', u.id) │ dict_get(default.redis_user_preferences, 'preferences', CONCAT('user:', TO_STRING(u.id))) │
+│ Nullable(Int32) │  String │               Nullable(String)               │                                      Nullable(String)                                     │
+├─────────────────┼─────────┼──────────────────────────────────────────────┼───────────────────────────────────────────────────────────────────────────────────────────┤
+│               1 │ Alice   │ alice@example.com                            │ {"notifications": "enabled", "theme": "dark"}                                             │
+│               2 │ Bob     │ bob@example.com                              │ {"notifications": "disabled", "theme": "light"}                                           │
+│               3 │ Charlie │ charlie@example.com                          │ {"notifications": "enabled", "theme": "dark"}                                             │
+└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
+```