「インストール - MySQL8」の版間の差分
34行目: | 34行目: | ||
# 過去のMySQLのGPGキーを削除する。 | # 過去のMySQLのGPGキーを削除する。 | ||
#: <code>sudo rpm -e gpg-pubkey-XXXXXXXX-XXXXXXXX</code> | #: <code>sudo rpm -e gpg-pubkey-XXXXXXXX-XXXXXXXX</code> | ||
# 過去のMySQLのGPGキーファイルを削除する。 | |||
#: <code>sudo rm "/etc/RPM-GPG-KEY-mysql*"</code> | |||
<br> | <br> | ||
まず、MySQL公式Webサイトからリポジトリを登録する必要がある。<br> | まず、MySQL公式Webサイトからリポジトリを登録する必要がある。<br> |
2022年2月18日 (金) 07:24時点における版
概要
標準でインストール可能なMySQLは、MariaDBというMySQL派生のDBである。
MySQLとほぼ同じなので、そのまま使用しても問題ないが、本番環境でMySQL8.0を使用する場合は、同じバージョンに揃えたい時がある。
ここでは、MySQL8.0をインストールする方法を記載する。
MariaDBのアンインストール
もし、既にMariaDBがインストールされている場合は、MariaDBをアンインストールする。
まず、インストールされているパッケージの確認するため、以下のコマンドを実行する。
# CentOS sudo rpm -qa | grep maria # SUSE sudo zypper search -i | grep maria
CentOSの場合、mariadb-libs-<バージョン名>.el<バージョン名>.x86_64
と表示されるので、このパッケージをアンインストールする。
SUSEの場合、mariadbと表示されるので、このパッケージをアンインストールする。
# CentOS sudo yum remove mariadb-libs sudo rm -rf /var/lib/mysql/ # SUSE sudo zypper remove mariadb mariadb-client mariadb-errormessages libmariadb3 akonadi-server akonadi-server-lang libQt5Sql5-mysql python3-mysqlclient sudo rm -rf /var/lib/mysql/
依存性関連のパッケージが存在すれば、同時に削除される。
MySQL公式リポジトリの追加と設定
過去のMySQLのGPGキーがインポートされている場合は削除する。
- 削除対象の鍵を確認する。
sudo rpm -q gpg-pubkey --qf '%{name}-%{version}-%{release} --> %{summary}\n'
- 過去のMySQLのGPGキーを削除する。
sudo rpm -e gpg-pubkey-XXXXXXXX-XXXXXXXX
- 過去のMySQLのGPGキーファイルを削除する。
sudo rm "/etc/RPM-GPG-KEY-mysql*"
まず、MySQL公式Webサイトからリポジトリを登録する必要がある。
- CentOS(CentOS 7系はRHEL 7系、CentOS 8系はRHEL 8系のリポジトリをダウンロードする)
- SUSE
または、以下のコマンドを実行して直接インストールする。
# CentOS 7 sudo yum install https://dev.mysql.com/get/mysql80-community-release-el7-5.noarch.rpm # CentOS 8 sudo dnf install https://dev.mysql.com/get/mysql80-community-release-el8-3.noarch.rpm # SUSE sudo zypper install https://dev.mysql.com/get/mysql80-community-release-sl15-5.noarch.rpm sudo rpm --import /etc/RPM-GPG-KEY-mysql-2022 # MySQLリポジトリのパッケージの署名チェックに使用するMySQL製品用のGnuPGキーをシステムにインポートする sudo zypper refresh または sudo rpm -ivh mysql80-community-release-sl15-5.noarch.rpm sudo rpm --import /etc/RPM-GPG-KEY-mysql-2022 # MySQLリポジトリのパッケージの署名チェックに使用するMySQL製品用のGnuPGキーをシステムにインポートする sudo zypper refresh
このリポジトリを追加することで、MySQL5.5~5.7、8.0のいずれかを選択して、インストールすることができるようになる。
リポジトリが追加されたかどうかは、以下のコマンドで確認できる。
# CentOS sudo yum repolist all | grep mysql # SUSE sudo zypper repos | grep mysql
上記のリストで[有効]と表示されている項目が、標準でインストールされるパッケージである。
MySQL8.0のインストール
リポジトリを追加してインストール
インストールを行う前に、パッケージのバージョンを確認する。
# CentOS sudo yum info mysql-community-server # SUSE sudo zypper search --detail mysql-community-server
表示されているパッケージのバージョンが8.0.xxであれば、インストールを開始する。
インストールの途中において、MySQLのGPG公開鍵が無いというメッセージが表示されるが、
インストール時にGPG公開鍵も同時にインストールされるので、そのまま続ける。
# CentOS sudo yum install mysql-community-server # SUSE sudo zypper install mysql-community-server
インストール完了後、MySQLのバージョンを確認する。
mysqld –-version
最後に、自動起動の設定をしてMySQLを起動する。
sudo systemctl enable mysqld sudo systemctl start mysqld
ソースコードからインストール
ビルドに必要なライブラリをインストールする。
sudo zypper install cmake git glibc-devel ncurses-devel perl perl-Data-Dumper libtirpc libtirpc-devel rpcgen
MySQLの公式Webサイトにアクセスして、MySQLのソースコードをダウンロードする。
[Product Version]は、インストールするMySQLのバージョンを選択、[Operating System]では"Source Code"を選択する。
表示されるリストから、最も下欄にある"mysql-boost-<バージョン>.tar.gz"をダウンロードする。
MySQL 5.7.5からBoostライブラリが必要になったため、Boostライブラリ同梱のものをダウンロードすること。
または、wget
コマンドを使用して直接ダウンロードする。
wget https://downloads.mysql.com/archives/get/p/23/file/mysql-boost-<バージョン>.tar.gz
ダウンロードしたファイルを解凍する。
tar xf mysql-boost-<バージョン>.tar.gz cd mysql-boost-<バージョン>
MySQLのビルドディレクトリを作成する。
mkdir build && cd build
MySQLをビルドおよびインストールする。
cmake .. \ -DCMAKE_INSTALL_PREFIX=<MySQLのインストールディレクトリ> \ -DDEFAULT_CHARSET=utf8mb4 \ -DWITH_EXTRA_CHARSETS=all \ -DDEFAULT_COLLATION=utf8mb4_general_ci \ -DWITH_INNOBASE_STORAGE_ENGINE=1 \ -DSYSCONFDIR=<MySQLのインストールディレクトリ> \ -DMYSQL_DATADIR=<MySQLのインストールディレクトリ>/data \ -DWITH_BOOST=../boost \ -DCMAKE_C_COMPILER=<GCCのインストールディレクトリ>/bin/gcc_11_2 \ -DCMAKE_CXX_COMPILER=<G++のインストールディレクトリ>/bin/g++_11_2 -DWITH_PIC=1 # 不要の可能性あり make -j $(nproc) make install
/<MySQLのインストールディレクトリ>/libディレクトリから/<MySQLのインストールディレクトリ>/lib64ディレクトリへ、シンボリックリンクを作成する。
ln -s /<MySQLのインストールディレクトリ>/lib /<MySQLのインストールディレクトリ>/lib64
MySQLのインストールディレクトリに、以下のディレクトリとファイルを作成する。
# ディレクトリを作成 mkdir <MySQLのインストールディレクトリ>/data mkdir <MySQLのインストールディレクトリ>/tmp mkdir <MySQLのインストールディレクトリ>/logs # ファイルの作成 touch <MySQLのインストールディレクトリ>/logs/mysqld.err
次に、MySQLのデータディレクトリを初期化する。(MySQL 5.7.6以降、mysql_install_dbは廃止されていることに注意する)
以下のコマンドを実行した後、/var/log/mysql/mysqld.logファイルに、MySQLのrootユーザのパスワードが保存される。
もし、保存されてない場合は、/<MySQLのインストールディレクトリ>/logs/mysqld.errファイルを確認する。
/<MySQLのインストールディレクトリ>/bin/mysqld --initialize \ --user=<任意のユーザ名> \ # 例. mysql等 --basedir=<MySQLのインストールディレクトリ> \ --datadir=/<MySQLのインストールディレクトリ>/data
MySQLのインストールディレクトリに、次のセクションに記述している内容のmy.cnfファイルを作成する。
vi /<MySQLのインストールディレクトリ>/my.cnf
作成したmy.cnfファイルを、以下のように編集する。
# my.cnf : ポートの変更 sed -i -e "s/\[_PORT_NO_\]/<任意のポート番号 例. 53306>/g" /<MySQLのインストールディレクトリ>/my.cnf # my.cnf : ユーザ名の変更 sed -i -e "s/\[_USER_NAME_\]/<任意のユーザ名 例. mysql>/g" /<MySQLのインストールディレクトリ>/my.cnf # my.cnf : MySQLのデータディレクトリの変更 sed -i -e "s/\[_MYSQL_DATA_BASE_DIR_\]/<MySQLのインストールディレクトリ 例. \/home\/user\/InstallSoftware\/MySQL>/g" /<MySQLのインストールディレクトリ>/my.cnf # my.cnf : 文字コードの変更 sed -i -e "s/\[_CHARACTER_SET_\]/utf8mb4/g" /<MySQLのインストールディレクトリ>/my.cnf sed -i -e "s/# collation-server = utf8mb4_bin/collation-server = utf8mb4_bin/g" /<MySQLのインストールディレクトリ>/my.cnf # my.cnf : パスワードの有効期限を無期限に延長する場合 sed -i -e "s/# default_password_lifetime = 0/default_password_lifetime = 0/g" /<MySQLのインストールディレクトリ>/my.cnf # my.cnf : パスワード認証をレガシーに設定する場合 sed -i -e "s/# default_authentication_plugin = mysql_native_password/default_authentication_plugin = mysql_native_password/g" /<MySQLのインストールディレクトリ>/my.cnf
MySQLを起動する。
/<MySQLのインストールディレクトリ>/support-files/mysql.server start
MySQLの初期設定を行う。
# rootユーザで接続する /<MySQLのインストールディレクトリ>/bin/mysql -u root -p (/var/log/mysql/mysqld.logファイルに保存されたパスワードを入力する) # rootユーザのパスワードを変更する ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '<任意のパスワード>'; quit;
/<MySQLのインストールディレクトリ>/binディレクトリにあるmysql_secure_installationを実行する。
詳細は、インストール - MySQL8#MySQLの初期設定を参照すること。
MySQLを停止するには、以下のコマンドを実行する。
/<MySQLのインストールディレクトリ>/support-files/mysql.server stop
my.cnfファイルのテンプレート
my.cnfファイルのテンプレートを以下に記述する。
[mysqld] port = [_PORT_NO_] user = [_USER_NAME_] basedir = [_MYSQL_DATA_BASE_DIR_] datadir = [_MYSQL_DATA_BASE_DIR_]/data tmpdir = [_MYSQL_DATA_BASE_DIR_]/tmp socket = [_MYSQL_DATA_BASE_DIR_]/tmp/mysql.sock pid-file = [_MYSQL_DATA_BASE_DIR_]/logs/mysqld.pid log-error = [_MYSQL_DATA_BASE_DIR_]/logs/mysqld # Windows / Mac環境のみ # lower_case_table_names = 2 # 文字コード character-set-server = [_CHARACTER_SET_] # utf8mb4を使う場合 # collation-server = utf8mb4_bin # SQLモード sql_mode = NO_ENGINE_SUBSTITUTION,STRICT_TRANS_TABLES #sql_mode = NO_ENGINE_SUBSTITUTION,STRICT_TRANS_TABLES,NO_ZERO_DATE,NO_ZERO_IN_DATE,ERROR_FOR_DIVISION_BY_ZERO # SQL文の最大長 max_allowed_packet = 1M # max_allowed_packet = 16MB # MySQL 5.6.6 以降はデフォルトでON : InnoDBをテーブルごとにファイルを分ける innodb_file_per_table = 1 # MySQL 5.5 のみ : federated が無くなったので無効にする # skip-federated # MySQL 5.6 以降 : 暗黙のDEFAULT値を持つTIMESTAMPは非推奨 explicit_defaults_for_timestamp = 1 # MySQL 5.7.4 以降 : パスワードの有効期間を無期限に # default_password_lifetime = 0 # MySQL 8.0 以降 : 以前までのパスワード認証にする # default_authentication_plugin = mysql_native_password # チューニング用 sort_buffer_size = 512K net_buffer_length = 8K read_buffer_size = 256K read_rnd_buffer_size = 512K myisam_sort_buffer_size = 8M # innodb_buffer_pool_size = 128M # join_buffer_size = 128M # sort_buffer_size = 2M # read_rnd_buffer_size = 2M # key_buffer = 16M # table_cache = 64 # skip-locking [mysql] port = [_PORT_NO_] user = [_USER_NAME_] socket = [_MYSQL_DATA_BASE_DIR_]/tmp/mysql.sock default-character-set = [_CHARACTER_SET_] [mysql.server] port = [_PORT_NO_] user = [_USER_NAME_] basedir = [_MYSQL_DATA_BASE_DIR_] datadir = [_MYSQL_DATA_BASE_DIR_]/data tmpdir = [_MYSQL_DATA_BASE_DIR_]/tmp socket = [_MYSQL_DATA_BASE_DIR_]/tmp/mysql.sock pid-file = [_MYSQL_DATA_BASE_DIR_]/logs/mysqld.pid log-error = [_MYSQL_DATA_BASE_DIR_]/logs/mysqld default-character-set = [_CHARACTER_SET_] [mysqld_safe] port = [_PORT_NO_] user = [_USER_NAME_] basedir = [_MYSQL_DATA_BASE_DIR_] datadir = [_MYSQL_DATA_BASE_DIR_]/data tmpdir = [_MYSQL_DATA_BASE_DIR_]/tmp socket = [_MYSQL_DATA_BASE_DIR_]/tmp/mysql.sock pid-file = [_MYSQL_DATA_BASE_DIR_]/logs/mysqld.pid log-error = [_MYSQL_DATA_BASE_DIR_]/logs/mysqld default-character-set = [_CHARACTER_SET_] [client] port = [_PORT_NO_] user = [_USER_NAME_] socket = [_MYSQL_DATA_BASE_DIR_]/tmp/mysql.sock
MySQLのrootパスワードの確認
MySQLのインストール時にrootのパスワードがログに出力されているので確認する。
ここでは、V9djjjWFd_wfがrootのパスワードである。
sudo grep 'temporary password' /var/log/mysql/mysqld.log # 結果 2019-02-17T01:49:46.433912Z 5 [Note] [MY-010454] [Server] A temporary password is generated for root@localhost: V9djjjWFd_wf
MySQLの初期設定
MySQLの初期設定は、いくつかの質問に答えるだけで完了する。以下に、質問箇所を抜粋して記載する。
パスワードは8文字以上+大文字小文字+数値+記号を含める必要がある。
sudo mysql_secure_installation Enter current password for root (enter for none):(何も入力せずエンター) Set root password? [Y/n] y(設定する方が良いのでy) New password:(設定したいパスワードを入力) Re-enter new password:(設定したいパスワードを再入力) Remove anonymous users? [Y/n] y(匿名ユーザーは不要なのでy) Disallow root login remotely? [Y/n] y(rootでリモートログインはNGなのでy) Remove test database and access to it? [Y/n]y(テスト用のデータベースはいらないのでy) Reload privilege tables now? [Y/n]y(ここまでの設定を反映させるのでy)
続いて、文字コードの設定を行うため、以下のファイルを開く。
この設定を行わない場合、日本語が文字化けする可能性がある。
sudo vi /etc/my.cnf
[mysqld_safe]の上部辺りに、以下の4行を追加する。
character_set_server=utf8mb4 explicit_defaults_for_timestamp=true skip-character-set-client-handshake table_definition_cache=400
MySQLを再起動するため、以下のコマンドを実行する。
sudo systemctl restart mysqld
もし、rootユーザのパスワードを変更する場合、MySQLにログインして以下のコマンドを実行する。
ALTER USER 'root'@'localhost' IDENTIFIED BY '<パスワード>';
パスワードポリシーの変更
非推奨ではあるが、パスワードポリシー(短いパスワードを許可する)を変更する場合、MySQLにログイン後、以下のクエリを実行する。
初期状態では、validate_password.policy
がMEDIUM
となっている。
set global validate_password.length=6; # パスワードの最低の長さを変更 set global validate_password.policy=LOW; # セキュリティレベルの変更
現在のパスワードポリシーを確認する場合、MySQLにログイン後、以下のクエリを実行する。
SHOW VARIABLES LIKE 'validate_password%';
WordPressを使用する場合は、認証をパスワード式にする必要がある。
ALTER USER 'ユーザ名'@'ホスト名または%' IDENTIFIED WITH mysql_native_password BY ‘<パスワード>’;
MySQLユーザの作成
一般的に、rootユーザでデータベースを操作しないため、データベースユーザを作成する。
まず、MySQLにログインする。
sudo mysql -p Enter password:(rootユーザに設定したパスワード)
ここでは、全ての権限を持ったユーザを作成する。(通常はこのようなユーザは作成しない)
- MySQL8をローカル環境でのみ使用する場合
mysql> CREATE USER 'ユーザ名'@'ホスト名' IDENTIFIED BY 'パスワード'; mysql> GRANT ALL PRIVILEGES ON *.* TO 'ユーザ名'@'ホスト名'; mysql> FLUSH PRIVILEGES;
- MySQL8を外部のネットワークから接続する場合
mysql> CREATE USER 'ユーザ名'@'%' IDENTIFIED BY 'パスワード'; mysql> GRANT ALL PRIVILEGES ON *.* TO 'ユーザ名'@'%'; mysql> FLUSH PRIVILEGES;
以降は、このユーザで操作をするため、再ログインする。
mysql> exit; sudo mysql -u ユーザ名 -p Enter password:(作成したユーザに設定したパスワード)
※注意
PHP7からMySQL8以降に接続する場合、以下のエラーが出力されることがある。
Warning: PDO::__construct(): The server requested authentication method unknown to the client [caching_sha2_password]
これは、MySQL8以降、データベースユーザの認証プラグインがcaching_sha2_password
に変更されたが、
PHP7では、caching_sha2_password
が未サポートであることが原因である。
そのため、データベースユーザの認証プラグインをmysql_native_password
に変更することが必要となる。
まず、MySQL8に接続して、認証プラグインを確認する。
mysql> SELECT User, Host, Plugin FROM mysql.user;
次に、ユーザの認証プラグインをcaching_sha2_password
からmysql_native_password
に変更する。
mysql> ALTER USER 'ユーザ名'@'ホスト名または%' IDENTIFIED WITH mysql_native_password BY 'パスワード';
Dockerを使用している場合、Dockerのコンテナ内でユーザの認証プラグインを変更する手順を、以下に記載する。
まず、Dockerのコンテナに入る。
# DockerのCONTAINER IDを確認 docker ps # 上記のコマンドで確認したMySQL 8のCONTAINER IDを指定して、コンテナに接続する docker exec -it <CONTAINER ID> bash # コンテナ内でMySQL 8にログインする mysql -u root -p Enter password: <database.ymlで設定したパスワード> # User、Host、Pluginを確認する(例えば、以下のような全ユーザの認証プラグイン) mysql> SELECT User, Host, Plugin FROM mysql.user; +------------------+-----------+-----------------------+ | User | Host | Plugin | +------------------+-----------+-----------------------+ | root | % | caching_sha2_password | | mysql.infoschema | localhost | caching_sha2_password | | mysql.session | localhost | caching_sha2_password | | mysql.sys | localhost | caching_sha2_password | | root | localhost | caching_sha2_password | +------------------+-----------+-----------------------+ # 例: rootユーザの認証プラグインを変更する mysql> ALTER USER 'ユーザ名'@'ホスト名' IDENTIFIED WITH mysql_native_password BY 'パスワード' # 正常に変更されているか確認する mysql> SELECT User, Host, Plugin FROM mysql.user; +------------------+-----------+-----------------------+ | User | Host | Plugin | +------------------+-----------+-----------------------+ | root | % | caching_sha2_password | | mysql.infoschema | localhost | caching_sha2_password | | mysql.session | localhost | caching_sha2_password | | mysql.sys | localhost | caching_sha2_password | | root | localhost | mysql_native_password | <= 変更されているか確認 +------------------+-----------+-----------------------+
コンテナを削除して、再度、ビルドを行う。
docker-compose down docker-compose build
パスワードの変更
MySQL8において、パスワードを変更するには、以下のクエリを実行する。
USE mysql; ALTER USER '<ユーザ名>'@'<ホスト名または%>' identified BY '<パスワード>';
パスワードを忘れた場合の対処
もし、パスワードを忘れてログインできない場合は、まず、MySQLをセーフモードで起動して、パスワードなしでログインする。
まず、/etc/my.cnfファイルの[mysqld]セクションに以下の設定を追記する記述する。
sudo vi /etc/my.cnf # /etc/my.cnfファイル [mysqld] skip-grant-tables ; skip-grant-tablesで認証をOFF skip-networking ; skip-networkingで外部(リモート)からの接続を禁止
MySQLを再起動をして設定を反映する。
sudo systemctl restart mysql
MySQLにログインする。
mysql -u root
MySQLのテーブルに格納されているrootユーザのパスワードを空にする。
USE mysql; UPDATE mysql.user SET authentication_string=null WHERE User='root';
/etc/my.cnfファイルの[mysqld]セクションの設定を元に戻す。
sudo vi /etc/my.cnf [mysqld] # skip-grant-tables # skip-networking
MySQLを再起動して設定を反映させる。
sudo systemctl restart mysql
上記で設定した空のパスワード(rootユーザ)でログインして、rootユーザのパスワードを再設定する。
mysql -u root -p USE mysql; ALTER USER 'root'@'localhost' identified BY 'HogeHoge1';
MySQL WorkBenchのインストール
パッケージ管理システムを使用してインストール
MySQL WorkBenchと依存関係のライブラリをインストールする。
sudo zypper install mysql-workbench libOpenCL1 libantlr4-runtime4_7_2 libfreexl1 libgdal26 libgeos-3_6_2 libgeos_c1 libgeotiff5 libhdf5-103 \ libhdf5_cpp103 libhdf5_hl100 libkea1_4 libmariadb-devel libnetcdf15 libproj19 libscintilla3 \ libspatialite7 libvsqlitepp3 proj python python-enum34 python-ipaddress python-xml python2-PyNaCl python2-appdirs \ python2-asn1crypto python2-bcrypt python2-cffi python2-cryptography python2-idna python2-packaging python2-paramiko \ python2-pexpect python2-ptyprocess python2-pyasn1 python2-pycparser python2-pyparsing python2-setuptools python2-six
ソースコードからインストール
MySQLの公式Webサイトにアクセスして、MySQL WorkBenchのソースコードをダウンロードする。
または、GitHubからソースコードをクローンする。
git clone --depth 1 https://github.com/mysql/mysql-workbench.git
MySQL WorkBenchのビルドに必要なライブラリをインストールする。
sudo zypper install cmake autoconf automake pkg-config libtool libzip-devel libxml2-devel libsigc++2-devel libglade2-devel \ Mesa-libGL1 Mesa-libGL-devel Mesa-devel libmysqlclient-dev libmysqlcppconn-devel libuuid-devel \ libpixman-1-0-devel pcre-devel pango-devel cairo-devel python-devel libboost_headers1_66_0-devel \ mysql-client python-pysqlite sqlite3-devel swig vsqlite++-devel gdal-devel gtk3-devel gtkmm3-devel \ libopenssl-devel libsecret-devel proj-devel
- ANTLR(推奨)
- MySQLパーサ用のファイルを生成するには、ANTLR 4.7以降が必要である。
- ANTLRの公式Webサイトにアクセスして、antlr-<バージョン>-complete.jarファイルをダウンロードする。
- cmakeコマンドを実行する時、このjarファイルのパスをcmakeの引数として渡す必要がある。
- -DWITH_ANTLR_JAR=<antlr-<バージョン>-complete.jarファイルのパス>
- iodbc
- ミドルウェアにおいて、iodbcの代わりにunixODBCを使用する場合を記載する。
- まず、unixODBCをインストールする。
- cmakeコマンドを実行する時、
-DUSE_UNIXODBC=True
オプションを付加する。
- gdal
- Ubuntuの場合、unixodbcが必須である。
- もし、iodbcを使用する場合は、MySQL WorkBenchをソースコードからビルドする必要がある。
cmakeコマンドを実行して、MySQL WorkBenchをコンパイルする。
mkdir build && cd build cmake -DCMAKE_INSTALL_PREFIX=<MySQL WorkBenchのインストールディレクトリ> -DWITH_ANTLR_JAR=<antlr-<バージョン>-complete.jarファイルのパス> .. make -j 8
MySQL WorkBenchをインストールする。
make install DESTDIR=<MySQL WorkBenchのインストールディレクトリ>
DBeaver
DBeaverは、Oracle、SQLServer、MySQL、MariaDB、SQLite等の計42種類のドライバに対応したSQLクライアントツールである。
DBeaverはJavaで開発されているため、動作にはJRE(Java Runtime Environment)が必要であるが、
ダウンロードしたDBeaverにはJREが付属している。
もし、最新のJREを使用する場合、以下に示すOracleのJREダウンロードページからJavaSEをダウンロードする。
ダウンロードしたJavaSEを任意のディレクトリに配置して、インストール(Windows)または環境変数PATH(Linux)を設定する。
DBeaverの公式Webサイトにアクセスして、Linux 64 bit (zip)をダウンロードする。
ダウンロードしたDBeaverを解凍する。(ここでは、~/InstallSoftware/DBeaverに解凍している)
以下のようなデスクトップエントリファイルを作成する。
[Desktop Entry] Version=1.0 Type=Application Terminal=false Name=DBeaver Community <バージョン名> GenericName=DBeaver Community Comment=Universal Database Manager and SQL Client. Path=/home/<ユーザ名>/InstallSoftware/DBeaver/ Exec=/home/<ユーザ名>/InstallSoftware/DBeaver/dbeaver Icon=/home/<ユーザ名>/InstallSoftware/DBeaver/dbeaver.png Categories=IDE;Development WM_CLASS=DBeaver StartupWMClass=DBeaver StartupNotify=true Keywords=Database;SQL;IDE;JDBC;ODBC;MySQL;PostgreSQL;Oracle;DB2;MariaDB MimeType=application/sql
※注意
データベース接続時において、以下のエラーが出力される場合がある。
SQL Error [08001]: Public Key Retrieval is not allowed
この時、DBeaverのメイン画面左の[データベースナビゲータ]から該当接続を右クリックして、[編集 接続]を選択する。
次に、[接続構成]画面右 - [ドライバのプロパティ]タブから、以下の項目を設定する。
- allowPublicKeyRetrieval
- trueに変更する。
- useSSL
- falseに変更する。
最後に、[接続構成]画面下の[OK]ボタンを押下する。
phpMyAdmin
phpMyAdminのインストール
常にコマンドラインから操作することは面倒であるので、Webブラウザから操作できるphpMyAdminをインストールする。
PHPからMySQLを使用するために必要なパッケージが一式インストールできるので、phpMyAdminを使用する予定がなくても、
インストールしておくと便利である。
# CentOS sudo yum --enablerepo=epel,remi,remi-php73 install phpMyAdmin sudo yum --enablerepo=epel,remi,remi-php73 install php-pecl-mcrypt # SUSE sudo zypper install phpMyAdmin
phpMyAdminの設定
まず、設定ファイルであるconfig.inc.phファイルを編集する。
config.inc.phpファイルに暗号化用のパスフレーズを設定する。これを行わないと、phpMyAdmin上でエラーが表示される。
(設定ファイルに暗号化(blowfish_secret)用の非公開パスフレーズの設定を必要とするようになった)
面倒な時は以下のコマンドを実行して、32桁のパスフレーズを作成する。
sudo openssl rand -base64 100 | fold -w 32 | head -1 出力例 : GgP1/5FMW7Nf3iX1rXmqeQj4k/mHAZDv
設定ファイルはサンプルがあるので、それをコピーして編集する。
sudo cp -a /usr/share/doc/phpMyAdmin-4.9.0.1/config.sample.inc.php /etc/phpMyAdmin/config.inc.php sudo nano /etc/phpMyAdmin/config.inc.php
ファイルの先頭のあたりに、以下の行がある。
$cfg['blowfish_secret']の値に、上記で作成したパスフレーズを入力する。
/** * This is needed for cookie based authentication to encrypt password in * cookie. Needs to be 32 chars long. */ $cfg['blowfish_secret'] = ; /* YOU MUST FILL IN THIS FOR COOKIE AUTH! */
次に、phpMyAdmin.conf”ファイルの設定を行う。
まず、アクセス権に関する設定を行う。(これを行わないとphpMyAdminにアクセスできない)
sudo nano /etc/httpd/conf.d/phpMyAdmin.conf
16行目と30行目にある”Require local”の1つ下の行に以下の設定を追加する。
# Apache 2.4 Require ip 192.168.xxx.0/24
編集を完了したら、Apacheを再起動する。
sudo systemctl restart httpd
Webブラウザから、http://localost/phpmyadmin/ にアクセスし、ログイン画面が表示されることを確認する。
※上記のURLでエラーが表示される場合
もし、下記のようなエラーが出力される場合は、外部と通信しないローカル環境のみのサーバなので、
セッション情報を保存するsessionディレクトリの権限を変更する。
# エラー内容 phpMyAdmin - Error Error during session start; please check your PHP and/or webserver log file and configure your PHP installation properly. Also ensure that cookies are enabled in your browser. session_start(): open(SESSION_FILE, O_RDWR) failed: Permission denied (13) session_start(): Failed to read session data: files (path: /var/lib/php/session) sudo chmod 777 /var/lib/php/session
また、下記のようなエラーが出力される場合は、tempディレクトリの権限を変更する。
# エラー内容 $cfg['TempDir'] (/var/lib/phpMyAdmin/temp/)にアクセスできません。 phpMyAdmin はテンプレートをキャッシュすることができないため、低速になります。 sudo chmod 777 /var/lib/phpMyAdmin/temp
※phpMyAdminにログインできない場合
接続方式を変更するために、rootユーザでMySQLにログインする。
sudo mysql -u root -p
次に、以下のクエリを発行する。
mysql> ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'パスワード'; mysql> FLUSH PRIVILEGES;
最後に、MySQLを再起動する。
sudo systemctl restart mysqld
phpMyAdminにログインできるか確認する。