データベース
PR

Mac に Homebrew で MySQL クライアントをインストールする手順

saratogax
記事内に商品プロモーションを含む場合があります

Mac で Docker や AWS(RDS / Aurora)上の MySQL サーバに接続するには、ターミナルから使える mysql クライアントが必要です。

この記事では、Homebrew を使って Mac に MySQL クライアントをインストールする手順を、現行バージョンに合わせてまとめます。

大きな流れは次の 3 ステップです。

  1. Homebrew をインストールする
  2. mysql-client をインストールして PATH を通す
  3. 接続用の設定ファイルを用意する

HomeBrewのインストール

現在の Mac は FreeBSD ベースのような OS になっていて、Linux の黒い画面を触ったことがある人なら開発がしやすい環境が整っています。

RedHat 系(CentOS, Fedora, AmazonLinux)の Linux では yum によるパッケージ管理がありますが、Mac の場合は HomeBrew が主流となっています。

しかし、この HomeBrew は最初からインストールされているわけではありません。

よって、いざ MySQL クライアントを使いたいと思っても、まずは HomeBrew からインストール作業を始めないといけません。

では早速、ターミナルを起動して以下のコマンドを入力しましょう。

1$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

少し時間がかかりますが、これで HomeBrew のインストールが完了します。

MySQLクライアントのインストール

Homebrew が入ったら、いよいよ MySQL クライアントをインストールします。

MySQL のクライアントだけが欲しい場合は、mysql-client パッケージを入れるのが手軽です(サーバまでは不要なら mysql 本体を入れる必要はありません)。

1$ brew install mysql-client

ひとつ注意点があります。mysql-client は keg-only(システムの PATH に自動ではリンクされない)パッケージです。

そのため、インストール後に表示される案内(あとから brew info mysql-client でも確認できます)にしたがって、mysql コマンドへの PATH を通しておきましょう。

1$ echo 'export PATH=/opt/homebrew/opt/mysql-client/bin:$PATH' >> ~/.zshrc

上のパスは Apple Silicon(M1 以降)の例です。Intel Mac では /usr/local/opt/mysql-client/bin になるなど環境で異なるので、brew info mysql-client の表示にあわせてください。

特定のメジャーバージョンに合わせたいときは、mysql-client@8.0mysql-client@8.4 のようにバージョン付きの formula を指定することもできます。

MySQLクライアントの設定

Linux の時も「AmazonLinuxにMySQLクライアントをインストールする」で書きましたが、次に MySQL クライアントの設定をします。

まずは、MySQL クライアントのサーバ接続時の文字コードを指定します。

今回は、サーバ側にあわせて utf8mb4 にします。

1$ sudo vi /etc/my.cnf
2
3[mysql]
4default-character-set=utf8mb4

続いて、認証ファイルを作成します。

1$ sudo vi /etc/.my.cnf
2
3[client]
4user = USER_NAME
5password = PASSWORD
6host = 127.0.0.1

これで、データベース名を指定して目的の MySQL サーバへログインができました。

1$ mysql --defaults-extra-file=/etc/.my.cnf DB_NAME

コンソールではなく GUI のクライアントツールが欲しい人には、Sequel Pro の後継として開発が続く「Sequel Ace」がおすすめです(Sequel Pro 自体はメンテナンスが止まっています)。

あわせて読みたい
【SequelPro】MacのMySQL GUIクライアントと後継Sequel Aceへの移行
【SequelPro】MacのMySQL GUIクライアントと後継Sequel Aceへの移行
ABOUT ME
saratoga
saratoga
フリーランスエンジニア
仕事にも趣味にも IT を駆使するフリーランスエンジニア。技術的な TIPS や日々の生活の中で深堀りしてみたくなったことを備忘録として残していきます。
記事URLをコピーしました