使用 Node.js 和其他指令碼語言連線至 Autonomous Database
您可以使用 Node.js、PHP、Ruby、R、Go 及 Perl 等不同語言的程式,連線至 Autonomous Database on Dedicated Exadata Infrastructure 。使用用戶端憑證強制執行安全性。
這些指令碼語言具有資料庫存取 API 或使用 Oracle Call Interface 程式庫的驅動程式。Oracle Call Interface 程式庫可以是來自完整 Oracle Client 或 Oracle Instant Client 的程式庫。
安裝語言驅動程式和用戶端程式庫
若要從您的指令碼語言連線至 Autonomous Database on Dedicated Exadata Infrastructure ,請先安裝語言驅動程式和用戶端程式庫,如下所示:
-
安裝 Instant Client 或 Full Client。Full Client 支援的最低版本為 11.2.0.4 版;Oracle Instant Client 使用 12.1.0.2 或更新版本:
Instant Client 可適用於大部分的應用程式。若要安裝 Instant Client,請執行下列動作:
-
從「即時用戶端下載」頁面選取所需的架構,並下載基本套件 (可從下載頁面取得):Oracle Instant Client
此外,如果 Basic Light 全球化限制符合您的使用需求,也可以從下載頁面下載所需架構的 Basic Light 套件。
-
如果您是從原始程式碼建置語言 API 或驅動程式,您可能也需要下載 Instant Client SDK:Oracle Instant Client
-
解壓縮您選取的基準套件。例如解壓縮至
C:\instantclient_12_2
或/home/myuser/instantclient_18_5.
如果您也下載 SDK,請將它解壓縮到同一個目錄中。 -
在 Windows 上,將路徑新增至「環境變數」窗格之「系統變數」區段中的
PATH
變數 (例如新增C:\instantclient_12_2
)。在 Windows 8 上,瀏覽至「控制台」>「系統」>「進階系統設定」>「環境變數」,以存取PATH
變數設定區域。如果您安裝了多個版本的 Oracle 程式庫,請確定路徑中會先出現新的目錄。 -
在非 Windows 平台上建立符號連結 (如果不存在)。舉例而言:
cd /home/myuser/instantclient_18_5 ln -s libclntsh.so.18.1 libclntsh.so
如果您的系統上沒有其他會受到影響的 Oracle 軟體,請將 Instant Client 新增至程式實際執行連結路徑。舉例而言:
sudo sh -c "echo /home/myuser/instantclient_18_5 > /etc/ld.so.conf.d/oic.conf" sudo ldconfig
或者,請在執行應用程式的每個 Shell 中設定磁帶櫃路徑。舉例而言:
export LD_LIBRARY_PATH=/home/myuser/instantclient_18_5:$LD_LIBRARY_PATH
附註:
Linux Instant Client 下載檔案可作為.zip
檔案或.rpm
檔案。您可以使用任一版本。
-
-
安裝 Oracle Database 的相關語言驅動程式:
-
Node.js :若要安裝 Node.js 的 node-oracledb,請使用下列頁面的指示:安裝 node-oracledb 。
-
ROracle :若要為 R 安裝 ROracle,請使用下列頁面上的指示:ROracle
-
PHP :若要為 PHP 安裝 PHP OCI8,請使用下列頁面上的指示:將 PHP 設定為 OCI8 。
Windows DLL 可在 http://php.net/downloads.php 上使用,也可以從 PECL oci8 取得。
-
PHP PDO_OCI :若要為 PHP 安裝 PHP PDO_OCI,請使用下列頁面上的指示:Oracle Functions (PDO_OCI) 。
Windows DLL 可於 PHP 內含的 http://php.net/downloads.php 上取得。
-
Ruby :若要安裝 Ruby 的 ruby-oci8,請使用下列頁面的指示:安裝 Oracle Instant Client
-
Perl 的 DBD :若要安裝 DBD::Oracle for Perl,請將
ORACLE_HOME
和您的程式庫搜尋路徑 (例如LD_LIBRARY_PATH
或PATH
) 設為「即時從屬端」目錄,然後使用下列頁面的指示: DBD::Oracle 。
-
啟用 Oracle Network 連線並取得安全證明資料 (Oracle Wallet)
-
取得從屬端安全證明資料以連線至 Autonomous Database 執行處理。您會取得一個 zip 檔案,其中包含存取 Autonomous Database 所需的用戶端安全認證和網路組態設定。您必須保護此檔案及其內容,以防止未經授權的資料庫存取。取得從屬端安全證明資料檔案,如下所示:
-
ADMIN 使用者:按一下資料庫連線。請參閱下載從屬端證明資料。
-
其他使用者 (非管理員):從管理員取得 Autonomous Database 的 Oracle Wallet。
-
-
擷取從屬端證明資料 (公事包) 檔案:
-
解壓縮從屬端證明資料壓縮檔。
-
如果您使用 Instant Client,請視需要在 Instant Client 目錄下建立
network/admin
子目錄階層。然後將檔案移至此子目錄。例如,檔案應位於下列目錄中:架構或用戶端系統以及安裝 Instant Client 的位置:C:\instantclient_12_2\network\admin
或
/home/myuser/instantclient_18_5/network/admin
或
/usr/lib/oracle/18.5/client64/lib/network/admin
-
如果您使用完整的 Oracle 從屬端,請將檔案移至
$ORACLE_HOME/network/admin
。
-
-
或者,將解壓縮的公事包檔案放在安全的目錄中,然後將
TNS_ADMIN
環境變數設為該目錄名稱。
附註:
從 zip 檔案中,僅需要下列檔案:tnsnames.ora
、sqlnet.ora
、cwallet.sso
和ewallet.p12
。 -
執行您的應用程式
-
更新您的應用程式,以使用您資料庫使用者名稱、密碼以及解壓縮之
tnsnames.ora
檔案中提供的 Oracle Net 連線名稱進行連線。例如,使用者、atpc_user
、 password 和atpc_low
作為連線字串。 -
或者,變更
tnsnames.ora
中的連線字串,以符合應用程式所使用的字串。 -
執行您的應用程式。