SPI 概述

当您实现一个新的 openLooKeng 插件时，您将实现多个接口并覆盖 SPI 定义的方法。插件可以提供额外的连接器、类型、函数和系统访问控制。特别地，连接器是用于在 openLooKeng 中进行查询的所有数据的源：它们支持 openLooKeng 可用的每个目录。

代码

可以在 openLooKeng 源代码树根目录下的 presto-spi 目录中找到 SPI 源代码。

插件元数据

每个插件标识一个入口点：Plugin 接口的实现。该类名通过标准 Java ServiceLoader 接口提供给 openLooKeng：classpath 包含 META-INF/services 目录中一个名为 io.prestosql.spi.Plugin 的资源文件。该文件的内容只有一行，其中列出了插件类的名称：

  1. com.example.plugin.ExamplePlugin

对于包含在 openLooKeng 源代码中的内置插件，每当插件的 pom.xml 文件包含以下行时，就会创建该资源文件：

  1. <packaging>hetu-plugin</packaging>

插件

对于想要了解 openLooKeng SPI 的开发人员而言，Plugin 接口是一个很好的起点。该接口包含用于检索插件可以提供的各种类的访问方法。例如，getConnectorFactories() 方法是一个顶层函数，当 openLooKeng 可以创建连接器实例来支持目录时，openLooKeng 会调用该函数来检索 ConnectorFactory。Type、ParametricType、Function、SystemAccessControl 和 EventListenerFactory 对象具有类似的方法。

通过 Maven 构建插件

插件依赖于 openLooKeng 的 SPI：

  1. <dependency>
  2.     <groupId>io.prestosql</groupId>
  3.     <artifactId>presto-spi</artifactId>
  4.     <scope>provided</scope>
  5. </dependency>

由于 openLooKeng 在运行时提供来自 SPI 的类，因此插件不应在插件程序集中包含这些类，所以插件使用 Maven provided 范围。

openLooKeng 还提供了其他一些依赖项，包括 Slice 和 Jackson 注释。特别地，Jackson 用于序列化连接器句柄，因此插件必须使用 openLooKeng 提供的注释版本。

所有其他依赖项都基于插件自身实现所需的内容。插件加载在一个单独的类加载器中，以提供隔离并允许插件使用 openLooKeng 内部使用的库的不同版本。

有关示例 pom.xml 文件，请参见 openLooKeng 源代码树根目录下 presto-example-http 目录中的示例 HTTP 连接器。

部署自定义插件

要在 openLooKeng 安装中添加自定义插件，请在 openLooKeng 插件目录中为该插件创建一个目录，并且在该目录中添加此插件的所有必需 JAR 文件。例如，对于名为 my-functions 的插件，您应在 openLooKeng 插件目录中创建 my-functions 目录，并在该目录中添加相关的 JAR 文件。

默认情况下，插件目录是相对于 openLooKeng 安装目录的 plugin 目录，但可以使用配置变量 catalog.config-dir 来配置插件目录。为了使 openLooKeng 能够识别新插件，您必须重新启动 openLooKeng。

必须在 openLooKeng 集群的所有节点（协调节点和工作节点）上安装插件。