Enum QueryTextMode 

pub enum QueryTextMode {
    Full,
    Obfuscated,
    Off,
}

Controls whether and how db.query.text is captured on spans.

Configured via PoolBuilder::with_query_text_mode.

Whitespace normalisation

For both Full and Obfuscated the emitted text has inter-token whitespace runs collapsed to a single ASCII space and leading/trailing whitespace trimmed. Whitespace inside string literals, quoted identifiers, dollar-quoted bodies, and comments is preserved verbatim. Multi-line SQL written across several Rust source lines therefore renders as a single readable line in OTel exports without the embedded \n and indentation runs that come from source-level formatting. Off is unaffected (no attribute is emitted).

When to choose what

• Full (default) – appropriate when all SQL flows through SQLx bind parameters. The captured text contains placeholders ($1, ?), not literal values, so user data does not leak into the span.
• Obfuscated – appropriate when SQL is built via string interpolation (format!, query concatenation, dynamic identifiers) and may contain literal values. Structure is preserved; literals (string, numeric, hex, boolean, and PostgreSQL dollar-quoted) are replaced with ?. Comments, identifiers (quoted or otherwise), operators, and NULL are kept verbatim.
• Off – appropriate when the query text is itself sensitive (proprietary schemas, query shapes that reveal business logic) or when query-text cardinality must be eliminated entirely.

db.query.parameter.<key> capture is not supported – SQLx’s Execute trait does not expose bind values, and reverse-engineering them from the encoded buffer would tie the wrapper to driver internals. Callers who need per-parameter attributes can add them manually via the active span using the OpenTelemetry API.

Variants

Full

Capture the parameterised query text. This is the default because SQLx queries use bind parameters ($1, ?), so literal values are not present in the query string. Inter-token whitespace is collapsed to a single space and leading/trailing whitespace is trimmed; whitespace inside literals, identifiers, and comments is preserved verbatim.

Obfuscated

Replace literal values in the query text with ?. Useful when queries are built via string interpolation rather than bind parameters. The same whitespace normalisation as Full is applied after redaction.

Off

Do not capture db.query.text at all.

Trait Implementations

impl Clone for QueryTextMode

fn clone(&self) -> QueryTextMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QueryTextMode

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

Formats the value using the given formatter.

impl Default for QueryTextMode

fn default() -> QueryTextMode

Returns the “default value” for a type.

impl PartialEq for QueryTextMode

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for QueryTextMode

impl Eq for QueryTextMode

impl StructuralPartialEq for QueryTextMode