想要连上 Oracle 数据库,需要先安装 Oracle 数据库的客户端程序在操作系统环境中。Oracle 数据库的客户端有分为「Oracle Client」和「Oracle Instant Client」两种,前者是完整的 Oracle 数据库的客户端程序和工具,很大一包,需要进行安装的动作;而后者则拆分出了多个函数库和可执行文件,直接从官网上下载下来解压缩就可以使用。如果我们只是希望 Oracle 数据库的应用程序或是我们自己开发的程序能够连上并使用 PL/SQL 来访问 Oracle 数据库,只需要使用 Oracle Instant Client 即可。

在开始这篇文章之前,为了避免各位花费不必要的时间,在此还是先提醒一下。如果您是想找 Oracle 数据库的图形化管理界面,可以直接使用 Oracle 官方提供的 SQL Developer,就不需要再按照本篇文章的方式使用 Oracle Instant Client。透过下列网址可以取得 SQL Developer:

安装缺少的套件

Oracle Instant Client 所依赖的套件可以先用以下指令来安装。

Debian 或其衍生的 Linux 发行版:

sudo apt install libaio1

红帽系的 Linux 发行版:

sudo dnf install libaio

Oracle Instant Client 下载与设置

以下是 Oracle Instant Client 官网下载页面的网址:

因为现在我们是要在 Linux 上使用,所以要选择 Linux 版的 Oracle Instant Client。

在 Oracle Instant Client for Linux 的下载页面会看到很多项目可以下载,我们要下载 Basic Package (ZIP)。

然后在一个您觉得可以的目录中解压缩出压缩档内的目录。笔者习惯放置在 /opt/odb 中,所以此时的 Oracle Instant Client 的根目录就会是 /opt/odb/instantclient_21_8(以 21.8 版本为例)。

在 /etc/profile 中设置需要用到的环境变量,如下:

export ORACLE_HOME="/opt/odb/instantclient_21_8"
export LD_LIBRARY_PATH="$ORACLE_HOME:$LD_LIBRARY_PATH"

export TNS_ADMIN="$ORACLE_HOME/network/admin"

export PATH="$ORACLE_HOME:$PATH"

如此一来您的操作系统环境就有最基本的 Oracle 数据库的客户端能用了!如果有 tnsnames.ora 文件请放置在 TNS_ADMIN 环境变量所指的目录之下。TNS_ADMIN 环境变量可以不用设置,不设置的话通常就会被当作是用 $ORACLE_HOME/network/admin 目录。不过为了避免有些应用程序是直接去读取 TNS_ADMIN 环境变量,还是设置一下比较保险。

SQL*Plus

如果您需要一个 CLI 的工具来下 SQL 叙述管理 Oracle 数据库,请在 Oracle Instant Client for Linux 的下载页面下载 SQL*Plus Package (ZIP) 项目并解压缩,将解压缩出来的目录与 Basic Package (ZIP) 解压缩出来的目录合并在一起即可。

此后就可以使用 sqlplus 指令来操作 Oracle 数据库。

以 sqlplus 连上 Oracle 数据库

在 Docker 容器中使用 Oracle Instant Client

Node.js 映像加上 Oracle Instant Client

Dockerfile 撰写方式如下:

FROM node:20-slim

RUN apt update && apt install -y curl unzip libaio1 \
    && apt clean && rm -rf /var/lib/apt/lists/*

# Oracle Instant Client
RUN curl -fL https://download.oracle.com/otn_software/linux/instantclient/2112000/instantclient-basic-linux.x64-21.12.0.0.0dbru.zip -o instantclient.zip \
    && mkdir -p /opt/odb \
    && unzip instantclient.zip -d /opt/odb \
    && rm instantclient.zip
ENV ORACLE_HOME="/opt/odb/instantclient_21_12"
ENV LD_LIBRARY_PATH="$ORACLE_HOME:$LD_LIBRARY_PATH"
ENV TNS_ADMIN="$ORACLE_HOME/network/admin"
ENV PATH="$ORACLE_HOME:$PATH"

# ...

至于 Node.js 的 alpine 版本的映像,笔者就不建议在那上面使用 Oracle Instant Client 了。因为 Oracle 官方根本没支持 alpine,不要为了让映像更轻巧却增加潜在的问题。