Struct QueryRequestContext 

pub struct QueryRequestContext {

    pub session_id: Option<i64>,
    pub user_name: Option<String>,
    pub space_name: Option<String>,
    pub query: String,
    pub parameters: HashMap<String, Value>,
    pub session_variables: HashMap<String, Value>,
    pub query_id: Option<u64>,
    pub transaction_id: Option<TransactionId>,
    pub auto_commit: bool,
    pub read_only: bool,
    pub isolation_level: Option<TransactionIsolationLevel>,
    pub operation_context: Option<StorageOperationContext>,
    pub operation_storage: Option<Arc<RwLock<dyn QueryStorage>>>,
    pub parsed_statement: Option<Arc<Ast>>,
    pub ryw_config: Option<ReadYourWritesConfig>,
}

Query request context – Simplified version

Contains:

• Session ID
• User name
• Graph Space Name
• Query string
• Query parameters
• Optional caller-assigned query ID (threaded to the runtime)

Fields

session_id: Option<i64>

Session ID

user_name: Option<String>

Username

space_name: Option<String>

Name of the graph space

query: String

Query string

parameters: HashMap<String, Value>

Query parameters

session_variables: HashMap<String, Value>

Session variable snapshot ($name references), captured once per statement at the API layer. Distinct from parameters (@name).

query_id: Option<u64>

Optional caller/server-assigned query ID.

When set, the execution runtime is registered and identified under this ID; when absent, the [QueryRegistry] allocates a unique id. [QueryRegistry]: crate::executor::streaming::query_registry::QueryRegistry

transaction_id: Option<TransactionId>

Transaction identity and storage binding for this execution.

auto_commit: bool

read_only: bool

isolation_level: Option<TransactionIsolationLevel>

Transaction isolation level injected by the API layer for queries running inside an explicit transaction. None = auto-commit statement-level snapshot semantics.

operation_context: Option<StorageOperationContext>

operation_storage: Option<Arc<RwLock<dyn QueryStorage>>>

parsed_statement: Option<Arc<Ast>>

Pre-parsed statement AST supplied by the API layer.

When present, prepare_request skips the internal parse of query and uses this AST directly (the classification pass already produced it). The AST carries its own expression analysis context, so all expression ids remain consistent with the generated plan.

ryw_config: Option<ReadYourWritesConfig>

Consistency requirement for secondary-index reads (vector/fulltext). None = eventual; Some(cfg) = read-your-writes with timeout and optional LSN.

Implementations

impl QueryRequestContext

pub fn new(query: String) -> Self

Create a new query request context.

pub fn with_parameters(self, parameters: HashMap<String, Value>) -> Self

Create a query request context with parameters

pub fn with_session_variables(self, variables: HashMap<String, Value>) -> Self

Set the session variable snapshot.

pub fn with_session_id(self, session_id: i64) -> Self

Setting the session ID

pub fn with_user_name(self, user_name: String) -> Self

Set the username

pub fn with_space_name(self, space_name: String) -> Self

Set the name of the graph space.

pub fn with_query_id(self, query_id: u64) -> Self

Set the caller/server-assigned query ID.

pub fn get_parameter(&self, param: &str) -> Option<Value>

Obtain parameters

pub fn has_parameter(&self, param: &str) -> bool

Check whether the parameters exist.

Trait Implementations

impl Clone for QueryRequestContext

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QueryRequestContext

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

Formats the value using the given formatter.

impl Default for QueryRequestContext

fn default() -> Self

Returns the “default value” for a type.