예치금 토큰 배포 참조
다음 정보에는 ORDS 스크립트로 생성된 데이터베이스 객체에 대한 설명과 문제 해결 팁이 포함되어 있습니다.
ORDS 스크립트는 구성된 VIEW_PREFIX 매개변수를 사용하여 다음과 같은 작업 뷰를 생성합니다.
<VIEW_PREFIX>_ACCOUNTS_V
<VIEW_PREFIX>_TRANSFER_EVENTS_V
<VIEW_PREFIX>_HOLDS_V
<VIEW_PREFIX>_ACTIVE_ROLES_V
<VIEW_PREFIX>_ACCOUNT_TX_HISTORY_V
<VIEW_PREFIX>_ACCOUNT_HISTORY_V분석을 선택하면 다음 분석 뷰가 생성되고 배치로 범위가 지정됩니다.
<VIEW_PREFIX>_ACCOUNTS_MOD
<VIEW_PREFIX>_TRANSACTION_MOD
<VIEW_PREFIX>_ACCOUNTS_TRANSACTION_MOD또한 이 스크립트는 구성된 값을 사용하여 ORDS 모듈, 경로, 스키마 별칭, 역할, 권한, OAuth 클라이언트 및 클라이언트-역할 연관을 생성하거나 구성합니다.
카탈로그 및 질의 논리 보기
다음 뷰는 선택한 스키마에 있는 일반적인 Oracle 뷰로, 추출기 테이블을 수정하지 않습니다.
| 보기 | 기본 소스 | 목적/논리 |
|---|---|---|
<VIEW_PREFIX>_ACCOUNTS_V |
_more, _store_state |
createAccount 호출 및 계정/토큰 상태에서 현재 계정 디렉토리를 작성합니다. 계정, 사용자 및 조직 ID, 잔액, 보류 잔액, 상태, 일별 제한, 토큰 메타데이터 및 생성 트랜잭션 메타데이터를 분석합니다.
|
<VIEW_PREFIX>_TRANSFER_EVENTS_V |
_more |
토큰 입고 로그를 이전 이벤트 행으로 정규화합니다. 발신자, 수신자, 금액, 함수, 블록/트랜잭션 메타데이터 및 선택적 ~OBPRPCTX~.value.category 컨텍스트를 추출합니다.
|
<VIEW_PREFIX>_HOLDS_V |
_store_hist, _more, _store_state |
민트, 레코딩 및 대출입 보유 레코드를 재구성합니다. 작업/보유 ID, 계정, 공증, 금액, 만료, 토큰, 범주, 설명 및 최신 수명 주기 상태를 추출합니다. 또한 현재 상태 행을 분석할 수 없는 경우에도 폴백 행을 제공합니다. |
<VIEW_PREFIX>_ACTIVE_ROLES_V |
_more |
역할 추가/제거 기록을 적용하고 계정 및 역할당 최신 활성 역할 지정을 반환합니다. |
<VIEW_PREFIX>_ACCOUNT_TX_HISTORY_V |
앞의 작업 뷰 | 이전 측면과 정규화된 민트/번/보류 수명 주기 결과를 포함하여 계정 관련 트랜잭션 내역 행을 생성합니다. _ACCOUNTS_V 뷰에서 ID를 가져오거나 ID로 확장합니다.
|
<VIEW_PREFIX>_ACCOUNT_HISTORY_V |
_more, _ACCOUNTS_V |
일별 제한 개정, 시간 기록, 블록 번호 및 트랜잭션 ID를 포함하여 계정 계약 돌연변이의 계정 구성 기록을 생성합니다. |
<VIEW_PREFIX>_ACCOUNTS_MOD(선택적 분석)
|
_ACCOUNTS_V |
분석 호환 계정 구성에 계정 메타데이터를 노출합니다. |
<VIEW_PREFIX>_TRANSACTION_MOD(선택적 분석)
|
_TRANSFER_EVENTS_V, _HOLDS_V, _store_hist |
이전, 민트, 레코딩, 요청, 보류, 해제 및 가능한 경우 결과 잔액을 포함하여 정규화된 비즈니스 트랜잭션을 노출합니다. |
<VIEW_PREFIX>_ACCOUNTS_TRANSACTION_MOD(선택적 분석)
|
_TRANSACTION_MOD, _ACCOUNTS_V |
분석 트랜잭션 레코드에 출처 및 대상 조직 컨텍스트를 추가합니다. |
ORDS 경로
모든 경로는 <BASE_PATH>/ 아래의 GET 경로이며 OAuth Bearer 토큰이 필요합니다. ORDS는 컬렉션 Envelope를 반환합니다. 빈 items 배열의 HTTP 200은 요청이 적합하지만 일치하는 인덱스화된 레코드가 없음을 의미합니다.
| 라우트 | 사용 및 응답 동작 | 필요한 입력 | 선택적 입력 및 기본 동작 |
|---|---|---|---|
getDepositTokenTransactionById |
정규화된 원장-트랜잭션 세부정보 레코드 하나를 반환합니다. | token_id는 토큰을 식별하고, transaction_id는 Besu 트랜잭션을 식별합니다.
|
없음. 일치하는 항목이 없으면 빈 컬렉션이 반환됩니다. |
getDepositTokenAccountTransactionHistory |
비즈니스 ID로 해결된 계정에 대한 기록을 반환합니다. | token_id, org_id 및 user_id는 계정을 식별합니다.
|
startTime 및 endTime는 시간범위를 제한합니다. 경계가 없으면 생략합니다. bookmark의 기본값은 0입니다. pageSize는 처리기 기본값을 사용합니다.
|
getAllDepositTokenAccountTransactionHistory |
토큰 전체 계정 트랜잭션 기록을 반환합니다. | token_id는 토큰을 식별합니다.
|
startTime, endTime, bookmark 및 pageSize는 계정별 내역 경로에 대해 작동합니다.
|
getDepositTokenAccountStatusHistory |
비즈니스 계정에 대해 인덱스화된 상태 기록 행을 반환합니다. | token_id, org_id 및 user_id는 계정을 식별합니다.
|
없음. |
getDepositTokenApproverActionHistory |
관리자/승인자 결정 및 최종 이전 보류 작업을 반환합니다. | token_id는 토큰을 식별합니다.
|
caller_account_id는 작업자 전자 지갑입니다. 모든 작업자에 대해 생략하거나 하나의 전자 지갑에 범위를 지정합니다.
|
getDepositTokenHistory |
토큰 레벨 내역 및 공급 관련 정보를 반환합니다. | token_id는 토큰을 식별합니다.
|
없음. |
getDepositTokenAccountsByRole |
역할과 연계된 계정을 반환합니다. | role은 일치시킬 롤 이름입니다.
|
없음. |
getDepositTokenUsersByRole |
역할에 대한 사용자/계정 역할 지정을 반환합니다. | role은 일치시킬 롤 이름입니다.
|
없음. |
getDepositTokenOrganizationAccountsByRole |
롤이 있는 조직 계정을 반환합니다. | org_id는 조직을 식별하고 role는 롤 이름입니다.
|
없음. |
getAllDepositTokenAccounts |
하나의 토큰에 대해 인덱스화된 모든 계정을 반환합니다. | token_id는 토큰을 식별합니다.
|
없음. |
getAllActiveDepositTokenAccounts |
현재 인덱스화된 상태가 활성인 계정을 반환합니다. | token_id는 토큰을 식별합니다.
|
없음. |
getAllSuspendedDepositTokenAccounts |
현재 인덱스화된 상태가 일시 중지된 계정을 반환합니다. | token_id는 토큰을 식별합니다.
|
없음. |
getDepositTokenOrganizationAccounts |
한 조직에서 인덱스화된 모든 계정을 반환합니다. | org_id는 조직을 식별합니다.
|
없음. |
getPendingDepositTokenIssuance |
현재 보류 중인 이전 보류 공정만 반환합니다. | token_id는 토큰을 식별합니다.
|
caller_account_id는 공증인/관리자 전자 지갑입니다. 전체 대기열을 생략하고 해당 전자 지갑의 범위를 지정합니다. 터미널 작업은 제외됩니다.
|
getPendingDepositTokenRequest |
대기 중인 민트/번/이전 요청만 반환합니다. | token_id는 토큰을 식별합니다. request_type는 지원되는 요청 유형을 선택합니다.
|
없음. 최근 수명 주기 이벤트가 보류 중으로 남아 있는 작업만 반환됩니다. |
getPendingRequest |
호환성 요청 대기 중 경로입니다. | token_id 및 request_type는 getPendingDepositTokenRequest와 동일한 의미를 가집니다. |
없음. |
getDepositTokenAccountsByUser |
하나의 조직/사용자/토큰 조합에 대한 계정 레코드를 반환합니다. | token_id, org_id 및 user_id는 계정 소유자 및 토큰을 식별합니다.
|
없음. |
getDepositTokenAccountHistory |
계정 구성/내역 개정을 반환합니다. | account_address은 블록체인 계정/지갑 주소입니다.
|
offset는 0 기반 오프셋이며 limit는 행의 상한값입니다. 처리기 기본값 중 하나를 생략합니다.
|
getDepositTokenAccountStatus |
현재 인덱스화된 계정 상태를 반환합니다. | token_id, org_id 및 user_id는 계정을 식별합니다.
|
없음. |
getDepositTokenRolesByAccount |
해결된 계정에 대한 역할을 반환합니다. | token_id는 항상 필요합니다. account_address 또는 org_id와 user_id를 입력합니다.
|
account_address가 제공된 경우 직접 조회이며, 그렇지 않은 경우 조직/사용자 조회가 사용됩니다.
|
getAllDepositTokenOrganizations |
토큰에 대해 인덱스화된 계정으로 표시되는 조직을 반환합니다. | token_id는 토큰을 식별합니다.
|
없음. |
getDepositTokenMetadata |
인덱스화된 변경할 수 없는 토큰 메타데이터를 반환합니다. | token_id는 토큰을 식별합니다.
|
없음. |
getDepositTokenRetiredQuantity |
토큰에 대한 처분/연소된 수량 정보를 반환합니다. | token_id는 토큰을 식별합니다.
|
없음. |
getDepositTokenAccountPolicies |
현재 계정 정책 레코드를 반환합니다. | 없음. | account_policy_id는 하나의 정책을 선택합니다. account_address는 계정별로 필터링합니다. 모두 나열하려면 둘 다 생략합니다. bookmark의 기본값은 0이고, pageSize의 기본값은 20입니다.
|
getDepositTokenAccountPolicyHistory |
계정 정책 개정을 반환합니다. | 없음. | account_policy_id 및 account_address 필터 개정입니다. 모두 나열하려면 모두 생략합니다. bookmark의 기본값은 0이고, pageSize의 기본값은 20입니다.
|
getDepositTokenApprovalPolicies |
현재 승인 정책 레코드를 반환합니다. | 없음. | approval_policy_id는 하나의 정책을 선택하고, 모두 나열하려면 생략합니다. bookmark의 기본값은 0이고, pageSize의 기본값은 20입니다.
|
getDepositTokenApprovalPolicyHistory |
승인 정책 개정을 반환합니다. | 없음. | approval_policy_id는 개정을 필터링하고, 모든 개정을 나열하려면 생략합니다. bookmark의 기본값은 0이고, pageSize의 기본값은 20입니다.
|
getPendingDepositTokenApprovalOperations |
승인 대기 중인 현재 작업을 반환합니다. | 없음. | token_id 및 operation_id는 선택적 필터입니다. 현재 보류 중인 작업을 모두 나열하려면 operation_id를 생략합니다. bookmark의 기본값은 0이고 pageSize의 기본값은 20입니다.
|
getDepositTokenApprovalsByApprover |
승인자의 승인/거부 결정을 반환합니다. | approver_address은 승인자 전자 지갑 주소입니다.
|
operation_id는 결과를 하나의 작업으로 좁힙니다. 해당 승인자의 모든 결정에 대해 생략합니다. bookmark의 기본값은 0이고 pageSize의 기본값은 20입니다.
|
getDepositTokenApprovalsByOperationId |
한 공정에 대한 승인/거부 이벤트를 반환합니다. | operation_id는 승인 작업을 식별합니다.
|
bookmark의 기본값은 0이고, pageSize의 기본값은 20입니다.
|
getDepositTokenApprovalStatusByOperationId |
저장된 워크플로우 상태와 현재 활성 정책 해상도를 반환합니다. | token_id 및 operation_id는 워크플로우/보유를 식별합니다.
|
없음. 합성 BLOCKED 또는 AWAITING_MANAGER_COMPLETION 상태를 생성하지 않습니다.
|
페이지 매김 및 시간 기록: bookmark 매개변수는 0 기반 행 오프셋이며 pageSize 매개변수는 대소문자를 구분하는 낙타 대소문자입니다. 내역 경로의 경우 startTime 및 endTime는 ISO-8601 시간 기록 텍스트를 YYYY-MM-DDTHH:MI:SS+/-HH:MI 형식으로 사용합니다.
끝점 인벤토리: 정확한 경로 인벤토리가 배치를 위해 패키지화된 스크립트 버전에 속합니다. 실행 후 ORDS OpenAPI 카탈로그 또는 생성된 끝점 출력을 클라이언트 응용 프로그램의 신뢰할 수 있는 목록으로 사용합니다.
문제 해결
| 메시지 또는 조건 | 해결 |
|---|---|
NJS-516: no configuration directory set |
액세스 가능한 전자 지갑/구성 디렉토리 없이 TNS 별칭이 사용되었습니다. 전자 지갑을 추출하고 tnsnames.ora 파일을 사용할 수 있도록 Oracle 클라이언트를 구성합니다.
|
NJS-511 또는 ORA-12506 |
리스너, 끝점, 서비스 이름, 네트워크 허용 목록 또는 전자 지갑 구성 문제입니다. DBA를 사용하여 스크립트 외부의 Oracle 연결을 검증합니다. |
| OAuth 토큰 요청이 404를 반환합니다. | /ords/<ALIAS_NAME>/oauth/token에서 정확한 별칭을 확인합니다. 별칭이 반드시 Oracle username일 필요는 없습니다.
|
| 끝점 반환 401 | 새 토큰을 얻고 OAuth 클라이언트에 구성된 모듈 기본 경로와 연관된 롤/권한이 있는지 확인합니다. |
| 끝점 반환 404 | 호스트, 별칭, 기본 경로, 경로 이름 및 모듈이 게시되었는지 확인합니다. |
ORDS-25001 |
끝점이 ORDS에 도달했지만 해당 SQL이 실패했습니다. 테이블 접두어, 계약 주소, 소스 데이터 구성 및 필수 요청 매개변수를 확인합니다. |
ORA-20049: Cannot alter the URL mapping while the schema is enabled |
선택한 ALIAS_NAME이 사용으로 설정된 스키마 매핑과 충돌합니다. 스키마의 기존 별칭을 재사용하거나 ORDS 관리자가 스크립트를 다시 실행하기 전에 승인된 disable/remap/enable 프로시저를 완료하도록 합니다.
|
| 뷰에 행이 없음 | 인스턴스 생성 중 올바른 서식 있는 내역 프로파일이 선택되었는지 확인하고, 테이블 접두어가 정확하며, 계약 주소가 배치된 프록시와 일치하고, 트랜잭션이 인덱스화되었는지 확인합니다. |
| 객체가 다른 배치와 충돌합니다. | 고유한 VIEW_PREFIX, 모듈 이름, 기본 경로, 롤, 권한, OAuth 클라이언트 이름 및 별칭을 사용합니다.
|