မေးခွန်းများ

Event subscribers နဲ့ filters တွေက blockchain state ထဲမှာ ဖြစ်ပေါ်နေတဲ့ ပြောင်းလဲမှုတွေကို ခြေရာခံနိုင်ပါတယ်။ လက်ရှိအခြေအနေကို တိုက်ရိုက်ကြည့်ဖို့ လိုအပ်တဲ့အခါ query ကို အသုံးပြုပါ။

မေးမြန်းချက်တွေဟာ ညွှန်ကြားချက်တွေလို အရာဝတ္ထုလေးတွေပါ၊ Iroha တူညီသူကို တစ်စုံတစ်ရာ ပေးပို့ပြီး သူ့လက်ရှိကမ္ဘာအခြေအနေအမြင်ရဲ့ အသေးစိတ်အချက်အလက်တွေကိုရယူပါ။

ကွန်ရက်တစ်ခုက အခြားသတင်းအချက်အလက်တွေကို ဖေါ်ပြနိုင်သည်။ ရှာဖွေလို့ရတဲ့ ကမ္ဘာ့နိုင်ငံဆိုင်ရာ သတင်းအချက်အလက်တွေဟာ Iroha ကွန်ရက်တိုင်းမှာ ရရှိနိုင်ခြေ အာမခံထားတဲ့ တစ်ခုတည်းသော အမျိုးအစားပါ။

Iroha ကို ဖြန့်ချိမှုတစ်ခုစီအတွက် အခြားသတင်းအချက်အလက်များရှိနိုင်သည်။ ဥပမာ၊ တယ်လီမက်ထရီဒေတာတွေရရှိမှုဟာ ကွန်ရက် အုပ်ချုပ်ရေးမှူးများအပေါ် မူတည်ပါတယ်။ တကယ်အလုပ်လုပ်ဖို့ သုံးမယ့်အစား အလုပ်ကို ခြေရာခံဖို့ စီမံခန့်ခွဲမှုစွမ်းအားဖြည့်ဆည်းပေးချင်၊မလုပ်ချင်တာ သူတို့ ဆုံးဖြတ်ချက်တစ်ခုလုံးပါ။ ဆန့်ကျင်ဘက်အနေနဲ့ တစ်ချို့လုပ်ဆောင်ချက်တွေဟာ အမြဲတမ်းလိုအပ်တယ်၊ ဥပမာ သင့်အကောင့်ရဲ့ ငွေကြေးစာရင်းဆီ ဝင်ခွင့်ရှိခြင်း။

မေးမြန်းချက်များ၏ ရလဒ်များကို ၊ paginated နှင့် peer-side filtered တို့ဖြင့် တစ်ပြိုင်နက်စီခွဲခြားနိုင်သည်။ စာလုံးစာရင်းခွဲဝေခြင်းသည် metadata key များတွင် lexicographically ပြုလုပ်သည်။ Filtering ကို domain-specific (ပုဂ္ဂိုလ်တစ်ဦးချင်း IP address filter mask များ) ကနေ begins_with လို substring method တွေကို logical operations တွေကို အသုံးပြုပြီး ပေါင်းစပ်ခြင်းအထိ အခြေခံမူမျိုးစုံနဲ့ လုပ်နိုင်ပါတယ်။

Taira မှာ စမ်းကြည့်ပါ။

Taira သည် အများသုံးအရင်းအမြစ်များအတွက် JSON ကိုသာ ဖတ်နိုင်သော မေးမြန်းမှုကူညီသူများကို ဖော်ပြပေးသည်။ SDK ကို ကြိုးသွင်းခြင်းမတိုင်မီ စာမျက်နှာပြုပြင်ခြင်းနှင့် တုံ့ပြန်မှု စီမံခန့်ခွဲမှုကို လေ့ကျင့်ရန်အသုံးပြုပါ:

TAIRA_ROOT=https://taira.sora.org

curl -fsS "$TAIRA_ROOT/v1/accounts?limit=3" \
  | jq '{total, ids: [.items[].id]}'

curl -fsS "$TAIRA_ROOT/v1/domains?limit=3" \
  | jq '{total, domains: [.items[].id]}'

curl -fsS "$TAIRA_ROOT/v1/assets/definitions?limit=3" \
  | jq '{total, assets: [.items[] | {id, name, total_quantity}]}'

App ရောဂါရှာဖွေရေးအတွက် ဒီမီးခိုးစစ်ဆေးမှုကို လက်မှတ်ထိုးထားတဲ့ ငွေပေးချေမှု စမ်းသပ်ချက်တွေနဲ့ သီးခြားထားပါ။ စာဖတ်ရုံပဲ မေးမြန်းမှု ပျက်ကွက်မှုက လက်မှတ်ထိုးသူကို ညွှန်ပြမချင်း အဆုံးသတ်မှတ်တိုင်၊ ကွန်ရက်ရရှိနိုင်မှု၊ (သို့) လမ်းကြောင်းညီညွတ်မှုကို ညွှန်ကြားတယ်။

မေးမြန်းမှု ဖန်တီးခြင်း

SDK (သို့) CLI မှ typeed query builders ကိုအသုံးပြုပါ။ ဥပမာ၊ လက်ရှိဒေတာပုံစံက စာရင်းတင်စာရင်းအတွက် FindAccounts ကို ဖော်ပြပါတယ်။

let query = FindAccounts;

ဒီမှာ Alice ရဲ့ အရင်းအမြစ်တွေကို ရှာဖွေတဲ့ မေးမြန်းမှုရဲ့ ဥပမာပါ။

let alice_id = load_canonical_account_id_from_client_config()?;
let query = FindAssetsByAccountId::new(alice_id);

စာမျက်နှာရှာဖွေခြင်း

တစ်ပုဒ်တည်းသော မေးမြန်းချက်များနှင့် အသေးစား အပြန်အလှန်မေးမြန်းနိုင်သည့် မေးမြန်းမှုများအတွက် client.request ကို အသုံးပြု၍ မေးမြန်းချက်ကို တင်ပြပြီး ရလဒ်ကို တစ်ကြိမ်တည်းရယူနိုင်သည်။

သို့သော်လည်း FindAccounts, FindAssets သို့မဟုတ် FindBlocks ကဲ့သို့သော ကျယ်ပြန့်သော အပြန်အလှန်မေးမြန်းနိုင်သည့် မေးမြန်းချက်များသည် ကြီးမားသော ရလဒ်စုများကို ပြန်လည်ပေးပို့နိုင်သည်။ peer နှင့် client ပေါ်တွင် load ကိုလျော့ချရန် pagination ကိုအသုံးပြုပါ။

Pagination ကို ဆောက်လုပ်ရန်အတွက် client.request_with_pagination(query, pagination) သို့ ဖုန်းခေါ်ဆိုရန် လိုအပ်ပြီး pagination ကို အောက်ပါအတိုင်း တည်ဆောက်ထားသည်။

let starting_result: u32 = _;
let limit: u32 = _;
let pagination = Pagination::new(Some(starting_result), Some(limit));

Filters များ

မေးမြန်းချက်တစ်ခု ဖန်တီးတဲ့အခါ သတ်မှတ်ထားတဲ့ စစ် filter နဲ့ ကိုက်ညီတဲ့ ရလဒ်တွေကိုပဲ ပြန်ပို့ဖို့ filter တစ်ခုကို အသုံးပြုနိုင်ပါတယ်။

Filters တွေဟာ query-specific ဖြစ်ပါတယ် ဥပမာ Account queries တွေကို account identity (သို့) metadata တွေနဲ့ ကျဉ်းမြောင်းနိုင်ပြီး Asset queries ကို asset နဲ့ ကျဉ်းမြုပ်စေနိုင်ပါတယ်။ Definition, holder account, or domain projection. SDK ရဲ့ typeed query builders တွေကို အသုံးပြုပြီး filter အမျိုးအစားက query output အမျိုးအစားနဲ့ ကိုက်ညီစေဖို့ ဖြစ်နိုင်ခြေရှိပါ။

အမျိုးအစားခွဲခြင်း

Iroha သည် စာမေးပွဲ တည်ဆောက်စဉ်တွင် sort လုပ်ရန် key ကိုပေးပါက metadata နှင့်အတူ entries များကို lexicographically sort လုပ်နိုင်သည်။ သာမန်အသုံးပြုမှုကိစ္စတစ်ခုမှာ အကောင့်များအတွက် registered-on metadata entry ကိုရှိသည်၊ ဒါက sorted ဖြစ်သောအခါ အကောင့်မှတ်ပုံတင်သမိုင်းကိုကြည့်ရှုခွင့်ပြုသည်။

Sorting သည် metadata ရှိသော entities များအတွက်သာ သက်ရောက်သည်၊ query ရလဒ်များကို sort လုပ်ရန် metadata key ကိုအသုံးပြုသည်။

Pagination နဲ့ Filter တွေကို ပေါင်းစပ်လို့ရပါတယ်။ Pagination ပါတဲ့ Query အများစုမှာ မလိုတော့ဘူး ဆိုတာကို သတိထားပါ။

ရည်ညွှန်းချက်

ရှိနေတဲ့ မေးမြန်းချက်တွေရဲ့ စာရင်းကို ကို စစ်ဆေးပြီး ဒါတွေနဲ့ ပတ်သက်တဲ့ အသေးစိတ် အချက်အလက်တွေ ရှာကြည့်ပါ။