pgx

Author: Leonid Moguchev

README.md

@@ -1,3 +1,12 @@
 # postgres
 
-Краткий tutorial для работы с postgres в Go.
+Краткий пример работы с PostgreSQL в Go.
+
+- *./database-sql* - пример работы со стандартной библиотекой __database/sql__
+- *./sqlx* - пример работы с расширением стандартной библиотеки __sqlx__
+- *./pgx* - пример работы с __pgx__
+
+Запуск БД:
+* `make up-dp`
+
+

database-sql/main.go

@@ -12,14 +12,14 @@ import (
 
 	// database/sql — это набор интерфейсов для работы с базой
 	// Чтобы эти интерфейсы работали, для них нужна реализация. Именно за реализацию и отвечают драйверы.
+
 	_ "github.com/lib/pq" // импортируем драйвер для postgres
 	// Обратите внимание, что мы загружаем драйвер анонимно, присвоив его квалификатору пакета псевдоним, _ ,
 	// чтобы ни одно из его экспортированных имен не было видно нашему коду.
 	// Под капотом драйвер регистрирует себя как доступный для пакета database/sql
 )
 
 const (
-
 	// название регистрируемоего драйвера github.com/lib/pq
 	stdPostgresDriverName = "postgres"
 	/*
@@ -48,7 +48,6 @@ const (
 )
 
 func main() {
-
 	// connection string
 	psqlConn := fmt.Sprintf("host=%s port=%d user=%s password=%s dbname=%s sslmode=disable", host, port, user, password, dbname)
 
@@ -100,6 +99,7 @@ func main() {
 	/* примеры работы c БД c контекстом */
 	// Совет: используйте запросы с контекстом
 	ctx := context.Background()
+
 	exampleQueryRowContext(ctx, db)
 	exampleQueryContext(ctx, db)
 	exampleExecContext(ctx, db)
@@ -127,8 +127,12 @@ func exampleQueryRow(db *sql.DB) {
 
 	// Ex. 2
 	var studentID int64
-	row = db.QueryRow("SELECT id FROM students WHERE age > 10000") // такого "долгожителя" в нашей таблице может не быть
-	if err := row.Scan(&studentID); err != nil {                   // мы тут получим ошубку, так как нам ничего не вернулось из БД
+	row = db.QueryRow("SELECT id FROM students WHERE age = 10000") // такого "долгожителя" в нашей таблице может не быть
+	if errors.Is(row.Err(), sql.ErrNoRows) {
+		fmt.Println("Не найден в БД студент с age > 10000")
+	}
+
+	if err := row.Scan(&studentID); err != nil { // мы тут получим ошубку, так как нам ничего не вернулось из БД
 		fmt.Println("db.QueryRow.Scan():", err) // нам вернется ошибка sql.ErrNoRows
 		if errors.Is(err, sql.ErrNoRows) {      // при использовании QueryRow не забывайте обрабатывать ошибку на sql.ErrNoRows, так как отстуствие результата может быть стандартным кейсом
 			fmt.Println("Не найден в БД студент с age > 10000")
@@ -262,8 +266,8 @@ func exampleExecContext(ctx context.Context, db *sql.DB) {
 func exampleTransaction(ctx context.Context, db *sql.DB) {
 	// создаем транзакцию
 	tx, err := db.BeginTx(ctx, &sql.TxOptions{
-		Isolation: sql.LevelRepeatableRead, // указываем в опциях уровень изоляции
-		ReadOnly:  false,                   // можем указать, что транзакции только для чтения
+		Isolation: sql.LevelSerializable, // указываем в опциях уровень изоляции
+		ReadOnly:  false,                 // можем указать, что транзакции только для чтения
 	})
 	if err != nil {
 		log.Fatal(err)
@@ -275,7 +279,7 @@ func exampleTransaction(ctx context.Context, db *sql.DB) {
 	if err != nil {
 		log.Fatal(err)
 	}
-	rows.Close()
+	defer rows.Close()
 
 	_, err = tx.ExecContext(ctx, "SELECT 1")
 	if err != nil {
@@ -353,23 +357,38 @@ func exampleWithNullableFields(ctx context.Context, db *sql.DB) {
 }
 
 type MyCustomType struct {
-	Valid  bool
 	Number int
+	Valid  bool
 }
 
 // Scan implements the Scanner interface.
-func (n *MyCustomType) Scan(value interface{}) error {
-	if value == nil {
+func (n *MyCustomType) Scan(src interface{}) error {
+	// The src value will be of one of the following types:
+	//
+	//    int64
+	//    float64
+	//    bool
+	//    []byte
+	//    string
+	//    time.Time
+	//    nil - for NULL values
+	if src == nil {
 		n.Number, n.Valid = 0, false
 		return nil
 	}
 	n.Valid = true
 
 	// some fantastic logic here
-	fmt.Printf("%#v\n", value)
+	switch src := src.(type) {
+	case int64:
+		n.Number = int(src)
+	case bool:
+		n.Number = 1
+	default:
+		return fmt.Errorf("can't scan %#v into MyCustomType", src)
+	}
 
 	return nil
-
 }
 
 var _ sql.Scanner = (*MyCustomType)(nil) // наш тип MyCustomType удовлетовряет интерфейсу sql.Scanner

go.mod

@@ -3,6 +3,23 @@ module github.com/moguchev/postgres
 go 1.17
 
 require (
+	github.com/georgysavva/scany v0.3.0 // indirect
+	github.com/jackc/chunkreader/v2 v2.0.1 // indirect
+	github.com/jackc/pgconn v1.12.1 // indirect
+	github.com/jackc/pgio v1.0.0 // indirect
+	github.com/jackc/pgpassfile v1.0.0 // indirect
+	github.com/jackc/pgproto3/v2 v2.3.0 // indirect
+	github.com/jackc/pgservicefile v0.0.0-20200714003250-2b9c44734f2b // indirect
+	github.com/jackc/pgtype v1.11.0 // indirect
+	github.com/jackc/pgx v3.6.2+incompatible // indirect
+	github.com/jackc/pgx/v4 v4.16.1 // indirect
+	github.com/jackc/puddle v1.2.1 // indirect
 	github.com/jmoiron/sqlx v1.3.4 // indirect
 	github.com/lib/pq v1.10.5 // indirect
+	github.com/pkg/errors v0.9.1 // indirect
+	go.uber.org/atomic v1.7.0 // indirect
+	go.uber.org/multierr v1.6.0 // indirect
+	go.uber.org/zap v1.21.0 // indirect
+	golang.org/x/crypto v0.0.0-20210711020723-a769d52b0f97 // indirect
+	golang.org/x/text v0.3.7 // indirect
 )