Stablecoin-Analysen

Die Oracle Blockchain Platform Digital Assets Edition enthält eine Oracle Analytics-Beispielarbeitsmappe für das Stablecoin-Szenario.

Um die Oracle Analytics-Beispielarbeitsmappe zu verwenden, müssen Sie das Skript Oracle REST Data Services (ORDS) ausführen, um die Definitionen der Datenbankansicht einzurichten, und dann die Arbeitsmappendateien importieren, um Oracle Analytics Cloud zu konfigurieren.

Oracle Database View-Definitionen für Stablecoin

Sie müssen die Definitionen der Datenbankansicht einrichten, bevor Sie die Oracle Analytics-Arbeitsmappe im Stablecoin-Szenario verwenden können.

  1. Aktivieren und konfigurieren Sie die Rich History-Datenbank.
    Weitere Informationen finden Sie unter Rich History-Datenbank aktivieren und konfigurieren in Oracle Blockchain Platform verwenden.
  2. Aktivieren Sie umfangreiche Historie für die Kanäle, die Chaincode-Daten enthalten, die Sie in die umfangreiche Historiendatenbank schreiben möchten. Weitere Informationen finden Sie unter Kanäle konfigurieren, die Daten in die Rich-History-Datenbank schreiben in Oracle Blockchain Platform verwenden.
  3. Laden Sie Node.js Version 18 oder höher herunter, und installieren Sie sie.
  4. Wählen Sie auf der Seite Digital Assets in Oracle Blockchain Platform die Option Stablecoin aus.
  5. Klicken Sie auf Database View Definitions-Package herunterladen.
  6. Extrahieren Sie die heruntergeladene Archivdatei.
  7. Navigieren Sie zum Ordner ORDSscript, und installieren Sie die erforderlichen Abhängigkeiten, indem Sie den folgenden Befehl ausführen.
    npm install
  8. Bearbeiten Sie die Datei .env, die mit dem Skript geliefert wird, um sie für Ihre Umgebung zu konfigurieren.
    Oracle REST Data Services-Endpunkte verwenden das folgende allgemeine Format.
    <base_URL>/<user_name>/<resource_link>
    Umgebung/Konfigurationstyp Umgebungs-/Konfigurationsvariablen Beschreibung Beispiel
    DB Connection CONNECTION_STRING Die Verbindungszeichenfolge für die Datenbank. 
    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 Der Name des Chaincodes, aus dem die Transaktionsdetails in der Rich-History-Datenbank abgerufen werden. CHAINCODE_NAME="Stablecoin"
    View Configuration INSTANCE_NAME Der Name der Instanz, in der der Chaincode bereitgestellt wird. INSTANCE_NAME="Stablecoin"
    View Configuration CHANNEL_NAME Der Name des Kanals, in dem der Chaincode bereitgestellt wird. CHANNEL_NAME="default"
    ORDS Endpoint Setup MODULE_NAME Der Name des zu verwendenden ORDS-Moduls. Dies kann ein beliebiger Wert sein, der nicht mit vorhandenen Assets in der Datenbank in Konflikt steht. MODULE_NAME="demotest"
    ORDS Endpoint Setup BASE_PATH Der Basispfad der ORDS-URL. Dies kann ein beliebiger Wert sein, der nicht mit vorhandenen Assets in der Datenbank in Konflikt steht. BASE_PATH="demotest"
    ORDS Endpoint Setup PATTERN Der Mustername der ORDS-URL. Dies kann ein beliebiger Wert sein, der nicht mit vorhandenen Assets in der Datenbank in Konflikt steht. PATTERN="accountTransactionDetails"
    ORDS REST Endpoint ORDS_REST_BASE_URL Die Basis-URL des ORDS-REST-Endpunkts der Datenbank. ORDS_REST_BASE_URL="https://g536390e55ee33f4_db_high.adg.ap-sydney-1.example.com"
    Alias Configuration ALIAS_NAME Der Alias, der anstelle eines Benutzernamens in der REST-Endpunkt-URL verwendet werden soll. Dies kann ein beliebiger Wert sein, der nicht mit vorhandenen Assets in der Datenbank in Konflikt steht. ALIAS_NAME="demotestAlias"
    ORDS Role ROLE_NAME Die ORDS-Rolle, die dem Benutzer zugewiesen ist. Dies kann ein beliebiger Wert sein, der nicht mit vorhandenen Assets in der Datenbank in Konflikt steht. ROLE_NAME="demotest_role"
    ORDS Privilege PRIVILEGE_NAME Die ORDS-Berechtigung, die dem Benutzer zugewiesen ist. Dies kann ein beliebiger Wert sein, der nicht mit vorhandenen Assets in der Datenbank in Konflikt steht. PRIVILEGE_NAME="demotest_priv"
    ORDS Privilege LABEL Ein Label für die ORDS-Berechtigung. Dies kann ein beliebiger Wert sein, der nicht mit vorhandenen Assets in der Datenbank in Konflikt steht. LABEL="demotest_label"
    ORDS Privilege DESCRIPTION Eine Beschreibung der Berechtigung ORDS. Dies kann ein beliebiger Wert sein, der nicht mit vorhandenen Assets in der Datenbank in Konflikt steht. DESCRIPTION="demotest_description"
    OAuth Configuration CLIENT_NAME Der Clientname für die OAuth-Authentifizierung mit dem ORDS-REST-Endpunkt. Dies kann ein beliebiger Wert sein, der nicht mit vorhandenen Assets in der Datenbank in Konflikt steht. CLIENT_NAME="demotest_client"
    OAuth Configuration OWNER Der Eigentümername, der für die OAuth-Authentifizierung mit dem ORDS-REST-Endpunkt verwendet werden soll. Dies kann ein beliebiger Wert sein, der nicht mit vorhandenen Assets in der Datenbank in Konflikt steht. OWNER="demotest"
    OAuth Configuration DESCRIPTION Eine Beschreibung der OAuth-Konfiguration. Dies kann ein beliebiger Wert sein, der nicht mit vorhandenen Assets in der Datenbank in Konflikt steht. DESCRIPTION="demotest_description"
    OAuth Configuration SUPPORT_EMAIL Die Support-E-Mail-Adresse für die Konfiguration OAuth. Dies kann ein beliebiger Wert sein, der nicht mit vorhandenen Assets in der Datenbank in Konflikt steht. SUPPORT_EMAIL="test@example.com"

    Die folgenden Oracle Analytics-Ansichten werden vom Skript generiert: ACCOUNTS_MOD, TRANSACTION_MOD und ACCOUNTS_TRANSACTION_MOD.

  9. Führen Sie das ORDS-Skript mithilfe des folgenden Befehls aus.
    npm run start
    Wenn der Befehl ausgeführt wird, werden die folgenden Prompts angezeigt.
    Enter your DB User Name
    Geben Sie den Benutzernamen für die Rich History-Datenbank ein. Der Account muss über die erforderlichen Berechtigungen zum Erstellen von Ansichten und ORDS-Endpunkten verfügen.
    Enter your DB Password
    Geben Sie das Kennwort für die Rich History-Datenbank ein.
    Please select a chaincode type
    Wählen Sie STABLECOIN aus. Verwenden Sie die Pfeiltasten, um zu navigieren, und drücken Sie die Eingabetaste, um Ihre Auswahl zu bestätigen.
    Do you want to create the View and ORDS Endpoint? (y/n)
    Geben Sie y ein, um die Ansicht und den Endpunkt zu erstellen. Geben Sie n ein, wenn Sie die Ansicht und den Endpunkt bereits erstellt haben.
    Please select the language of your chaincode? (TS/GO)
    Wenn Sie zuvor y eingegeben haben, geben Sie TS für TypeScript ein.
    Do you want to generate ORDS Endpoint URL and Bearer Token? (y/n)
    Geben Sie y ein, um die Endpunktzugangsdaten zu generieren. Andernfalls geben Sie n ein.

Oracle Analytics Cloud für Stablecoin konfigurieren

Führen Sie die folgenden Schritte aus, um Oracle Analytics Cloud zu konfigurieren und die Analysearbeitsmappe für das Stablecoin-Szenario zu verwenden.

  1. Erstellen Sie eine Instanz von Oracle Autonomous Database.
  2. Datenbank-View-Definitionen einrichten Informationen zum Einrichten der Datenbankansichtsdefinitionen für das Stablecoin-Beispiel finden Sie unter Oracle Database View Definitions for Stablecoin.
  3. Erstellen Sie eine Instanz von Oracle Analytics Cloud in Oracle Cloud Infrastructure (OCI).
    1. Melden Sie sich bei der OCI-Konsole an.
    2. Klicken Sie auf Analysen und KI > Oracle Analytics Cloud.
    3. Wählen Sie Instanz erstellen aus, und fügen Sie die erforderlichen Informationen hinzu.
    4. Wählen Sie Erstellen aus, und warten Sie, bis die Instanz erstellt wurde.
    Weitere Informationen zu Oracle Analytics Cloud finden Sie unter Oracle Analytics Cloud.
  4. Wählen Sie unter Sample Stablecoin Analytics Workbook auf der Seite Digital Assets in der Oracle Blockchain Platform Digital Assets Edition die Option Beispielanalysepackage herunterladen aus. Die Datei StablecoinAnalyticsPackage.zip, die die Beispielanwendung enthält, wird auf Ihren Computer heruntergeladen.
  5. Extrahieren Sie die Datei StablecoinAnalyticsPackage.zip, die das Verzeichnis StablecoinAnalyticsPackage enthält. Die Arbeitsmappendateien (.dva) befinden sich im Verzeichnis StablecoinAnalyticsPackage
  6. Sichern Sie die Arbeitsmappendateien System Owner Dashboard.dva und Participating Org Dashboard.dva.
  7. Navigieren Sie in der OCI-Konsole zu Oracle Analytics Cloud, und wählen Sie Analytics-Homepage aus.
  8. Wählen Sie Arbeitsmappe/Ablauf importieren aus, und importieren Sie beide Arbeitsmappendateien. Wählen Sie Alle Berechtigungen einbeziehen, falls vorhanden aus. Geben Sie OraAnalytic@2025 als Kennwort ein. Weitere Informationen finden Sie unter Arbeitsmappendatei importieren.
  9. Aktualisieren Sie die Verbindungsdetails der Datenquelle für das Dataset Analytics_Connection.
    1. Gehen Sie zur Seite Daten in Oracle Analytics Cloud.
    2. Suchen Sie das Dataset Analytics_Connection, und wählen Sie Prüfen/Bearbeiten > Datenbankverbindung aktualisieren aus.
    3. Datenbank-Views zuordnen
    4. Wählen Sie Speichern aus.
    Weitere Informationen zum Verbinden von Oracle Autonomous Transaction Processing mit Oracle Analytics Cloud finden Sie unter Verbindung zu Oracle Autonomous Transaction Processing herstellen.
  10. Richten Sie Rollen und Berechtigungen für die Dashboards des Systemeigentümers und der Teilnehmerorganisation ein.
    1. Wählen Sie in Oracle Analytics Cloud die Konsole aus.
    2. Wählen Sie Rollen und Berechtigungen, Anwendungsrollen aus.
    3. Wählen Sie Anwendungsrolle erstellen aus, und erstellen Sie die Anwendungsrolle SystemOwnerRole.
    4. Wählen Sie unter Mitglieder die Option Gruppen und dann Gruppen hinzufügen aus.
    5. Weisen Sie den Rollen SystemOwnerRole und BI Dataload Author Gruppen zu. Die Rolle BI Dataload Author ist erforderlich, um Oracle Analytics Cloud-Daten in Oracle Visual Builder einzubetten. Die mit der Beispielanwendung verknüpften Oracle Identity Cloud Service-(IDCS-)Gruppen müssen der Rolle BI Dataload Author zugeordnet werden. Wenn die Rollen SystemOwnerRole und BI Dataload Author nicht zugeordnet sind, werden die Analysedaten nicht in der Beispielanwendung angezeigt, selbst wenn Oracle Analytics Cloud in Oracle Visual Builder integriert ist. Ordnen Sie diesen Rollen alle relevanten IDCS-Gruppen aus der Beispielanwendung zu. Ordnen Sie beispielsweise die folgenden Gruppen zu.
      • SYSTEM_ADMINS
      • SYSTEM_AUDITORS
      • SYSTEM_CREATORS
      • SYSTEM_MANAGERS
      • SYSTEM_ISSUERS
      • SYSTEM_RETIRERS
    6. Erstellen Sie Rollen für die Teilnehmerorganisationen: ParticipantOrg1Role, ParticipantOrg2Role usw.
    7. Weisen Sie den Teilnehmerorganisationsrollen und der Rolle BI Dataload Author Gruppen zu. Sie können Gruppen mit beliebigen Namen erstellen, wie die folgenden Beispielgruppen. Ändern Sie in den folgenden Beispielgruppen die Nummer der Teilnehmerorganisation im Gruppennamen so, dass sie mit der entsprechenden Organisationsrolle übereinstimmt.
      • ORG1_ADMINS
      • ORG1_AUDITORS
      • ORG1_MANAGERS
      • ORG1_OFFICERS
    Weitere Informationen finden Sie unter Gruppen Anwendungsrollen zuweisen.
  11. Aktualisieren Sie die Parameter für den Instanznamen für die Dashboards des Systemverantwortlichen und der Teilnehmerorganisation.
    1. Melden Sie sich als Administrator an, und öffnen Sie das Dashboard des Systemeigentümers.
    2. Wählen Sie Bearbeiten.
    3. Klicken Sie unter Parameter mit der rechten Maustaste, um den Parameter für den Instanznamen des Systemeigentümers zu bearbeiten.
    4. Geben Sie den Namen der Instanz des Systemeigentümers oder die MSP-ID (Member Service Provider) ein. Geben Sie z.B. CB ein.
    5. Wiederholen Sie die vorherigen Schritte, um den Namen der Systemverantwortlicheninstanz im Teilnehmerorganisations-Dashboard zu aktualisieren.
  12. Aktualisieren Sie die Rollen im Teilnehmerorganisations-Dashboard.
    1. Öffnen Sie das Teilnehmerorganisations-Dashboard, und wählen Sie Dashboard bearbeiten aus.
    2. Wählen Sie in der Registerkarte Daten die Ansicht System_Owner_Account_Trans_Mod-Participating_Org aus.
    3. Wählen Sie Join-Diagramm.
    4. Fügen Sie Rollen und Filter für jeden Teilnehmer hinzu.
      1. Wählen Sie die Schaltfläche "Hinzufügen" neben Rollenfilter aus.
      2. Fügen Sie einen Filterausdruck mit einer Abfrage hinzu. Beispiel: Fügen Sie der Rolle ParticipantOrg1Role die folgende SQL-Abfrage hinzu, in der Org1 und Org2 als Teilnehmerorganisationen erwähnt werden.
        FROM_ORG_ID = 'Org1' AND TO_ORG_ID = 'Org2'
        Sie müssen Rollen hinzufügen und Ausdrücke sequenziell filtern, bevor Sie mit der nächsten Rolle fortfahren.
      3. Wiederholen Sie diesen Vorgang für die Rollen ParticipantOrg2Role, ParticipantOrg3Role usw.
  13. Verschieben Sie die Dashboards in freigegebene Ordner in Oracle Analytics Cloud.
    1. Navigieren Sie zu Katalog > Meine Ordner.
    2. Erstellen Sie einen Ordner namens Shared im Verzeichnis Shared Folders.
    3. Verschieben Sie die Dashboards aus dem Verzeichnis My Folders in den Ordner Shared im Verzeichnis Freigegebene Ordner.
  14. Testen Sie gründlich, um sicherzustellen, dass alle Visualisierungen, Datenverbindungen, Benutzerzugriff und andere Funktionen wie erwartet funktionieren.