利用管理主控台來配置資料來源

應用程式元件利用資料來源來存取關聯式資料庫的連線實例。

開始之前

應用程式伺服器支援兩個不同版本的資料來源。 請根據作為應用程式基礎的 Enterprise Bean 和 Servlet 規格層次來決定環境的資料來源:
  • 資料來源(WebSphere® Application Server 第 4 版)用來搭配 Enterprise JavaBeans (EJB) 1.0 規格和 Java™ Servlet 2.2 規格。
  • 最新標準版本的資料來源專用來搭配實作這些規格更進階版本的應用程式。

關於這項作業

當您建立資料來源時,您會將它關聯於配置來存取特定供應商資料庫的「Java 資料庫連線功能 (JDBC)」提供者。 應用程式伺服器需要這兩個物件,您的應用程式才能呼叫這個特定資料庫及接收其中的資料。 資料來源提供連線管理功能,使應用程式和資料庫之間,能夠實際進行這些交換。
記住: 伺服器必須重新啟動,才能從應用程式提供新建的資料來源給 「Java Java 命名和目錄介面 (JNDI)」使用。

程序

  1. 開啟管理主控台。
  2. 存取必要的主控台畫面。 請使用下列路徑之一:
    • 按一下資源 > JDBC > 資料來源
    • 按一下資源 > JDBC > 資料來源(WebSphere Application Server 第 4 版)
    • 按一下資源 > JDBC > JDBC 提供者 > JDBC_provider > 資料來源
    • 按一下資源 > JDBC > JDBC 提供者 > JDBC_provider > 資料來源(WebSphere Application Server 第 4 版)
  3. 選取應用程式能夠使用資料來源的範圍。 您可以選擇 Cell、節點、叢集或伺服器。 如需相關資訊,請參閱範圍設定的相關主題。
    只限第 4 版: 從這裡開始,建立 WebSphere Application Server 第 4 版資料來源的步驟,有別於建立最新標準版本資料來源的步驟。如果要配置第 4 版資料來源,請執行下列動作:
    • 按一下新建,繼續進入定義必要內容的主控台畫面。
    • 在這個內容畫面中,指定分組在配置標題下的欄位值。 應用程式伺服器需要這些內容,才能實作您的 JDBC 驅動程式類別。
    • 按一下確定來儲存您的配置。 現在,您已完成主要資料來源配置作業。
    • 定義資料庫供應商可能需要的其他內容,或以選項來提供它們,以便使用 JDBC 驅動程式。 應用程式伺服器稱它們為自訂內容,您必須在資料來源上設定它們。 首先,請按一下管理主控台畫面現在所顯示的自訂內容鏈結。 請參閱資料庫說明文件,以瞭解這些必要和選用的內容。

      [z/OS]另外,如果您採用「DB2® Universal 驅動程式」或「使用 IBM® JCC 驅動程式的 DB2」作為 JDBC 提供者,您也可以在您的 DB2 for z/OS® 版本的 Application Programming Guide and Reference for Java 中,學習選用的資料來源內容。

  4. 按一下新建 這個動作使得建立資料來源精靈,能夠啟動和顯示輸入基本資料來源資訊畫面。 第一個欄位是範圍欄位,它是唯讀。 這個欄位會顯示先前選取的範圍。
  5. 資料來源名稱欄位中,輸入資料來源名稱。 這個名稱識別專用來進行管理的資料來源。
  6. JNDI 名稱欄位中,輸入「Java 命名和目錄介面 (JNDI)」名稱。 應用程式伺服器利用 JNDI 名稱,將應用程式的資源參照連結到這個資料來源。 當您指定 JNDI 名稱時,請遵循這些需求:
    • 不跨越不同的資源類型(如資料來源與 J2C Connection Factory 或 JMS Connection Factory)來指派重複的 JNDI 名稱。
    • 不在相同範圍中,指派重複的 JNDI 名稱給相同類型的多項資源。
    如需 JNDI 的相關資訊,請參閱命名的相關主題。
  7. 下一步來查看選取 JDBC 提供者畫面。 如果您沒有任何在現行範圍配置的 JDBC 提供者,就會跳過選取 JDBC 提供者畫面。
  8. 選取現有的 JDBC 提供者,或建立一個新的提供者。
    • 選取現有的 JDBC 提供者。
      1. 按一下選取現有的 JDBC 提供者
      2. 從清單中選取一個 JDBC 驅動程式。
      3. 下一步。現在,您會看到標題為輸入資料來源的資料庫專用內容的畫面。
    • 建立一個新的 JDBC 提供者。
      1. 按一下建立新的 JDBC 提供者
      2. 下一步來查看建立 JDBC 提供者畫面。
      3. 請利用第一份下拉清單,來選取您必須建立的 JDBC 提供者的資料庫類型。
        使用者定義的選項: 只要您遇到下列情況之一,請選取使用者定義作為資料庫類型。
        • 看不到資料庫類型。
        • 無法選取您在下一步驟中所需的 JDBC 提供者類型。
        使用者定義選項會觸發精靈畫面,將您的提供者類型顯示為使用者定義的 JDBC 提供者,將您的實作類型顯示為使用者定義的實作類型。 請參閱您的資料庫文件,以瞭解 JDBC 驅動程式類別檔、資料來源內容等使用者定義的提供者所需要的項目。 您必須在接下來的兩個精靈畫面中提供這項資訊:
        • 資料庫類別路徑資訊
        • 資料庫專用內容
      4. 如果 JDBC 提供者類型顯示在第二份清單中,請選取您的 JDBC 提供者類型。 選取顯示已淘汰,以同時觸發顯示現行的和已淘汰的提供者。如果您在這份擴充清單中找不到您的提供者,請從前一份資料庫類型清單中,選取使用者定義
      5. 從第三份清單中,選取應用程式所需要的實作類型。 如果您的應用程式不需要連線支援兩段式確定交易,請選擇連線儲存區資料來源。 不過,如果您的應用程式需要支援兩段式確定交易的連線,請選擇 XA 資料來源。 使用這個資料來源配置的應用程式有儲存器管理交易回復的好處。

        選取實作類型之後,精靈會填入 JDBC 提供者的名稱和說明欄位。 這些欄位可以輸入不同的值;它們只用來進行管理。

      6. 定義好資料庫類型、提供者類型和實作類型之後,請按下一步。 這時會出現「輸入資料庫類別路徑資訊」精靈畫面。
      7. 在「類別路徑」欄位中,輸入資料庫 JDBC 驅動程式類別檔的完整路徑位置。 您的類別路徑資訊會成為這個畫面所顯示的 WebSphere 環境變數值,格式為 ${DATABASE_JDBC_DRIVER_PATH}。 應用程式伺服器利用變數來定義您的 JDBC 提供者;如此一來,就不再需要指定個別應用程式的靜態 JDBC 類別路徑。 請記住,如果您並未提供變數的完整而正確的 JDBC 驅動程式類別路徑,您的資料來源最終會失敗。 如果欄位已顯示完整的類別路徑,您可以完成這個精靈頁面的其餘部分,然後按下一步,來接受這個變數定義。
      8. 利用原生程式庫路徑欄位,來指定 JDBC 驅動程式在應用程式伺服器平台中適當運作時,所需要的其他類別檔。 請輸入這些類別檔的完整目錄路徑名稱。
      9. 下一步。現在,您會看到輸入資料來源的資料庫專用內容畫面。
  9. 完成輸入資料來源的資料庫專用內容畫面的所有欄位。
    • 如果儲存器管理的持續性 Enterprise Bean 必須存取這個資料來源,請按一下在儲存器管理的持續性 (CMP) 中使用這個資料來源
    • 這個精靈畫面所顯示的任何其他內容欄位,都是您的資料庫類型專用的內容欄位。 請參閱「資料來源必要設定下限(依供應商)」主題,以取得這些內容設定的相關資訊。 這篇文章處理應用程式伺服器預先定義的現行 JDBC 提供者及已淘汰的 JDBC 提供者。
      使用者定義的資料來源: 這個精靈畫面不會顯示資料來源中,對應於使用者定義 JDBC 提供者的其他內容欄位。 不過,應用程式伺服器通常可以從您安裝的 JDBC 驅動程式類別檔中,擷取出必要的資料來源內容名稱。 應用程式伺服器將它們定義為資料來源自訂內容、將它們顯示在自訂內容主控台畫面上,以及指派它們的預設值。 請參閱您的資料庫文件中,關於設定這些內容及您的使用者定義資料來源的任何其他需求的資訊。 建立好資料來源之後,請在管理主控台中,按一下資料來源 > data_source > 自訂內容,來導覽至對應的自訂內容集合畫面。 請檢視內容預設值,必要的話,請修改它們。

      如果您將驅動程式類別檔安裝在部署管理程式節點中,且正確配置了代表它們的 WebSphere 變數,應用程式伺服器只能從這些檔案中擷取供應商專用的內容。 否則,產品會顯示一則參考訊息(不是錯誤訊息)來指引您以手動方式,將必要的內容定義成自訂內容。

  10. 選擇性的: 配置資料來源的安全別名。 您可以選取 none,代表任何鑑別方法,或選擇下列類型之一:
    • 元件管理的鑑別別名 - 指定元件資源參照 res-auth 值是 Application 時,所用的鑑別別名。 如果要定義新的別名,請導覽至相關項目 > J2EE 連接器架構 (J2C) 鑑別資料項目。 元件管理的別名代表應用程式中所指定的 ID 和密碼的組合,供資料來源鑑別使用。 因此,您在資料來源上設定的別名必須與應用程式碼中的別名相同。
      1. 請利用下拉清單來選取現有的元件管理鑑別別名。
      2. 如果要建立新的別名,請按一下所提供的鏈結。 這個動作會關閉資料來源精靈,且會觸發管理主控台來顯示 J2C 鑑別資料畫面。 按一下新建來定義新的別名。 請按一下確定來儲存您的設定,以及在 J2C 鑑別資料畫面中檢視新的別名。 請導覽回資料來源集合畫面,選取適當的範圍,再按一下新建,以重新啟動資料來源精靈。
      如需 Java 2 Connector (J2C) 安全的相關資訊,請參閱關於「管理 Java 2 Connector Architecture 鑑別資料項目」的主題。
    • 對映配置別名 - 只用於元件資源參照的登入配置不存在之時。 元件資源參照的登入配置和相關內容的規格,是在 res-auth 值設為 Container 時,用來定義鑑別策略的偏好方法。 如果您指定 DefaultPrincipalMapping 登入配置,相關聯的內容就是 JAAS - J2C 鑑別資料項目別名。
    • 儲存器管理鑑別別名 - 只用於元件資源參照的登入配置不存在之時。 元件資源參照的登入配置和相關內容的規格,決定了 res-auth 值設為 Container 時的儲存器管理鑑別策略。
    註: 如果您已在應用程式伺服器中定義安全網域,您可以按一下瀏覽... 來選取正在配置的資源鑑別別名。 安全網域支援將不同伺服器的鑑別別名隔開。 在判斷別名所屬的安全網域時,樹狀結構視圖很有用,可以協助您判斷能夠存取每一個鑑別別名的伺服器。樹狀結構視圖會針對每項資源進行調整,因此,當無法使用時,網域和別名會隱藏起來。
  11. 下一步來檢視摘要畫面,然後檢閱資料來源的任何資訊。 如果有任何資訊不正確,您可以按上一步,回上頁進行更正。
  12. 按一下完成來儲存配置和結束精靈。 這時會出現資料來源畫面,它會在一份表格中顯示您的新配置及配置給相同範圍的其他資料來源。

下一步

  • 您可以置換某些資料來源內容的預設值。
  • 您也可以配置資料庫供應商可能需要的其他內容,或以選項來提供它們。 請參閱關於這些設定的資料庫文件。
  • [z/OS]如果您採用「DB2 Universal JDBC 驅動程式」提供者,或「使用 IBM JCC 驅動程式的 DB2」,請在您的 DB2 for z/OS 版本的 Application Programming Guide and Reference for Java 中,暸解選用的資料來源內容。
  • 當您的 JDBC 資料來源在非預期的情況下關閉時,如果您要在任何未確定的工作中採取特定動作,您可以將 commitOrRollbackOnCleanup 自訂內容新增至 JDBC 資料來源的設定中。 您可以為這個內容指定的值是 commitrollback

    如果您的 JDBC 資料來源支援「工作單元 (UOW)」偵測,當您在分離的工作單元內工作時,才適用這個內容。如果您的 JDBC 資料來源不支援 UOW 偵測,就一律適用這個內容。

    如果您沒有將這個內容新增至 JDBC 資料來源設定,任何偵測到的隱含交易都會被回復,而且您的應用程式必須處理任何未偵測到的隱含交易。

    如果要將這個自訂內容新增至您的 JDBC 資料來源配置設定,請執行下列動作:
    1. 在管理主控台中,按一下 JDBC 提供者 > JDBC_provider > 資料來源 > data_source > 自訂內容 > 新建
    2. 名稱欄位中,輸入 commitOrRollbackOnCleanup,然後在欄位中,輸入 commitrollback
    3. 儲存您的變更。

這個資訊中心的下列主題,告訴您如何利用管理主控台來指派內容值:


指出主題類型的圖示 作業主題



時間戳記圖示 前次更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_ccrtpds
檔名:tdat_ccrtpds.html