Oracle

要添加数据库连接,请点击右上角的齿轮图标,然后转到管理设置 > 数据库 > 添加数据库

设置

您可以在任何时间编辑这些设置。只需记住保存您的更改。

显示名称

数据库在Metabase界面中的显示名称。

主机

您的数据库的IP地址,或其域名(例如,esc.mydatabase.com)。

端口

数据库端口。例如,1521。

Oracle系统ID(SID)

通常是类似于ORCL或XE的名称。如果使用服务名称,则可选。

Oracle服务名称

可选的TNS别名。

用户名

您想要用于连接数据库的数据库用户名。您可以使用不同的用户帐户设置多个连接到同一数据库,每个帐户都有不同的权限集。

密码

连接到数据库所使用的用户名的密码。

使用安全连接(SSL)

您可以同时使用客户端和服务器身份验证(称为相互认证)。

使用密钥库进行客户端身份验证

为了配置服务器(Oracle服务器)以验证客户端(Metabase)的标识,您需要配置一个密钥库文件,该文件包含客户端的私钥。

您将客户端的私钥导入密钥库(而不是将根CA导入到信任库文件中)。为Metabase添加以下JVM选项

-Djavax.net.ssl.keyStore=/path/to/keystore.jks
-Djavax.net.ssl.keyStoreType=JKS \
-Djavax.net.ssl.keyStorePassword=<keyStorePassword>

完成此操作后,当Metabase尝试通过SSL连接时,Oracle服务器将使用私钥进行认证。

使用信任库进行服务器身份验证

为了配置客户端(Metabase)以验证服务器的标识(Oracle服务器),您可能需要配置一个包含服务器根CA的信任库文件,以便Metabase的JVM信任其证书链。请参阅有关使用keytool管理密钥和信任库文件、导入证书等的Oracle文档

有关为AWS RDS Oracle实例设置信任库的更多信息,请参阅Amazon提供的方法

如果您需要使用SSL连接到其他数据库,而不是创建新的信任库,您可能希望将RDS CA添加到现有的信任库文件(可能称为cacerts)中。

支持的Oracle数据库和Oracle驱动程序版本

  • 驱动程序版本:最低Oracle驱动程序版本应为19c,无论您使用的是哪个Java版本或Oracle数据库版本。
  • 数据库版本:最低数据库版本应为版本19c,因为Oracle 不再支持19版本之前的数据库版本

下载Oracle JDBC驱动程序JAR

您可以从Oracle JDBC驱动程序下载页面下载JDBC驱动程序。

我们建议使用ojdbc8.jar JAR。

将Oracle JDBC驱动程序JAR添加到Metabase插件目录

在您的Metabase目录(您保存并运行metabase.jar的目录)中,创建一个名为plugins的目录(如果尚未创建)。

将您刚刚下载的JAR(ojdbc8.jar)移动到插件目录,并重新启动Metabase。当Metabase重新启动时,它将自动使Oracle驱动程序可用。

从JAR运行时

默认情况下,插件目录名为plugins,位于Metabase JAR相同的目录中。

例如,如果您从名为/app/的目录中运行Metabase,则应将Oracle JDBC驱动程序JAR移动到/app/plugins/

# example directory structure for running Metabase with Oracle support
/app/metabase.jar
/app/plugins/ojdbc8.jar

从Docker运行时

通过Docker运行时添加插件的过程类似,但您需要挂载plugins目录。有关更多详细信息,请参阅此处的说明。

进一步阅读

阅读关于Metabase其他版本的文档。

想要改进这些文档? 提出更改。