字典

Databend 的字典功能提供了一种高效的方式，可以直接在 Databend 中集成和查询来自支持的外部数据源的数据。通过充当内存中的键值存储，字典能够快速访问外部数据，而无需复杂的数据管道或传统的 ETL 流程。

字典的工作原理

在 Databend 中，您可以通过定义字典的结构并指定外部数据源来创建字典。当查询时，Databend 会从外部数据源获取所需的数据。您可以使用 DICT_GET 函数高效地检索值，确保查询始终反映最新的数据。

支持的外部数据源

Databend 目前支持 MySQL 和 Redis 作为字典的外部数据源。

教程

• 使用字典访问 MySQL 和 Redis

  在本教程中，我们将指导您如何使用 Databend 中的字典访问 MySQL 和 Redis 数据。您将学习如何创建映射到这些外部数据源的字典，从而实现无缝的数据查询和集成。

使用示例

以下示例演示了如何通过使用字典将 MySQL 与 Databend 集成，使您能够直接从 Databend 查询存储在 MySQL 中的数据。此过程包括在 MySQL 中创建表、在 Databend 中设置相应的表、创建字典以映射数据，并在查询中使用 DICT_GET 函数从字典中检索值。

第一步：在 MySQL 中创建表

首先，在您的本地 MySQL 数据库中创建一个表。在本示例中，我们将创建一个名为 dict 的数据库和一个名为 orders 的表。

CREATE DATABASE dict;
USE dict;

CREATE TABLE orders (
   order_id INT PRIMARY KEY,
   customer_name VARCHAR(100),
   order_total INT);

INSERT INTO orders (order_id, customer_name, order_total) VALUES
(1, 'John Doe', 250),    
(2, 'Jane Smith', 175),  
(3, 'Alice Johnson', 300);

第二步：在 Databend 中创建表

接下来，在 Databend 中创建一个包含 order_id 和 customer_name 的对应表，但将从字典中查询 order_total。

CREATE TABLE orders (
    order_id INT,
    customer_name VARCHAR
);

INSERT INTO orders (order_id, customer_name) VALUES
(1, 'John Doe'),
(2, 'Jane Smith'),
(3, 'Alice Johnson');

第三步：在 Databend 中创建字典

现在，在 Databend 中创建一个引用 MySQL orders 表的字典。

CREATE DICTIONARY order_dict
(
    order_id INT,
    customer_name STRING,
    order_total INT
)
PRIMARY KEY order_id
SOURCE(MYSQL(
    host='mysql'
    port='3306'
    username='root'
    password='admin'
    db='dict'
    table='orders'
));

第四步：在查询中使用 DICT_GET

现在，您可以在查询 Databend 表时结合使用 DICT_GET 函数。以下是一些示例：

检索特定订单 ID 的订单总额：

SELECT DICT_GET(order_dict, 'order_total', 1);

-[ RECORD 1 ]-----------------------------------
dict_get(default.order_dict, 'order_total', 1): 250

检索所有订单的客户名称和订单总额：

SELECT
    order_id,
    customer_name,
    dict_get(order_dict, 'order_total', order_id) AS order_total
FROM
    orders;

┌──────────────────────────────────────────────────────┐
│     order_id    │   customer_name  │   order_total   │
│ Nullable(Int32) │ Nullable(String) │ Nullable(Int32) │
├─────────────────┼──────────────────┼─────────────────┤
│               1 │ John Doe         │             250 │
│               2 │ Jane Smith       │             175 │
│               3 │ Alice Johnson    │             300 │
└──────────────────────────────────────────────────────┘