MySQL 入門

MySQL Workbenchでのデータベース接続ガイド

MySQLサーバーへの接続は、データベースとやり取りするための重要かつ最初のステップです。このプロセスにより、クライアントアプリケーション（ここでは MySQL Workbench）とデータベースを保持するMySQLサーバーの間に通信チャネルが確立されます。これにより、サーバーにコマンドを送信して結果を受け取ることが可能になり、データの管理やクエリの実行が実現します。

1. 接続プロセスの理解

MySQLサーバーに接続するには、特定のパラメータ（引数）を提供する必要があります。クライアントアプリケーション（MySQL Workbench）は、これらのパラメータを使用してサーバーを特定し、認証を行います。これらのパラメータには通常、サーバーのホスト名またはIPアドレス、MySQLサーバーがリッスンしているポート番号、認証用のユーザー名、および対応するパスワードが含まれます。サーバーは、アクセスを許可する前にこれらのクレデンシャル（認証情報）を照合します。

1.1 接続パラメータ

接続を成功させるには、正確な接続パラメータが不可欠です。通信を確立するために必要なコア情報は以下の通りです：

  • ホスト名/IPアドレス (Hostname/IP Address): MySQLサーバーソフトウェアが動作している物理マシンまたは仮想マシンを識別するために使用します。サーバーとWorkbenchが同じマシン上にある場合は localhost になります。また、特定のIPアドレス（例: 192.168.1.100）やドメイン名（例: db.example.com）を指定することも可能です。
    • 例 1（ローカル）： 個人のPCに MySQL Community Server をインストールした場合、サーバーはそのマシン上で動作しています。同じPC上の Workbench から接続するには、ホスト名として localhost を使用します。これにより、Workbench は現在のマシン内でMySQLサーバーを探すよう指示されます。
    • 例 2（リモート）： 小規模なECサイトが、クラウドサービス上の専用サーバーでデータベースを運用していると仮定します。管理者がローカルマシンからこのデータベースを管理する場合、Workbench のホスト名にクラウドサーバーのパブリックIPアドレスまたはドメイン名を入力する必要があります。
  • ポート番号 (Port Number): サーバーマシン上でMySQLサーバーが使用する特定の通信エンドポイントです。MySQLのデフォルトポートは 3306 です。サーバーが異なるポートをリッスンするように構成されている場合は、その特定のポートを指定する必要があります。
    • 例（非標準ポート）： デベロッパーが一台のマシン上で異なるプロジェクトのために複数のMySQLインスタンスを実行し、コンフリクト（衝突）を避けるために各インスタンスに固有のポート（例: 3307 や 3308）を割り当てることがあります。特定のインスタンスに接続するには、Workbench で正しいポートを設定する必要があります。
  • ユーザー名 (Username): 認証を行うために、MySQLサーバー上で適切なパーミッション（権限）を持つ有効なユーザー名が必要です。一般的なユーザー名には root（すべての管理権限を持つスーパーユーザー）や、後で作成するカスタムユーザーが含まれます。
    • 例（Rootユーザー）： MySQLを初めてインストールした際、通常は root ユーザーが作成されます。このユーザーは、データベースや他のユーザーの作成を含むすべての操作を実行する権限を持っています。
    • 例（アプリケーションユーザー）： 本番環境では、アプリケーションは特定のユーザー（例: app_user）を使用して接続することがあります。このユーザーは特定のテーブルに対して SELECT、INSERT、UPDATE、DELETE 権限のみを持ちます。これにより、アクセス権限を制限してセキュリティを高めます。
  • パスワード (Password): 提供されたユーザー名に関連付けられたパスワードです。これは本人確認を行い、アクセス権限を付与するために不可欠です。
    • 例： インストールプロセスで root ユーザーを構成する際、パスワードを設定します。Workbench は接続を認証するために、これと全く同じパスワードを必要とします。

2. MySQL Workbench での新機能接続セットアップ

MySQL Workbench は、MySQLサーバーへの接続を簡単に構成および管理できるグラフィカルインターフェース（GUI）を提供しています。

2.1 新規接続作成のステップ

  1. MySQL Workbench の起動： アプリケーションを開きます。「Welcome to MySQL Workbench」画面に、「MySQL Connections」というタイトルのエリアが表示されます。
  2. 新規接続の追加： 「MySQL Connections」の横にある「+」ボタンをクリックし、「Setup New Connection」ダイアログを開きます。
  3. 接続パラメータの構成：
    • Connection Name (接続名): 接続に記述的な名前を付けます（例: Local MySQL、Development Server、Production Database）。この名前は Workbench 内で参照するためのもので、複数の接続を区別するのに役立ちます。
    • Connection Method (接続メソッド): ほとんどの基本的な接続では、デフォルトの Standard TCP/IP のままで問題ありません。このメソッドは、標準的なネットワークプロトコルを使用してサーバーに接続します。
    • Hostname (ホスト名): 127.0.0.1 または localhost を入力します。これらは両方ともMySQLサーバーがインストールされているローカルマシンを指します。
    • Port (ポート): 3306（デフォルトのMySQLポート）を入力します。インストール中にサーバーを異なるポートを使用するように構成した場合は、その特定のポート番号を入力してください。
    • Username (ユーザー名): root を入力します。これはMySQLのインストール中に作成されたデフォルトの管理ユーザーです。
    • Password (パスワード): 「Store in Vault...」ボタンをクリックします。root ユーザーのパスワードを求めるウィンドウが表示されます。MySQL Community Server のインストール中に設定したパスワードを入力し、「OK」をクリックします。パスワードをヴォルト（保存庫）に保存すると、Workbench が次回の接続のためにパスワードを記憶するため、毎回入力する必要がなくなります。
  4. 接続テスト (Test the Connection)： 「Test Connection」ボタンをクリックします。
    • 接続に成功すると、「Successfully made the MySQL connection.（MySQL接続に成功しました）」というダイアログが表示されます。これにより、Workbench がサーバーに接続し、提供されたクレデンシャルで認証できたことが確認されます。
    • 接続に失敗した場合、Workbench はエラーメッセージを表示します。失敗の一般的な原因は以下の通りです：
      • ホスト名またはポートが正しくない（例: サーバーが起動していない、ファイアウォールがポートをブロックしている）。ユーザー名またはパスワードが正しくない。MySQLサーバーが実行されていない（サーバーが動作していない疑いがある場合は、インストールセクションを再確認してください）。
  5. 接続の確定 (Confirm the Connection)： テスト成功後、「Setup New Connection」ダイアログで「OK」をクリックして接続を保存します。新しい接続が Workbench メイン画面の「MySQL Connections」の下に表示されるようになります。

3. 実戦デモ

root ユーザーを使用してローカルのMySQLサーバーに接続する方法をステップバイステップで実演します。

  1. 前章で説明した MySQLサーバーと Workbench のインストールが完了していることを前提とします。
  2. MySQL Workbench を開きます。
  3. メイン画面で「MySQL Connections」パネルを見つけます。
  4. 「+」記号をクリックして新しい接続を追加します。
  5. 「Setup New Connection」ダイアログに以下を入力します：
    • Connection Name: My Local Server
    • Connection Method: Standard TCP/IP (デフォルト)
    • Hostname: 127.0.0.1
    • Port: 3306
    • Username: root
  6. 「Store in Vault...」をクリックします。インストール中に root ユーザーに設定したパスワード（例: MyStrongPassword123!）を入力し、「OK」をクリックします。
  7. 「Test Connection」をクリックします。成功メッセージが表示されるはずです。
  8. 「OK」をクリックして接続を保存します。
  9. 次に、Workbench メイン画面で作成したばかりの My Local Server 接続アイコンをクリックします。これにより新しい SQLエディターのタブが開き、MySQLサーバーへの接続に成功したことを示します。

SQLエディター内には、さまざまなパネルが表示されます：

  • Navigator Panel (左側ナビゲーターパネル): Schemas（データベース/スキーマ）やその他の管理オプションを表示します。
  • SQL Editor (中央SQLエディター): ここで SQLクエリを記述し実行します。
  • Output Panel (下部アウトプットパネル): メッセージ、クエリ結果、およびエラーを表示します。

SQLエディターの右下隅には、[email protected]:3306 のような接続詳細が表示され、現在アクティブな接続状態であることを確認できます。