Redis Insight 中的 RDI

从 Redis Insight 连接到 RDI、配置管道等。

Redis 数据集成 （RDI） 及其提取管道功能是一种端到端解决方案，用于在 Redis 中镜像应用程序的主数据库。RDI 采用捕获数据更改机制和流处理器将源数据（如关系表）映射并转换为与您的使用案例匹配的快速 Redis 数据结构。 您可以在这些页面上阅读有关 RDI 的摄取架构的更多信息。

截至版本2.54.0中，Redis Insight 包括 RDI 连接，允许您连接到 RDI 管理平面，创建、测试和部署 RDI 管道，以及查看 RDI 统计数据。

连接

打开 Redis Insight，单击 Redis Data Integration 选项卡，然后单击两个 + Add RDI Endpoint 按钮之一，如下所示。

在提供的对话框中输入 RDI 服务器详细信息。RDI 别名字段可以是您选择的任何名称，它将用作 RDI 实例列表视图中的主名称。

如果您的连接成功，您将收到通知。

创建、测试和部署 RDI 管道

首先，在 RDI 实例视图中单击新配置的 RDI 终端节点的别名（例如，上图中的测试连接）。您将在屏幕中央看到以下对话框。

从以下选项中选择：

  • 从服务器下载 - 从 RDI 配置下载现有管道。
  • 从文件上传 - 以 zip 格式从本地计算机上传 YAML 管道文件。
  • 创建新管道 – 使用 Redis Insight 的内置编辑器从头开始或使用内置模板之一创建新管道。

这些菜单选项中的每一个都将在后续部分中更详细地介绍。

编辑器窗格顶部还有用于前两个函数的等效按钮。

如果您希望从空配置开始，请退出对话框，这将让您进入 Configuration file （配置文件） 编辑器，您可以在其中开始编辑管道的配置组件;这config.yaml文件。

从 RDI 配置下载管道

单击 Start with your pipeline 对话框中的 Download from server 按钮，从 RDI 配置下载以前定义的管道。下载的管道将显示在 Pipeline management （管道管理） 窗格中。如下所示，每个管道都由一个配置文件 （config.yaml） 和零个或多个jobYAML 文件。配置文件将显示在中央编辑器面板中。

从本地计算机上传管道

单击 Start with your pipeline （从管道开始） 对话框中的 Upload from file （从文件上传） 按钮，从本地计算机上传配置和作业 YAML 文件。这些文件必须存储在具有以下结构的 zip 文件中。

├── config.yaml
└── jobs
    └── job1.yaml

这config.yamlfile 时，您的配置 YAML 文件是必需的。这jobsdirectory 可以为空，因为不需要作业管道，但空目录必须存在于 zip 文件中。否则，jobs文件夹可能包含一个或多个作业 YAML 文件。

使用内置编辑器创建新的配置文件

单击 Start with your pipeline 对话框中的 Create new pipeline 按钮，以使用内置编辑器创建新管道。执行此作后，您将进入 Configuration file 编辑器，您将在编辑器的右上角看到一个打开的 Select a template 对话框。

在提供的字段中进行选择：

  • 默认情况下，管道类型设置为 Ingest。
  • 数据库类型有六个选项：
    • MongoDB 数据库
    • 卡珊德拉
    • MySQL 的
    • 神谕
    • PostgreSQL 的
    • sqlserver 服务器
注意：
上述菜单中列出的选项取决于您的 RDI 配置的功能。

在您做出选择并单击 Apply 后，Redis Insight 将使用适当的模板填充编辑器窗口。要从头开始，请单击 Cancel。

有关必填字段的信息，请参阅 RDI 文档。

测试目标数据库连接

创建 Target 数据库配置后，您可以使用编辑器窗格右下角的 Test Connection 按钮来测试连接。右侧将打开一个新面板，其中包含测试结果，如下所示。

使用内置编辑器创建新的转换作业文件

在 Pipeline Management 窗格中，单击 Jobs 文件夹旁边的 ，然后输入新转换作业的名称。 接下来，单击您刚刚创建的作业名称。 这将带您进入作业编辑器，并打开模板选择菜单。进行选择，然后单击 Apply。Redis Insight 将使用适当的模板填充编辑器窗口。要从头开始，请单击 Cancel。+

注意：
上述菜单中列出的选项取决于您的 RDI 配置的功能。

RDI 文档提供了几个转换作业示例，可帮助您入门。注意：RDI 对作业文件使用非常特定的 YAML 格式。有关更多信息，请参阅此处。

使用内置编辑器

Redis Insight 管道文件编辑器是上下文感知的。它们为以下各项提供自动完成、语法高亮显示和错误检测：

  • 配置和作业文件编辑器中的 YAML 文件
  • 专用编辑器中的 JMESPath 和 SQL 函数片段。要打开 JMESPath 和 SQL 编辑器，请单击 SQL 和 JMESPathEditor 按钮，如上所示。一个新的编辑器窗口将在屏幕的下半部分打开。

如果您决定在不使用模板的情况下编写自己的配置管道，则会看到如下所示的自动完成提示。

虽然这不能替代 RDI 文档，但当您基本熟悉 RDI 管道文件的构建块后，它可以帮助您加快学习速度。

Redis Insight 还将突出显示任何错误，如下所示。

下面是一个显示 SQL 和 JMESPath 编辑器窗格的示例。请注意此编辑器窗格左下角的切换开关。单击它允许您从以下选项中进行选择：

  • SQLite 函数
  • JMESPath

构建 SQLite 或 JMESPath 代码后，将其复制到主编辑器窗口。以下是对可在作业文件中使用的受支持的 JMESPath 扩展函数和表达式的参考。

警告：

如果您在不保存工作的情况下退出 Redis Insight，您在编辑器中所做的任何更改都将丢失。要保存对管道文件所做的任何更改，请将其部署到 RDI 服务器（见下文），或使用 RDI 窗口右上角的 Download （下载） 按钮将修改后的文件作为 zip 文件下载到本地磁盘。Redis Insight 将在未保存/未部署的文件前面加上一个绿色圆圈。

试运行转换作业管道

创建转换作业管道后，您可以在 RDI 服务器上执行试运行。为此，请单击编辑器窗格右下角的 Dry Run。新的 Test transformation logic 面板将打开到一侧。有两个垂直堆叠的窗格：Input （输入） 和 Results （结果）。在 Input 部分中，输入将触发转换的 JSON 数据。所有结果都将显示在 Results （结果） 部分中。

Results （结果） 部分中有两个选项卡：

  1. Transformations （转换） - 这是您将看到试运行中的 JSON 输出的位置。
  2. 输出 -（未显示）这是您将看到在实际场景中运行的 Redis 命令的位置。

下面是一个示例。

部署管道并将目标数据库添加到 Redis Insight

如果您对配置和转换作业管道感到满意，可以将它们部署到 RDI 管理平面。单击 Deploy Pipeline 按钮继续。

部署管道后，您可以添加 RDI 目标 Redis 数据库，该数据库在config.yaml文件添加到 Redis Insight。 这样做将允许您监控一段时间内从 RDI 管道创建的密钥。

查看 RDI 统计信息

您可以查看 RDI 部署的各种统计信息。为此，请单击左侧菜单面板中的 Pipeline Status 菜单按钮。

每个统计信息部分要么是静态的，要么按您设置的特定间隔自动刷新。 第一部分 Processing performance information （处理性能信息） 默认设置为每 5 秒刷新一次。 其他部分是静态的，需要通过按每个部分右上角的刷新按钮手动刷新。 您还可以为其他部分设置自动刷新。

要为一个或多个统计信息部分设置自动刷新，请单击 Last refresh 行末尾的向下箭头。 然后启用 Auto Refresh 设置并设置所需的刷新间隔（以秒为单位）。如上图所示。

为本页评分
返回顶部 ↑