Tạo sink connector Redis
Dùng sink connector Redis để ứng dụng có thể đọc từ Redis những thay đổi ghi nhận từ cơ sở dữ liệu nguồn. Connector đọc các Kafka topic bạn chọn và lưu bản ghi bằng lệnh Redis bạn chọn.
Điều kiện cần
- CDC Service ở trạng thái Healthy. Xem Tạo CDC Service.
- Topic có dữ liệu thay đổi do một source connector ghi vào, ví dụ source connector PostgreSQL.
- URL, username và mật khẩu của cơ sở dữ liệu Redis.
Tạo connector
-
Chọn Data platform → Workspace management, rồi chọn workspace.
-
Ở tab Overview, trong phần Services, chọn thẻ CDC.
-
Chọn tab Connectors, rồi chọn Create Connector.

-
Ở màn hình Connector Information, nhập Name, chọn sink ở Type và chọn Redis ở Database.

-
Chọn Next Step. Ở màn hình Properties, nhập thông tin kết nối, rồi chọn Test connection. Next Step chỉ khả dụng sau khi kiểm tra thành công.

-
Vẫn ở màn hình này, chọn Converter class và thiết lập bốn trường converter. Trong phần Kafka topic, chọn +, rồi chọn các topic cần đọc trong panel Select topics.


-
Chọn Next Step. Ở màn hình Additional properties, thiết lập các trường trong phần Task, Redis config và Error Tolerance.



-
Chọn Next Step, rồi kiểm tra cấu hình ở màn hình Review.

-
Chọn Create.
Portal quay về tab Essential Information của CDC Service. Ở tab Connectors, connector mới có trạng thái Running, và mọi bộ đếm Tasks đều bằng 0 cho tới khi task của connector khởi động. Việc này có thể mất tới khoảng 2,5 phút.
Cài đặt của connector
Màn hình Connector Information
| Trường | Bắt buộc | Mô tả |
|---|---|---|
| Name | Có | Tên connector. Chỉ dùng chữ thường, chữ số và dấu gạch ngang (-). Nếu có chữ hoa, _, . hoặc dấu cách, form báo lỗi "Name has invalid characters". |
| Type | Có | Chọn sink. |
| Database | Có | Chọn Redis. |
Màn hình Properties
Connector này không có tùy chọn From FPT Database Engine. Nhập thông tin kết nối ở phần Database Information. Xem cách Test connection hoạt động ở Chế độ kết nối.
| Trường | Bắt buộc | Mô tả |
|---|---|---|
| URL | Có | Địa chỉ của cơ sở dữ liệu Redis, theo dạng redis://HOST:PORT/DB hoặc rediss://HOST:PORT/DB, trong đó DB là số thứ tự của cơ sở dữ liệu, ví dụ 0. |
| Username | Có | Username mà connector dùng để kết nối tới Redis, ví dụ default. |
| Password | Có | Mật khẩu của user đó. |
| Converter class | Có | Converter class của connector. Portal cung cấp Redis. Bốn trường converter bị làm mờ cho tới khi bạn chọn class. Xem Converter. |
| Converter key, Converter key schema enable, Converter value, Converter value schema enable | Có | Cách connector đọc key và value của message, và key, value có kèm schema hay không. Converter key và Converter value đều có org.apache.kafka.connect.json.JsonConverter, org.apache.kafka.connect.storage.StringConverter và org.apache.kafka.connect.converters.ByteArrayConverter. Cả hai trường schema enable đều có true và false. |
| Kafka topic | Có | Các topic cần đọc, tối đa 100 topic. Chọn + để mở panel Select topics, chọn các topic, rồi chọn Select. Xem Topic. |
Màn hình Additional properties
| Trường | Bắt buộc | Mô tả |
|---|---|---|
| Number of task | Có | Số task tối đa chạy song song. Giá trị mặc định là 1. Xem Tasks max. |
| Command | Có | Lệnh Redis dùng để lưu từng bản ghi: HSET, SET, JSONSET, XADD, RPUSH hoặc SADD. Trường này không có giá trị mặc định. JSONSET cần module RedisJSON. |
| Mode (trong phần Error Tolerance) | Có | Cách connector xử lý message không đọc hoặc không chuyển đổi được. None làm connector dừng và chuyển sang trạng thái Failed. All bỏ qua message đó và chuyển nó tới topic bạn nhập để nhận bản ghi lỗi. Trường này không có giá trị mặc định. Xem Error tolerance. |