New

The executive guide to generative AI

Read more
About usPartnersSupport|Login
« Elastic Zoom 连接器参考 从 Docker 容器运行 »
Elastic 文档 ›Elasticsearch 指南 [8.17] ›使用 Elastic 连接器摄取内容

自管理连接器

编辑

自管理连接器

编辑

命名历史

自管理连接器最初被称为“连接器客户端”。您可能会在较旧的文档中找到此术语。

自管理 Elastic 连接器在您自己的基础设施上运行。这意味着它们在您的 Elastic 部署之外运行。

您可以从源代码或 Docker 容器运行连接器服务。

我们还提供了一个使用 Docker Compose 的快速启动选项，可以一次启动所有必需的服务：Elasticsearch、Kibana 和连接器服务。有关更多信息，请参阅Docker Compose 快速启动。

以下连接器可作为自管理连接器使用

可用性和 Elastic 先决条件

编辑

自管理连接器目前不支持 Windows。使用此兼容性矩阵来检查自管理连接器支持哪些操作系统。在该页面的自管理连接器下查找此信息。

展开查看 Elastic 先决条件信息

您的 Elastic 部署必须包含以下 Elastic 服务

  • Elasticsearch
  • Kibana

（新的 Elastic Cloud 部署默认包含这些服务。）

要运行自管理连接器，您自行部署的连接器服务版本必须与您的 Elasticsearch 版本匹配。例如，如果您运行 Elasticsearch 8.10.1，则您的连接器服务应为 8.10.1.x 版本。Elastic 不支持运行版本不匹配的部署（升级期间除外）。

从 8.10.0 开始，新的自管理连接器不再需要 Enterprise Search 服务。但是，如果您从早于 8.9 的版本升级连接器，则需要运行 Enterprise Search 一次才能将连接器迁移到新格式。在未来的版本中，您可能仍然需要运行 Enterprise Search 以进行迁移或升级。

您必须有权访问 Kibana，并且对 .elastic-connectors 索引具有 write 索引权限。

要在自管理环境中使用连接器客户端，您必须部署连接器服务。

支持和许可要求

根据您使用自管理连接器的方式，支持和许可要求会有所不同。

有关详细信息，请参阅以下订阅页面。在客户端集成下的Elastic Search部分中找到您感兴趣的连接器

请注意有关自管理连接器支持的以下信息

  • Elastic 支持转换但未修改的托管连接器。
  • Elastic 不支持转换但自定义的托管连接器。

数据源先决条件

在部署连接器之前，您需要做的第一个决定是要将哪个第三方服务（数据源）同步到 Elasticsearch。请注意，每个数据源都有特定的先决条件，您需要满足这些先决条件才能授权连接器访问其数据。例如，某些数据源可能需要您创建 OAuth 应用程序或创建服务帐户。

您需要查看各个连接器的文档以了解这些详细信息。

部署连接器服务

编辑

连接器服务是一个 Python 应用程序，使用自管理连接器时，您必须在自己的基础设施上运行它。源代码托管在elastic/connectors存储库中。

您可以从源代码运行连接器服务或使用 Docker

教程

编辑

这些示例使用 PostgreSQL 连接器，但基本过程对于所有自管理连接器都是相同的。

连接器测试

编辑

连接器框架使您能够针对真实数据源对自管理连接器运行端到端 (E2E) 测试。

为了避免篡改真实的 Elasticsearch 实例，E2E 测试在 Docker 中运行一个隔离的 Elasticsearch 实例。配置值在您的 docker-compose.yml 文件中设置。Docker Compose 管理开发环境的设置，包括模拟 Elastic 实例和模拟数据源。

E2E 测试使用连接器的默认配置值。在每个连接器的文档中查找有关测试的说明。

连接器框架

编辑

Elastic 连接器框架使您能够

  • 自定义现有的自管理连接器。
  • 构建您自己的自管理连接器。

有关更多信息，请参阅构建和自定义连接器。

« Elastic Zoom 连接器参考 从 Docker 容器运行 »

On this page

Was this helpful?
Feedback