【Golang】データベース接続・クエリ実行・トランザクション処理の解説【サンプルソース】

■ソースコード解説

	// INSERT
	insert_sql := "INSERT INTO test_table (user_id, user_name) VALUES ($1, $2), ($3, $4), ($5, $6)"
	_, err = db.Exec(insert_sql, "001", "sato", "002", "tanaka", "003", "takahashi")

insert_sql := "INSERT INTO test_table (user_id, user_name) VALUES ($1, $2), ($3, $4), ($5, $6)"

• insert_sql という変数に、SQLのINSERT文を文字列として代入しています。
• VALUES ($1, $2), ($3, $4), ($5, $6) は、挿入するデータの値をプレースホルダー（$1, $2 など）で指定しています。プレースホルダーは、後続の db.Exec 関数で実際の値を指定するために使用されます。

_, err = db.Exec(insert_sql, "001", "sato", "002", "tanaka", "003", "takahashi")

• db.Exec 関数は、SQLクエリを実行します。
• 第1引数 insert_sql には、実行するSQLクエリの文字列を指定します。
• 第2引数以降には、プレースホルダーに対応する実際の値を指定します。この例では、$1 に "001"、$2 に "sato"、$3 に "002"、$4 に "tanaka"、$5 に "003"、$6 に "takahashi" がそれぞれ対応します。
• db.Exec 関数の戻り値は2つあります。1つ目は sql.Result 型の値ですが、ここでは _（ブランク識別子）で受け取っています。これは、戻り値を使用しないことを意味します。2つ目は error 型の値で、クエリの実行中にエラーが発生した場合にエラー情報が格納されます。
• err 変数には、クエリ実行中に発生したエラーが格納されます。エラーが発生しなかった場合は nil が格納されます。

    // エラー確認
	if err != nil {
		log.Fatal(err)
	}

if err != nil { ... }

• err != nil は、err 変数が nil (ヌル) ではないかどうかを評価する条件式です。
• Go言語では、関数がエラーを返す場合、通常、最後の戻り値として error 型の値を返します。エラーが発生しなかった場合は nil が返され、エラーが発生した場合はエラー情報が格納された error 型の値が返されます。
• したがって、err != nil は、直前の処理でエラーが発生したかどうかをチェックしています。

log.Fatal(err)

• log.Fatal 関数は、引数として渡されたエラーメッセージを標準エラー出力に出力し、プログラムを終了させます。
• err 変数には、直前の処理で発生したエラー情報が格納されています。

■ソースコード解説

	// トランザクション開始
	tx, err := db.Begin()
	if err != nil {
		log.Fatal(err)
	}

このコードは、Go言語でデータベースのトランザクションを開始するための処理です。以下に各部分の解説をします。

tx, err := db.Begin()

• db.Begin() 関数は、データベースのトランザクションを開始し、sql.Tx 型のトランザクションオブジェクトと error 型の値を返します。
• tx 変数には、トランザクションオブジェクトが格納されます。このオブジェクトを使用して、トランザクション内で実行するSQLクエリを実行したり、トランザクションをコミットまたはロールバックしたりします。
• err 変数には、トランザクションの開始中に発生したエラーが格納されます。エラーが発生しなかった場合は nil が格納されます。

	if err != nil {
		tx.Rollback() // エラーが発生したらロールバック
		log.Fatal(err)
	}

tx.Rollback()

• tx.Rollback() 関数は、トランザクションをロールバックします。ロールバックとは、トランザクション内で行われたすべてのデータベース操作を取り消し、トランザクション開始前の状態に戻すことです。
• トランザクション内でエラーが発生した場合、データベースが矛盾した状態になるのを防ぐために、必ずロールバックを行う必要があります。

	// トランザクションをコミット
	err = tx.Commit()
	if err != nil {
		log.Fatal(err)
	}

err = tx.Commit()

• tx.Commit() 関数は、トランザクションをコミットします。コミットとは、トランザクション内で行われたすべてのデータベース操作を確定し、データベースに永続化することです。
• トランザクション内でエラーが発生しなかった場合、tx.Commit() 関数を呼び出してトランザクションをコミットします。
• err 変数には、トランザクションのコミット中に発生したエラーが格納されます。エラーが発生しなかった場合は nil が格納されます。