Method FormatURI

pkg/sql/sem/tree/format.go:579–612

FormatURI formats a string literal or placeholder containing a URI. If the node is a string literal, we redact the contents to avoid leaking secrets.

(uri Expr)

// FormatURI formats a string literal or placeholder containing a URI. If the
// node is a string literal, we redact the contents to avoid leaking secrets.
func (ctx *FmtCtx) FormatURI(uri Expr) {
	switch n := uri.(type) {
	case *StrVal, *DString:
		if ctx.HasAnyFlags(
			FmtShowPasswords | FmtShowFullURIs | FmtHideConstants | FmtConstantsAsUnderscores,
		) {
			ctx.FormatNode(n)
			return
		}
		var raw, elided string
		if str, ok := n.(*StrVal); ok {
			raw = str.RawString()
		} else {
			raw = string(MustBeDString(uri))
		}
		if raw == "" || raw == "_" {
			// Some commands treat empty URIs as special. And if we've re-parsed a URI
			// formatted with FmtHideConstants, we should not try to interpret it as a
			// URL but should leave it as-is.
			ctx.FormatNode(n)
			return
		}
		// TODO(michae2): Call SanitizeExternalStorageURI for fine-grained
		// sanitization.
		elided = strings.Trim(PasswordSubstitution, "'")
		ctx.FormatNode(NewStrVal(elided))
	case *Placeholder:
		ctx.FormatNode(n)
	default:
		// We don't want to fail to sanitize other literals, so disallow other types
		// of expressions (which should already be disallowed by the parser anyway).
		panic(errors.AssertionFailedf("expected *StrVal, *DString, or *Placeholder, found %T", n))
	}
}

// FormatNode recurses into a node for pretty-printing.
// Flag-driven special cases can hook into this.