chore: ⬆️ updated deps

2026-05-20 22:52:20 +02:00
parent d9f27c1775
commit 43f4680176
374 changed files with 295527 additions and 301467 deletions
@@ -1,16 +1,62 @@
-// package mssql implements the TDS protocol used to connect to MS SQL Server (sqlserver)
-// database servers.
+// Package mssql is Microsoft's official Go driver for SQL Server and Azure SQL Database.
 //
-// This package registers the driver:
+// This package implements the TDS protocol used to connect to Microsoft SQL Server
+// (SQL Server 2005 and later) and Azure SQL Database.
 //
-//	sqlserver: uses native "@" parameter placeholder names and does no pre-processing.
+// # Driver Registration
 //
-// If the ordinal position is used for query parameters, identifiers will be named
-// "@p1", "@p2", ... "@pN".
+// This package registers the following drivers:
 //
-// Please refer to the README for the format of the DSN. There are multiple DSN
-// formats accepted: ADO style, ODBC style, and URL style. The following is an
-// example of a URL style DSN:
+//	sqlserver: preferred driver; uses native "@" parameter placeholder names and does no pre-processing.
+//	mssql: legacy compatibility driver (deprecated); performs query token replacement and may be removed in a future release.
 //
-//	sqlserver://sa:mypass@localhost:1234?database=master&connection+timeout=30
+// Use "sqlserver" as the driver name with database/sql.Open:
+//
+//	db, err := sql.Open("sqlserver", "sqlserver://user:password@localhost:1433?database=mydb")
+//
+// # Connection String Formats
+//
+// URL format (recommended):
+//
+//	sqlserver://user:password@localhost:1433?database=mydb
+//	sqlserver://user:password@localhost/instance?database=mydb
+//
+// ADO format:
+//
+//	server=localhost;user id=sa;password=secret;database=mydb
+//
+// ODBC format:
+//
+//	odbc:server=localhost;user id=sa;password=secret;database=mydb
+//
+// # Query Parameters
+//
+// Use "@ParameterName" or "@p1", "@p2", etc. for query parameters:
+//
+//	// Named parameters
+//	db.Query("SELECT * FROM users WHERE id = @ID", sql.Named("ID", 123))
+//
+//	// Positional parameters
+//	db.Query("SELECT * FROM users WHERE id = @p1", 123)
+//
+// # Azure AD Authentication
+//
+// For Azure Active Directory authentication, import the azuread subpackage:
+//
+//	import "github.com/microsoft/go-mssqldb/azuread"
+//
+//	db, err := sql.Open(azuread.DriverName,
+//	    "sqlserver://server.database.windows.net?database=mydb&fedauth=ActiveDirectoryDefault&encrypt=true&TrustServerCertificate=false")
+//
+// # Features
+//
+//   - SQL Server 2005+ and Azure SQL Database support
+//   - Windows Authentication, SQL Authentication, Azure AD, Kerberos
+//   - Always Encrypted column encryption
+//   - Bulk copy operations via [CopyIn]
+//   - Stored procedures with output parameters
+//   - Table-valued parameters
+//   - Named pipes and shared memory on Windows
+//
+// For complete documentation, see https://github.com/microsoft/go-mssqldb
 package mssql