数据库驱动程序基础知识

Metabase 驱动程序

• 为 Metabase 提供有关数据库的基本信息，例如数据库的功能、连接属性等。
• 为 Metabase 提供有关数据库架构的信息——表（或等价物）、这些表中的字段、外键关系（对于支持外键的数据库）。
  • 此功能由 Metabase 的同步进程使用并存储在应用程序数据库中。
  • 存储的信息用于可视化查询生成器和其他地方，以向用户显示可用的表/列等。
• 将我们内部的查询语言 MBQL 编译为原生查询。
  • MBQL 查询由可视化查询生成器生成。
  • Metabase查询处理器*将 MBQL 查询转换为原生查询
• 执行原生查询并返回结果.

将您的驱动程序编写为模块并打包为插件

Metabase 驱动程序被组织成模块并打包为插件。模块是源代码；插件是由该源代码构建的 JAR 文件。

Metabase 插件是一个 JAR 文件，其中包含编译后的类文件和 Metabase插件清单，该清单列出了有关驱动程序的详细信息。在大多数情况下，插件是惰性加载的，这意味着 Metabase 在连接到将使用该驱动程序的数据库之前不会初始化驱动程序。

要让 Metabase 使用您的驱动程序，您只需将构建的驱动程序 JAR 文件放入 /plugin 目录中，您会在运行 metabase.jar 的同一目录中找到它。大致如下

/Users/cam/metabase/metabase.jar
/Users/cam/metabase/plugins/my-plugin.jar

您可以通过设置环境变量 MB_PLUGINS_DIR 来更改插件目录。

示例模块目录

让我们高层概览一下SQLite 驱动程序

|-- deps.edn
|-- resources
|   `-- metabase-plugin.yaml
|-- src
|   `-- metabase
|       `-- driver
|           `-- sqlite.clj
`-- test
    `-- metabase
        |-- driver
        |   `-- sqlite_test.clj
        `-- test
            `-- data
                `-- sqlite.clj

这里有三个文件需要注意

deps.edn

deps.edn 文件指定了驱动程序的依赖项。

resources/metabase-plugin.yaml

您的驱动程序的清单包含有关您驱动程序的详细信息。

src/metabase/driver/sqlite.clj

这是您驱动程序的核心文件。我们将在实现多方法中进一步讨论它。

下一步

我们将了解更多关于插件清单的信息。