建立豐富歷史記錄資料庫

本主題包含可協助您指定 Oracle Database 連線的資訊，以及選擇建立豐富歷史記錄資料庫的通道。您將使用此資料庫來製作分類帳活動的分析報表和視覺化。

什麼是豐富的歷史資料庫？

豐富的歷史資料庫是 Oracle Blockchain Platform 的外部資料庫，其中包含區塊鏈分類帳在所選通道上交易的相關資料。您可以使用此資料庫來建立關於分類帳活動的分析報表和視覺化。

例如，使用豐富的歷史記錄資料庫，您可以建立分析來瞭解銀行中所有客戶的平均餘額，或將商品從批發商出貨給零售商所需的時間。

在內部，Oracle Blockchain Platform 會使用 Hyperledger Fabric 歷史記錄資料庫來管理分類帳，並在主控台中向您顯示分類帳交易資訊。只有鏈碼可以存取此歷史記錄資料庫，而且您無法將 Hyperledger Fabric 歷史記錄資料庫公開為分析查詢的資料來源。豐富的歷史記錄資料庫使用 Oracle Database 的外部複本，並包含許多在通道上確認之每個交易的詳細資訊。此層次的資料收集使豐富的歷史記錄資料庫成為分析的絕佳資料來源。如需豐富歷史記錄資料庫收集之資料的相關資訊，請參閱 Rich History Database Tables and Columns 。

您只能將 Oracle Autonomous AI Lakehouse 或 Oracle Base Database Service 等資料庫與 Oracle Cloud Infrastructure 搭配使用，以建立豐富的歷史記錄資料庫。您可以使用 Oracle Blockchain Platform 主控台來提供連線字串和證明資料，以存取和寫入資料庫。請注意，您提供的證明資料是資料庫的證明資料，而 Oracle Blockchain Platform 並未加以管理。建立連線之後，您可以選取包含要包含在豐富歷史記錄資料庫中之分類帳資料的管道。請參閱啟用及設定豐富歷史記錄資料庫。

您可以使用標準表格或區塊鏈表格來儲存豐富的歷史記錄資料庫。區塊鏈資料表是防竄改的僅附加資料表，可作為安全分類帳使用，同時也可用於與其他資料表的交易和查詢。

您可以使用任何分析工具 (例如 Oracle Analytics Cloud 或 Oracle Data Visualization Cloud Service) 來存取豐富的歷史記錄資料庫，以及建立分析報表或資料視覺化。

建立 Oracle Base Database Service 連線字串

您必須從 Oracle Cloud Infrastructure 上部署的 Oracle Base Database Service 收集資訊，以建立 RTF 歷史記錄資料庫所需的連線字串。您也必須啟用透過連接埠 1521 存取資料庫的功能。

尋找並記錄 Oracle Base Database Service 資訊

您可以從 Oracle Cloud Infrastructure 主控台取得建立 Oracle Base Database Service 連線所需的資訊。

  1. 從「基礎架構主控台」的導覽功能表中選取資料庫。
  2. 找出您要連線並記錄公用 IP 位址的資料庫。
  3. 選取您要連接的資料庫名稱，並在這些欄位中記錄值：
    • 資料庫唯一名稱
    • 主機網域名稱
    • 連接埠
  4. 尋找具有從此資料庫讀取之權限的資料庫使用者 (例如，使用者 SYSTEM) 的使用者名稱和密碼，並記下這些權限。

啟用透過連接埠 1521 進行資料庫存取

新增輸入規則，讓 Rich History 資料庫能夠透過通訊埠 1521 存取資料庫。

  1. 在 Oracle Cloud Infrastructure 首頁中，選取導覽圖示，然後在資料庫下選取資料庫系統。
  2. 選取您要連接的資料庫。
  3. 選取虛擬雲端網絡連結。
  4. 瀏覽至適當的子網路，然後在安全清單下，選取 < 目標資料庫 > 的預設安全清單。

    就會顯示「安全清單」頁面。

  5. 選取編輯所有規則。
  6. 新增傳入規則，以允許來自公用網際網路的任何傳入流量使用此資料庫節點的連接埠 1521，設定如下：

    • 來源 CIDR ：0.0.0.0/0

    • IP 協定：TCP
    • 來源報告範圍：全部
    • 目的地連接埠範圍：1521
    • 允許：以下連接埠的 TCP 流量：1521

建立連線字串

啟用 Oracle Database 存取權之後，請使用您先前收集的資訊，在設定豐富歷史記錄對話方塊中建立連線字串。

使用下列語法建構連線字串：<publicIP>：<portNumber>/<database unique name>.<host domain name>

下列連線字串是一個範例：192.0.2.0:1521/CustDB_iad1vm.sub05031027070.customervcnwith.oraclevcn.example.com

檢查資料庫使用者權限

為了讓豐富的歷史記錄功能能夠管理其資料庫階段作業，以及從暫時資料庫或網路停止工作時間復原，請確定在 Oracle Blockchain Platform 註冊的資料庫使用者具有下列兩種權限：
grant select on v_$session to <user>;
grant alter system to <user>;
此外，如果豐富的歷史記錄資料庫使用 Oracle Autonomous AI Lakehouse ，則資料庫使用者必須具有下列權限：
grant unlimited tablespace to <user>;
如果資料庫使用者尚未具備這些權限，則必須由系統資料庫管理員授予。

如果沒有這些權限，Oracle Blockchain Platform 可以複製到資料庫，但無法從導致資料庫階段作業受損的情況中復原，以防止豐富的歷史記錄長期追趕最近的交易。如果沒有 Oracle Autonomous AI Lakehouse 的這些權限，就不會儲存豐富的歷史記錄資料。

啟用和設定 Rich History 資料庫

使用主控台提供資料庫連線資訊，並選取要寫入 Rich History 資料庫的鏈碼分類帳資料通道。依預設，不會啟用將資料寫入 Rich History 資料庫的通道。

  • 每個區塊鏈網路成員都會設定自己的豐富歷史記錄資料庫。
  • 您必須使用 Oracle Database。不支援其他資料庫類型。
  • 寫入豐富歷史記錄資料庫的每個通道都必須至少包含一個對等節點。
  1. 輸入 Oracle Database 執行處理的連線和證明資料資訊，以儲存豐富的歷史記錄資訊。
    1. 移至主控台並選取選項，然後選取設定豐富歷史記錄。
      隨即顯示設定 RTF 歷史記錄對話方塊。
    2. 輸入存取 Oracle Database 所需的使用者名稱和密碼。
    3. 在連線字串欄位中，輸入將用來儲存豐富歷史記錄資料的資料庫連線字串。您在此輸入的內容取決於使用的資料庫。
      • 如果您使用 Oracle Autonomous AI Lakehouse ，則請輸入類似 <username>adw_high 的內容。若要尋找 Oracle Autonomous AI Lakehouse 的連線資訊，請前往其證明資料公事包 ZIP 檔案，然後開啟 TNS 檔案。
      • 如果您將 Oracle Base Database Service 與 Oracle Cloud Infrastructure (OCI) 搭配使用，請參閱建立 Oracle Base Database Service 連線字串。
      • 如果您使用非自治式資料庫 (不使用證明資料公事包的資料庫)，並且想要使用 sys 使用者連線至資料庫，則必須將 ?as=sys[dba|asm|oper] 附加至連線字串。例如，203.0.113.0:1521/oraclevcn.example.com?as=sysdba
    4. 如果您使用 OCI 自治式資料庫執行處理 (例如 Oracle Autonomous AI Lakehouse 或 Oracle Autonomous AI Transaction Processing)，請使用公事包套裝程式檔案欄位來上傳必要的證明資料公事包 .zip 檔案。這個檔案包含從屬端證明資料，由資料庫產生。

      附註：

      當您設定 RTF 歷史記錄之後，再次開啟設定 RTF 歷史記錄對話方塊時，不會顯示公事包檔案名稱。如果更新其他設定值，您必須先重新上傳公事包 .zip 檔案，再選取儲存。如果您在未顯示公事包檔案名稱時選取儲存，組態就會更新而不使用公事包檔案。
    5. 若要使用區塊鏈表格來儲存豐富的歷史記錄資料庫，請選取使用資料庫區塊鏈表格。
      基礎資料庫必須支援區塊鏈表格。
      • 若要指定保留表格與資料列的天數，請選取基本組態，然後輸入保留表格與資料列的天數。輸入 0 以永久保留表格或資料列。若要避免對保留值進行進一步的變更，請選取已鎖定。
      • 若要使用資料定義語言 (DDL) 敘述句來指定表格和資料列保留，請選取進階組態查詢，然後輸入 DDL 敘述句。
    6. 選取儲存 (Save) 。
  2. 在包含您要寫入豐富歷史記錄資料庫之鏈碼資料的通道上啟用豐富歷史記錄。
    1. 前往主控台並選取通道頁籤。
    2. 尋找包含要寫入豐富歷史記錄資料庫之鏈碼資料的通道。選取其他選項，然後選取設定豐富歷史記錄。
      隨即顯示設定 Rich History 對話方塊。
    3. 選取啟用 Rich History 。若要將專用資料集合儲存在 RTF 歷史記錄資料庫中，請輸入專用資料集合名稱清單 (以逗號分隔)。如需有關專用資料收集的詳細資訊，請參閱何謂專用資料收集？。若要新增異動詳細資料至 RTF 記錄資料庫，請選取您要新增的詳細資料。選取儲存。
已設定 RTF 歷史記錄資料庫，但不會立即在資料庫中建立表格。發生下一個相關交易或分類帳變更時，會在 RTF 歷史記錄資料庫中建立表格。

修改 Rich History 資料庫的連線

您可以變更 Rich history 資料庫的連線資訊。

在資料庫中為通道建立表格之後，即使在您選取儲存之後，修改通道的 RTF 歷史記錄組態也不會有任何作用，除非您變更使用者名稱和密碼或連線字串。如果您變更使用者名稱和密碼，則會在同一個資料庫中建立表格。如果您變更連線字串與證明資料，則會設定不同的資料庫，並在下一個相關交易或分類帳變更之後建立表格。您無法將豐富的歷史記錄資料庫從標準表格變更為區塊鏈表格，而且除非您也變更證明資料或連線字串，否則無法變更保留時間。
  1. 移至主控台並選取選項，然後選取設定豐富歷史記錄。
  2. 視需要更新使用者名稱和密碼，以存取資料庫。
  3. 如有需要，請在連線字串欄位中修改您將用來儲存豐富歷史記錄資料的資料庫連線字串。您在此輸入的內容取決於使用的資料庫。
    • 如果您使用 Oracle Autonomous AI Lakehouse ，則請輸入類似 <username>adw_high 的內容。若要尋找 Oracle Autonomous AI Lakehouse 的連線資訊，請前往其證明資料公事包 .zip 檔案，然後開啟 TNS 檔案。
    • 如果您將 Oracle Base Database Service 與 Oracle Cloud Infrastructure (OCI) 搭配使用，請參閱建立 Oracle Base Database Service 連線字串。
    • 如果您使用非自治式資料庫 (不使用證明資料公事包的資料庫)，並且想要使用 sys 使用者連線至資料庫，則必須將 ?as=sys[dba|asm|oper] 附加至連線字串。例如，203.0.113.0:1521/oraclevcn.example.com?as=sysdba
  4. 如果您使用 OCI 自治式資料庫執行處理 (例如 Oracle Autonomous AI Lakehouse 或 Oracle Autonomous AI Transaction Processing)，請使用公事包套裝程式檔案欄位來上傳或重新上傳必要的證明資料公事包檔案。這個檔案包含從屬端證明資料，由資料庫產生。

    附註：

    當您設定 RTF 歷史記錄之後，再次開啟設定 RTF 歷史記錄對話方塊時，不會顯示公事包檔案名稱。如果更新其他設定值，您必須先重新上傳公事包 .zip 檔案，再選取儲存。如果您在未顯示公事包檔案名稱時選取儲存，組態就會更新而不使用公事包檔案。
  5. 若要使用區塊鏈表格來儲存豐富的歷史記錄資料庫，請選取使用資料庫區塊鏈表格。
    基礎資料庫必須支援區塊鏈表格。
    • 若要指定保留表格與資料列的天數，請選取基本組態，然後輸入保留表格與資料列的天數。輸入 0 以永久保留表格或資料列。若要避免對保留值進行進一步的變更，請選取已鎖定。
    • 若要使用資料定義語言 (DDL) 敘述句來指定表格和資料列保留，請選取進階組態查詢，然後輸入 DDL 敘述句。
  6. 選取「儲存」。

設定將資料寫入豐富歷史記錄資料庫的通道

您可以讓通道將鏈碼分類帳資料寫入豐富的歷史記錄資料庫，也可以停止通道將資料寫入豐富的歷史記錄資料庫。您也可以將個別通道設定為使用與全域設定不同的豐富歷史記錄資料庫組態。

您必須指定要連線至 Rich History 資料庫的全域資訊，才能選取寫入 Rich History 資料庫的通道。請參閱啟用及設定豐富歷史記錄資料庫。

在資料庫中建立通道的表格之後，修改通道的 RTF 歷史記錄組態並不會有任何作用，即使您按一下儲存之後，除非您變更使用者名稱和密碼或連線字串。如果您變更使用者名稱和密碼，則會在同一個資料庫中建立表格。如果您變更連線字串與證明資料，則會設定不同的資料庫，並在下一個相關交易或分類帳變更之後建立表格。您無法將豐富的歷史記錄資料庫從標準表格變更為區塊鏈表格，而且除非您也變更證明資料或連線字串，否則無法變更保留時間。

  1. 前往主控台並選取通道頁籤。
  2. 尋找您要修改其存取權的管道。按一下其其他選項按鈕，然後選取設定豐富歷史記錄。
    隨即顯示設定 Rich History 對話方塊。
  3. 若要啟用管道的 RTF 歷史記錄資料收集，請勾選啟用 RTF 歷史記錄核取方塊。若要停用收集管道的 RTF 歷史記錄資料，請取消勾選啟用 RTF 歷史記錄核取方塊。
  4. 若要設定通道使用不同資料庫或其他設定值收集 RTF 歷史記錄資料，請選取使用通道層次組態，然後指定要使用的設定值。
    如需有關豐富歷史記錄設定值的詳細資訊，請參閱啟用及設定豐富歷史記錄資料庫。
  5. 按一下「儲存」。

監督豐富歷史記錄狀態

設定豐富的歷史記錄資料庫之後，您可以使用主控台來監督豐富的歷史記錄複製狀態。

  1. 前往主控台並選取通道頁籤。
  2. 在通道表格中，按一下想要監督之通道的其他動作按鈕，然後按一下歷史記錄狀態。
    此時會顯示歷史記錄狀態對話方塊，其中包含複製和組態狀態的詳細資訊。
  3. 按一下重新整理以顯示最新狀態。

限制豐富歷史記錄的存取權

您可以使用通道原則和存取控制清單 (ACL) 來限制可以設定豐富歷史記錄資料庫的組織，並擷取豐富的歷史記錄狀態或組態資訊。

依照預設，具有通道管理存取權的所有組織都可以設定豐富的歷史記錄收集，並可擷取豐富的歷史記錄狀態和組態詳細資訊。若要限制此存取權，例如創始組織，您可以建立通路政策，並將該政策套用至控制存取權的資源。
  1. 前往主控台並選取通道頁籤。
    隨即顯示通道頁籤。通道表格包含您網路上所有通道的清單。
  2. 在通路表格中，按一下您要限制存取的通路名稱。
  3. 按一下管道政策，然後建立簽名政策，其中包含將存取豐富歷史記錄功能的組織成員。
    如需有關通道原則的詳細資訊，請參閱使用通道原則和 ACL 。
    例如，建立僅包含創始組織身分的原則，而非任何參與者組織的身分識別。
  4. 按一下 ACL 。
  5. 在「資源」表格中，找出您要更新的資源，以使用新原則。按一下資源的展開，然後選取要指派給資源的原則
    下表顯示控制豐富歷史記錄存取權的資源。
    資源 存取控制
    obpadmin/ConfigureRichHistoryChannel 控制設定、啟用及停用通道的豐富歷史記錄。
    obpadmin/GetRichHistoryChannelStatus 控制擷取通道的豐富歷史記錄複製狀態。
    obpadmin/GetRichHistoryChannelConfig 控制擷取通道目前的豐富歷史記錄組態。
  6. 按一下更新 ACL 。
豐富的歷史記錄存取權現在由新的原則控制。未包含在新原則中的組織成員在嘗試存取由原則控制的資源時，將會收到錯誤訊息。

豐富的歷史記錄資料庫表格和資料欄

豐富的歷史記錄資料庫包含每個通道的三個表格：歷史記錄、狀態以及最新高度。當您建立鏈碼的分類帳交易相關分析時，將會查詢歷史記錄與狀態表格。如果您選擇在啟用豐富歷史記錄時選取任何交易明細，將會建立含有交易明細的其他表格。

歷史記錄表

<instanceName><channelName> _hist 表格包含分類帳歷史記錄。此表中的資料會告訴您鏈碼 ID、使用的關鍵碼、交易是否有效、指派給關鍵碼的值等等。

請注意， value 和 valueJson 資料欄是以互斥的方式使用。亦即，索引鍵值是有效的 json 時，該值會設為 valueJson 資料欄。否則，會在值資料欄中設定值。valueJson 資料欄在資料庫中設定為 json 資料欄，這表示使用者可以使用一般的 Oracle JSON 特定擴充功能來查詢該資料欄。

如果設定，專用資料也會儲存在此表格中。對於私人資料，鏈碼 ID 使用下列格式： <chaincodeName> $ <collectionName> 。

欄 資料類型
chaincodeId VARCHAR2 (256)
金鑰   VARCHAR2 (1024)
txnIsValid     數字 (1)
value VARCHAR2 (4000)
valueJson CLOB
blockNo 數字非空值
txnNo 編號 NOT NULL
txnId VARCHAR2 (128)  
txnTimestamp TIMESTAMP
txnIsDelete 數字 (1)

狀態表

<instanceName><channelName> 狀態表格包含從狀態資料庫複製的資料值。當您建立分類帳狀態的相關分析時，將會查詢狀態表格。

請注意， value 和 valueJson 資料欄是以互斥的方式使用。亦即，索引鍵值是有效的 json 時，該值會設為 valueJson 資料欄。否則，會在值資料欄中設定值。valueJson 資料欄在資料庫中設定為 json 資料欄，這表示使用者可以使用一般的 Oracle JSON 特定擴充功能來查詢該資料欄。

欄 資料類型
chaincodeId VARCHAR2 (256)
索引鍵 VARCHAR2 (1024)
value VARCHAR2 (4000) 
valueJson CLOB
blockNo NUMBER
txnNo NUMBER

最新的高度表格

<instanceName><channelName> 最後一個表格是由 Oracle Blockchain Platform 內部使用，以追蹤豐富歷史記錄資料庫中記錄的區塊高度。它會決定目前的豐富歷史記錄資料庫，以及是否所有鏈碼交易都記錄在豐富的歷史記錄資料庫中。您無法查詢此資料庫以進行分析。

交易明細表格

<instanceName><channelName> _more 表格包含已確認交易的相關屬性。啟用 RTF 記錄資料庫時，您可以選取您要在此表格中記錄的屬性。交易明細表格只會擷取背書人交易的相關資訊，不會擷取組態交易或任何其他種類的 Hyperledger Fabric 交易。

欄 資料類型
鏈碼 ID VARCHAR2 (256)
區塊號碼 NUMBER
繁體中文 NUMBER
交易平台 VARCHAR2(128)
交易戳記 TIMESTAMP
提交者 VARCHAR2(512)
提交者組織 VARCHAR2(512)
提交者 VARCHAR2(512)
鏈碼型態 VARCHAR2(32)
驗證代碼名稱 VARCHAR2(32)
背書 CLOB
輸入 CLOB
事件 CLOB
回應狀態 數字 (0)
回應有效負載 VARCHAR2(1024)
RWSET CLOB
區塊建立器 VARCHAR2(512)
BLOCKCREATORORG VARCHAR2(512)
BLOCKCREATOROU VARCHAR2(512)
組態區塊編號 數字 (0)
組態區塊建立程式 VARCHAR2(512)
設定區塊建立組織 VARCHAR2(512)
設定區塊建立工具 VARCHAR2(512)

附註：

  • 組織 (ORG) 與組織單位 (OU) 由識別憑證驅動，這表示它們可以指派給多個值。它們在表格的值中會被擷取為以逗號分隔的清單。
  • 對於識別，表格僅包含憑證的「主旨」部分資訊，而非「發行者」資訊。
  • RWSET 資料欄包含背書期間執行之所有鏈碼 (在相同分類帳中) 的作業。因此，您通常會看到 lscc 讀取作業與實際的鏈碼命名空間作業。