存取 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 主控台，然後執行下列作業：

從畫面左側的功能表中選取 Oracle Database 。
選取 Autonomous Data Warehouse 。

oci-orcldb.png 圖解描述
選取要建立資料庫的區間。
按一下建立自治式資料庫。
輸入 Autonomous Database 的基本資訊；例如
- 區間：輸入上方選取的區間名稱。
- 顯示名稱：要在主控台上顯示的名稱；例如，NoSqlToAdwDb。
- 資料庫名稱：連線到資料庫時使用的名稱。例如：NoSqlToAdwDb (不得超過 14 個字元)。
crtadb-dbname.png 圖解描述
選擇資料倉儲工作負載類型。
選擇共用基礎架構部署類型。

crtadb-wltype.png 圖解描述
選擇資料庫的預設組態。

crtadb-param.png 圖解描述
在建立管理員證明資料底下設定密碼。

crtadb-admin.png 圖解描述
從任何位置選擇存取類型的允許安全存取。
選擇適當的授權類型。如果您有自己的授權，請選擇 Bring Your Own License (BYOL) 。
按一下建立自治式資料庫。

crtadb-network.png 圖解描述

相關主題

產生物件儲存的授權權杖

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

您在 Autonomous Data Warehouse 中建立的資料庫連線必須安全。為了讓 Oracle NoSQL Database Analytics Integrator 安全地連線至 ADW 資料庫，公用程式會使用 Oracle Wallet 中包含的證明資料。

若要取得 Oracle Wallet，請前往 Oracle Cloud 主控台，然後執行下列動作：

從畫面左側的功能表中選取 Oracle Database 。
選取 Autonomous Data Warehouse 。

oci-orcldb.png 圖解描述
選取資料庫所在的區間。
按一下建立資料庫時所輸入顯示名稱的連結。

adb-listdb.png 圖解描述
按一下服務主控台。

adb-srvconsole.png 圖解描述
按一下顯示左側的管理連結。
選取下載從屬端證明資料 (公事包) ，然後在建立資料庫時輸入設定的管理密碼。

adb-adminstration.png 圖解描述
將檔案 (zip) 儲存在安全的位置。

產生的壓縮檔包含下列項目：

連線資料庫所需的網路組態檔 (tnsnames.ora 和 sqlnet.ora)。
自動開啟的 SSO 公事包檔案 cwallet.sso。
PKCS12 檔案 ewallet.p12 會受到您透過 Oracle Cloud 主控台下載壓縮檔時所提供的公事包密碼保護。
受公事包密碼保護的 Java 金鑰存放區和信任存放區檔案 keystore.js 和 truststore.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 Data Warehouse 。

oci-orcldb.png 圖解描述
選取資料庫所在的區間。
按一下建立資料庫時所輸入顯示名稱的連結。

adb-listdb.png 圖解描述
按一下服務主控台。

adb-srvconsole.png 圖解描述
從顯示左側的功能表中選取開發。

adb-development.png 圖解描述
選取資料庫動作並登入資料庫；例如，
- 使用者名稱：ADMIN
- 密碼：<password-set-during-database-creation>
dbactions 圖解描述 - login.png
選取項目 SQL 。

dbactions 圖解描述 - sqlsheet.png
從標示為 [ 工作表 ]* 的視窗中，如果您想要使用「資源主體」使用「物件儲存」來認證 ADW 資料庫，請執行下列程序。
```
EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL();
```
dbactions-resource-principal.png 圖解描述
或者，如果您想要使用系統管理員提供給您的 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;
```
dbactions 圖解描述 - worksheet.png

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 資料庫的認證機制而定。