מטאדאטה
מטאדאטה היא מפה של ערך מפתח מבוקש הקשורת לאובייקטים במספר. המפתחות הן ערכים Name והערכים הם עומסי תועלת JSON (Json).
האובייקטים הבאים יכולים להכיל מטא נתונים:
- תחומים
- חשבונות
- נכסים
- הגדרות נכסים
- NFTs
- RWAs
- תפעילים
- עסקאות
השתמשו בתנתונים מטא עבור שדות תיאוריים או אינדקסינג קטנים שייכים למצב ספריה. עומסים מועילים גדולים צריכים להיות מאוחסנים מחוץ ל- WSV ומועדגים על ידי מסלול דיג'סט, URI, או SoraFS.
לקבלת הוראות על בחירת נתונים מטאטא, נכסים NFTs, RWAs או אחסון מחוץ לרשת, ראה הבחירות לאחסון נתונים מטטאטא ונתונים ספריים .
נסה את זה על Taira
נתונים מטאטא נראים באמצעות קריאת משאבים רגילה. פקודה זו רשימה הגדרות נכסים Taira שיש להם כיום נתונים מטטא:
curl -fsS 'https://taira.sora.org/v1/assets/definitions?limit=100' \
| jq '.items[]
| select((.metadata | length) > 0)
| {id, name, metadata}'השתמשו בדפוס זהה עבור דומנים וחשבות:
curl -fsS 'https://taira.sora.org/v1/domains?limit=20' \
| jq '.items[] | select((.metadata // {} | length) > 0)'
curl -fsS 'https://taira.sora.org/v1/accounts?limit=20' \
| jq '.items[] | select((.metadata // {} | length) > 0)'מתייחס לתוצאת ריקה כתוצאה תקפה. זה אומר שהדף הנוכחי של Taira אובייקטים אינו מכיל מטא נתונים, לא כי נקודת הסיום נכשלה.
עדכון נתונים מטאטא
הנתונים המטאטאליים משתנים עם הוראות מיוחדות Iroha:
SetKeyValueמדביקים או מחליפים מפתחRemoveKeyValueמסיר מפתח
לרשות המגיש את העסקה חייב להיות הרשיון הנדרש על ידי מתוקן הזמן הפעיל. עבור שטח הרשיונות המקובל, ראה Tokens Permission .
אירועים
אירועי נתונים יוצרים כאשר מתנתונים משתנים. עומס השימוש של אירוע כללי הוא MetadataChanged<Id>:
השתמשו ב- filters של אירועים נתונים כדי לחתום רק על אירועי מטא נתונים עבור סוג הארגון או אובייקט ID החשוב לאינטגרציה.
שאלות
נתונים מטאטא חוזרים כחלק מהאובייקט שאל. לדוגמה, השתמש FindAccountById, FindDomainById, או FindAssetDefinitionById. השתמש FindNfts או FindNftsByAccountId עבור NFTs, ו FindRwas עבור RWA הרבה. ואז לקרוא את שדה הנתונים המתאים של האובייקט. תשובות השאלות של NFT חושפות את המפה NFT content כמטאטא נתונים רשומים.
מפתחות הנתונים מטאטא הם חלק ממצב הספרים, אז לשמור אותם יציבים ולהימנע מקודד גרסה ספציפית יישום ל-churn לתוך שם המפתח כאשר ערך JSON יכול לשאת את הגרסה הזו באופן בולט.