建立 Node.js 應用程式

若要建置可存取 Autonomous Database 的 Node.js 應用程式,請先設定開發系統來支援資料庫存取,以利用 Autonomous Database 的持續可用性和高效能功能。

設定開發系統之後,您可以對應用程式中的資料庫連線和 SQL 敘述句編寫程式碼,以利用持續可用性和高效能功能。

秘訣:

如需閱讀下列主題的「試試看」替代方案,請前往 Oracle Autonomous Database Dedicated for Developers and Database Users Workshop 中的 Lab 3:Build and Deploy Node.js Application

配置您的 Node.js 開發系統

若要設定您的開發系統,讓您的 Node.js 應用程式能夠充分利用 an Autonomous Database 的持續可用性和高效能功能,請執行下列步驟。

  1. 下載並安裝 Node.js。
  2. 下載並安裝 Oracle Instant Client。
  3. 下載並安裝 node-oracledb。
  4. 下載資料庫的用戶端憑證,並將其提供給 Oracle Instant Client 使用。

Before You Begin - 開始之前

您的開發系統必須符合特定條件才能順利設定。

  • 它必須能夠存取網際網路。

  • 它必須具備 Autonomous Database 的網路存取權。

    請參閱設定開發系統以存取資料庫,瞭解如何確保您的開發系統符合此需求。

下載並安裝 Node.js

下載並安裝適用於系統作業系統與架構的 Node.js:

  • Oracle Linux:

    執行下列命令以下載並安裝最新版本的 Node.js:

    sudo yum install -y oracle-release-el7 oracle-nodejs-release-el7
    sudo yum install -y nodejs 
  • 其他 OSes 與架構:

    請前往 Node.js 下載頁面,為您的系統作業系統和架構選擇最新的 LTS (長期支援) 版本,然後進行安裝。

下載並安裝 Oracle Instant Client

您需要 Oracle Instant Client 程式庫版本 19.6 或更新版本。

下載並安裝適用於系統作業系統與架構的 Oracle Instant Client 基本套裝軟體:

  • Oracle Linux:

    執行下列指令以下載和安裝 Oracle Instant Client 基本套裝軟體:

    sudo yum -y install oracle-release-el7
    sudo yum -y install oracle-instantclient19.3-basic

    (如果您要查看所有 Instant Client 套裝軟體的清單,請前往 http://yum.oracle.com/repo/OracleLinux/OL7/oracle/instantclient/x86_64/index.html。)

  • 其他 OSes 與架構:

    1. 請前往 Oracle Instant Client 下載項目頁面,選取您系統作業系統與架構的下載項目。

    2. 在下載頁面上,接受 Oracle Technology Network License Agreement,下載最新版本的基本套件,然後依照下載頁面底部的指示進行安裝。

下載並安裝 node-oracledb

下載並安裝適用於 Node.js 的 node-oracledb 附加元件作為系統作業系統與架構:

  • Oracle Linux:

    執行下列命令以下載並安裝最新版本的 node-oracledb:

    sudo yum install -y oracle-release-el7 oracle-nodejs-release-el7
    sudo yum install -y node-oracledb-node10
  • 其他 OSes 與架構:

    前往 Installing node-oracledb 頁面,為您的作業系統與架構選擇「我的資料庫位於另一台機器」說明,然後依照 Install the add-on 指示操作。

下載並安裝資料庫的從屬端證明資料

  1. 將包含您資料庫之從屬端證明資料的壓縮檔下載至您電腦上的安全目錄。

    您可以從 Oracle Cloud 主控台中資料庫的「詳細資訊」頁面下載此壓縮檔。如果您有允許您存取此頁面的 Oracle Cloud 使用者帳戶,請下載下列證明資料。如果您沒有此帳戶,則必須從資料庫管理員取得 zip 檔案,以及用來保護 zip 檔案的密碼。

    1. 在 Web 瀏覽器中,登入 Oracle Cloud 並瀏覽至 Autonomous Database 的「詳細資訊」頁面。

    2. 按一下資料庫連線

    3. 資料庫連線頁面上,按一下下載

    4. 下載公事包對話方塊的密碼欄位中輸入公事包密碼,然後在確認密碼欄位中確認密碼。

      密碼的長度至少要有 8 個字元,而且至少必須包含 1 個字元、1 個數字字元或 1 個特殊字元。

    5. 按一下下載,將用戶端憑證 zip 檔案儲存至安全目錄。

  2. 下載壓縮檔之後,請依照下列步驟進行:

    1. 解壓縮從屬端證明資料壓縮檔。

    2. 編輯從屬端證明資料中提供的 sqlnet.ora 檔案,以您解壓縮從屬端證明資料之目錄的完整路徑取代 "?/network/admin";例如,變更:

      (DIRECTORY="?/network/admin")

      到:

      (DIRECTORY="/users/jdoe/adbcredentials")
    3. 建立 TNS_ADMIN 環境變數,將其值設為您解壓縮從屬端證明資料的目錄完整路徑。

程式碼資料庫連線和 SQL 敘述句

將您的開發系統設定為支援 Autonomous Database 的 Node.js 應用程式連線之後,請依照下列步驟,確保應用程式使用資料庫的最佳效能:

  1. 將 node-oracledb 附加元件的相依性新增至您應用程式的 package.json 檔案。

  2. 提供高效能和持續可用性的程式碼連線。

將 node-oracledb 相依性新增至 package.json

編輯您應用程式之 package.json 檔案中的 dependencies 物件,並新增 oracledb 套裝程式和版本。(如果不存在,請使用 npm init 命令來產生 package.json。)舉例而言:

. . .
"dependencies": {
  . . .,
  "oracledb": "^4.0",
  . . .
},
. . .

如需 dependencies 物件的詳細資訊,請參閱 npm-package.json 頁面。若要顯示已安裝的 oracledb 版本,您可以使用 npm list 命令;例如:

npm list -g --depth=0

高效能和持續可用性的程式碼連線

若要達到高效能與持續可用性,請在連線到資料庫時遵循下列準則:

舉例而言:

pool = await oracledb.createPool({
  events: true,
  user: "appuser",
  password: process.env.MY_PASSWORD_ENV_VAR,
  connectString: "tp_tls"
});

此範例會為連線至 tp_tls 資料庫服務的連線建立集區,並透過將 events 特性設為 true 來啟用 FAN。

其他資源

如需有關 node-oracledb 的詳細資訊,請移至 node-oracledb Documentation 頁面,其中包含 API Reference 與 User Guide。

如需示範各種 node-oracledb 功能的程式碼範例,請移至 node-oracledb examples 資料夾。