こんにちは。データベースとAPIの深淵をさまよい続けて早幾年。今日も現場で泥臭く、しかしスマートに開発を楽しんでいるエンジニアです。
新しい技術に触れるとき、一番ストレスを感じるのは「ツール同士がうまく会話してくれない」という瞬間ですよね。特に、Dockerで立ち上げたデータベースと、Windowsで愛用している『A5:SQL Mk-2』の橋渡し。ここで躓いてモチベーションを削がれるのは非常にもったいない。
今日は、Dockerコンテナ内のデータベースをA5:SQL Mk-2で自在に操るための、現場の「鉄板セットアップ」を伝授します。これを読めば、もう接続トラブルで悩むことはありません。
—
1. なぜ「A5:SQL Mk-2」なのか？
多くのエンジニアがVS CodeやDataGripを使う中、なぜA5:SQL Mk-2なのか。それは、「日本人の手に馴染む、圧倒的な軽快さとER図生成能力」にあります。特にSQLの整形や、複雑なテーブル構造を一瞬で可視化する機能は、今もなお最強クラスです。
2. Docker接続の「最大の罠」を回避する
Docker上のDBに接続する際、初心者が陥る罠は「コンテナ内のIPアドレス」を直接指定しようとすることです。コンテナは再起動のたびにIPがコロコロ変わります。
解決策は「ポートマッピング」と「localhost固定」です。
ステップ1：docker-compose.yml の鉄則
まずは `docker-compose.yml` で、ホスト側（あなたのPC）とコンテナ側のポートを明確に固定します。
version: ‘3.8’
services:
db:
image: postgres:15-alpine # MySQLなら mysql:8.0 等
container_name: dev-db
ports:
- “5432:5432” # ホストの5432をコンテナの5432にマッピング
environment:
POSTGRES_USER: user
POSTGRES_PASSWORD: password
POSTGRES_DB: dev_db
restart: always # コンテナが落ちても自動復帰させる
- ポイント: `ports: “5432:5432″` と書くことで、あなたのPCの `localhost:5432` が常にコンテナ内のDBを指すようになります。これで、IPアドレスの変化に怯える必要はゼロです。
—
3. A5:SQL Mk-2の接続設定（極限の最適化）
A5:SQL Mk-2を起動し、「データベースの追加と削除」から設定を行います。
1. データベースのタイプ: PostgreSQL または MySQL を選択。
2. ホスト名: `localhost` （※重要：ここをIPにしない！）
3. ポート番号: `5432` (Postgres) または `3306` (MySQL)
4. データベース名/ユーザー/パスワード: `docker-compose.yml` に記載したものと一致させる。
【プロの小技】接続テストの前に
接続ボタンを押す前に、以下のコマンドをターミナルで実行して、ポートが本当に開いているか確認する癖をつけましょう。
Windowsのコマンドプロンプトで実行
netstat -ano | findstr :5432
ここで応答があれば、DBは正常に起動し、ホストと繋がっています。A5:SQL Mk-2が繋がらない原因の9割は、このポートが空いていないことです。
—
4. Hello World：最初のクエリを投げよう
接続ができたら、まずは「自分だけのテーブル」を作って、データの読み書きを確認しましょう。
— 動作確認用テーブル作成
CREATE TABLE hello_world (
id SERIAL PRIMARY KEY,
message TEXT NOT NULL,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);
— データ挿入
INSERT INTO hello_world (message) VALUES (‘DockerとA5:SQL Mk-2の連携、成功です！’);
— データ確認
SELECT FROM hello_world;
これが正常に表示されたら、あなたはもうDocker DB開発の基礎をクリアしました。おめでとうございます！
—
5. 現場で震えるほど役立つ「運用の極意」
最後に、ベテランが必ず行っている「さらなる効率化」のヒントを3つ贈ります。
- 接続プロファイルの保存: A5:SQL Mk-2の接続設定を「エクスポート」して、チームの `README.md` に含めておきましょう。メンバー全員が同じ接続設定をインポートするだけで、環境構築時間が数十分短縮されます。
- ER図の自動生成: 開発が進んだら、A5:SQL Mk-2の「ER図作成」機能を使ってください。DBからスキーマをインポートするだけで、今自分がどのようなデータ構造を作っているのか俯瞰できます。これがバグを未然に防ぐ最大の武器になります。
- Dockerのクリーンアップ: 開発中にデータが汚れたら、`docker-compose down -v` でボリュームごと消去し、`docker-compose up` でクリーンな環境を作り直す。この「使い捨て」の精神こそが、Docker開発の醍醐味です。
結び
ツールはあくまで「あなたの思考を形にするための補助」です。A5:SQL Mk-2とDockerを適切に繋ぐことで、あなたはインフラの些細なトラブルから解放され、本来注力すべき「アプリケーションのロジック」に全神経を集中できるようになります。
さあ、この快適な環境で、最高にエキサイティングな開発ライフを楽しみましょう！何か詰まったら、いつでもまた聞きに来てくださいね。