კითხვები

მოვლენების აბონენტებს და ფილტრებს შეუძლიათ აკვირდნენ ცვლილებებს ბლოკჩეინის მდგომარეობაში. გამოიყენეთ გამოკითხვა, როდესაც თქვენ გჭირდებათ პირდაპირი ნახვა მიმდინარე მდგომარეობის შესახებ.

შეკითხვები პატარა ინსტრუქციების მსგავსი ობიექტებია. გააგზავნეთ ერთი Iroha თანატოლს, რათა მიიღოთ დეტალები მისი ამჟამინდელი მსოფლიო მდგომარეობის შესახებ.

ქსელმა შეიძლება გამოავლინოს სხვა ინფორმაცია. მსოფლიოს სახელმწიფოების შესახებ ინფორმაციის მოძიება ერთადერთი სახის გარანტირებულია, რომელიც ყველა Iroha ქსელში იქნება ხელმისაწვდომი.

თითოეული Iroha განთავსებისას შეიძლება არსებობდეს სხვა ხელმისაწვდომი ინფორმაცია. მაგალითად, ტელემეტრიული მონაცემების ხელმისაწვდომობა დამოკიდებულია ქსელის ადმინისტრატორებზე. ეს მთლიანად მათი გადაწყვეტილებაა, უნდათ თუ არა გადანაწილდეს დამუშავების ძალა სამუშაოს თვალსაზრისით და არა მისი გამოყენებით რეალური სამუშაოს შესასრულებლად. ამის საპირისპიროდ, გარკვეული ფუნქციები ყოველთვის საჭიროა, მაგალითად, თქვენი ანგარიშის ბალანსზე წვდომა.

შეკითხვების შედეგები შეიძლება ერთდროულად იყოს სორტირებული, გვერდებიანი და ფილტრული peer-side. სორტირება ხორციელდება ლექსიკოგრაფიულად მეტა მონაცემების გასაღებად. ფილტრირება შეიძლება განხორციელდეს სხვადასხვა პრინციპით, დომენის სპეციფიკიდან (ინდივიდუალური IP მისამართის ფილტრის ნიღაბები) ქვესტრიგების მეთოდებამდე, როგორიცაა begins_with, რომელიც კომბინირებულია ლოგიკური ოპერაციებით.

სცადეთ 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}]}'

აპლიკაციის დიაგნოსტიკისთვის, შეინახეთ ეს სიგარეტის შემოწმება ხელმოწერილი ტრანზაქციის ტესტებისგან ცალკე. მხოლოდ წაკითხვის გამოკითხვის წარუმატებლობა ჩვეულებრივ მიუთითებს საბოლოო წერტილის ხელმისაწვდომობაზე, ქსელის მისაღწევად ან მარშრუტის თავსებადობაზე, სანამ ის მიუთითებთ ხელმომწერის პარამეტრზე.

შეიქმნას შეკითხვა

გამოიყენეთ SDK ან CLI-ის ტიპირებული გამოკითხვის შემქმნელები. მაგალითად, მიმდინარე მონაცემთა მოდელი ასახავს FindAccounts სარეკლამო ანგარიშებისთვის:

let query = FindAccounts;

აქ არის მაგალითი გამოკითხვის, რომელიც ალიცის ქონებას იპოვნებს:

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

გვერდების გათვლა

ცალკეული და მცირე iterable შეკითხვები, შეგიძლიათ გამოიყენოთ client.request წარადგინოს შეკითხვა და მიიღოს შედეგი ერთ სვლაში.

მიუხედავად ამისა, ფართო განმეორებადი გამოკითხვები, როგორიცაა FindAccounts, FindAssets ან FindBlocks შეიძლება დაბრუნდეს დიდი შედეგების ნაკრებები. გამოიყენეთ პაჟინაცია, რათა შეამციროთ დატვირთვა პარტნიორსა და კლიენტზე.

იმისათვის, რომ 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 are query-specific. მაგალითად, ანგარიშის შეკითხვები შეიძლება შეიზღუდოს ანგარიშის იდენტობის ან მეტა მონაცემების მიხედვით, ხოლო აქტივების შეკითხვები შესაძლებელია შეიზღუდონ აქტივებით განსაზღვრა, მფლობელის ანგარიში ან დომენის პროექცია. გამოიყენეთ SDK ტიპირებული გამოკითხვის მშენებლები, სადაც შესაძლებელია, ასე რომ ფილტრის ტიპი შეესაბამება გამოკითხვის საგამოშვო ტიპს.

დახარისხება

Iroha შეუძლია ლექსიკოგრაფიულად დაასორტიროს ელემენტები მეტა მონაცემებით, თუ შეკითხვის მშენებლობის დროს მიუთითებთ გასაღებს. ტიპიური გამოყენების შემთხვევა არის ანგარიშებისთვის registered-on მეტა მონაცემთა შესვლა, რომელიც, როდესაც დაასორდირდება, საშუალებას გაძლევთ ნახოთ ანგარიშის რეგისტრაციის ისტორია .

დარიგება მხოლოდ იმ სუბიექტებზე ვრცელდება, რომელთაც მეტა მონაცემები აქვთ, რადგან მიმოხილვის შედეგების დარიგებისთვის გამოიყენება მეტა მონაცემთა გასაღებები.

თქვენ შეგიძლიათ შეურიგოთ სორტირება გვერდების დაფილტრებით. გაითვალისწინეთ, რომ სორტირება არის ვარიანტული მახასიათებელი, უმეტეს გამოკითხვებში გვერდების გამოყენებით ეს არ იქნება საჭირო.

რეფერენცია

შეამოწმეთ არსებული გამოკითხვების სია მათ შესახებ დეტალური ინფორმაციის მისაღებად.