Ion (serialization format)
≈ 3 min read
Names in other languages
No names in other languages are held for this entry yet.
Article bodies are English and are not machine-translated. A name in another language is not a translation of the article.
Ion is a data serialization language developed by Amazon. It may be represented by either a human-readable text form or a compact binary form. The text form is a superset of JSON; thus, any valid JSON document is also a valid Ion document.
Ion is a data serialization language developed by Amazon. It may be represented by either a human-readable text form or a compact binary form. The text form is a superset of JSON; thus, any valid JSON document is also a valid Ion document.
Data types
As a superset of JSON, Ion includes the following data types : An empty value (for JSON compatibility) : Boolean values : Unicode text literals : Ordered heterogeneous collection of Ion values (extension of JSON array) : Unordered collection of key/value pairs (extension of JSON object) The nebulous JSON 'number' type is strictly defined in Ion to be one of : Signed integers of arbitrary size : 64-bit IEEE binary-encoded floating point numbers : Decimal-encoded real numbers of arbitrary precision Ion adds these types: : Date/time/time zone moments of arbitrary precision : Unicode symbolic atoms ( identifiers), stored as interned strings in binary format : Binary data of user-defined encoding : Text data of user-defined encoding : Nested list of values (equivalent to an S-expression) with application-defined semantics Each Ion type supports a null variant, indicating a lack of value while maintaining a strict type (e.g., , ). The Ion format permits attaching one or more annotations (i.e. a list of symbols) to any value. Such annotations may be used as metadata for otherwise opaque data (such as a blob).
Examples
Sample document
Features seen in JavaScript and JSON5: // Comments are allowed using the double forward slash { key: "value", // key here is a symbol, it can also be a string as in JSON nums: 1_000_000, // equivalent to 1000000, use of underscores with numbers is more readable "A float": 31415e-4, // key is a value that contains spaces } Features unique to Ion: { symbol: 'a symbol', // symbols are interned Unicode strings "A null integer": null.int, annotated: age::35, // the symbol "age" is attached to the value "35" as an annotation lists : 'hw grades'::[80, 85, 90], // any symbol can be used as an annotation many_annot: I::have::many::annotations::true, // annotations are not nested, but rather, a list of annotations sexp: (this (is a [valid] "Ion") last::value + 42) // Ion S-expressions. 'this', 'is', 'a', 'valid', 'value', and '+' are symbols. _value: , // blob value is represented as base64 _value: // clob value is represented as an ASCII string with C-style escapes // ^ repeated names (keys) are allowed but generate a warning for undefined behavior }
Uses
Amazon's Quantum Ledger Database (QLDB) stores data in Ion documents. PartiQL, an open source SQL-based query language also by Amazon, is built upon Ion. PartiQL supported queries are used by QLDB, S3Select.
References
External links
Ion specification Amazon supported language implementations Java API documentation C# implementation
Text derived from https://en.wikipedia.org/w/index.php?oldid=1370487166 under CC BY-SA 4.0; modifications have been made.