跳到主要内容 跳到补充内容
Qlik 资源

Microsoft Fabric

您可以使用 Microsoft Fabric 作为数据管道中的目标数据平台。在数据管道中，可以在目标平台上执行各种操作，包括登陆数据、存储数据、转换数据、创建数据集市和注册数据。

信息注释Microsoft Fabric 端点当前处于预览中，因为它是使用 Microsoft Fabric Public Preview 开发和测试的。在公开预览版和正式发布版之间对 Microsoft Fabric 的更改可能会影响连接器特性。
信息注释需要 数据移动网关 2023.5.15 或更高版本。

将 Microsoft Fabric 设定为目标涉及以下方面：

  • 满足先决条件
  • 正在配置到云暂存区域（Azure 数据湖存储）的连接。如果您正在注册现有数据，则不需要执行此操作。
  • 配置连接，指向 Microsoft Fabric

设置云暂存区

信息注释如果您正在注册现有数据，则无需设置云暂存区。

您还需要一个 Azure Data Lake Storage 云暂存区，在应用和存储之前，数据和更改都在那里暂存。有关设置与 Azure 数据湖存储的连接的信息，请参阅Azure Data Lake Storage。

设置 Microsoft Fabric 连接属性

提供 Azure 数据湖存储目标设置后，选择 Microsoft Fabric 目标连接器并提供以下设置：

数据目标

数据网关：只有当目标数据库无法从 Qlik Cloud 访问时（例如，如果它位于或虚拟专用云中），才需要 数据移动网关，并且只能使用私有链接访问。如果是这种情况，请选择要通过其访问目标数据库的 数据移动网关。

根据您的使用情况，这将是从数据源部署到陆地数据的相同 数据移动网关，或者是与之不同的。有关可能的 数据移动网关 部署可能性的信息，请参阅常见用例。

信息注释需要 数据移动网关 2023.5.11 或更高版本。

如果可以从 Qlik Cloud 直接访问目标数据库，请选择无。

信息注释通过 数据移动网关 访问目标数据库时，还需要在 数据移动网关 计算机上安装相应的驱动程序。有关详细信息，请参见下文的Microsoft Fabric。

连接属性

  • 服务器：您正在使用的 Microsoft Fabric Data Warehouse 服务器的名称。

帐户属性

验证方式：选择以下选项之一：

  • Azure Active Directory 服务原则

    然后在指定字段中提供您的客户端 ID 和客户端机密。

  • Azure Active Directory 用户原则

    然后在指定字段中提供用户名和密码。

数据库属性

  • 数据库名称：有两种方法可以用于指定数据库：

    • 方法 1 - 从列表中选择：单击加载数据库，然后选择一个数据库。
    • 方法 2 - 手动：选择手动输入数据库名称，然后输入数据库名称。

数据加载

  • SAS 令牌：将由 Microsoft Fabric 用于访问 ADLS 存储帐户的 SAS 令牌。如果您正在注册现有数据，则不需要执行此操作。

名称

连接的显示名称。

先决条件

数据库权限

Microsoft Fabric 连接器 设置的 ODBC 访问部分中指定的 Azure Active Directory 用户/服务主体必须被授予贡献者角色。

驱动程序设置

只有通过 数据移动网关 访问数据库时才需要驱动程序。在这种情况下，您需要在 数据移动网关 计算机上安装驱动程序。

您可以使用驱动程序安装实用程序（推荐）安装 driver 或手动安装。只有在您遇到驱动程序安装实用程序发生问题的少见情况下，才应尝试手动安装。

使用驱动程序安装实用程序安装驱动程序

本部分介绍如何安装所需的 driver。这个过程包括运行一个脚本，该脚本将自动下载、安装和配置所需的 driver。您还可以根据需要运行脚本来更新和卸载 driver。

准备安装

  • 请确保在 数据移动 网关服务器上安装了 Python 3.6 或更高版本。

    Python 预装在大多数 Linux 发行版上。您可以通过运行以下命令来检查系统上安装了哪个 Python 版本。

    python3 --version

安装 driver

下载并安装 driver ：

  1. 停止 数据移动网关 服务：

    sudo systemctl stop repagent

  2. 可选择确认服务已停止：

    sudo systemctl status repagent

    状态应如下所示：

    Active: inactive (dead) since <timestamp> ago

  3. 在 数据移动 网关计算机上，将工作目录更改为：

    opt/qlik/gateway/movement/drivers/bin

  4. 然后运行以下命令：

    语法：

    ./install fabric

    如果无法下载 driver（由于访问限制或技术问题），将显示一条消息，为您指示在 数据移动 网关机器上下载 driver 的位置和复制驱动程序的位置。完成此操作后，请再次运行 install fabric 命令。

    否则，将显示 driver 的 EULA。

  5. 执行以下选项之一：

    • 重复按 [Enter] 可在 EULA 中缓慢滚动。
    • 重复按空格键可快速滚动 EULA。
    • 按 q 退出许可证文本并显示 EULA 接受选项。

  6. 执行以下操作之一：

    • 键入 "y" 并按 [Enter] 接受 EULA 并开始安装。
    • 键入 "n" 并按 [Enter] 拒绝 EULA 并退出安装。

    • 键入“v”并按 [Enter] 以再次查看 EULA。

    7. 将会安装 driver。

  7. 等待安装完成（以“完成！”指示），然后启动 数据移动网关 服务：

    sudo systemctl start repagent

  8. 可选择确认服务已启动：

    sudo systemctl status repagent

    状态应如下所示：

    Active: active (running) since <timestamp> ago

更新 driver

如果要在安装提供的 driver 之前卸载以前版本的 driver，请运行 update 命令。

下载并更新 driver：

  1. 停止 数据移动网关 服务：

    sudo systemctl stop repagent

  2. 可选择确认服务已停止：

    sudo systemctl status repagent

    状态应如下所示：

    Active: inactive (dead) since <timestamp> ago

  3. 在 数据移动 网关计算机上，将工作目录更改为：

    opt/qlik/gateway/movement/drivers/bin

  4. 然后运行以下命令：

    语法：

    ./update fabric

    如果无法下载 driver（由于访问限制或技术问题），将显示一条消息，为您指示在 数据移动 网关机器上下载 driver 的位置和复制驱动程序的位置。完成此操作后，请再次运行 update fabric 命令。

    否则，将显示 driver 的 EULA。

  5. 执行以下选项之一：

    • 重复按 [Enter] 可在 EULA 中缓慢滚动。
    • 重复按空格键可快速滚动 EULA。
    • 按 q 退出许可证文本并显示 EULA 接受选项。

  6. 执行以下操作之一：

    • 键入 "y" 并按 [Enter] 接受 EULA 并开始安装。
    • 键入 "n" 并按 [Enter] 拒绝 EULA 并退出安装。
    • 键入“v”并按 [Enter] 可从头开始查看 EULA。

    7. 将卸载旧的 driver，并安装新的 driver。

  7. 等待安装完成（以“完成！”指示），然后启动 数据移动网关 服务：

    sudo systemctl start repagent

  8. 可选择确认服务已启动：

    sudo systemctl status repagent

    状态应如下所示：

    Active: active (running) since <timestamp> ago

卸载 driver

如果要卸载 driver，请运行 uninstall 命令。

卸载 driver：

  1. 停止所有配置为使用此连接器的任务。

  2. 在 数据移动 网关计算机上，将工作目录更改为：

    opt/qlik/gateway/movement/drivers/bin

  3. 然后运行以下命令：

    语法：

    ./uninstall fabric

    将卸载 driver。

手动安装驱动程序

只有在自动驱动程序安装未成功完成的情况下，才应尝试手动安装 driver。

您需要同时安装 ODBC 驱动程序和 JDBC 驱动程序。

安装 ODBC 驱动程序

在安装 数据移动网关 后，下载 msodbcsql<版本>.x86_64.rpm 驱动程序。您可以在此路径下面找到受支持版本的直接下载链接：/opt/qlik/gateway/movement/drivers/manifests/fabric.yaml 中的 binary-artifacts。下载完成后，将 RPM 复制到 数据移动网关 机器上。

  1. 停止 数据移动网关 服务：

    sudo systemctl stop repagent

  2. 可选择确认服务已停止：

    sudo systemctl status repagent

    3. 状态应如下所示：

    Active: inactive (dead) since <timestamp> ago

  3. 在 数据移动网关 计算机上安装驱动程序。

  4. 如下将驱动程序位置复制到 site_arep_login.sh 文件：

    echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/microsoft/msodbcsql<version>/lib64/" >> site_arep_login.sh

    示例：

    echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/microsoft/msodbcsql17/lib64/" >> site_arep_login.sh

    这将把驱动程序添加到 "LD_LIBRARY_PATH" 并更新驱动程序位置于 site_arep_login.sh 文件。

  5. 可选择确认已将驱动程序位置复制：

    cat site_arep_login.sh

  6. 启动 数据移动网关 服务：

    sudo systemctl start repagent

  7. 可选择确认服务已启动：

    sudo systemctl status repagent

    状态应如下所示：

    Active: active (running) since <timestamp> ago

安装 JDBC 驱动程序

  1. 下载 /opt/qlik/gateway/movement/drivers/manifests/fabric.yaml 中 binary-artifacts 下列出的以下 JAR 文件：然后将文件复制到 数据移动网关 计算机上的以下文件夹中：

    /opt/qlik/gateway/movement/qcs_agents/qdi-db-commands/lib

  2. 通过运行重新启动服务中所述的命令重新启动 数据移动网关 服务

警告注释如果您使用的是 Microsoft SQL Server 数据源（基于 CDC 或基于日志），卸载结构驱动程序也会中断与 SQL Server 的连接，因为它们共享相同的驱动程序。

端口

打开端口 1433 以进行出站通信。

限制和考虑事项

以下操作不受支持，也不会应用于目标：

  • 截断表
  • 重命名列
  • ADD/DROP/ALTER 列

数据类型

下表显示了使用 Qlik Cloud 时支持的 Microsoft Fabric 数据类型以及自 Qlik Cloud 数据类型的默认映射。

本机数据类型信息将被保留，并显示在数据集视图的本机数据类型列中。如果列不可见，则需要打开数据集视图的列选择器，然后选择本机数据类型列。

支持的数据类型
数据移动网关 数据类型 Microsoft Fabric 数据类型

BOOL

BIT

BYTES

如果长度为 1-8000，则：

VARBINARY（以字节计算的长度）

如果长度超出 8000，则：

VARBINARY (8000)

DATE

DATE

TIME

如果刻度为 0-6，则：

TIME（刻度）

如果刻度超过 6，则：

TIME (6)

DATETIME

如果刻度为 0-6，则：

DATETIME2（刻度）

如果刻度超过 6，则：

DATETIME2 (6)

INT1

SMALLINT

INT2

SMALLINT

INT4

INT

INT8

BIGINT

NUMERIC

DECIMAL (p,s)

REAL4

FLOAT(24)

REAL8

FLOAT(53)

STRING

如果长度按字节计为 1-8000，则：

VARCHAR（以字节计算的长度）

如果长度按字节计超出 8000，则：

VARCHAR (8000)

UINT1

SMALLINT

UINT2

INT

UINT4

BIGINT

UINT8

DECIMAL (20,0)

WSTRING

如果长度按字节计为 1-8000，则：

VARCHAR（以字节计算的长度）

如果长度按字节计超出 8000，则：

VARCHAR (8000)

BLOB

VARCHAR (8000)

NCLOB

VARCHAR (8000)

CLOB

VARCHAR (8000)

信息注释不支持完整 LOB 数据类型。有关在 登陆 中包括有限大小 LOB 数据类型的信息，请参阅从数据源登陆数据。

本页面有帮助吗？

如果您发现此页面或其内容有任何问题 – 打字错误、遗漏步骤或技术错误 – 请告诉我们如何改进！

在此处留下您的反馈