数据连接
重要
To simplify the shift from Data Connections to DCM Connections, starting with the Server 2024.2 release it is possible to migrate all Data Connections and respective workflows to be replaced by DCM Connections.
First, it is necessary to migrate each data connection and then trigger the migration of workflows. Check our Maveryx Community blog post How to migrate Server Data Connections to DCM for more information.
注意
Server-FIPS
我们移除了旧版 Server 数据连接。您可以改用数据连接管理器 (DCM) 功能。已启用 DCM 强制执行模式,并且无法在支持 FIPS 标准的 Server 版本中更改。DCM 具有以下优势:在工作流之外安全地存储用于建立数据连接的用户凭证,提高了安全性,改进了密码凭证的可管理性,以及实现 Server 和 Designer 之间的凭证同步。有关详细信息,请访问 DCM - Server 帮助页面。
在 Server 管理员界面 的 数据连接 页面上,Server 管理员可以创建 Server 数据连接,以允许 Server 用户连接到数据库。配置完成后,已添加 Server 的用户可以从列表中选择和使用这些数据源。
注意
Server 中的数据连接与 Designer 中的数据连接不同。如需详细了解 Designer 中的数据连接,请前往 管理数据连接 和 管理数据库内连接 。
Server 数据连接不能用于数据库内连接。
添加数据连接
在 数据连接 页面上,点击 + 添加新项 。
在 技术 下拉列表中选择连接类型。
在 名称 中,输入连接名称。
在 主机 中,输入 SQL 数据库主机名。
选择一个身份验证选项。
Windows :为数据连接使用默认凭证或输入特定凭证。
SQL Server :键入服务器凭证。密码中不支持管道字符。
(可选)点击 测试连接 。将显示连接验证或失败消息。如果测试失败,您可以保存连接。
(可选)选择 数据库 ,查看服务器上的数据库列表。仅当连接测试成功时,才会显示列表。
选择一个数据库以将其设置为此连接的默认数据库。
选择 键入数据库名称 并输入服务器上的数据库的名称。确保服务器名称中包含正斜杠 (\),例如 RM-LT-013\SQLEXPRESS2。
选择 创建 。
所有字段均为必填。填写所需信息后,测试连接。
在 名称 中,输入连接名称。
在 主机 中,输入 Oracle 服务器主机名或 IP 地址。
在 服务名称 中,输入网络上基于 TNS 的应用程序的名称。如果仅存在一个服务,则此信息是可选的。
在 端口 中,输入 Oracle 数据库的网络侦听端口。默认值为 1521。
在 用户名 和 密码 中,输入数据连接的用户名和密码。密码中不支持管道字符。
(可选)点击 测试连接 。将显示连接验证或失败消息。如果测试失败,您可以保存连接。
选择 创建 。
在 名称 中,输入连接的名称。
在 Connection String(连接字符串) 中输入连接字符串。
连接字符串长度不得超过 212 个字符。
建议不要在连接中使用数据源名称 (DSN)。这种连接也称为非 DSN 连接。
从 Designer 复制连接字符串
您可以从在 Designer 中创建的数据连接中复制连接字符串并粘贴于此。为此,请以管理员身份登录 Designer。转至 选项 > 高级选项 > 管理数据连接 。
选择 创建 。
测试数据连接
多节点 Server 上的连接测试
Server 的多节点配置具有一个控制器以及至少两台工作程序计算机。在此配置中,测试功能会测试控制器计算机上的连接,而不是各个工作程序计算机上的连接。为了确保连接在任何计算机上都能正常工作,请确认每台计算机上都安装了相同的数据库驱动程序和驱动程序版本。
连接测试失败
连接测试失败的原因有很多。这些是连接测试失败的最常见原因。
您无权访问服务器或数据库。例如,在某些情况下,只有连接终端用户才有权访问服务器或数据库。
网络安全机制还会阻止您连接到服务器或数据库。
服务器无法连接到数据库服务器主机。要进行排错,请 ping 数据库服务器主机以确保在登录到安装 Server 的服务器时存在网络连接。
数据库的凭证无效或没有适当的访问权限。请联系数据库管理员。
数据库处于脱机状态。请联系数据库管理员,确认数据库处于联机状态并ru期运行。
您运行de'shi Server 的多节点配置。
您仍然可以保存未能通过连接测试的数据连接。
连接测试中使用的默认凭证
您可以使用 Windows 身份验证或 SQL Server 身份验证来创建 Microsoft SQL Server 连接。对于 Windows 身份验证,您可以为数据连接使用默认凭证或特定凭证。您可以在多个位置设置默认凭证。Server 会在这些位置查找可用凭证,并按以下顺序选择默认凭证:
System Settings > Worker > Run As 。如需详细了解用户的运行身份,请转至 Worker(工作程序) 帮助页面。
Windows Server Manager(Windows 服务器管理器) > Tools(工具) > Services(服务) 。找到 AlteryxService ,然后右键单击并选择 Properties(属性) 。 Log On(登录) 选项卡的 This account(此帐户) 下的凭证。
本地计算机。
如果凭证无效,连接测试将会失败。
共享数据连接
创建数据连接后,返回 数据连接 页面,与要在 Designer 中使用的用户或自定义用户组共享连接。
重要
要使工作流能够由特定用户或用户组运行,您需要请求 Server 管理员确保提供其所需的数据连接。
在 数据连接 页面上,选择要共享的数据连接。
在 编辑数据连接 屏幕上,选择 用户 或 自定义用户组 。
点击 + 新建 。
输入用户或用户组的名称。
选择用户或用户组。
选择 添加 。
您与之共享连接的用户、用户组或工作室会在相应的选项卡上列出。前往 Designer 帮助中的 输入数据工具 和 管理数据连接 ,了解用户如何在 Designer 中访问和管理共享连接。
重要
对于 Microsoft SQL Server 连接,请确认用户在其计算机上安装了相同或更新版本的 Microsoft SQL Server Native Client。转至 排错 。
撤销对数据连接的访问权限
要撤销用户对连接的访问权限,请在与此用户对应的 三点菜单 中选择 删除 。要确认,请点击 删除 。
编辑数据连接
在 数据连接 页面上,选择要编辑的数据连接。
在 编辑数据连接 屏幕中,点击 编辑 。
编辑 名称 或 连接字符串 中的信息。
选择 保存 。
在 用户 或 自定义用户组 选项卡上,您可以 与用户和用户组共享连接 。
删除数据连接
要删除连接,请在此连接的对应 三点菜单 中选择 删除 。然后点击 删除 。
Migrate Data Connections and Workflows to DCM
To shift from Data Connections to DCM Connections, migrate all Data Connections and respective workflows.
Migrate a Data Connection to DCM
As the first step in Data Connection migration, it is necessary to link the Data Connection to a DCM Connection, to be used as a replacement in workflows. Alteryx will assist you in finding the right DCM Connection and share the DCM Connection with the same set of users and user groups.
On the Data Connection detail page, select Migrate to DCM.
On the Migrate Connection to DCM screen, select the DCM Connection you want to associate the Data Connection with from the list of all DCM Connections present on Server.
Alteryx tries to find the best matching DCM Connection and loads it into the dropdown. It also groups all available DCM Connections into categories, depending on the type of match with the Server Data Connection. The groups are Perfect Match, Partial Match, Unresolved Vault, or Unmatched. For more information about these groups, go to Migration Tool.
Choose whether you want to Share to Existing Users. This shares the DCM Connection for collaboration with the same set of users and user groups as the migrated Data Connection. This option is enabled by default.
注意
The DCM Connection gets shared for collaboration with all associated credentials. This is to reflect the Data Connection sharing behavior, allowing users to see and use the DCM Connection in Alteryx Designer. If you want to change which of the credentials are shared with others, initiate the Sharing for Collaboration first and then proceed with the migration.
You must be the DCM Connection owner to be able to share it with others. You may still proceed with the Data Connection migration, but it’s then on the owner to share the DCM Connection manually.
While workflows using Server Data Connections can be run by any Server user (with permission to the workflow), that’s not the case for DCM Connections. Sharing to Run on Server on the DCM Connection has to be initialized for all users, who would be running this workflow.
DCM Connections can’t be shared with Private Studios. These are currently ignored during this step.
Select Migrate.
Once this process is complete, the Data Connection is in a Migrated state. This means the Data Connection is still available to everyone, but can’t be shared or modified anymore, with all such actions now only available on the DCM Connection instead. No changes are made to the existing workflows at this point.
It is possible to Remigrate the Data Connection, which triggers the migration process described above. It allows you to choose a different DCM Connection to migrate to. Note: This doesn’t affect the sharing of the DCM Connection from the initial migration.
Migrate Workflows to DCM
After linking DCM Connections to your Data Connections, you can proceed with workflow migration. This process scans all workflows on the Server for Data Connections and replaces them with the linked DCM Connections. Workflows not containing any Data Connections are skipped.
On the Data Connections page, select Migrate Workflows to DCM.
To confirm the workflow migration, select Migrate in the Migrate Workflows dialogue.
All workflows stored on the Server are then checked for Data Connections to be automatically replaced by the associated DCM Connections.
Workflow is migrated only when all data connections used in that workflow are migrated to DCM.
A new version is created for each workflow migrated.
While it is possible to initiate the workflow migration repeatedly, only one migration can run on the Server at a time.
The status of the migration is visible on top of the Data Connections page. Refresh the page to update the current status.
Supported Technologies and Limitations
The following workflow file formats are supported:
YXMD (regular workflow)
YXWZ (analytic apps)
YXMC (macros)
Data connections uploaded as a data package (YXZP format) are not migrated because they don't include the metadata for the connections. As a result, they can't be migrated automatically.
Workflow is migrated only when all data connections used in that workflow are migrated to DCM.
All Server aliases in the Input Data and Output Data tools are gathered and replaced during workflow migration. Other tools are unsupported.
On a multi-node Server setup, the migration log will be present only on a node where the migration runs. Such is selected at random.
疑难解答
没有,您可以创建和共享数据连接,而无需测试。如果数据连接未通过连接测试,您也可以保存该数据连接。
连接测试失败的原因有很多。这些是连接测试失败的最常见原因。
您无权访问服务器或数据库。例如,在某些情况下,只有连接终端用户才有权访问服务器或数据库。
网络安全机制还会阻止您连接到服务器或数据库。
服务器无法连接到数据库服务器主机。要进行排错,请 ping 数据库服务器主机以确保在登录到安装 Server 的服务器时存在网络连接。
数据库的凭证无效或没有适当的访问权限。请联系数据库管理员。
数据库处于脱机状态。请联系数据库管理员,确认数据库处于联机状态并ru期运行。
您正在运行 Server 的多节点配置。如需了解多节点 Server 上的连接测试,请参阅本文中的 测试连接 部分。
您仍然可以保存未能通过连接测试的数据连接。
您可以使用 Windows 身份验证或 SQL Server 身份验证来创建 Microsoft SQL Server 连接。对于 Windows 身份验证,您可以为数据连接使用默认凭证或特定凭证。您可以在多个位置设置默认凭证。Server 会在这些位置查找可用凭证,并按以下顺序选择默认凭证:
System Settings > Worker > Run As 。如需详细了解用户的运行身份,请转至 Worker(工作程序) 帮助页面。
Windows Server Manager(Windows 服务器管理器) > Tools(工具) > Services(服务) 。找到 AlteryxService ,然后右键单击并选择 Properties(属性) 。 Log On(登录) 选项卡的 This account(此帐户) 下的凭证。
本地计算机。
如果凭证无效,连接测试将会失败。
用户在 Designer 中看不到 Server 数据连接的原因有很多。请按照以下步骤进行排错。
确认您已与用户共享数据连接。编辑数据连接并在用户和工作室列表中查找用户。
确认用户用于登录 Server UI 的电子邮件地址与您所共享连接的地址相同。
要求用户从 Designer 中移除 Server 然后使用正确的凭证重新添加 Server。
如果要将与工作室的连接进行共享,请确认用户有权访问该工作室。
如果尝试使用在某一计算机上创建的数据连接,而这台计算机使用的 Microsoft SQL Server 驱动程序版本与正在使用数据连接的计算机不同,则用户可能会在 Designer 或 Server 中收到此错误。
这台计算机必须具有相同版本或更新版本的 Microsoft SQL Server 驱动程序。例如,如果正在使用数据连接的计算机使用 10.0 版 Microsoft SQL Server 驱动程序,而在其中创建数据连接的计算机使用的是 11.0 版,则会显示错误消息。
在 Designer 中创建工作流并将其保存到 Server 的用户可能无权使用共享数据连接。要进行排错,请执行以下步骤。
打开 AlteryxService 日志 (AlteryxServiceLog.log)。服务日志保存在配置期间设定的位置。如需了解详情,请转至 配置及使用日志 。
搜索错误发生的时间戳并查看错误描述。
如果描述显示“无法找到数据连接的权限:[数据连接名称]”,则用户无权访问数据连接。
编辑数据连接并将其共享给用户。