Stablecoin 分析

Oracle Blockchain Platform Digital Assets Edition 包含穩定案例的範例 Oracle Analytics 工作簿。

若要使用範例 Oracle Analytics 工作簿，您必須執行 Oracle REST Data Services (ORDS) 指令碼以設定資料庫檢視定義，然後匯入工作簿檔案以設定 Oracle Analytics Cloud。

Oracle Database View Stablecoin 的定義

您必須先設定資料庫檢視定義，才能在穩定案例中使用 Oracle Analytics 工作簿。

  1. 啟用和設定 RTF 歷史記錄資料庫。
    For more information, see Enable and Configure the Rich History Database in Using Oracle Blockchain Platform.
  2. Enable rich history on the channels that contain the chaincode data that you want to write to the rich history database. For more information, see Configure the Channels that Write Data to the Rich History Database in Using Oracle Blockchain Platform.
  3. 下載並安裝 Node.js 版本 18 或更新版本。
  4. 在 Oracle Blockchain Platform 的「數位資產」頁上，選擇 Stablecoin 。
  5. 按一下下載資料庫檢視定義套裝程式。
  6. 擷取下載的存檔檔案。
  7. 瀏覽至 ORDSscript 資料夾，然後執行下列命令來安裝必要的相依性。
    npm install
  8. 編輯命令檔隨附的 .env 檔案，以設定您的環境。
    Oracle REST Data Services 端點使用下列一般格式。
    <base_URL>/<user_name>/<resource_link>
    環境 / 組態類型 環境 / 組態變數 描述 範例
    DB Connection CONNECTION_STRING 資料庫的連線字串. 
    CONNECTION_STRING="(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)
(host=adg.ap-sydney-1.example.com))(connect_data=
(service_name=g536390e55ee33f4_db_high.adg.example.com))(security=(ssl_server_dn_match=yes)))"
    View Configuration CHAINCODE_NAME 從 RTF 歷史記錄資料庫中擷取交易明細的鏈碼名稱。 CHAINCODE_NAME="Stablecoin"
    View Configuration INSTANCE_NAME 部署鏈碼的執行處理名稱。 INSTANCE_NAME="Stablecoin"
    View Configuration CHANNEL_NAME 部署鏈碼的通道名稱。 CHANNEL_NAME="default"
    ORDS Endpoint Setup MODULE_NAME 要使用的 ORDS 模組名稱。這可以是任何與資料庫中現有資產不衝突的值。 MODULE_NAME="demotest"
    ORDS Endpoint Setup BASE_PATH ORDS URL 的基本路徑。這可以是任何與資料庫中現有資產不衝突的值。 BASE_PATH="demotest"
    ORDS Endpoint Setup PATTERN ORDS URL 的樣式名稱。這可以是任何與資料庫中現有資產不衝突的值。 PATTERN="accountTransactionDetails"
    ORDS REST Endpoint ORDS_REST_BASE_URL 資料庫 ORDS REST 端點的基礎 URL。 ORDS_REST_BASE_URL="https://g536390e55ee33f4_db_high.adg.ap-sydney-1.example.com"
    Alias Configuration ALIAS_NAME 用於取代 REST 端點 URL 中使用者名稱的別名。這可以是任何與資料庫中現有資產不衝突的值。 ALIAS_NAME="demotestAlias"
    ORDS Role ROLE_NAME 指派給使用者的 ORDS 角色。這可以是任何與資料庫中現有資產不衝突的值。 ROLE_NAME="demotest_role"
    ORDS Privilege PRIVILEGE_NAME 指派給使用者的 ORDS 權限。這可以是任何與資料庫中現有資產不衝突的值。 PRIVILEGE_NAME="demotest_priv"
    ORDS Privilege LABEL ORDS 權限的標籤。這可以是任何與資料庫中現有資產不衝突的值。 LABEL="demotest_label"
    ORDS Privilege DESCRIPTION ORDS 權限的描述。這可以是任何與資料庫中現有資產不衝突的值。 DESCRIPTION="demotest_description"
    OAuth Configuration CLIENT_NAME 要用於 ORDS REST 端點之 OAuth 認證的從屬端名稱。這可以是任何與資料庫中現有資產不衝突的值。 CLIENT_NAME="demotest_client"
    OAuth Configuration OWNER 要用於 ORDS REST 端點之 OAuth 認證的擁有者名稱。這可以是任何與資料庫中現有資產不衝突的值。 OWNER="demotest"
    OAuth Configuration DESCRIPTION OAuth 組態的描述。這可以是任何與資料庫中現有資產不衝突的值。 DESCRIPTION="demotest_description"
    OAuth Configuration SUPPORT_EMAIL OAuth 組態的支援電子郵件地址。這可以是任何與資料庫中現有資產不衝突的值。 SUPPORT_EMAIL="test@example.com"

    下列 Oracle Analytics 檢視是由指令碼所產生：ACCOUNTS_MOD、TRANSACTION_MOD 及 ACCOUNTS_TRANSACTION_MOD。

  9. 使用下列命令執行 ORDS 命令檔。
    npm run start
    當指令執行時，會顯示以下提示。
    Enter your DB User Name
    輸入 RTF 記錄資料庫的使用者名稱。帳戶必須具備建立檢視和 ORDS 端點的必要權限。
    Enter your DB Password
    輸入 Rich History 資料庫的密碼。
    Please select a chaincode type
    選取 STABLECOIN 。使用方向鍵瀏覽，然後按 Enter 鍵確認您的選取。
    Do you want to create the View and ORDS Endpoint? (y/n)
    輸入 y 以建立檢視和端點。如果您已經建立視觀表和端點，請輸入 n 。
    Please select the language of your chaincode? (TS/GO)
    如果您先前輸入 y ，請為 TypeScript 輸入 TS 。
    Do you want to generate ORDS Endpoint URL and Bearer Token? (y/n)
    輸入 y 以產生端點證明資料。否則，請輸入 n。

設定適用於 Stablecoin 的 Oracle Analytics Cloud

完成下列步驟以設定 Oracle Analytics Cloud，並使用分析工作簿進行穩定的案例。

  1. 建立 Oracle Autonomous Database 執行處理。
  2. 設定資料庫檢視定義。如需如何設定 Stablecoin 範例之資料庫檢視定義的相關資訊，請參閱 Oracle Database View Definitions for Stablecoin 。
  3. 在 Oracle Cloud Infrastructure (OCI) 中建立 Oracle Analytics Cloud 執行處理。
    1. 登入 OCI 主控台。
    2. 按一下分析與 AI > Oracle Analytics Cloud 。
    3. 選取建立執行處理，然後新增必要的資訊。
    4. 選取建立，然後等待執行處理建立完成。
    如需有關 Oracle Analytics Cloud 的詳細資訊，請參閱 Oracle Analytics Cloud 。
  4. 在 Oracle Blockchain Platform Digital Assets Edition 中數位資產頁面的範例 Stablecoin Analytics 工作簿底下，選取下載範例分析套件。StablecoinAnalyticsPackage.zip 檔案 (包含範例應用程式) 會下載至您的電腦。
  5. 擷取包含 StablecoinAnalyticsPackage 目錄的 StablecoinAnalyticsPackage.zip 檔案。工作簿 (.dva) 檔案位於 StablecoinAnalyticsPackage 目錄中
  6. 同時備份工作簿檔案 System Owner Dashboard.dva 和 Participating Org Dashboard.dva。
  7. 在 OCI 主控台中瀏覽至 Oracle Analytics Cloud，然後選取分析首頁。
  8. 選取匯入工作簿 / 流程，然後匯入兩個工作簿檔案。選取包含所有權限 (若有的話) 。輸入 OraAnalytic@2025 作為密碼。如需詳細資訊，請參閱匯入工作簿檔案。
  9. 更新 Analytics_Connection 資料集的資料來源連線詳細資訊。
    1. 前往 Oracle Analytics Cloud 的資料頁面。
    2. 尋找 Analytics_Connection 資料集，然後選取檢查 / 編輯 > 更新資料庫連線。
    3. 對應資料庫視觀表。
    4. 選取儲存 (Save) 。
    如需有關將 Oracle Autonomous Transaction Processing 連接至 Oracle Analytics Cloud 的詳細資訊，請參閱連線至 Oracle Autonomous Transaction Processing 。
  10. 設定系統擁有者與參與者組織儀表板的角色與權限。
    1. 在 Oracle Analytics Cloud 中，選取主控台。
    2. 選取角色與權限，然後選取應用程式角色。
    3. 選取建立應用程式角色，然後建立 SystemOwnerRole 應用程式角色。
    4. 在成員下，選取群組，然後選取新增群組。
    5. 將群組指派給 SystemOwnerRole 和 BI Dataload Author 角色。將 Oracle Analytics Cloud 資料內嵌至 Oracle Visual Builder 時，需有 BI Dataload Author 角色。與範例應用程式關聯的 Oracle Identity Cloud Service (IDCS) 群組必須對應至 BI Dataload Author 角色。如果未對應 SystemOwnerRole 和 BI Dataload Author 角色，即使 Oracle Analytics Cloud 與 Oracle Visual Builder 整合，範例應用程式中也不會顯示分析資料。將範例應用程式的所有相關 IDCS 群組對應至這些角色。例如，對應下列群組。
      • SYSTEM_ADMINS
      • SYSTEM_AUDITORS
      • SYSTEM_CREATORS
      • SYSTEM_MANAGERS
      • SYSTEM_ISSUERS
      • SYSTEM_RETIRERS
    6. 為參與者組織建立角色：ParticipantOrg1Role 、ParticipantOrg2Role 等等。
    7. 將群組指派給參與者組織角色和 BI Dataload Author 角色。您可以使用任何名稱建立群組，例如下列範例群組。在下列範例群組中，變更群組名稱中的參與者組織數目，以符合對應的組織角色。
      • ORG1_ADMINS
      • ORG1_AUDITORS
      • ORG1_MANAGERS
      • ORG1_OFFICERS
    如需詳細資訊，請參閱指派應用程式角色給群組。
  11. 更新系統擁有者與參與者組織儀表板的實例名稱參數。
    1. 以管理員身分登入，並開啟系統擁有者儀表板。
    2. 選取編輯。
    3. 在參數底下，按一下滑鼠右鍵以編輯系統擁有者執行處理名稱的參數。
    4. 輸入系統擁有者實例名稱或會員服務提供者 (MSP) ID。例如，輸入 CB 。
    5. 重複先前步驟以更新參與者組織儀表板中的系統擁有者實例名稱。
  12. 更新參與者組織儀表板中的角色。
    1. 開啟參與者組織儀表板，然後選取編輯儀表板。
    2. 選取資料頁籤，然後選取 System_Owner_Account_Trans_Mod-Participating_Org 檢視。
    3. 選取結合圖表。
    4. 為每個參與者新增角色與篩選條件。
      1. 選取角色篩選條件旁邊的新增按鈕。
      2. 新增包含查詢的篩選表示式。例如，將下列 SQL 查詢新增至 ParticipantOrg1Role 角色，該角色會將 Org1 與 Org2 提及為參與者組織。
        FROM_ORG_ID = 'Org1' AND TO_ORG_ID = 'Org2'
        您必須先依序新增角色和篩選表示式，才能繼續下一個角色。
      3. 對 ParticipantOrg2Role 、ParticipantOrg3Role 角色等等重複此程序。
  13. 將儀表板移至 Oracle Analytics Cloud 中的共用資料夾。
    1. 瀏覽至目錄 > 我的資料夾。
    2. 在 Shared Folders 目錄中建立名為 Shared 的資料夾。
    3. 將儀表板從 My Folders 目錄移至共用資料夾目錄內的 Shared 資料夾。
  14. 徹底測試以確保所有視覺化、資料連線、使用者存取和其他功能如預期般運作。