|
LIGHTWEIGHT_API | SqlConnection () |
| Constructs a new SQL connection to the default connection.
|
|
LIGHTWEIGHT_API | SqlConnection (std::optional< SqlConnectionString > connectInfo) |
| Constructs a new SQL connection to the given connect informaton.
|
|
LIGHTWEIGHT_API | SqlConnection (SqlConnection &&) noexcept |
|
LIGHTWEIGHT_API SqlConnection & | operator= (SqlConnection &&) noexcept |
|
| SqlConnection (SqlConnection const &)=delete |
|
SqlConnection & | operator= (SqlConnection const &)=delete |
|
LIGHTWEIGHT_API | ~SqlConnection () noexcept |
| Destructs this SQL connection object,.
|
|
uint64_t | ConnectionId () const noexcept |
| Retrieves the connection ID.
|
|
LIGHTWEIGHT_API void | Close () noexcept |
| Closes the connection (attempting to put it back into the connect[[ion pool).
|
|
LIGHTWEIGHT_API bool | Connect (SqlConnectionDataSource const &info) noexcept |
|
LIGHTWEIGHT_API bool | Connect (SqlConnectionString sqlConnectionString) noexcept |
|
LIGHTWEIGHT_API SqlErrorInfo | LastError () const |
| Retrieves the last error information with respect to this SQL connection handle.
|
|
LIGHTWEIGHT_API std::string | DatabaseName () const |
| Retrieves the name of the database in use.
|
|
LIGHTWEIGHT_API std::string | UserName () const |
| Retrieves the name of the user.
|
|
LIGHTWEIGHT_API std::string | ServerName () const |
| Retrieves the name of the server.
|
|
LIGHTWEIGHT_API std::string | ServerVersion () const |
| Retrieves the reported server version.
|
|
SqlServerType | ServerType () const noexcept |
| Retrieves the type of the server.
|
|
std::string const & | DriverName () const noexcept |
| Retrieves the name of the driver used for this connection.
|
|
SqlQueryFormatter const & | QueryFormatter () const noexcept |
| Retrieves a query formatter suitable for the SQL server being connected.
|
|
LIGHTWEIGHT_API SqlQueryBuilder | Query (std::string_view const &table={}) const |
|
LIGHTWEIGHT_API SqlQueryBuilder | QueryAs (std::string_view const &table, std::string_view const &tableAlias) const |
|
LIGHTWEIGHT_API SqlMigrationQueryBuilder | Migration () const |
| Creates a new migration query builder, compatible the current connection.
|
|
LIGHTWEIGHT_API bool | TransactionActive () const noexcept |
| Tests if a transaction is active.
|
|
LIGHTWEIGHT_API bool | TransactionsAllowed () const noexcept |
| Tests if transactions are allowed.
|
|
LIGHTWEIGHT_API bool | IsAlive () const noexcept |
| Tests if the connection is still active.
|
|
LIGHTWEIGHT_API SqlConnectionString const & | ConnectionString () const noexcept |
| Retrieves the connection information.
|
|
SQLHDBC | NativeHandle () const noexcept |
| Retrieves the native handle.
|
|
LIGHTWEIGHT_API std::chrono::steady_clock::time_point | LastUsed () const noexcept |
| Retrieves the last time the connection was used.
|
|
LIGHTWEIGHT_API void | SetLastUsed (std::chrono::steady_clock::time_point lastUsed) noexcept |
| Sets the last time the connection was used.
|
|
LIGHTWEIGHT_API void | RequireSuccess (SQLRETURN sqlResult, std::source_location sourceLocation=std::source_location::current()) const |
| Checks the result of an SQL operation, and throws an exception if it is not successful.
|
|
|
static LIGHTWEIGHT_API SqlConnectionString const & | DefaultConnectionString () noexcept |
| Retrieves the default connection information.
|
|
static LIGHTWEIGHT_API void | SetDefaultConnectionString (SqlConnectionString const &connectionString) noexcept |
|
static LIGHTWEIGHT_API void | SetDefaultDataSource (SqlConnectionDataSource const &dataSource) noexcept |
| Sets the default connection information as SqlConnectionDataSource.
|
|
static LIGHTWEIGHT_API void | SetPostConnectedHook (std::function< void(SqlConnection &)> hook) |
| Sets a callback to be called after each connection being established.
|
|
static LIGHTWEIGHT_API void | ResetPostConnectedHook () |
| Resets the post connected hook.
|
|
Represents a connection to a SQL database.
Definition at line 36 of file SqlConnection.hpp.