Wholesale CBDCデプロイメント・リファレンス

次の情報には、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コールおよびアカウント/トークンの状態から現在のアカウント・ディレクトリを構築します。アカウント、ユーザーおよび組織のアイデンティティ、残高、保留残高、ステータス、日次限度、トークン・メタデータおよび作成トランザクション・メタデータを解決します。
<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ビューからアイデンティティをエンリッチします。
<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ベアラー・トークンが必要です。ORDSはコレクション・エンベロープを返します。HTTP 200が指定された空のitems配列は、リクエストが有効であったが、一致する索引付きレコードがないことを意味します。

ルート	使用および応答動作	必須の入力	オプションの入力とデフォルトの動作
getCBDCTransactionById	正規化された元帳取引詳細レコードを1つ返します。	token_idはWCBDCトークンを識別し、transaction_idは取得するBesuトランザクションのハッシュ/識別子です。	なし。一致するトランザクションがないと、空のコレクションが返されます。
getCBDCAccountTransactionHistoryWithFilters	ビジネス・アイデンティティで識別されるアカウントの履歴を返します。	token_idはトークンを識別し、org_idは組織を識別し、user_idはアカウント・ユーザーを識別します。	startTimeおよびendTimeは時間範囲を制限します。省略すると、下限/上限境界がないことを意味します。bookmarkはゼロベースのオフセットです。省略すると0を意味します。pageSizeはリクエストされた行数です。省略すると、ハンドラのデフォルトが使用されます。
getAllCBDCAccountTransactionHistoryWithFilters	トークン全体のアカウント・トランザクション履歴を返します。	token_idはトークンを識別します。	startTime、endTime、bookmarkおよびpageSizeは、アカウント固有の履歴ルートと同様に動作します。
getCBDCAccountStatusHistory	ビジネス・アカウントの索引付きステータス履歴行を返します。	token_id、org_idおよびuser_idは、アカウントを識別します。	なし。一致するアカウント/履歴が空のコレクションを返しません。
getApproverActionHistory	ミント/バーン決定および最終的な転送保留アクションを返します。executeHoldが実行され、releaseHoldは拒否されます。	token_idは、結果をトークンに制限します。	caller_account_idは、マネージャ/承認者のウォレット・アドレスです。それを省略して、すべてのアクターによるアクションを返し、そのウォレットのアクションのみを返すようにします。データ・スコープ・フィルタであり、認可ではありません。
getTokenHistory	トークン・レベルの履歴および供給関連情報を返します。	token_idはトークンを識別します。	なし。
getCBDCAccountsByRole	ロールに関連付けられたアカウントを返します。	roleは、照合するロールの名前です。	なし。結果は、このルートによってトークン・フィルタされません。
getUsersByRole	ロールのユーザー/アカウント・ロール割当を返します。	roleは、照合するロール名です。	なし。
getOrgAccountsByRole	ロールを持つ1つの組織内のアカウントを返します	org_idは組織を識別し、roleはロール名です。	なし。
getAllCBDCAccounts	1つのトークンのすべてのインデックス付きアカウントを返します。	token_idはトークンを識別します。	なし。
getAllActiveCBDCAccounts	現在のステータスがアクティブであるインデックス付きアカウントを返します。	token_idはトークンを識別します。	なし。
getAllSuspendedCBDCAccounts	現在のステータスが一時停止されているインデックス付きアカウントを返します。	token_idはトークンを識別します。	なし。
getAllOrgAccounts	1つの組織内のすべての索引付き勘定科目を返します。	org_idは、組織を識別します。	なし。結果は、このルートによってトークン・フィルタされません。
getPendingCBDCIssuance	現在の保留中の転送保留操作のみを返します。端末、実行、拒否、および解放された操作は除外されます。	token_idはトークンを識別します。	caller_account_idは、公証人/マネージャ・ウォレットです。保留キュー全体を省略し、そのウォレットに割り当てられた保留のみを返すように指定します。
getPendingCBDCRequest	現在の保留中のミント/バーン・リクエストのみを返します。	token_idはトークンを識別し、request_typeはサポートされているリクエスト・タイプ(mintやburnなど)を選択します。	なし。承認または却下されたリクエストは除外されます。
getPendingRequest	同じリクエスト保留中ユース・ケースの互換性ルート。	token_idおよびrequest_typeは、getPendingCBDCRequestと同じ意味を持ちます。	なし。
getCBDCAccountsByUser	1つの組織/ユーザー/トークンの組合せの勘定科目レコードを返します。	token_id、org_idおよびuser_idは、アカウントの所有者とトークンを識別します。	なし。
getCBDCAccountHistory	アカウント構成/履歴リビジョンを返します。	account_addressは、ブロックチェーンのアカウント/ウォレット・アドレスです。	offsetは、ゼロベースの行オフセットです。最初のページでは省略します。limitは最大行数です。SQLハンドラのデフォルトの使用を省略します。
getCBDCAccountStatus	現在のインデックス付きアカウント・ステータスを返します。	token_id、org_idおよびuser_idは、アカウントを識別します。	なし。
getRolesByAccount	解決されたアカウントのロールを返します。	token_idは常に必須です。account_address (ブロックチェーン・アカウント/ウォレット・アドレス)または結合されたorg_idおよびuser_idビジネス参照のいずれかを指定します。	account_addressを指定した場合、直接アカウント・フィルタになります。指定しない場合、ルートはorg_idおよびuser_idを使用します。どちらの参照もアカウントを解決しない場合、レスポンスは空になります。
getAllRegisteredOrgs	トークンのインデックス付きアカウントで表される組織を返します。	token_idはトークンを識別します。	なし。
getCBDCMetadata	索引付き不変トークン・メタデータを返します。	token_idはトークンを識別します。	なし。
getCBDCRetiredQuantity	トークンの除・売却済/バーン済数量情報を返します。	token_idはトークンを識別します。	なし。

ページ区切りとタイムスタンプ: bookmarkおよびpageSizeパラメータをサポートする2つの履歴ルートの場合、bookmarkパラメータはゼロベースの行オフセットで、pageSizeパラメータはキャメル・ケースです。ハンドラ・デフォルトを使用するには、いずれかの値を省略します。startTimeおよびendTimeパラメータを指定すると、YYYY-MM-DDTHH:MI:SS+/-HH:MI形式のISO-8601タイムスタンプ・テキストが使用されます。

エンドポイント・インベントリ: 正確なルート・インベントリは、デプロイメント用にパッケージ化されたスクリプト・バージョンに属します。実行後、ORDS OpenAPIカタログまたは生成されたエンドポイント出力をクライアント・アプリケーションの認可リストとして使用します。

トラブルシューティング

メッセージまたは条件	解決策
NJS-516: no configuration directory set	アクセス可能なウォレット/構成ディレクトリがない状態でTNS別名が使用されました。ウォレットを抽出し、Oracleクライアントを構成して、tnsnames.oraファイルを使用できるようにします。
NJS-511またはORA-12506	リスナー、エンドポイント、サービス名、ネットワーク許可リストまたはウォレット構成の問題。DBAとともにスクリプト外部のOracle接続を検証します。
OAuthトークン・リクエストが404を返します	/ords/<ALIAS_NAME>/oauth/tokenの正確な別名を確認します。別名は必ずしもOracleユーザー名ではありません。
エンドポイントから401が返されました	新しいトークンを取得し、構成済のモジュール・ベース・パスに関連付けられたロール/権限がOAuthクライアントにあることを確認します。
エンドポイントから404が返されました	ホスト、別名、ベース・パス、ルート名、およびモジュールが公開されていることを確認します。
ORDS-25001	エンドポイントがORDSに到達しましたが、そのSQLが失敗しました。表の接頭辞、契約住所、ソース・データ・シェイプおよび必要なリクエスト・パラメータを確認します。
ORA-20049: Cannot alter the URL mapping while the schema is enabled	選択したALIAS_NAMEは、有効なスキーマ・マッピングと競合します。スキーマの既存の別名を再利用するか、またはスクリプトを再実行する前にORDS管理者に承認済の無効化/再マップ/有効化プロシージャを完了してもらいます。
ビューには行がありません	インスタンスの作成中に正しいリッチ履歴プロファイルが選択され、表接頭辞が完全で、契約住所がデプロイされたプロキシと一致し、トランザクションが索引付けされていることを確認します。
オブジェクトが別のデプロイメントと競合しています	個別のVIEW_PREFIX、モジュール名、ベース・パス、ロール、権限、OAuthクライアント名および別名を使用します。