Stablecoin 분석

Oracle Blockchain Platform Digital Assets Edition에는 Stablecoin 시나리오를 위한 샘플 Oracle Analytics 워크북이 포함되어 있습니다.

샘플 Oracle Analytics 워크북을 사용하려면 Oracle REST Data Services(ORDS) 스크립트를 실행하여 데이터베이스 뷰 정의를 설정한 다음 워크북 파일을 임포트하여 Oracle Analytics Cloud를 구성해야 합니다.

Stablecoin에 대한 Oracle Database 뷰 정의

Stablecoin 시나리오에서 Oracle Analytics 워크북을 사용하려면 먼저 데이터베이스 뷰 정의를 설정해야 합니다.

  1. 풍부한 기록 데이터베이스를 사용으로 설정하고 구성합니다.
    자세한 내용은 Oracle Blockchain Platform 사용의 리치 기록 데이터베이스 사용 및 구성을 참조하십시오.
  2. 리치 이력 데이터베이스에 쓰려는 체인코드 데이터가 포함된 채널에서 풍부한 이력을 사용할 수 있습니다. 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 풍부한 기록 데이터베이스에서 트랜잭션 세부정보를 인출하는 체인 코드의 이름입니다. 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"

    ACCOUNTS_MOD, TRANSACTION_MOD 및 ACCOUNTS_TRANSACTION_MOD 스크립트를 통해 생성되는 Oracle Analytics 뷰는 다음과 같습니다.

  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을 입력합니다.

Stablecoin용 Oracle Analytics Cloud 구성

Oracle Analytics Cloud를 구성하고 Stablecoin 시나리오에 대한 분석 워크북을 사용하려면 다음 단계를 완료하십시오.

  1. Oracle Autonomous Database의 인스턴스를 생성합니다.
  2. 데이터베이스 뷰 정의를 설정합니다. Stablecoin 샘플에 대한 데이터베이스 뷰 정의를 설정하는 방법에 대한 자세한 내용은 Oracle Database View Definitions for Stablecoin을 참조하십시오.
  3. OCI(Oracle Cloud Infrastructure)에서 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 분석 워크북에서 샘플 분석 패키지 다운로드를 선택합니다. 샘플 응용 프로그램이 포함된 StablecoinAnalyticsPackage.zip 파일이 컴퓨터에 다운로드됩니다.
  5. StablecoinAnalyticsPackage 디렉토리가 포함된 StablecoinAnalyticsPackage.zip 파일의 압축을 풉니다. 워크북(.dva) 파일은 StablecoinAnalyticsPackage 디렉토리에 있습니다.
  6. 워크북 파일 System Owner Dashboard.dva 및 Participating Org Dashboard.dva를 모두 백업합니다.
  7. OCI 콘솔에서 Oracle Analytics Cloud로 이동한 다음 Analytics 홈 페이지를 선택합니다.
  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. 역할 및 권한을 선택한 다음 애플리케이션 롤을 선택합니다.
    3. 애플리케이션 롤 생성을 선택하고 SystemOwnerRole 애플리케이션 롤을 생성합니다.
    4. 멤버에서 그룹을 선택한 다음 그룹 추가를 선택합니다.
    5. SystemOwnerRole 및 BI Dataload Author 롤에 그룹을 지정합니다. Oracle Analytics Cloud 데이터를 Oracle Visual Builder에 포함하려면 BI Dataload Author 롤이 필요합니다. 샘플 애플리케이션과 연관된 IDCS(Oracle Identity Cloud Service) 그룹은 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. 질의를 포함하는 필터 표현식을 추가합니다. 예를 들어, Org1 및 Org2를 참가자 조직으로 언급하는 ParticipantOrg1Role 역할에 다음 SQL 질의를 추가합니다.
        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. 모든 시각화, 데이터 연결, 사용자 액세스 및 기타 기능이 예상대로 작동하는지 철저히 테스트합니다.