Enum EmbedRendering 

pub enum EmbedRendering {
    Verbatim,
    Normalised,
}

How an embedded row or array is rendered.

jsonb reorders keys. It sorts them by length and then bytewise, inside PostgreSQL – SELECT row_to_json(t)::jsonb FROM (SELECT 1 AS aaa, 2 AS zz) t gives {"zz": 2, "aaa": 1} – so the order the columns were selected in is gone before the row reaches this process, and nothing on the Rust side can put it back. It also regularises the spacing that json keeps verbatim.

Both behaviours are wanted, in different places, which is why this is a choice made per query rather than a constant.

Variants

Verbatim

json. The row is written exactly as row_to_json produced it, so the columns stay in the order they were selected. This is what an embedded resource in a JSON body wants, and what PostgREST itself emits there.

Normalised

jsonb. PostgreSQL normalises the text.

Only needed where the embedded value is rendered as text rather than as part of a JSON body: a schema-declared media handler that stringifies a whole row renders each column’s text, and a json column renders verbatim where PostgREST’s jsonb one renders normalised – {"id":1} against {"id": 1}. Measured: it is the only difference between the two in PostgREST’s whole corpus.

Trait Implementations

impl Clone for EmbedRendering

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for EmbedRendering

impl Debug for EmbedRendering

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for EmbedRendering

impl PartialEq for EmbedRendering

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for EmbedRendering