1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
use crate::{tds::codec::FeatureLevel, SqlReadBytes};
use std::fmt;
#[derive(Clone, Debug, PartialEq, Eq, thiserror::Error)]
/// An error token returned from the server.
pub struct TokenError {
/// ErrorCode
pub(crate) code: u32,
/// ErrorState (describing code)
pub(crate) state: u8,
/// The class (severity) of the error
pub(crate) class: u8,
/// The error message
pub(crate) message: String,
pub(crate) server: String,
pub(crate) procedure: String,
pub(crate) line: u32,
}
impl TokenError {
pub(crate) async fn decode<R>(src: &mut R) -> crate::Result<Self>
where
R: SqlReadBytes + Unpin,
{
let _length = src.read_u16_le().await? as usize;
let code = src.read_u32_le().await?;
let state = src.read_u8().await?;
let class = src.read_u8().await?;
let message = src.read_us_varchar().await?;
let server = src.read_b_varchar().await?;
let procedure = src.read_b_varchar().await?;
let line = if src.context().version() > FeatureLevel::SqlServer2005 {
src.read_u32_le().await?
} else {
src.read_u16_le().await? as u32
};
let token = TokenError {
code,
state,
class,
message,
server,
procedure,
line,
};
Ok(token)
}
/// The error code, see descriptions from [the manual].
///
/// [the manual]: https://docs.microsoft.com/en-us/sql/relational-databases/errors-events/database-engine-events-and-errors?view=sql-server-ver15
pub fn code(&self) -> u32 {
self.code
}
/// The error state, used as a modifier to the error number.
pub fn state(&self) -> u8 {
self.state
}
/// The class (severity) of the error. A class of less than 10 indicates an
/// informational message.
pub fn class(&self) -> u8 {
self.class
}
/// The error message returned from the server.
pub fn message(&self) -> &str {
&self.message
}
/// The server name.
pub fn server(&self) -> &str {
&self.server
}
/// The name of the stored procedure causing the error.
pub fn procedure(&self) -> &str {
&self.procedure
}
/// The line number in the SQL batch or stored procedure that caused the
/// error. Line numbers begin at 1. If the line number is not applicable to
/// the message, the value is 0.
pub fn line(&self) -> u32 {
self.line
}
}
impl fmt::Display for TokenError {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
write!(
f,
"'{}' on server {} executing {} on line {} (code: {}, state: {}, class: {})",
self.message, self.server, self.procedure, self.line, self.code, self.state, self.class
)
}
}