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其他版本的文档。