שאלות

המנויים של האירועים והפילטרים יכולים לעקוב אחר שינויים במצב blockchain. השתמש בקשת כאשר אתה צריך הצגה ישירה של המצב הנוכחי.

שאלות הן אובייקטים קטנים דומים להוראות. שלח אחד לבן זוג Iroha לקבל פרטים על התפיסה הנוכחית שלו למצב העולם.

רשת עשויה לחשוף מידע אחר. מידע מבוקש של מדינת העולם הוא הסוג היחיד המובטח להיות זמין על כל רשת Iroha.

עבור כל פיתוח של Iroha, עשויים להיות מידע אחר זמין. לדוגמה, הזמינות של נתונים טלמטריים תלויה במנהל הרשתים. זה לגמרי החלטה שלהם אם הם רוצים להקצות כוח עיבוד לעקוב אחר העבודה במקום להשתמש בו כדי לעשות את העבודה האמיתית. לעומת זאת, כמה פונקציות תמיד נדרשות, למשל גישה לריבית החשבון שלך.

התוצאות של שאלות יכולות להיות: סגורה, עמודים ו מסנן סורטינג נעשה על פי לקסיקוגרפית על מפתחות מטא נתונים. סינון ניתן לבצע על בסיס מגוון של עקרונות, החל מקטע ספציפי (פרטי 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);

עמודות

עבור שאילות ייחודיות ושאלות קטנות שניתן לחזור עליהן, אתה יכול להשתמש 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));

פילטרים

כאשר אתה יוצר בקשה, אתה יכול להשתמש במעשן כדי להחזיר רק את התוצאות שמתאימות למעשן המפורט.

פילטרים הם ספציפיים למשאלות. לדוגמה, משאלות חשבונות ניתן לצמצם על ידי זהותו של חשבון או מטא נתונים, בעוד שאילת נכסים ניתן לצמצום על ידי נכס הגדרות, חשבון בעלים או תחזית דומיין. השתמשו בפיתוח השאלות הדפוסים של SDK ככל האפשר כדי שהסוג של המסנן יתאים לסוג יצירה של השאלת.

סורטינג

Iroha יכול לסדר פריטים עם נתונים מטאטא מבחינה לקסיקוגרפית אם אתה מספק מפתח לסדר במהלך הבנייה של החיפוש. מקרה שימוש טיפוסי הוא עבור חשבונות שיש registered-on הכניסה של מטא-מנתונים, אשר, לאחר הסדר, מאפשרת לך להציג את ההיסטוריה של רישום החשבון.

הסגירה חל רק על יחידות שיש להן מטא נתונים, שכן מפתח המטא נתונים משמש לסדר את תוצאות המשאלות .

אתה יכול לשלב סורטינג עם pagination ופילטרים. ציין כי הסורטינג הוא תכונה אופציונלית, רוב שאלות עם pagination לא יצטרכו אותו.

תיקון

בדוק את רשימת השאלות הקיימות לקבלת מידע מפורט עליהם.