注意:以下翻译的准确性尚未经过验证。这是使用 AIP ↗ 从原始英文文本进行的机器翻译。

通用连接器

通用连接器可以被用于在表示连接到任意外部系统。作为一个连接器,它不直接支持其他连接器中可用的标准功能。然而,当仅被用作在代码中使用的连接器时,它可以被用于在代码中创建这些标准功能的替代方案,包括批量同步、文件和表格以某种格式导出、流式同步、流式导出、媒体同步、webhooks等。

通过配置通用连接器与适当的运行时、凭证和以某种格式导出控制,开发人员可以使用它编写连接到任意外部系统的代码。当源所有者一起配置网络/运行时、凭证和以某种格式导出控制时,他们可以确保凭证仅与指定的外部系统一起使用,并且在建立连接的不同代码环境中强制执行权限标记。

支持的功能

功能状态
在代码中使用🟢 普遍可用

设置

通用连接器应从代码库环境侧边栏中的新建连接选项创建,而不是通过数据连接应用程序。然而,任何配置的通用连接器将在数据连接中与其他连接器一起出现。

查看我们的外部变换教程,以获取有关如何直接从代码库设置通用连接器的更多信息。

网络

由于通用连接器必须在代码中使用,唯一可用的运行时选项是直接连接用于可接受来自Palantir入站流量的系统,以及代理代理用于位于无法接受来自Palantir入站流量的私有网络中的系统。

仅在数据连接中配置通用连接器时可以选择代理代理运行时选项;在代码库中直接设置通用连接器时无法选择此选项。

配置选项

从概念上讲,您可以将通用连接器视为一组网络配置凭证可导出的权限标记的集合,旨在一起使用。

  • 网络配置指定使用此通用连接器从代码中应可访问哪个系统。
  • 凭证指定必须可用的秘密值以成功连接。
  • 可导出的权限标记指定哪些数据可以安全地离开Palantir平台到指定的网络目的地。

为了提供上述功能,通用连接器提供以下配置选项:

选项是否必需?描述
网络如果选择了直接连接运行时,则通用连接器支持选择一组出口策略,规定哪些目的地址或IP应可访问。

如果选择了代理代理运行时,代码中使用的客户端必须能够通过代理代理路由流量。
凭证一组键值对可用于存储凭证。目前,仅可存储秘密值。不支持未加密的值。
可导出的控制权限标记如果通用连接器将与Foundry数据输入一起使用,必须启用允许以某种格式导出的设置,并且必须指定一组可导出的权限标记。有关数据连接的以某种格式导出控制的更多信息,请参阅我们的文档

在代码中使用通用连接器

本节提供有关如何从Foundry中的各种代码环境中使用通用连接器的附加信息。

代码环境描述
Python外部变换使用通用连接器从Python变换库连接到外部系统。
计算模块使用通用连接器从长时间运行的计算模块中连接。用于流式同步和导出工作流以及定制的数据输出工作流。
TypeScript函数在测试中。联系Palantir支持团队以启用此功能。
Python函数处于测试状态。联系Palantir支持团队以启用此功能。

Python外部变换

通用连接器可以被导入到代码库中。使用此通用连接器,您可以编写代码来访问外部系统并在源上访问凭证。

了解有关基于源的外部变换的更多信息。

计算模块

通用连接器可以被导入到计算模块中。使用此通用连接器,您可以编写与外部系统交互的计算模块。

TypeScript函数

通用连接器可以被导入到TypeScript函数代码库中。使用此通用连接器,您可以使用fetch直接调用外部系统。

Python函数

通用连接器可以被导入到Python函数代码库中。使用此通用连接器,您可以使用Python的requests库直接调用外部系统。

通用连接器的转换

如果源上仅附有一个用于端口443的DNS地址的出口策略,通用连接器可以转换为REST API源

执行此转换将使开发人员能够访问用于代码中的内置HTTP客户端,允许开发人员立即编写与外部系统交互的代码。

提示将通用连接器转换为REST API源的提示框。