はじめに

手元の開発環境でプログラムを開発するときに、MySQL に接続したくなる時が有ります。クラウド上でのマネージドサービスを使ってもよいのですが、費用など掛かるためローカルで MySQL を動かしたくなります。そこで、Docker を使って MySQL を動作させる方法がかなりお手軽だと思います。

この記事では、ローカルで MySQL を動かしたうえで、Go言語から接続する手順を残しておきます。

Docker で MySQL を動かす

ECR Public で公開されている Docker Image を使って、ローカル上で MySQL を動かします。Docker Hub でもよいのですが、スロットリングの上限が自分の場合は 6時間につき 100 が上限となっているため、ECR Public を使っていきます。

docker run のコマンド一発でローカル環境で MySQL が動作できます。コンテナサイコー。

MySQL 8.0 を利用
MySQL のパスワードなどを指定

docker run \
--name mydb \
-itd \
--hostname my-mysql \
-e MYSQL_ROOT_PASSWORD=mypassword \
-e BIND-ADDRESS=0.0.0.0 \
-p 3306:3306 \
public.ecr.aws/docker/library/mysql:8.0

なお、ここで動作した MySQL コンテナを削除する場合は次のコマンドで削除可能です。

docker kill mydb
docker rm mydb

MySQL が正常に稼働しているか、接続テストを行います。

mysql -u root -h 127.0.0.1 --port=3306 -pmypassword

実行例です。問題なく接続できました。

> mysql -u root -h 127.0.0.1 --port=3306 -pmypassword
mysql: [Warning] Using a password on the command line interface can be insecure.
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 8
Server version: 8.0.28 MySQL Community Server - GPL

Copyright (c) 2000, 2021, Oracle and/or its affiliates.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql>

SHOW DATABASES でデータベース一覧も確認してみましょう。正常に見えていますね。

mysql> SHOW DATABASES;
+--------------------+
| Database           |
+--------------------+
| information_schema |
| mysql              |
| performance_schema |
| sys                |
+--------------------+
4 rows in set (0.01 sec)

mysql>

テスト用のデータを格納

テスト用のデータ格納します。

CREATE DATABASE sugi01;
USE sugi01;

CREATE TABLE sample(
  id INT(11) NOT NULL AUTO_INCREMENT,
  name VARCHAR(10) NOT NULL,
  PRIMARY KEY (id)
);

INSERT INTO sample(name) VALUES ("MySQLのデータ");

確認

SELECT * FROM sugi01.sample;

実行例

mysql> SELECT * FROM sugi01.sample;
+----+-------------------+
| id | name              |
+----+-------------------+
|  1 | MySQLのデータ     |
+----+-------------------+
1 row in set (0.00 sec)

mysql>

環境変数の設定

Go言語をつかって動作確認をしていくのですが、接続先の情報は環境変数として渡したいと思います。環境変数化しておくと、なにかと便利です。

Bash

Bash の場合の設定例

export MYSQL_HOSTNAME=localhost
export MYSQL_PORT=3306
export MYSQL_USERNAME=root
export MYSQL_PASSWORD=mypassword

Fish

Fish の場合の設定例

set -x MYSQL_HOSTNAME localhost
set -x MYSQL_PORT 3306
set -x MYSQL_USERNAME root
set -x MYSQL_PASSWORD mypassword

Go から接続

Go 言語用プロジェクト用のディレクトリを作成します。

mkdir ~/godir/app-runner-testapp
cd ~/godir/app-runner-testapp

MySQL 接続用のライブラリを取得します。

go get -u github.com/go-sql-driver/mysql

Goの動作確認用プログラム。このコードは、エラーのハンドリングはまったくしていないので、本番環境での利用はだめです。

MySQL の接続先に環境変数を利用
1行分のみのデータを取得して、標準出力にプリント

package main

import (
	"database/sql"
	"os"
	"time"

	_ "github.com/go-sql-driver/mysql"
)

func main() {
	mysql_hostname := os.Getenv("MYSQL_HOSTNAME")
	mysql_port := os.Getenv("MYSQL_PORT")
	mysql_username := os.Getenv("MYSQL_USERNAME")
	mysql_password := os.Getenv("MYSQL_PASSWORD")

	db, err := sql.Open("mysql", mysql_username+":"+mysql_password+"@tcp("+mysql_hostname+":"+mysql_port+")/sugi01")
	if err != nil {
		println("MySQL のコネクション接続に失敗")
		panic(err)
	}
	defer db.Close()

	// See "Important settings" section.
	db.SetConnMaxLifetime(time.Minute * 3)
	db.SetMaxOpenConns(10)
	db.SetMaxIdleConns(10)

	row := db.QueryRow(`select * from sample`)

	var id, name string
	row.Scan(&id, &name)

	println(name)
}

Go の依存関係を管理するための go.mod を生成

go mod init github.com/Sugi275/app-runner-testapp

動作確認

それでは動作確認をしてみましょう。「MySQLのデータ」と表示されており、正常に表示されることがわかります。

> go run app.go
MySQLのデータ