Struct RpcRequest 

pub struct RpcRequest { /* private fields */ }

RPC request builder.

Implementations

impl RpcRequest

pub fn named(proc_name: impl Into<String>) -> Self

Create a new RPC request for a named procedure.

pub fn by_id(proc_id: ProcId) -> Self

Create a new RPC request for a well-known procedure.

pub fn execute_sql(sql: &str, params: Vec<RpcParam>) -> Self

Create an sp_executesql request.

This is the primary method for parameterized queries.

Example

use tds_protocol::rpc::{RpcRequest, RpcParam};

let rpc = RpcRequest::execute_sql(
    "SELECT * FROM users WHERE id = @p1 AND name = @p2",
    vec![
        RpcParam::int("@p1", 42),
        RpcParam::nvarchar("@p2", "Alice"),
    ],
);

pub fn prepare(sql: &str, params: &[RpcParam]) -> Self

Create an sp_prepare request.

pub fn execute(handle: i32, params: Vec<RpcParam>) -> Self

Create an sp_execute request.

pub fn unprepare(handle: i32) -> Self

Create an sp_unprepare request.

pub fn with_options(self, options: RpcOptionFlags) -> Self

Set option flags.

pub fn param(self, param: RpcParam) -> Self

Add a parameter.

pub fn encode(&self) -> Bytes

Encode the RPC request to bytes (auto-commit mode).

For requests within an explicit transaction, use Self::encode_with_transaction.

pub fn encode_with_transaction(&self, transaction_descriptor: u64) -> Bytes

Encode the RPC request with a transaction descriptor.

Per MS-TDS spec, when executing within an explicit transaction:

• The transaction_descriptor MUST be the value returned by the server in the BeginTransaction EnvChange token.
• For auto-commit mode (no explicit transaction), use 0.

Arguments

• transaction_descriptor - The transaction descriptor from BeginTransaction EnvChange, or 0 for auto-commit mode.

Trait Implementations

impl Clone for RpcRequest

fn clone(&self) -> RpcRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RpcRequest

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

Formats the value using the given formatter.