Struct SqlServerVersion 

pub struct SqlServerVersion {
    pub major: u8,
    pub minor: u8,
    pub build: u16,
    pub sub_build: u16,
}

SQL Server product version.

Represents the SQL Server product version (e.g., 11.0.5058 for SQL Server 2012). This is distinct from the TDS protocol version - during PreLogin, the server sends its product version, not the TDS version it will use.

Wire Format

Per MS-TDS 2.2.6.4, the VERSION option in PreLogin response contains:

• UL_VERSION (4 bytes): Major.Minor.Build in format [major][minor][build_hi][build_lo]
• US_SUBBUILD (2 bytes): Sub-build number

SQL Server Version Mapping

Major	SQL Server Version
8	SQL Server 2000
9	SQL Server 2005
10	SQL Server 2008/2008 R2
11	SQL Server 2012
12	SQL Server 2014
13	SQL Server 2016
14	SQL Server 2017
15	SQL Server 2019
16	SQL Server 2022

Fields

major: u8

Major version (e.g., 11 for SQL Server 2012)

minor: u8

Minor version

build: u16

Build number

sub_build: u16

Sub-build number

Implementations

impl SqlServerVersion

pub const fn from_prelogin_bytes(version_bytes: [u8; 4], sub_build: u16) -> Self

Create a new SQL Server version from raw PreLogin bytes.

The PreLogin VERSION field contains 6 bytes:

• Bytes 0-3: UL_VERSION (major, minor, build_hi, build_lo) in big-endian
• Bytes 4-5: US_SUBBUILD in little-endian

pub const fn from_raw(raw: u32, sub_build: u16) -> Self

Create from a raw u32 value (as decoded from PreLogin).

pub const fn product_name(&self) -> &'static str

Get the SQL Server product name for this version.

pub const fn max_tds_version(&self) -> TdsVersion

Get the corresponding TDS version for this SQL Server version.

This returns the maximum TDS version supported by this SQL Server version.

Trait Implementations

impl Clone for SqlServerVersion

fn clone(&self) -> SqlServerVersion

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SqlServerVersion

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

Formats the value using the given formatter.

impl Default for SqlServerVersion

fn default() -> SqlServerVersion

Returns the “default value” for a type.

impl Display for SqlServerVersion

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

Formats the value using the given formatter.

impl PartialEq for SqlServerVersion

fn eq(&self, other: &SqlServerVersion) -> 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 SqlServerVersion

impl Eq for SqlServerVersion

impl StructuralPartialEq for SqlServerVersion