shell> mysqlaccess [host_name [user_name [db_name]]] [options]

$MYSQL     = '/usr/local/bin/mysql';    # path to mysql executable

mysqladmin是 一个执行管理操作的客户程序。可以用它来检查服务器的配置和当前的状态，创建并删除数据库等等。

这样调用mysqladmin：

shell> mysqladmin [options] command [command-options] [command [command-options]] ...

mysqladmin支 持下面的命令：

·         create db_name

创建一个名为db_name的 新数据库。

·         debug

告诉服务器向错误日志写入调试信息。

·         drop db_name

删除名为db_nam的 数据库和所有表。

·         extended-status

显示服务器状态变量及其值。

·         flush-hosts

刷新主机缓存中的所有信息。

·         flush-logs

刷新所有日志。

·         flush-privileges

重载授权表(类似reload)。

·         flush-status

清除状态变量。

·         flush-tables

刷新所有表。

·         flush-threads

刷新线程缓存。

·         kill id,id,...

杀掉服务器线程。

·         old-password new-password

类似password但使用旧的(pre-4.1)密 码哈希格式保存 密码。(参见5.7.9节，“MySQL 4.1中的密码哈希处理”）。

·         password new-password

设置一个新密码。将用mysqladmin连 接服务器使用的 账户的密码更改为new-password。

如果new-password包 含空格或其它命令解释符的特殊字符，需要用引号将它引起来。在Windows中，一定要使用双引号而不要用单引号；单引号不会 从 密码中剥离出来，而是解释为密码的一部分。例如：

shell> mysqladmin password "my new password"

·         ping

检查服务器是否仍活动。如果服务器在运行mysqladmin返 回状态0，如果不运行返回1。即使出现错误例如Access denied也 为0，因为这说明服务器在运行但拒绝了连接，与服务器不在运行不同。

·         processlist

显示活动服务器线程的列表。类似SHOW PROCESSLIST语句的输出。如果给出了--verbose选项，输出类似SHOW FULL PROCESSLIST。(参见13.5.4.16节，“SHOW PROCESSLIST语法”）。

·         reload

重载授权表。

·         refresh

刷新所有表并关闭和打开日志文件。

·         shutdown

停止服务器。

·         start-slave

开始从服务器上的复制。

·         status

显示短服务器状态消息。

·         stop-slave

停止从服务器上的复制。

·         variables

显示服务器系统变量及其值。

·         version

显示服务器的版本信息。

所有命令可以简化为任何唯一的前缀。例如：

shell> mysqladmin proc stat

+----+-------+-----------+----+---------+------+-------+------------------+

| Id | User  | Host      | db | Command | Time | State | Info             |

+----+-------+-----------+----+---------+------+-------+------------------+

| 51 | monty | localhost |    | Query   | 0    |       | show processlist |

+----+-------+-----------+----+---------+------+-------+------------------+

Uptime: 1473624  Threads: 1  Questions: 39487  

Slow queries: 0  Opens: 541  Flush tables: 1  

Open tables: 19  Queries per second avg: 0.0268

mysqladmin status命令的结果显示下面的值：

·         Uptime

MySQL服务器已经运行的秒 数。

·         Threads

活动线程(客户)的 数目。

·         Questions

服务器启动以来客户的问题(查询)数 目。

·         Slow queries

执行时间超过long_query_time秒 的查询的数量。参见5.11.4节，“慢速查询日志”。

·         Opens

服务器已经打开的数据库表的数量。

·         Flush tables

服务器已经执行的flush ...、refresh和reload命 令的数量。

·         Open tables

目前打开的表的数量。

·         Memory in use

mysqld代 码直接分配的内存数量。只有用--with--debug=full编译了MySQL该值才显示。

·         Maximum memory used

mysqld代 码直接分配的最大内存数量。只有用--with--debug=full编译了MySQL该值才显 示。

如果当使用Unix套接字文件连 接本地服务器时执行mysqladmin shutdown，mysqladmin将 等待直到服务器的进程ID文件被删除，以确保服务器正确停止。

mysqladmin支 持下面的选项：

·         ---help，-？

显示帮助消息并退出。

·         --character-sets-dir=path

字符集的安装目录。参见5.10.1节，“数据 和排序用字符集”。

·         --compress，-C

压缩客户和服务器之间发送的所有信息（如果二者均支持压缩）。

·         --count=num，-c num

迭代数目。该选项只有结合--sleep (-i)才能工作。

·         ---debug[=debug_options]，-# [debug_options]

写调试日志。debug_options字 符串通常为'd:t:o,file_name'。 默认为'd:t:o,/tmp/mysqladmin.trace'。

·         --default-character-set=charset

使用charsetas作 为默认字符集。参见5.10.1节，“数据 和排序用字符集”。

·         --force，-f

不再为drop database命 令进行确认。对于多个命令，即使出现错误也继续。

·         --host=host_name，-h host_name

连接给定主机上的MySQL服务 器。

·         --password[=password]，-p[password]

连接服务器使用的密码。如果使用短选项形式(-p)， 该选项和 密码之间不能有空格。如果你在命令行中在--password或-p选 项后面省略 密码值，将提示你输入密码。

·         --port=port_num，-P port_num

用于连接的TCP/IP端口号。

·         --protocol={TCP | SOCKET | PIPE | MEMORY}

使用的连接协议。

·         --relative，-r

当带-I使用时显示当前和前面值 的差别。目前，该选项只用于extended-status命令。

·         --silent，-s

如果不能建立与服务器的连接则以沉默方式退出。

·         --sleep=delay，-i delay

每睡眠delay秒 后执行一次命令。

·         --socket=path，-S path

用于连接的套接字文件。

·         --user=user_name，-u user_name

当连接服务器时使用的MySQL用 户名。

·         --verbose，-v

冗长模式。打印出程序操作的详细信息。

·         --version，-V

显示版本信息并退出。

·         --vertical，-E

垂直打印输出。类似于--relative， 但垂直打印输出。

·         --wait[=count]，-w[count]

如果连接不能建立，等待并重试而不是放弃。如果给出一个选项值，则指示重试的次数。默认是一次。

也可以使用--var_name=value选 项设置下面的变量：

·         connect_timeout

连接超时之前的最大秒数。默认值为43200(12小 时)。

·         shutdown_timeout

等候关闭的最大秒数。默认值为3600(1小 时)。

也可以使用--set-variable=var_name=value或-O var_name=value语法来设置变量。然而，现在不赞成该语法，并且不再使用。

服务器生成的二进制日志文件写成二进制格式。要想检查这些文本格式的文件，应使用mysqlbinlog实 用工具。

应这样调用mysqlbinlog直接读取二进制日志文件并将它们用于本地MySQL服 务器。也可以使用--read-from-remote-server选项从远程服务器读取二进制日志。

当读取远程二进制日志时，可以通过连接参数选项来指示如何连接服务器，但它们经常被忽略掉，除非你还指定了--read-from-remote-server选 项。这些选项是--host、--password、--port、--protocol、--socket和--user。

还可以使用5.11.3节，“二进制日志”中详细讨论了二进制日志。

mysqlbinlog支 持下面的选项：

·         ---help，-？

显示帮助消息并退出。

·         ---database=db_name，-d db_name

只列出该数据库的条目(只 用本地日志)。

·         --force-read，-f

使用该选项，如果mysqlbinlog读 它不能识别的二进制日志事件，它会打印警告，忽略该事件并继续。没有该选项，如果mysqlbinlog读 到此类事件则停止。

·         --hexdump，-H

在注释中显示日志的十六进制转储。该输出可以帮助复制过程中的调试。在MySQL 5.1.2中添加了该选项。

·         --host=host_name，-h host_name

获取给定主机上的MySQL服 务器的二进制日志。

·         --local-load=path，-l pat

为指定目录中的LOAD DATA INFILE预处理本地临时文件。

·         --offset=N，-o N

跳过前N个 条目。

·         --password[=password]，-p[password]

当连接服务器时使用的密码。如果使用短选项形式(-p)，选项和 密码之间不能有空格。如果在命令行中--password或-p选 项后面没有 密码值，则提示输入一个密码。

·         --port=port_num，-P port_num

用于连接远程服务器的TCP/IP端 口号。

·         --position=N，-j N

不赞成使用，应使用--start-position。

·         --protocol={TCP | SOCKET | PIPE | -position

使用的连接协议。

·         --read-from-remote-server，-R

从MySQL服 务器读二进制日志。如果未给出该选项，任何连接参数选项将被忽略。这些选项是--host、--password、--port、--protocol、--socket和--user。

·         --result-file=name, -r name

将输出指向给定的文件。

·         --short-form，-s

只显示日志中包含的语句，不显示其它信息。

·         --socket=path，-S path

用于连接的套接字文件。

·         --start-datetime=datetime

从二进制日志中第1个 日期时间等于或晚于datetime参量的事件开始读取。datetime值 相对于运行5.9.1节，“数据库备份”)：

shell> mysqlbinlog hostname-bin.000001 | mysql

或：

shell> mysqlbinlog hostname-bin.[0-9]* | mysql

如果你需要先修改含语句的日志，还可以将mysqlbinlog的输出重新指向一个文本文 件。(例如，想删除由于某种原因而不想执行的语句)。编辑好文件后，将它输入到mysql程 序并执行它包含的语句。

mysqlbinlog有 一个--position选项，只打印那些在二进制日志中的偏移量大于或等于某个给定位置的语句(给 出的位置必须匹配一个事件的开始)。它还有在看见给定日期和时间的事件后停止或启动的选项。这样可以使用--stop-datetime选 项进行点对点恢复(例如，能够说“将数据库前滚动到今天10:30 AM的位置”)。

如果MySQL服 务器上有多个要执行的二进制日志，安全的方法是在一个连接中处理它们。下面是一个说明什么是不安全的例子：

shell> mysqlbinlog hostname-bin.000001 | mysql # DANGER!!

shell> mysqlbinlog hostname-bin.000002 | mysql # DANGER!!

使用与服务器的不同连接来处理二进制日志时，如果第1个日志文件包含一个CREATE TEMPORARY TABLE语句，第2个日志包含一个使用该临时表的语句，则会造成问题。当第1个mysql进 程结束时，服务器撤销临时表。当第2个mysql进程想使用该 表时，服务器报告 “不知道该表”。

要想避免此类问题，使用一个连接来执行想要处理的所有二进制日志中的内容。下面提供了一种方法：

shell> mysqlbinlog hostname-bin.000001 hostname-bin.000002 | mysql

另一个方法是：

shell> mysqlbinlog hostname-bin.000001 >  /tmp/statements.sql

shell> mysqlbinlog hostname-bin.000002 >> /tmp/statements.sql

shell> mysql -e "source /tmp/statements.sql"

mysqlbinlog产 生的输出可以不需要原数据文件即可重新生成一个LOAD DATA INFILE操作。mysqlbinlog将 数据复制到一个临时文件并写一个引用该文件的LOAD DATA LOCAL INFILE语句。由系统确定写入这些文件的目 录的默认位置。要想显式指定一个目录，使用--local-load选项。

因为mysqlbinlog可 以将LOAD DATA INFILE语句转换为LOAD DATA LOCAL INFILE语 句(也就是说，它添加了LOCAL)，用于处理语句的客户端和服务器必 须配置为允许LOCAL操作。参见5.6.4节，“LOAD DATA LOCAL安全问题”。

警 告：为LOAD DATA LOCAL语句创建的临时文件不会自动删除，因为在实际执行完那 些语句前需要它们。不再需要语句日志后应自己删除临时文件。文件位于临时文件目录中，文件名类似original_file_name-#-#。

--hexdump选项可以在注释中产生日志内容的十六进制转储：

shell> mysqlbinlog --hexdump master-bin.000001

上述命令的输出应类似：

/*!40019 SET @@session.max_insert_delayed_threads=0*/;

/*!50003 SET @OLD_COMPLETION_TYPE=@@COMPLETION_TYPE,COMPLETION_TYPE=0*/;

# at 4

#051024 17:24:13 server id 1  end_log_pos 98

# Position  Timestamp   Type   Master ID        Size      Master Pos    Flags

# 00000004 9d fc 5c 43   0f   01 00 00 00   5e 00 00 00   62 00 00 00   00 00

# 00000017 04 00 35 2e 30 2e 31 35  2d 64 65 62 75 67 2d 6c |..5.0.15.debug.l|

# 00000027 6f 67 00 00 00 00 00 00  00 00 00 00 00 00 00 00 |og..............|

# 00000037 00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00 |................|

# 00000047 00 00 00 00 9d fc 5c 43  13 38 0d 00 08 00 12 00 |.......C.8......|

# 00000057 04 04 04 04 12 00 00 4b  00 04 1a                |.......K...|

#       Start: binlog v 4, server v 5.0.15-debug-log created 051024 17:24:13

#       at startup

ROLLBACK;

十六进制转储的输出包含下面 的元素：

·         Position: The byte position within the log file.

·         Timestamp: The event timestamp. In the example just shown, '9d fc 5c 43' is the representation of '051024 17:24:13' in hexadecimal.

·         Type: The type of the log event. '0f' means that the example event is a FORMAT_DESCRIPTION_EVENT. The types are:

·                00  UNKNOWN_EVENT

·                    This event should never be present in the log.

·                01  START_EVENT_V3

·                    This indicates the start of a log file written by MySQL 4 or earlier.

·                02  QUERY_EVENT

·                    The most common type of events.  These contain queries executed

·                    on the master.

·                03  STOP_EVENT

·                    Indicates that master has stopped.

·                04  ROTATE_EVENT

·                    Written when the master switches to a new log file.

·                05  INTVAR_EVENT

·                    Used mainly for AUTO_INCREMENT values and if the LAST_INSERT_ID()

·                    function is used in the statement.

·                06  LOAD_EVENT

·                    Used for LOAD DATA INFILE in MySQL 3.23.

·                07  SLAVE_EVENT

·                    Reserved for future use.

·                08  CREATE_FILE_EVENT

·                    Used for LOAD DATA INFILE statements.  This indicates the start

·                    of execution of such a statement.  A temporary file is created

·                    on the slave.  Used in MySQL 4 only.

·                09  APPEND_BLOCK_EVENT

·                    Contains data for use in a LOAD DATA INFILE statement.  The

·                    data is stored in the temporary file on the slave.

·                0a  EXEC_LOAD_EVENT

·                    Used for LOAD DATA INFILE statements.  The contents of the

·                    temporary file is stored in the table on the slave.

·                    Used in MySQL 4 only.

·                0b  DELETE_FILE_EVENT

·                    Rollback of LOAD DATA INFILE statement.  The temporary file

·                    should be deleted on slave.

·                0c  NEW_LOAD_EVENT

·                    Used for LOAD DATA INFILE in MySQL 4 and earlier.

·                0d  RAND_EVENT

·                    Used to send information about random values if the RAND()

·                    function is used in the query.

·                0e  USER_VAR_EVENT

·                    Used to replicate user variables.

·                0f  FORMAT_DESCRIPTION_EVENT

·                    This indicates the start of a log file written by MySQL 5 or later.

·                10  XID_EVENT

·                    Event indicating commit of XA transaction

·                11  BEGIN_LOAD_QUERY_EVENT

·                    Used for LOAD DATA statements in MySQL 5 and later.

·                12  EXECUTE_LOAD_QUERY_EVENT

·                    Used for LOAD DATA statements in MySQL 5 and later.

·                13  TABLE_MAP_EVENT

·                    Reserved for future use

·                14  WRITE_ROWS_EVENT

·                    Reserved for future use

·                15  UPDATE_ROWS_EVENT

·                    Reserved for future use

·                16  DELETE_ROWS_EVENT

·                    Reserved for future use

·         Master ID: The server id of the master that created the event.

·         Size: The size in bytes of the event.

·         Master Pos: The position of the event in the original master log file.

·         Flags: 16 flags.

·                01  LOG_EVENT_BINLOG_IN_USE_F

·                    Log file correctly closed (Used only in FORMAT_DESCRIPTION_EVENT)

·                    If this flag is set (if the flags are e.g. '01 00') in an

·                    FORMAT_DESCRIPTION_EVENT, then the log file has not been

·                    properly closed.  Most probably because of a master crash (for

·                    example, due to power failure).

·                02  Reserved for future use.