Driver/Go: Add information about lib/pq

Author: amotl

docs/connect/go.md

@@ -90,4 +90,71 @@ Demonstrates basic examples and bulk insert operations using the pgx driver.
 [![Go pgx CI](https://github.com/crate/cratedb-examples/actions/workflows/lang-go-pgx.yml/badge.svg)](https://github.com/crate/cratedb-examples/actions/workflows/lang-go-pgx.yml)
 
 
+(go-pq)=
+## pq
+
+:::{rubric} About
+:::
+
+[pq] is a pure Go PostgreSQL driver for Go's database/sql package.
+
+:::{rubric} Synopsis
+:::
+
+`go.mod`
+```text
+module github.com/cratedb-guide/connect/go/pq
+require github.com/lib/pq v1.10.9
+```
+`example.go`
+```go
+package main
+
+import (
+    "database/sql"
+    "fmt"
+
+    _ "github.com/lib/pq"
+)
+
+func main() {
+
+    // Connect to database.
+    connStr := "postgresql://crate:crate@localhost/doc?sslmode=disable"
+    db, _ := sql.Open("postgres", connStr)
+
+    // Invoke basic query.
+    rows, _ := db.Query("SELECT mountain, height FROM sys.summits ORDER BY height DESC LIMIT 3")
+
+    // Display results.
+    for rows.Next() {
+        var mountain string
+        var height int
+        rows.Scan(&mountain, &height)
+        fmt.Println(mountain, height)
+    }
+}
+```
+
+Start CrateDB using Docker or Podman, then invoke the example program.
+```shell
+docker run --rm --publish=5432:5432 crate -Cdiscovery.type=single-node
+```
+```shell
+go mod tidy
+go run example.go
+```
+
+:::{rubric} CrateDB Cloud
+:::
+
+For connecting to CrateDB Cloud, use `sslmode=require`, and
+replace username, password, and hostname with values matching
+your environment.
+```go
+connStr := "postgresql://admin:[email protected]:5432/doc?sslmode=require"
+```
+
+
 [pgx]: https://github.com/jackc/pgx
+[pq]: https://github.com/lib/pq