存取 Oracle Cloud Autonomous Data Warehouse

從 Oracle NoSQL Database Analytics Integrator 存取 Oracle Cloud Autonomous Data Warehouse 的步驟。

在 Autonomous Data Warehouse 中建立資料庫

您必須建立資料庫,才能從 Oracle NoSQL Database Analytics Integrator 存取 Oracle Cloud Autonomous Data Warehouse。若要在 Oracle Cloud Autonomous Data Warehouse 中建立資料庫,請前往 Oracle Cloud 主控台並執行下列動作:

安裝安全資料庫連線所需的證明資料

您在 Autonomous Data Warehouse 中建立的資料庫連線必須安全。若要讓 Oracle NoSQL Database Analytics Integrator 安全地連線到 ADW 資料庫,此公用程式會使用 Oracle Wallet 中所含的證明資料。

若要取得 Oracle Wallet,請前往 Oracle Cloud 主控台,然後執行下列動作:
產生的壓縮檔包含下列項目:
  • 連線資料庫所需的網路組態檔 (tnsnames.orasqlnet.ora)。
  • 自動開啟的 SSO 公事包檔案 cwallet.sso
  • PKCS12 檔案 ewallet.p12 會受到您透過 Oracle Cloud 主控台下載壓縮檔時所提供的公事包密碼保護。
  • 受公事包密碼保護的 Java 金鑰存放區和信任存放區檔案 keystore.jkstruststore.jks;
  • 檔案 ojdbc.properties 指定透過 JDBC 連線至資料庫時所需的公事包相關 Java 系統特性。
  • 包含公事包到期資訊的 README 檔案。

取得公事包壓縮檔之後,請記下密碼,並將公事包儲存在要連線資料庫的任何環境中。此外,若要使用 Oracle NoSQL Database Analytics Integrator,公事包壓縮檔的擷取內容必須安裝在執行公用程式的環境中。例如,如果您是從 Oracle Cloud Compute 執行處理執行公用程式,則應該將壓縮檔的內容擷取到該執行處理上任何目錄中。然後在公用程式組態檔的資料庫區段中,使用該目錄的路徑作為參數 databaseWallet 的值。

在 ADW 資料庫中啟用資源主體證明資料或儲存 / 啟用使用者的物件儲存體 AUTH_TOKEN

從想要的 NoSQL Cloud Service 表格擷取資料並將該資料寫入物件儲存中的 Parquet 檔案之後,Oracle NoSQL Database Analytics Integrator 會使用 Oracle PL/SQL DBMS_CLOUD 套裝程式中的子程式從物件儲存擷取 Parquet 檔案。然後將這些檔案中包含的資料載入至您在 Oracle Cloud Autonomous Data Warehouse 中建立之資料庫中的表格。

在 Oracle NoSQL Database Analytics Integrator 執行這項作業之前,您必須先提供 ADW 資料庫認證物件儲存的方式,以存取這些 Parquet 檔案。ADW 資料庫可以使用下列其中一種方式向物件儲存體服務進行認證:使用 OCI 資源主體或由您或系統管理員產生的使用者特定 AUTH_TOKEN。您決定使用的認證機制是透過從 Oracle Cloud 主控台執行下列步驟來啟用。
  • 從畫面左側的功能表中選取 Oracle Database
  • 選取 Autonomous Database

  • 套用的篩選條件中,選取資料庫所在的區間
  • 選取連結,以您在建立資料庫時所輸入的顯示名稱。

  • 資料庫動作下,選取 SQL

  • 從標示為 [ 工作表 ]* 的視窗中,如果您想要使用「資源主體」使用「物件儲存」來認證 ADW 資料庫,請執行下列程序。
    EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL();


    或者,如果您想要使用系統管理員提供給您的 AUTH_TOKEN 或您自行產生認證,請執行程序,

    BEGIN
    DBMS_CLOUD.CREATE_CREDENTIAL (
    credential_name => 'NOSQLADWDB_OBJ_STORE_CREDENTIAL',
    username => '<your-Oracle-Cloud-username>',
    password => '<cut-and-paste-the-AUTH_TOKEN>'
    );
    END;


DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL 程序可讓 OCI 資源主體 (名稱為 OCI$RESOURCE_PRINCIPAL) 在使用 OCI 資源 (例如物件儲存) 進行認證時供 ADW 資料庫使用。DBMS_CLOUD.CREATE_CREDENTIAL 程序會加密指定的 AUTH_TOKEN 證明資料,並將它儲存在名為 adwc_user 之資料庫的表格中。無論您使用的程序為何,該程序都只能執行一次;之後可以為從物件儲存傳輸至 ADW 資料庫的所有證明資料名稱指定相同的證明資料名稱。

附註:

當 ADW 資料庫使用 OCI 資源主體以物件儲存進行認證時,證明資料的名稱為 OCI$RESOURCE_PRINCIPAL。或者,使用 AUTH_TOKEN 進行物件儲存認證時,證明資料的名稱就是您在 DBMS_CLOUD.CREATE_CREDENTIAL 程序中為 credential_name 參數指定的值。但請注意,上面顯示的值 (NOSQLADWDB_OBJ_STORE_CREDENTIAL) 只是一個範例。您可以使用任何您想要的名稱。因此,組態檔中的 dbmsCredentialName 參數應包含值 OCI$RESOURCE_PRINCIPAL,或您在此處為 credential_name 參數指定的名稱;視您選擇用於以物件儲存認證 ADW 資料庫的認證機制而定。