AskSQL API Reference (core v0.10.0)
    Preparing search index...

    Interface AskSqlBubbleProps

    interface AskSqlBubbleProps {
        answerSchemaQuestions?: boolean;
        connectionId?: string;
        icon?: string;
        initialQuestion?: string;
        maxRows?: number;
        nonce?: string;
        offset?: number | { x?: number; y?: number };
        onInitialQuestionConsumed?: () => void;
        placeholder?: string;
        position?: BubblePosition;
        requireApproval?: boolean;
        showConnectionPicker?: boolean;
        sqlDisplayPlacement?: "before" | "after";
        styleRoot?: Document | ShadowRoot;
        suggestions?: readonly string[];
        theme?: "light" | "dark" | "auto";
        title?: string;
        transport: Transport;
        zIndex?: number;
    }

    Hierarchy (View Summary)

    Index
    answerSchemaQuestions? connectionId? icon? initialQuestion? maxRows? nonce? offset? onInitialQuestionConsumed? placeholder? position? requireApproval? showConnectionPicker? sqlDisplayPlacement? styleRoot? suggestions? theme? title? transport zIndex?
    answerSchemaQuestions?: boolean

    Answer questions that aren't a data query in plain language from the schema. Off by default.

    connectionId?: string
    icon?: string
    initialQuestion?: string

    Asked automatically whenever this changes to a new non-empty value, such as a question seeded by a browser extension's "ask about selection". The same value twice in a row asks once; the transcript is preserved either way.

    maxRows?: number

    Row cap sent with every query, so it applies to a sidecar as well as an in-page engine.

    nonce?: string

    CSP nonce for the injected stylesheet (strict-CSP pages).

    offset?: number | { x?: number; y?: number }

    Distance (px) from the chosen corner's edges. Default 24.

    onInitialQuestionConsumed?: () => void

    Called when initialQuestion is actually asked, so the host can clear its state (enabling the same text to seed again later).

    placeholder?: string
    position?: BubblePosition

    Which corner the bubble sits in. Default 'bottom-right'.

    requireApproval?: boolean

    Gate every query behind a Run button. Off by default (results auto-run).

    showConnectionPicker?: boolean

    Show a connection picker when the sidecar exposes more than one.

    sqlDisplayPlacement?: "before" | "after"

    Where the SQL block renders relative to results (default 'before'). Forced to 'before' when requireApproval is on - a query can't be approved unseen.

    styleRoot?: Document | ShadowRoot

    Where to inject the stylesheet. Pass the shadow root when rendering into one; defaults to the document.

    suggestions?: readonly string[]
    theme?: "light" | "dark" | "auto"
    title?: string
    transport: Transport
    zIndex?: number

    Stacking order, to sit above/below the host's own fixed elements. Default very high.

    Settings
    Member Visibility

    On This Page
    Properties