Skip navigation links
MySQL 5.0 Reference Manual :: 8 Programas cliente y utilidades MySQL :: 8.4 Administrar un servidor MySQL con mysqladmin
8.5 La utilidad mysqlbinlog para registros binarios »
Section Navigation      [Toggle]

8.4. Administrar un servidor MySQL con mysqladmin

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:

  • create nombre_base_de_datos

    Crea una nueva base de datos llamada nombre_base_de_datos.

  • debug

    Le dice al servidor que escriba información de depuración en el log de error.

  • drop nombre_base_de_datos

    Borra la base de datos llamada nombre_base_de_datos y todas sus tablas.

  • extended-status

    Muestra las variables de estado del servidor y sus valores.

  • flush-hosts

    Vuelca toda la información en la caché del equipo.

  • flush-logs

    Vuelca todos los logs.

  • flush-privileges

    Recarga las tablas de permisos (lo mismo que reload).

  • flush-status

    Limpia las variables de estado.

  • flush-tables

    Vuelca todas las tablas.

  • flush-threads

    Vuelca la caché de threads.

  • kill id,id,...

    Mata los threads del servidor.

  • old-password nueva_contraseña

    Es como el comando password pero 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”.)

  • password nueva_contraseña

    Introduce una nueva contraseña. Esto cambia la contraseña a nueva_contraseña para la cuenta que usa con mysqladmin para conectar con el servidor.

    Si nueva_contraseña contiene 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"

  • ping

    Comprueba 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.

  • processlist

    Muestra 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 de SHOW FULL PROCESSLIST. (Consulte Sección 13.5.4.16, “Sintaxis de SHOW PROCESSLIST”.)

  • reload

    Recarga las tablas de permisos.

  • refresh

    Vuelca todas las tablas y cierra y abre los ficheros de logs.

  • shutdown

    Detiene el servidor.

  • start-slave

    Comienza la replicación en un servidor esclavo.

  • status

    Muestra un mensaje de estado corto del servidor.

  • stop-slave

    Detiene la replicación en un servidor esclavo.

  • variables

    Muestra las variables de sistema del servidor y sus valores.

  • version

    Muestra 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:

  • Uptime

    Número de segundos que MySQL server ha estado en ejecución.

  • Threads

    Número de threads activos (clientes).

  • Questions

    Número de preguntas (consultas) de los clientes desde el arranque del servidor.

  • Slow queries

    Número de consultas que han tardado más de long_query_time segundos. Consulte Sección 5.10.4, “El registro de consultas lentas (Slow Query Log)”.

  • Opens

    Número de tablas que el servidor ha abierto.

  • Flush tables

    Número de comandos flush ..., refresh y reload ejecutados.

  • Open tables

    Número de tablas abiertas actualmente.

  • Memory in use

    Cantidad 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 used

    La 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=ruta

    Directorio 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, -C

    Comprime 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ón a menudo es 'd:t:o,nombre_de_fichero'. Por defecto es 'd:t:o,/tmp/mysqladmin.trace'.

  • --default-character-set=conjunto_de_caracteres

    Usa conjunto_de_caracteres como el conjunto de caracteres por defecto. Consulte Sección 5.9.1, “El conjunto de caracteres utilizado para datos y ordenación”.

  • --force, -f

    No pide confirmación para el comando drop database. Con comandos múltiples, continúa incluso si hay un error.

  • --host=nombre_de_equipo, -h nombre_de_equipo

    Conecta 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 valor contraseña siguiente a la opción --password o -p en la línea de comando, aparece un prompt pidiéndola.

  • --port=número_de_puerto, -P número_de_puerto

    Puerto TCP/IP para usar en las conexiones.

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

    Protocolo de conexión en uso. Nuevo en MySQL 4.1.

  • --relative, -r

    Muestra la diferencia entre los valores actuales y anteriores cuando se usa con -i. Actualmente, esta opción sólo funciona con el comando extended-status.

  • --silent, -s

    Sale silenciosamente si no puede establecerse una conexión con el servidor.

  • --sleep=retraso, -i retraso

    Ejecuta comandos una y otra vez, durmiendo durante retraso segundos entre ellos.

  • --socket=ruta, -S ruta

    El fichero socket a usar en la conexión.

  • --user=nombre_de_usuario, -u nombre_de_usuario

    Nombre de usuario MySQL a usar al conectar con el servidor.

  • --verbose, -v

    Modo explícito. Muestra más información sobre lo que hace el programa.

  • --version, -V

    Muestra información sobre la versión y sale.

  • --vertical, -E

    Muestra 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_timeout

    El número de segundos máximos antes que la conexión dé un timeout. El valor por defecto es 43200 (12 horas).

  • shutdown_timeout

    El 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.

Ésta es una traducción del manual de referencia de MySQL, que puede encontrarse en dev.mysql.com. El manual de referencia original de MySQL está escrito en inglés, y esta traducción no necesariamente está tan actualizada como la versión original. Para cualquier sugerencia sobre la traducción y para señalar errores de cualquier tipo, no dude en dirigirse a mysql-es@vespito.com.