MySQL :: MySQL 9.0 参考手册 :: 2.4.3 安装和使用 MySQL 启动守护程序

版本 9.0

8.4 当前
8.0
5.7

8.0 日语

MySQL 9.0 参考手册 / ... / 安装和使用 MySQL 启动守护程序

2.4.3 安装和使用 MySQL 启动守护程序

macOS 使用启动守护程序来自动启动、停止和管理 MySQL 等进程和应用程序。

默认情况下，macOS 上的安装包 (DMG) 会安装一个名为 /Library/LaunchDaemons/com.oracle.oss.mysql.mysqld.plist 的启动守护程序文件，其中包含类似于以下内容的 plist 定义：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>             <string>com.oracle.oss.mysql.mysqld</string>
    <key>ProcessType</key>       <string>Interactive</string>
    <key>Disabled</key>          <false/>
    <key>RunAtLoad</key>         <true/>
    <key>KeepAlive</key>         <true/>
    <key>SessionCreate</key>     <true/>
    <key>LaunchOnlyOnce</key>    <false/>
    <key>UserName</key>          <string>_mysql</string>
    <key>GroupName</key>         <string>_mysql</string>
    <key>ExitTimeOut</key>       <integer>600</integer>
    <key>Program</key>           <string>/usr/local/mysql/bin/mysqld</string>
    <key>ProgramArguments</key>
        <array>
            <string>/usr/local/mysql/bin/mysqld</string>
            <string>--user=_mysql</string>
            <string>--basedir=/usr/local/mysql</string>
            <string>--datadir=/usr/local/mysql/data</string>
            <string>--plugin-dir=/usr/local/mysql/lib/plugin</string>
            <string>--log-error=/usr/local/mysql/data/mysqld.local.err</string>
            <string>--pid-file=/usr/local/mysql/data/mysqld.local.pid</string>
            <string>--keyring-file-data=/usr/local/mysql/keyring/keyring</string>
            <string>--early-plugin-load=keyring_okv=keyring_okv.so</string>
        </array>
    <key>WorkingDirectory</key>  <string>/usr/local/mysql</string>
</dict>
</plist>

注意

一些用户报告说，添加 plist DOCTYPE 声明会导致 launchd 操作失败，尽管它通过了 lint 检查。我们怀疑这是一个复制粘贴错误。包含上述代码段的文件的 md5 校验和为 d925f05f6d1b6ee5ce5451b596d6baed。

要启用 launchd 服务，您可以：

打开 macOS 系统偏好设置，选择 MySQL 首选项面板，然后执行启动 MySQL 服务器。

图 2.6 MySQL 首选项面板：位置

实例页面包含用于启动或停止 MySQL 的选项，初始化数据库重新创建 data/ 目录。卸载卸载 MySQL 服务器以及可选的 MySQL 首选项面板和 launchd 信息。

图 2.7 MySQL 首选项面板：实例

或者，手动加载 launchd 文件。

$> cd /Library/LaunchDaemons
$> sudo launchctl load -F com.oracle.oss.mysql.mysqld.plist

要配置 MySQL 在启动时自动启动，您可以：

$> sudo launchctl load -w com.oracle.oss.mysql.mysqld.plist

注意

升级过程会替换您现有的名为 com.oracle.oss.mysql.mysqld.plist 的 launchd 文件。

其他与 launchd 相关的信息

plist 条目会覆盖 my.cnf 条目，因为它们作为命令行参数传递。有关传入程序选项的更多信息，请参见第 6.2.2 节，“指定程序选项”。
ProgramArguments 部分定义了传递给程序的命令行选项，在本例中为 mysqld 二进制文件。
默认的 plist 定义是在考虑不太复杂的使用场景的情况下编写的。对于更复杂的设置，您可能希望删除一些参数，而是依赖 MySQL 配置文件，例如 my.cnf。
如果您编辑 plist 文件，则在重新安装或升级 MySQL 时，请取消选中安装程序选项。否则，您编辑的 plist 文件将被覆盖，并且所有编辑都将丢失。

由于默认的 plist 定义定义了几个 ProgramArguments，因此您可以删除其中的大多数参数，而是依靠您的 my.cnf MySQL 配置文件来定义它们。例如：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>             <string>com.oracle.oss.mysql.mysqld</string>
    <key>ProcessType</key>       <string>Interactive</string>
    <key>Disabled</key>          <false/>
    <key>RunAtLoad</key>         <true/>
    <key>KeepAlive</key>         <true/>
    <key>SessionCreate</key>     <true/>
    <key>LaunchOnlyOnce</key>    <false/>
    <key>UserName</key>          <string>_mysql</string>
    <key>GroupName</key>         <string>_mysql</string>
    <key>ExitTimeOut</key>       <integer>600</integer>
    <key>Program</key>           <string>/usr/local/mysql/bin/mysqld</string>
    <key>ProgramArguments</key>
        <array>
            <string>/usr/local/mysql/bin/mysqld</string>
            <string>--user=_mysql</string>
            <string>--basedir=/usr/local/mysql</string>
            <string>--datadir=/usr/local/mysql/data</string>
            <string>--plugin-dir=/usr/local/mysql/lib/plugin</string>
            <string>--log-error=/usr/local/mysql/data/mysqld.local.err</string>
            <string>--pid-file=/usr/local/mysql/data/mysqld.local.pid</string>
            <string>--keyring-file-data=/usr/local/mysql/keyring/keyring</string>
            <string>--early-plugin-load=keyring_okv=keyring_okv.so</string>
        </array>
    <key>WorkingDirectory</key>  <string>/usr/local/mysql</string>
</dict>
</plist>

在这种情况下，basedir、datadir、plugin_dir、log_error、pid_file 和 --early-plugin-load 选项已从默认的 plist ProgramArguments 定义中删除，您可能已经在 my.cnf 中定义了这些选项。