{"id":4523,"date":"2024-09-21T18:58:46","date_gmt":"2024-09-21T11:58:46","guid":{"rendered":"https:\/\/www.sqlservertutorial.net\/?page_id=4523"},"modified":"2024-09-21T19:16:53","modified_gmt":"2024-09-21T12:16:53","slug":"go-connect-sql-server","status":"publish","type":"page","link":"https:\/\/www.sqlservertutorial.net\/go-sql-server\/go-connect-sql-server\/","title":{"rendered":"Go: Connecting to SQL Server"},"content":{"rendered":"\n<p><strong>Summary<\/strong>: in this tutorial, you&#8217;ll learn how to connect to an SQL Server database from a Go using the <a href=\"http:\/\/github.com\/microsoft\/go-mssqldb\" target=\"_blank\" rel=\"noreferrer noopener\">Microsoft SQL Server driver<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id='creating-a-new-go-project'>Creating a new Go project <a href=\"#creating-a-new-go-project\" class=\"anchor\" id=\"creating-a-new-go-project\" title=\"Anchor for Creating a new Go project\">#<\/a><\/h2>\n\n\n\n<p>Step 1. Open your terminal and create a project directory called <code>sqlservergo<\/code>:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-1\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\">mkdir sqlservergo<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-1\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>Step 2. Navigate to the project directory:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-2\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\">cd sqlsevergo<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-2\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>Step 3. Executing the <code>go mod init<\/code> command to create a <code>go.mod<\/code> file to track the dependencies:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-3\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\"><span class=\"hljs-keyword\">go<\/span> mod init sqlservergo<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-3\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>This command will create a <code>go.mod<\/code> file in the project directory, which stores the Go version and the project dependencies.<\/p>\n\n\n\n<p>Step 4. Install the <code>godotenv<\/code> and <code>go-mssqldb<\/code> packages by executing the following commands on your terminal:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-4\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\"><span class=\"hljs-keyword\">go<\/span> get github.com\/joho\/godotenv\n<span class=\"hljs-keyword\">go<\/span> get github.com\/microsoft\/<span class=\"hljs-keyword\">go<\/span>-mssqldb@latest<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-4\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<ul class=\"wp-block-list\">\n<li>The <code>godotenv<\/code> allows you to read SQL Server configuration parameters from the <code>.env<\/code> file, which makes your program more configurable and secure.<\/li>\n\n\n\n<li>The <code>go-mssqldb<\/code> is a Microsoft SQL Server Driver written in Go.<\/li>\n<\/ul>\n\n\n\n<p>Step 5. <a href=\"https:\/\/www.sqlservertutorial.net\/creating-a-bookstore-database-in-sql-server\/\">Create a <code>BookStore<\/code> database<\/a> and a user account that has sufficient privileges.<\/p>\n\n\n\n<p>Step 6. Create a new <code>.env<\/code> file within the project directory with the following SQL Server configuration:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-5\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\">DB_SERVER=localhost\nDB_PORT=<span class=\"hljs-number\">1433<\/span>\nDB_USER=joe\nDB_PASSWORD=YourPassword\nDB_NAME=BookStore<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-5\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>Please replace the <code>YourPassword<\/code> with your password.<\/p>\n\n\n\n<p>Step 7. Create <code>db.go<\/code> and <code>main.go<\/code> files within the project directory<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id='connecting-to-sql-server-database'>Connecting to SQL Server database <a href=\"#connecting-to-sql-server-database\" class=\"anchor\" id=\"connecting-to-sql-server-database\" title=\"Anchor for Connecting to SQL Server database\">#<\/a><\/h2>\n\n\n\n<p>The <code>db.go<\/code> file will store the code that interacts with the SQL Server database:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-6\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\"><span class=\"hljs-keyword\">package<\/span> main\n\n<span class=\"hljs-keyword\">import<\/span> (\n    <span class=\"hljs-string\">\"database\/sql\"<\/span>\n    <span class=\"hljs-string\">\"fmt\"<\/span>\n    <span class=\"hljs-string\">\"os\"<\/span>\n\n    <span class=\"hljs-string\">\"github.com\/joho\/godotenv\"<\/span>\n    _ <span class=\"hljs-string\">\"github.com\/microsoft\/go-mssqldb\"<\/span>\n)\n\n<span class=\"hljs-keyword\">type<\/span> DBConfig <span class=\"hljs-keyword\">struct<\/span> {\n    Server   <span class=\"hljs-keyword\">string<\/span>\n    Port     <span class=\"hljs-keyword\">string<\/span>\n    User     <span class=\"hljs-keyword\">string<\/span>\n    Password <span class=\"hljs-keyword\">string<\/span>\n    Database <span class=\"hljs-keyword\">string<\/span>\n}\n\n<span class=\"hljs-function\"><span class=\"hljs-keyword\">func<\/span> <span class=\"hljs-title\">LoadConfig<\/span><span class=\"hljs-params\">()<\/span> <span class=\"hljs-params\">(*DBConfig, error)<\/span><\/span> {\n    err := godotenv.Load()\n    <span class=\"hljs-keyword\">if<\/span> err != <span class=\"hljs-literal\">nil<\/span> {\n        <span class=\"hljs-keyword\">return<\/span> <span class=\"hljs-literal\">nil<\/span>, fmt.Errorf(<span class=\"hljs-string\">\"error loading .env file: %w\"<\/span>, err)\n    }\n\n    config := &amp;DBConfig{\n        Server:   os.Getenv(<span class=\"hljs-string\">\"DB_SERVER\"<\/span>),\n        Port:     os.Getenv(<span class=\"hljs-string\">\"DB_PORT\"<\/span>),\n        User:     os.Getenv(<span class=\"hljs-string\">\"DB_USER\"<\/span>),\n        Password: os.Getenv(<span class=\"hljs-string\">\"DB_PASSWORD\"<\/span>),\n        Database: os.Getenv(<span class=\"hljs-string\">\"DB_NAME\"<\/span>),\n    }\n\n    <span class=\"hljs-comment\">\/\/ Validate that all necessary environment variables are set<\/span>\n    <span class=\"hljs-keyword\">if<\/span> config.Server == <span class=\"hljs-string\">\"\"<\/span> || config.Port == <span class=\"hljs-string\">\"\"<\/span> || config.User == <span class=\"hljs-string\">\"\"<\/span> || config.Password == <span class=\"hljs-string\">\"\"<\/span> || config.Database == <span class=\"hljs-string\">\"\"<\/span> {\n        <span class=\"hljs-keyword\">return<\/span> <span class=\"hljs-literal\">nil<\/span>, fmt.Errorf(<span class=\"hljs-string\">\"missing one or more required environment variables\"<\/span>)\n    }\n\n    <span class=\"hljs-keyword\">return<\/span> config, <span class=\"hljs-literal\">nil<\/span>\n}\n\n<span class=\"hljs-function\"><span class=\"hljs-keyword\">func<\/span> <span class=\"hljs-title\">Connect<\/span><span class=\"hljs-params\">(config *DBConfig)<\/span> <span class=\"hljs-params\">(*sql.DB, error)<\/span><\/span> {\n    connString := fmt.Sprintf(<span class=\"hljs-string\">\"server=%s;port=%s;user id=%s;password=%s;database=%s\"<\/span>, config.Server, config.Port, config.User, config.Password, config.Database)\n    db, err := sql.Open(<span class=\"hljs-string\">\"sqlserver\"<\/span>, connString)\n    <span class=\"hljs-keyword\">if<\/span> err != <span class=\"hljs-literal\">nil<\/span> {\n        <span class=\"hljs-keyword\">return<\/span> <span class=\"hljs-literal\">nil<\/span>, fmt.Errorf(<span class=\"hljs-string\">\"error creating a SQL Server database connection: %w\"<\/span>, err)\n    }\n\n    <span class=\"hljs-comment\">\/\/ Verify the connection<\/span>\n    err = db.Ping()\n    <span class=\"hljs-keyword\">if<\/span> err != <span class=\"hljs-literal\">nil<\/span> {\n        <span class=\"hljs-keyword\">return<\/span> <span class=\"hljs-literal\">nil<\/span>, fmt.Errorf(<span class=\"hljs-string\">\"error verifying connection to the SQL Server: %w\"<\/span>, err)\n    }\n\n    <span class=\"hljs-keyword\">return<\/span> db, <span class=\"hljs-literal\">nil<\/span>\n}<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-6\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>How it works.<\/p>\n\n\n\n<p>Step 1. Declare the <code>main<\/code> package:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-7\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\"><span class=\"hljs-keyword\">package<\/span> main<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-7\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>Step 2. Import necessary packages:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-8\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\"><span class=\"hljs-keyword\">import<\/span> (\n    <span class=\"hljs-string\">\"database\/sql\"<\/span>\n    <span class=\"hljs-string\">\"fmt\"<\/span>\n    <span class=\"hljs-string\">\"os\"<\/span>\n\n    <span class=\"hljs-string\">\"github.com\/joho\/godotenv\"<\/span>\n    _ <span class=\"hljs-string\">\"github.com\/microsoft\/go-mssqldb\"<\/span>\n)<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-8\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>Step 3. Define a struct that stores the database configuration:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-9\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\"><span class=\"hljs-keyword\">type<\/span> DBConfig <span class=\"hljs-keyword\">struct<\/span> {\n    Server   <span class=\"hljs-keyword\">string<\/span>\n    Port     <span class=\"hljs-keyword\">string<\/span>\n    User     <span class=\"hljs-keyword\">string<\/span>\n    Password <span class=\"hljs-keyword\">string<\/span>\n    Database <span class=\"hljs-keyword\">string<\/span>\n}<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-9\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>Step 4. Define a <code>LoadConfig()<\/code> function that loads database configuration from the <code>.env<\/code> file:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-10\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\"><span class=\"hljs-function\"><span class=\"hljs-keyword\">func<\/span> <span class=\"hljs-title\">LoadConfig<\/span><span class=\"hljs-params\">()<\/span> <span class=\"hljs-params\">(*DBConfig, error)<\/span><\/span> {\n    err := godotenv.Load()\n    <span class=\"hljs-keyword\">if<\/span> err != <span class=\"hljs-literal\">nil<\/span> {\n        <span class=\"hljs-keyword\">return<\/span> <span class=\"hljs-literal\">nil<\/span>, fmt.Errorf(<span class=\"hljs-string\">\"error loading .env file: %w\"<\/span>, err)\n    }\n\n    config := &amp;DBConfig{\n        Server:   os.Getenv(<span class=\"hljs-string\">\"DB_SERVER\"<\/span>),\n        Port:     os.Getenv(<span class=\"hljs-string\">\"DB_PORT\"<\/span>),\n        User:     os.Getenv(<span class=\"hljs-string\">\"DB_USER\"<\/span>),\n        Password: os.Getenv(<span class=\"hljs-string\">\"DB_PASSWORD\"<\/span>),\n        Database: os.Getenv(<span class=\"hljs-string\">\"DB_NAME\"<\/span>),\n    }\n\n    <span class=\"hljs-comment\">\/\/ Validate that all necessary environment variables are set<\/span>\n    <span class=\"hljs-keyword\">if<\/span> config.Server == <span class=\"hljs-string\">\"\"<\/span> || config.Port == <span class=\"hljs-string\">\"\"<\/span> || config.User == <span class=\"hljs-string\">\"\"<\/span> || config.Password == <span class=\"hljs-string\">\"\"<\/span> || config.Database == <span class=\"hljs-string\">\"\"<\/span> {\n        <span class=\"hljs-keyword\">return<\/span> <span class=\"hljs-literal\">nil<\/span>, fmt.Errorf(<span class=\"hljs-string\">\"missing one or more required environment variables\"<\/span>)\n    }\n\n    <span class=\"hljs-keyword\">return<\/span> config, <span class=\"hljs-literal\">nil<\/span>\n}<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-10\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>Step 5. Define the <code>Connect()<\/code> that connects to the SQL Server database:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-11\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\"><span class=\"hljs-function\"><span class=\"hljs-keyword\">func<\/span> <span class=\"hljs-title\">Connect<\/span><span class=\"hljs-params\">(config *DBConfig)<\/span> <span class=\"hljs-params\">(*sql.DB, error)<\/span><\/span> {\n    connString := fmt.Sprintf(<span class=\"hljs-string\">\"server=%s;port=%s;user id=%s;password=%s;database=%s\"<\/span>, config.Server, config.Port, config.User, config.Password, config.Database)\n    db, err := sql.Open(<span class=\"hljs-string\">\"sqlserver\"<\/span>, connString)\n    <span class=\"hljs-keyword\">if<\/span> err != <span class=\"hljs-literal\">nil<\/span> {\n        <span class=\"hljs-keyword\">return<\/span> <span class=\"hljs-literal\">nil<\/span>, fmt.Errorf(<span class=\"hljs-string\">\"error creating a SQL Server database connection: %w\"<\/span>, err)\n    }\n\n    <span class=\"hljs-comment\">\/\/ Verify the connection<\/span>\n    err = db.Ping()\n    <span class=\"hljs-keyword\">if<\/span> err != <span class=\"hljs-literal\">nil<\/span> {\n        <span class=\"hljs-keyword\">return<\/span> <span class=\"hljs-literal\">nil<\/span>, fmt.Errorf(<span class=\"hljs-string\">\"error verifying connection to the SQL Server: %w\"<\/span>, err)\n    }\n\n    <span class=\"hljs-keyword\">return<\/span> db, <span class=\"hljs-literal\">nil<\/span>\n}<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-11\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>The <code>main.go<\/code> function includes the <code>main<\/code> function that uses the functions from the <code>db.go<\/code> file to connect to the SQL Server database:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-12\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\"><span class=\"hljs-keyword\">package<\/span> main\n\n<span class=\"hljs-keyword\">import<\/span> <span class=\"hljs-string\">\"fmt\"<\/span>\n\n<span class=\"hljs-function\"><span class=\"hljs-keyword\">func<\/span> <span class=\"hljs-title\">main<\/span><span class=\"hljs-params\">()<\/span><\/span> {\n    <span class=\"hljs-comment\">\/\/ Load the database configuration<\/span>\n    config, err := LoadConfig()\n    <span class=\"hljs-keyword\">if<\/span> err != <span class=\"hljs-literal\">nil<\/span> {\n        fmt.Println(err)\n        <span class=\"hljs-keyword\">return<\/span>\n    }\n\n    <span class=\"hljs-comment\">\/\/ Connect to the database<\/span>\n    db, err := Connect(config)\n    <span class=\"hljs-keyword\">if<\/span> err != <span class=\"hljs-literal\">nil<\/span> {\n        fmt.Println(err)\n        <span class=\"hljs-keyword\">return<\/span>\n    }\n    <span class=\"hljs-keyword\">defer<\/span> db.Close()\n\n    fmt.Println(<span class=\"hljs-string\">\"Successfully connected to SQL Server database.\"<\/span>)\n}<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-12\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>How it works.<\/p>\n\n\n\n<p>Step 1. Load the database configuration by calling the <code>LoadConfig()<\/code> function:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-13\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\">config, err := LoadConfig()\n<span class=\"hljs-keyword\">if<\/span> err != <span class=\"hljs-literal\">nil<\/span> {\n    fmt.Println(err)\n    <span class=\"hljs-keyword\">return<\/span>\n}<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-13\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>Step 2. Connect to the SQL Server database by calling the <code>Connect()<\/code> function:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-14\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\">db, err := Connect(config)\n<span class=\"hljs-keyword\">if<\/span> err != <span class=\"hljs-literal\">nil<\/span> {\n    fmt.Println(err)\n    <span class=\"hljs-keyword\">return<\/span>\n}<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-14\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>Step 3. Close the database connection once the <code>main<\/code> function exits:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-15\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\"><span class=\"hljs-keyword\">defer<\/span> db.Close()<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-15\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>Step 4. Display a success message:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-16\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\">fmt.Println(<span class=\"hljs-string\">\"Successfully connected to SQL Server database.\"<\/span>)<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-16\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<h2 class=\"wp-block-heading\" id='running-the-program'>Running the program <a href=\"#running-the-program\" class=\"anchor\" id=\"running-the-program\" title=\"Anchor for Running the program\">#<\/a><\/h2>\n\n\n\n<p>Execute the following command from your terminal to run the go program:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-17\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\"><span class=\"hljs-keyword\">go<\/span> run main.<span class=\"hljs-keyword\">go<\/span> db.<span class=\"hljs-keyword\">go<\/span><\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-17\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>It&#8217;ll return the following output if the connection succeeds:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-18\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\">Successfully connected to SQL Server database.<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-18\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>If the password is not valid, you&#8217;ll get the following error:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-19\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\">error verifying connection to the SQL Server: mssql: login error: Login failed <span class=\"hljs-keyword\">for<\/span> user <span class=\"hljs-string\">'joe'<\/span>.<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-19\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>In this case, you need to check the <code>DB_USER<\/code> and <code>DB_PASSWORD<\/code> in the <code>.env<\/code> file.<\/p>\n\n\n\n<p>If the SQL Server is not running, you&#8217;ll get the following error:<\/p>\n\n\n<pre class=\"wp-block-code\" aria-describedby=\"shcb-language-20\" data-shcb-language-name=\"Go\" data-shcb-language-slug=\"go\"><span><code class=\"hljs language-go\">error verifying connection to the SQL Server: unable to open tcp connection with host <span class=\"hljs-string\">'localhost:1433'<\/span>: dial tcp &#91;::<span class=\"hljs-number\">1<\/span>]:<span class=\"hljs-number\">1433<\/span>: connectex: No connection could be made because the target machine actively refused it.<\/code><\/span><small class=\"shcb-language\" id=\"shcb-language-20\"><span class=\"shcb-language__label\">Code language:<\/span> <span class=\"shcb-language__name\">Go<\/span> <span class=\"shcb-language__paren\">(<\/span><span class=\"shcb-language__slug\">go<\/span><span class=\"shcb-language__paren\">)<\/span><\/small><\/pre>\n\n\n<p>Please ensure the SQL Server is running at <code>DB_SERVER<\/code> and listening on the port <code>DB_PORT<\/code>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id='summary'>Summary <a href=\"#summary\" class=\"anchor\" id=\"summary\" title=\"Anchor for Summary\">#<\/a><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Use the Microsoft SQL Server driver to connect a Go program to the SQL Server.<\/li>\n<\/ul>\n<div class=\"helpful-block-content\" data-title=\"\">\n\t<header>\n\t\t<div class=\"wth-question\">Was this tutorial helpful?<\/div>\n\t\t<div class=\"wth-thumbs\">\n\t\t\t<button\n\t\t\t\tdata-post=\"4523\"\n\t\t\t\tdata-post-url=\"https:\/\/www.sqlservertutorial.net\/go-sql-server\/go-connect-sql-server\/\"\n\t\t\t\tdata-post-title=\"Go: Connecting to SQL Server\"\n\t\t\t\tdata-response=\"1\"\n\t\t\t\tclass=\"wth-btn-rounded wth-yes-btn\"\n\t\t\t>\n\t\t\t\t<svg\n\t\t\t\t\txmlns=\"http:\/\/www.w3.org\/2000\/svg\"\n\t\t\t\t\tviewBox=\"0 0 24 24\"\n\t\t\t\t\tfill=\"none\"\n\t\t\t\t\tstroke=\"currentColor\"\n\t\t\t\t\tstroke-width=\"2\"\n\t\t\t\t\tstroke-linecap=\"round\"\n\t\t\t\t\tstroke-linejoin=\"round\"\n\t\t\t\t\tclass=\"feather feather-thumbs-up block w-full h-full\"\n\t\t\t\t>\n\t\t\t\t\t<path\n\t\t\t\t\t\td=\"M14 9V5a3 3 0 0 0-3-3l-4 9v11h11.28a2 2 0 0 0 2-1.7l1.38-9a2 2 0 0 0-2-2.3zM7 22H4a2 2 0 0 1-2-2v-7a2 2 0 0 1 2-2h3\"\n\t\t\t\t\t><\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t<span class=\"sr-only\"> Yes <\/span>\n\t\t\t<\/button>\n\n\t\t\t<button\n\t\t\t\tdata-response=\"0\"\n\t\t\t\tdata-post=\"4523\"\n\t\t\t\tdata-post-url=\"https:\/\/www.sqlservertutorial.net\/go-sql-server\/go-connect-sql-server\/\"\n\t\t\t\tdata-post-title=\"Go: Connecting to SQL Server\"\n\t\t\t\tclass=\"wth-btn-rounded wth-no-btn\"\n\t\t\t>\n\t\t\t\t<svg\n\t\t\t\t\txmlns=\"http:\/\/www.w3.org\/2000\/svg\"\n\t\t\t\t\tviewBox=\"0 0 24 24\"\n\t\t\t\t\tfill=\"none\"\n\t\t\t\t\tstroke=\"currentColor\"\n\t\t\t\t\tstroke-width=\"2\"\n\t\t\t\t\tstroke-linecap=\"round\"\n\t\t\t\t\tstroke-linejoin=\"round\"\n\t\t\t\t>\n\t\t\t\t\t<path\n\t\t\t\t\t\td=\"M10 15v4a3 3 0 0 0 3 3l4-9V2H5.72a2 2 0 0 0-2 1.7l-1.38 9a2 2 0 0 0 2 2.3zm7-13h2.67A2.31 2.31 0 0 1 22 4v7a2.31 2.31 0 0 1-2.33 2H17\"\n\t\t\t\t\t><\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t<span class=\"sr-only\"> No <\/span>\n\t\t\t<\/button>\n\t\t<\/div>\n\t<\/header>\n\n\t<div class=\"wth-form hidden\">\n\t\t<div class=\"wth-form-wrapper\">\n\t\t\t<div class=\"wth-title\"><\/div>\n\t\t\t\n\t\t\t<textarea class=\"wth-message\"><\/textarea>\n\n\t\t\t<button class=\"btn btn-primary wth-btn-submit\">Send<\/button>\n\t\t\t<button class=\"btn wth-btn-cancel\">Cancel<\/button>\n\t\t\n\t\t<\/div>\n\t<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>In this tutorial, you&#8217;ll learn how to connect to an SQL Server database from a Go using the Microsoft SQL Server driver.<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":4520,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-4523","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.5 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Go: Connecting to SQL Server<\/title>\n<meta name=\"description\" content=\"In this tutorial, you&#039;ll learn how to connect to an SQL Server database from a Go using the Microsoft SQL Server driver.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.sqlservertutorial.net\/go-connect-sql-server\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Go: Connecting to SQL Server\" \/>\n<meta property=\"og:description\" content=\"In this tutorial, you&#039;ll learn how to connect to an SQL Server database from a Go using the Microsoft SQL Server driver.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.sqlservertutorial.net\/go-connect-sql-server\/\" \/>\n<meta property=\"og:site_name\" content=\"SQL Server Tutorial\" \/>\n<meta property=\"article:modified_time\" content=\"2024-09-21T12:16:53+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.sqlservertutorial.net\\\/go-connect-sql-server\\\/\",\"url\":\"https:\\\/\\\/www.sqlservertutorial.net\\\/go-connect-sql-server\\\/\",\"name\":\"Go: Connecting to SQL Server\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.sqlservertutorial.net\\\/#website\"},\"datePublished\":\"2024-09-21T11:58:46+00:00\",\"dateModified\":\"2024-09-21T12:16:53+00:00\",\"description\":\"In this tutorial, you'll learn how to connect to an SQL Server database from a Go using the Microsoft SQL Server driver.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.sqlservertutorial.net\\\/go-connect-sql-server\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.sqlservertutorial.net\\\/go-connect-sql-server\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.sqlservertutorial.net\\\/go-connect-sql-server\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.sqlservertutorial.net\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Go: Connecting to SQL Server\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.sqlservertutorial.net\\\/#website\",\"url\":\"https:\\\/\\\/www.sqlservertutorial.net\\\/\",\"name\":\"SQL Server Tutorial\",\"description\":\"The Practical SQL Server Tutorial\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.sqlservertutorial.net\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Go: Connecting to SQL Server","description":"In this tutorial, you'll learn how to connect to an SQL Server database from a Go using the Microsoft SQL Server driver.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.sqlservertutorial.net\/go-connect-sql-server\/","og_locale":"en_US","og_type":"article","og_title":"Go: Connecting to SQL Server","og_description":"In this tutorial, you'll learn how to connect to an SQL Server database from a Go using the Microsoft SQL Server driver.","og_url":"https:\/\/www.sqlservertutorial.net\/go-connect-sql-server\/","og_site_name":"SQL Server Tutorial","article_modified_time":"2024-09-21T12:16:53+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.sqlservertutorial.net\/go-connect-sql-server\/","url":"https:\/\/www.sqlservertutorial.net\/go-connect-sql-server\/","name":"Go: Connecting to SQL Server","isPartOf":{"@id":"https:\/\/www.sqlservertutorial.net\/#website"},"datePublished":"2024-09-21T11:58:46+00:00","dateModified":"2024-09-21T12:16:53+00:00","description":"In this tutorial, you'll learn how to connect to an SQL Server database from a Go using the Microsoft SQL Server driver.","breadcrumb":{"@id":"https:\/\/www.sqlservertutorial.net\/go-connect-sql-server\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.sqlservertutorial.net\/go-connect-sql-server\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.sqlservertutorial.net\/go-connect-sql-server\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.sqlservertutorial.net\/"},{"@type":"ListItem","position":2,"name":"Go: Connecting to SQL Server"}]},{"@type":"WebSite","@id":"https:\/\/www.sqlservertutorial.net\/#website","url":"https:\/\/www.sqlservertutorial.net\/","name":"SQL Server Tutorial","description":"The Practical SQL Server Tutorial","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.sqlservertutorial.net\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/www.sqlservertutorial.net\/wp-json\/wp\/v2\/pages\/4523","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.sqlservertutorial.net\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.sqlservertutorial.net\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.sqlservertutorial.net\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.sqlservertutorial.net\/wp-json\/wp\/v2\/comments?post=4523"}],"version-history":[{"count":5,"href":"https:\/\/www.sqlservertutorial.net\/wp-json\/wp\/v2\/pages\/4523\/revisions"}],"predecessor-version":[{"id":4530,"href":"https:\/\/www.sqlservertutorial.net\/wp-json\/wp\/v2\/pages\/4523\/revisions\/4530"}],"up":[{"embeddable":true,"href":"https:\/\/www.sqlservertutorial.net\/wp-json\/wp\/v2\/pages\/4520"}],"wp:attachment":[{"href":"https:\/\/www.sqlservertutorial.net\/wp-json\/wp\/v2\/media?parent=4523"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}