Stablecoin 分析

Oracle Blockchain Platform Digital Assets Edition 包含用于稳定币方案的示例 Oracle Analytics 工作簿。

要使用示例 Oracle Analytics 工作簿，必须运行 Oracle REST Data Services (ORDS) 脚本来设置数据库视图定义，然后导入工作簿文件以配置 Oracle Analytics Cloud。

Stablecoin 的 Oracle Database View 定义

您必须先设置数据库视图定义，然后才能在稳定币方案中使用 Oracle Analytics 工作簿。

  1. 启用和配置富历史记录数据库。
    有关详细信息，请参阅 Using Oracle Blockchain Platform 中的 Enable and Configure the Rich History Database 。
  2. 在包含要写入到富历史记录数据库的链代码数据的渠道上启用富历史记录。有关详细信息，请参阅 Using Oracle Blockchain Platform 中的 Configure the Channels that Write Data to the Rich History Database 。
  3. 下载并安装 Node.js 版本 18 或更高版本。
  4. 在 Oracle Blockchain Platform 的数字资产页面上，选择稳定币。
  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 用于从富历史记录数据库中提取事务处理详细信息的链代码的名称。 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
    输入丰富历史记录数据库的用户名。账户必须具有创建视图和 ORDS 端点所需的权限。
    Enter your DB Password
    输入丰富的历史记录数据库的密码。
    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。

配置 Oracle Analytics Cloud for Stablecoin

完成以下步骤来配置 Oracle Analytics Cloud 并针对稳定币方案使用分析工作簿。

  1. 创建 Oracle Autonomous Database 的实例。
  2. 设置数据库视图定义。有关如何为稳定币示例设置数据库视图定义的信息，请参阅 Oracle Database View Definitions for Stablecoin 。
  3. 在 Oracle Cloud Infrastructure (OCI) 中创建 Oracle Analytics Cloud 实例。
    1. 登录到 OCI 控制台。
    2. 单击 Analytics & AI > Oracle Analytics Cloud 。
    3. 选择创建实例，然后添加所需的信息。
    4. 选择创建，然后等待实例创建完成。
    有关 Oracle Analytics Cloud 的更多信息，请参阅 Oracle Analytics Cloud 。
  4. 在 Oracle Blockchain Platform Digital Assets Edition 中的 Digital Assets 页面的 Sample Stablecoin Analytics Workbook 下，选择 Download sample Analytics package（下载示例分析包）。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. 选择保存。
    有关将 Oracle Autonomous Transaction Processing 连接至 Oracle Analytics Cloud 的更多信息，请参阅连接至 Oracle Autonomous Transaction Processing 。
  10. 为系统责任人和参与者组织仪表盘设置角色和权限。
    1. 在 Oracle Analytics Cloud 中，选择控制台。
    2. 选择 Roles and Permissions（角色和权限），然后选择 Application Roles（应用程序角色）。
    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
    有关更多信息，请参见 Assign Application Roles to Groups 。
  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 Folders 目录内的 Shared 文件夹。
  14. 全面测试，确保所有可视化、数据连接、用户访问和其他功能都能按预期工作。