注意:以下翻译的准确性尚未经过验证。这是使用 AIP ↗ 从原始英文文本进行的机器翻译。
通用连接器可以被用于在表示连接到任意外部系统。作为一个连接器,它不直接支持其他连接器中可用的标准功能。然而,当仅被用作在代码中使用的连接器时,它可以被用于在代码中创建这些标准功能的替代方案,包括批量同步、文件和表格以某种格式导出、流式同步、流式导出、媒体同步、webhooks等。
通过配置通用连接器与适当的运行时、凭证和以某种格式导出控制,开发人员可以使用它编写连接到任意外部系统的代码。当源所有者一起配置网络/运行时、凭证和以某种格式导出控制时,他们可以确保凭证仅与指定的外部系统一起使用,并且在建立连接的不同代码环境中强制执行权限标记。
功能 | 状态 |
---|---|
在代码中使用 | 🟢 普遍可用 |
通用连接器应从代码库环境侧边栏中的新建连接选项创建,而不是通过数据连接应用程序。然而,任何配置的通用连接器将在数据连接中与其他连接器一起出现。
查看我们的外部变换教程,以获取有关如何直接从代码库设置通用连接器的更多信息。
由于通用连接器必须在代码中使用,唯一可用的运行时选项是直接连接用于可接受来自Palantir入站流量的系统,以及代理代理用于位于无法接受来自Palantir入站流量的私有网络中的系统。
仅在数据连接中配置通用连接器时可以选择代理代理运行时选项;在代码库中直接设置通用连接器时无法选择此选项。
从概念上讲,您可以将通用连接器视为一组网络配置、凭证和可导出的权限标记的集合,旨在一起使用。
为了提供上述功能,通用连接器提供以下配置选项:
选项 | 是否必需? | 描述 |
---|---|---|
网络 | 是 | 如果选择了直接连接运行时,则通用连接器支持选择一组出口策略,规定哪些目的地址或IP应可访问。 如果选择了代理代理运行时,代码中使用的客户端必须能够通过代理代理路由流量。 |
凭证 | 否 | 一组键值对可用于存储凭证。目前,仅可存储秘密值。不支持未加密的值。 |
可导出的控制权限标记 | 否 | 如果通用连接器将与Foundry数据输入一起使用,必须启用允许以某种格式导出的设置,并且必须指定一组可导出的权限标记。有关数据连接的以某种格式导出控制的更多信息,请参阅我们的文档。 |
本节提供有关如何从Foundry中的各种代码环境中使用通用连接器的附加信息。
代码环境 | 描述 |
---|---|
Python外部变换 | 使用通用连接器从Python变换库连接到外部系统。 |
计算模块 | 使用通用连接器从长时间运行的计算模块中连接。用于流式同步和导出工作流以及定制的数据输出工作流。 |
TypeScript函数 | 在测试中。联系Palantir支持团队以启用此功能。 |
Python函数 | 处于测试状态。联系Palantir支持团队以启用此功能。 |
通用连接器可以被导入到代码库中。使用此通用连接器,您可以编写代码来访问外部系统并在源上访问凭证。
通用连接器可以被导入到计算模块中。使用此通用连接器,您可以编写与外部系统交互的计算模块。
通用连接器可以被导入到TypeScript函数代码库中。使用此通用连接器,您可以使用fetch
直接调用外部系统。
通用连接器可以被导入到Python函数代码库中。使用此通用连接器,您可以使用Python的requests
库直接调用外部系统。
如果源上仅附有一个用于端口443的DNS地址的出口策略,通用连接器可以转换为REST API源。
执行此转换将使开发人员能够访问用于代码中的内置HTTP客户端,允许开发人员立即编写与外部系统交互的代码。