mysqladmin es un cliente para realizar operaciones administrativas. Se puede usar para comprobar la configuración y el estado actual del servidor, crear y borrar bases de datos, y con más finalidades.
Invoque mysqladmin así:
shell> mysqladmin [opciones]comando[opciones_de_comando]comando...
mysqladmin soporta los siguientes comandos:
-
createnombre_base_de_datosCrea una nueva base de datos llamada
nombre_base_de_datos. -
debugLe dice al servidor que escriba información de depuración en el log de error.
-
dropnombre_base_de_datosBorra la base de datos llamada
nombre_base_de_datosy todas sus tablas. -
extended-statusMuestra las variables de estado del servidor y sus valores.
-
flush-hostsVuelca toda la información en la caché del equipo.
-
flush-logsVuelca todos los logs.
-
flush-privilegesRecarga las tablas de permisos (lo mismo que
reload). -
flush-statusLimpia las variables de estado.
-
flush-tablesVuelca todas las tablas.
-
flush-threadsVuelca la caché de threads.
-
kill id,id,...Mata los threads del servidor.
-
old-passwordnueva_contraseñaEs como el comando
passwordpero guarda la contraseña usando el formato de hash antiguo (pre-4.1). Consulte Sección 5.6.9, “Hashing de contraseñas en MySQL 4.1”.) -
passwordnueva_contraseñaIntroduce una nueva contraseña. Esto cambia la contraseña a
nueva_contraseñapara la cuenta que usa con mysqladmin para conectar con el servidor.Si
nueva_contraseñacontiene espacios u otros caracteres que son especiales para su intérprete de comandos, debe ponerla entre comillas. En Windows, aségurese de usar comillas dobles en lugar de simples; comillas simples no se eliminan de la contraseña sino que se interpretan como parte del acontraseña. Por ejemplo:shell> mysqladmin password "mi nueva contraseña"
-
pingComprueba si el servidor está vivo. El estado retornado por mysqladmin es 0 si el servidor está en ejecución, 1 si no lo está. En MySQL 5.0, el estado es 0 incluso en caso de un error tal como
Access denied, ya que esto significa que el servidor está en ejecución pero no ha admitido la conexión, lo que no es lo mismo que el servidor no esté en ejecución. -
processlistMuestra una lista de los threads activos del servidor. Esto es como la salida del comando
SHOW PROCESSLIST. Si se da la opción--verbose, la salida es como la deSHOW FULL PROCESSLIST. (Consulte Sección 13.5.4.16, “Sintaxis deSHOW PROCESSLIST”.) -
reloadRecarga las tablas de permisos.
-
refreshVuelca todas las tablas y cierra y abre los ficheros de logs.
-
shutdownDetiene el servidor.
-
start-slaveComienza la replicación en un servidor esclavo.
-
statusMuestra un mensaje de estado corto del servidor.
-
stop-slaveDetiene la replicación en un servidor esclavo.
-
variablesMuestra las variables de sistema del servidor y sus valores.
-
versionMuestra información de la versión del servidor.
Todos los comandos pueden abreviarse a un prefijo único. Por ejemplo:
shell> mysqladmin proc stat +----+------+-----------+----+---------+------+-------+------------------+ | Id | User | Host | db | Command | Time | State | Info | +----+------+-----------+----+---------+------+-------+------------------+ | 51 | root | 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 Memory in use: 92M Max memory used: 410M
El comando mysqladmin status muestra los siguientes valores:
-
UptimeNúmero de segundos que MySQL server ha estado en ejecución.
-
ThreadsNúmero de threads activos (clientes).
-
QuestionsNúmero de preguntas (consultas) de los clientes desde el arranque del servidor.
-
Slow queriesNúmero de consultas que han tardado más de
long_query_timesegundos. Consulte Sección 5.10.4, “El registro de consultas lentas (Slow Query Log)”. -
OpensNúmero de tablas que el servidor ha abierto.
-
Flush tablesNúmero de comandos
flush ...,refreshyreloadejecutados. -
Open tablesNúmero de tablas abiertas actualmente.
-
Memory in useCantidad de memoria reservada directamente por el código de mysqld. Este valor se muestra sólo cuando MySQL es ha compilado con
--with-debug=full. -
Maximum memory usedLa cantidad máxima de memoria reservada directamente por el código de mysqld. Este valor se muestra sólo cuando MySQL se ha compilado con
--with-debug=full.
Si ejecuta mysqladmin shutdown al conectar a un servidor local usando ficheros socket Unix, mysqladmin espera hasta que el fichero con el ID del proceso del servidor se haya borrado, para asegurar que el servidor se ha parado correctamente.
mysqladmin soporta las siguientes opciones:
-
--help,-?Muestra un mensaje de ayuda y sale.
-
--character-sets-dir=rutaDirectorio donde están instalados los conjuntos de caracteres. Consulte Sección 5.9.1, “El conjunto de caracteres utilizado para datos y ordenación”.
-
--compress,-CComprime toda la información enviada entre el cliente y el servidor, si ambos soportan compresión.
-
--count=#,-c#Número de iteraciones a realizar en la ejecución de comandos repetidos. Esto funciona sólo con
--sleep(-i). -
--debug[=opciones_de_depuración],-# [opciones_de_depuración]Escribe un log de depuración. La cadena de caracteres
opciones_de_depuracióna menudo es'd:t:o,nombre_de_fichero'. Por defecto es'd:t:o,/tmp/mysqladmin.trace'. -
--default-character-set=conjunto_de_caracteresUsa
conjunto_de_caracterescomo el conjunto de caracteres por defecto. Consulte Sección 5.9.1, “El conjunto de caracteres utilizado para datos y ordenación”. -
--force,-fNo pide confirmación para el comando
drop database. Con comandos múltiples, continúa incluso si hay un error. -
--host=nombre_de_equipo,-hnombre_de_equipoConecta con el servidor MySQL en un equipo dado.
-
--password[=contraseña],-p[contraseña]La contraseña a usar cuando conecta con el servidor. Si usa la forma corta de la opción (
-p), no puede haber un espacio entre la opción y la contraseña. Si omite el valorcontraseñasiguiente a la opción--passwordo-pen la línea de comando, aparece un prompt pidiéndola. -
--port=número_de_puerto,-Pnúmero_de_puertoPuerto TCP/IP para usar en las conexiones.
-
--protocol={TCP | SOCKET | PIPE | MEMORY}Protocolo de conexión en uso. Nuevo en MySQL 4.1.
-
--relative,-rMuestra la diferencia entre los valores actuales y anteriores cuando se usa con
-i. Actualmente, esta opción sólo funciona con el comandoextended-status. -
--silent,-sSale silenciosamente si no puede establecerse una conexión con el servidor.
-
--sleep=retraso,-iretrasoEjecuta comandos una y otra vez, durmiendo durante
retrasosegundos entre ellos. -
--socket=ruta,-SrutaEl fichero socket a usar en la conexión.
-
--user=nombre_de_usuario,-unombre_de_usuarioNombre de usuario MySQL a usar al conectar con el servidor.
-
--verbose,-vModo explícito. Muestra más información sobre lo que hace el programa.
-
--version,-VMuestra información sobre la versión y sale.
-
--vertical,-EMuestra la salida (output) verticalmente. Es similar a
--relative, pero la salida es vertical. -
--wait[=#],-w[#]Si la conexión no puede establecerse, espera y vuelve a intentarlo en lugar de abortar. Si se da un valor de opción, indica el número de veces a reintentar. El valor por defecto es una vez.
Puede asignar valores a las siguientes variables usando las
opciones
--nombre_de_variable=valor
:
-
connect_timeoutEl número de segundos máximos antes que la conexión dé un timeout. El valor por defecto es 43200 (12 horas).
-
shutdown_timeoutEl número máximo de segundos a esperar para la parada del servidor. El valor por defecto es 3600 (1 hora).
También es posible asignar valores a las variables usando la
sintaxis
--set-variable=nombre_de_variable=valor
o -O
nombre_de_variable=valor.
Sin embargo, esta sintaxis está obsoleta desde MySQL 4.0.