13.5. Sentencias de administración de base de datos

SHOW [GLOBAL | SESSION] STATUS [LIKE 'pattern']

SHOW STATUS proporciona información de estado del servidor. Esta información puede obtenerse usando el comando mysqladmin extended-status .

Aquí se muestra una salida parcial. La lista de variables y sus vallires pueden ser distintos para su servidor. El significado de cada variable se da en Sección 5.3.4, “Variables de estado del servidor”.

mysql> SHOW STATUS;
+--------------------------+------------+
| Variable_name            | Value      |
+--------------------------+------------+
| Aborted_clients          | 0          |
| Aborted_connects         | 0          |
| Bytes_received           | 155372598  |
| Bytes_sent               | 1176560426 |
| Connections              | 30023      |
| Created_tmp_disk_tables  | 0          |
| Created_tmp_tables       | 8340       |
| Created_tmp_files        | 60         |
...                       ...          ...
| Open_tables              | 1          |
| Open_files               | 2          |
| Open_streams             | 0          |
| Opened_tables            | 44600      |
| Questions                | 2026873    |
...                       ...          ...
| Table_locks_immediate    | 1920382    |
| Table_locks_waited       | 0          |
| Threads_cached           | 0          |
| Threads_created          | 30022      |
| Threads_connected        | 1          |
| Threads_running          | 1          |
| Uptime                   | 80380      |
+--------------------------+------------+

Con una cláusula LIKE , el comando muestra sólo las variables que coinciden con el patrón:

mysql> SHOW STATUS LIKE 'Key%';
+--------------------+----------+
| Variable_name      | Value    |
+--------------------+----------+
| Key_blocks_used    | 14955    |
| Key_read_requests  | 96854827 |
| Key_reads          | 162040   |
| Key_write_requests | 7589728  |
| Key_writes         | 3813196  |
+--------------------+----------+

Las opciones GLOBAL y SESSION son nuevas en MySQL 5.0.2 Con GLOBAL, obtiene los valores de estado para todas las conexiones a MySQL. Con SESSION, obtiene los valores de estado para la conexión actual. Si no usa estas opciones, por defecto es SESSION. LOCAL es sinónimo de SESSION.

Tenga en cuenta que algunas variables de estado sólo tienen un valor global. Para ellas obtiene el mismo valor para GLOBAL y SESSION.

SHOW TABLE STATUS [FROM db_name] [LIKE 'pattern']

SHOW TABLE STATUS funciona como SHOW TABLE, pero proporciona mucha más información acerca de cada tabla. Puede obtener esta lista usando el comando mysqlshow --status db_name . Desde MySQL 5.0.1, este comando también muestra información sobre vistas.

SHOW TABLE STATUS returna los siguientes campos:

En el comentario de tabla, las tablas InnoDB reportan el espacio libre del espacio de tabla al que pertenece la tabla. Para una tabla localizada en el espacio compartido, este es el espacio libre del espacio de tabla compartido. Si usa múltiples espacios y la tabla tiene el suyo, el espacio libre es sólo para esa tabla.

Para tablas MEMORY (HEAP) los valores Data_length, Max_data_length, y Index_length aproximan la cantidad real de memoria reservada. El algoritmo de reserva reserva grandes cantidades de memoria para reducir el número de operaciones de reserva.

Para vistas, todos los campos mostrados por SHOW TABLE STATUS son NULL excepto que Name indicata el nombre de vista y Comment dice view.

SHOW [FULL] TABLES [FROM db_name] [LIKE 'pattern']

SHOW TABLES lista las tablas no TEMPORARY en una base de datos dada. Puede obtener esta lista usando el comando mysqlshow db_name .

Antes de MySQL 5.0.1, la salida de SHOW TABLES contiene una única columna de nombres de tabla. Desde MySQL 5.0.1, este comando lista cualquier vista en la base de datos. Desde MySQL 5.0.2, se soporta el modificador FULL de forma que SHOW FULL TABLES muestra una segunda columna de salida. Los valores para la segunda columna son BASE TABLE para una tabla VIEW para una vista.

Nota: Si no tiene permisos para una tabla, la tabla no se muestra en la salida de SHOW TABLES o mysqlshow db_name.

SHOW TRIGGERS [FROM db_name] [LIKE expr]

SHOW TRIGGERS lista los disparadores definidos en el MySQL server. Se implementó en MySQL 5.0.10.

Para el disparadores ins_sum como se define en Sección 20.3, “Utilización de disparadores”, la salida de este comando es la que se muestra:

mysql> SHOW TRIGGERS LIKE 'acc%';
+---------+--------+---------+-------------------------------+--------+---------+
| Trigger | Event  | Table   | Statement                     | Timing | Created |
+---------+--------+---------+-------------------------------+--------+---------+
| ins_sum | INSERT | account |  SET @sum = @sum + NEW.amount | BEFORE | NULL    |
+---------+--------+---------+-------------------------------+--------+---------+

Nota: Cuando use una cláusula LIKE con SHOW TRIGGERS, la expresión a cumplir (expr) se compara con el nombre de la tabla en que se declara el disparador, y no con el nombre del disparador:

mysql> SHOW TRIGGERS LIKE 'ins%';
Empty set (0.01 sec)

Aquí se muestra una breve explicación de las columnas de la salida de este comando:

Debe tener el permiso SUPER para ejecutar SHOW TRIGGERS.

Consulte Sección 22.1.16, “La tabla INFORMATION_SCHEMA TRIGGERS”.

SHOW [GLOBAL | SESSION] VARIABLES [LIKE 'pattern']

SHOW VARIABLES muestra los valores de algunas variables de sistema de MySQL. Esta información puede obtenerse usando el comando mysqladmin variables .

Con la opción GLOBAL, obtiene los valores que se usan para nuevas conexiones de MySQL. Con SESSION, obtiene los valores que hay en efecto para la conexión actual. Si no usa estas opciones, por defecto es SESSION.

LOCAL es sinónimo de SESSION.

Si los valores por defecto no son adecuados, puede cambiar la mayoría de variables usando opciones de línea de comandos cuando mysqld arranca o en tiempo de ejecución con el comando SET . Consulte Sección 5.3.1, “Opciones del comando mysqld” y Sección 13.5.3, “Sintaxis de SET”.

La salida parcial se muestra aquí. La lista de variables y sus valores pueden ser distintos para su servidor. El significado de cada variable se da en Sección 5.3.3, “Variables de sistema del servidor”. Información acerca de cómo adecuarlos se proporciona en Sección 7.5.2, “Afinar parámetros del servidor”.

mysql> SHOW VARIABLES;
+---------------------------------+---------------------------------------------------------+
| Variable_name                   | Value                                                   |
+---------------------------------+---------------------------------------------------------+
| auto_increment_increment        | 1                                                       |
| auto_increment_offset           | 1                                                       |
| automatic_sp_privileges         | ON                                                      |
| back_log                        | 50                                                      |
| basedir                         | /                                                       |
| bdb_cache_size                  | 8388600                                                 |
| bdb_home                        | /var/lib/mysql/                                         |
| bdb_log_buffer_size             | 32768                                                   |
...                               ...                                                       ...    
| max_connections                 | 100                                                     |
| max_connect_errors              | 10                                                      |
| max_delayed_threads             | 20                                                      |
| max_error_count                 | 64                                                      |
| max_heap_table_size             | 16777216                                                |
| max_join_size                   | 4294967295                                              |
| max_relay_log_size              | 0                                                       |
| max_sort_length                 | 1024                                                    |
...                               ...                                                       ...    
| time_zone                       | SYSTEM                                                  |
| timed_mutexes                   | OFF                                                     |
| tmp_table_size                  | 33554432                                                |
| tmpdir                          |                                                         |
| transaction_alloc_block_size    | 8192                                                    |
| transaction_prealloc_size       | 4096                                                    |
| tx_isolation                    | REPEATABLE-READ                                         |
| updatable_views_with_limit      | YES                                                     |
| version                         | 5.0.7-beta-Max                                          |
| version_bdb                     | Sleepycat Software: Berkeley DB 4.1.24: (June 11, 2005) |
| version_comment                 | MySQL Community Edition - Max (GPL)                     |
| version_compile_machine         | i686                                                    |
| version_compile_os              | pc-linux-gnu                                            |
| wait_timeout                    | 28800                                                   |
+---------------------------------+---------------------------------------------------------+   

Con una cláusula LIKE , el comando muestra sólo las variables que coinciden con el patrón:

mysql> SHOW VARIABLES LIKE 'have%';
+-----------------------+----------+
| Variable_name         | Value    |
+-----------------------+----------+
| have_archive          | NO       |
| have_bdb              | YES      |
| have_blackhole_engine | YES      |
| have_compress         | YES      |
| have_crypt            | YES      |
| have_csv              | YES      |
| have_example_engine   | YES      |
| have_federated_engine | YES      |
| have_geometry         | YES      |
| have_innodb           | YES      |
| have_isam             | NO       |
| have_ndbcluster       | DISABLED |
| have_openssl          | NO       |
| have_query_cache      | YES      |
| have_raid             | NO       |
| have_rtree_keys       | YES      |
| have_symlink          | YES      |
+-----------------------+----------+ 

SHOW WARNINGS [LIMIT [offset,] row_count]
SHOW COUNT(*) WARNINGS

SHOW WARNINGS muestra los mensajes de error, advertencia y notas retornadas por el último comando que haya generado algún mensaje, o nada si el último mensaje que haya usado una tabla no haya generado mensajes. Un comando relacionado, SHOW ERRORS, sólo muestra los errores. Consulte Sección 13.5.4.9, “Sintaxis de SHOW ERRORS”.

La lista de mensajes se resetea para cada nuevo comando que use una tabla.

El comando SHOW COUNT(*) WARNINGS muestra el número total de errores, advertencias y notas. Puede recibir este número de la variable warning_count :

SHOW COUNT(*) WARNINGS;
SELECT @@warning_count;

El valor de warning_count puede ser mayor que el número de mensajes mostrados por SHOW WARNINGS si la variable de sistema max_error_count tiene un valor tan pequeño que no se almacenen todos los mensajes. Se muestra posteriormente un ejemplo de cómo puede pasar esto.

La cláusula LIMIT tiene la misma sintaxis que para el comando SELECT . Consulte Sección 13.2.7, “Sintaxis de SELECT”.

El servidor MySQL devuelve el número total de errores, advertencias, y notas que hayan resultado desde el último comando. Si usa la API de C, este valor puede obtenerse llamando a mysql_warning_count(). Consulte Sección 24.3.3.63, “mysql_warning_count()”.

Las advertencias se generan para comandos tales como LOAD DATA INFILE y comandos DML tales como INSERT, UPDATE, CREATE TABLE, y ALTER TABLE.

El siguiente comando DROP TABLE provoca una nota:

mysql> DROP TABLE IF EXISTS no_such_table;
mysql> SHOW WARNINGS;
+-------+------+-------------------------------+
| Level | Code | Message                       |
+-------+------+-------------------------------+
| Note  | 1051 | Unknown table 'no_such_table' |
+-------+------+-------------------------------+

Aquí hay un ejemplo simple que muesta una advertencia de sintaxis para CREATE TABLE y advertencias de conversiones para INSERT:

mysql> CREATE TABLE t1 (a TINYINT NOT NULL, b CHAR(4)) TYPE=MyISAM;
Query OK, 0 rows affected, 1 warning (0.00 sec)
mysql> SHOW WARNINGS\G
*************************** 1. row ***************************
  Level: Warning
   Code: 1287
Message: 'TYPE=storage_engine' is deprecated, use
         'ENGINE=storage_engine' instead
1 row in set (0.00 sec)

mysql> INSERT INTO t1 VALUES(10,'mysql'),(NULL,'test'),
    -> (300,'Open Source');
Query OK, 3 rows affected, 4 warnings (0.01 sec)
Records: 3  Duplicates: 0  Warnings: 4

mysql> SHOW WARNINGS\G
*************************** 1. row ***************************
  Level: Warning
   Code: 1265
Message: Data truncated for column 'b' at row 1
*************************** 2. row ***************************
  Level: Warning
   Code: 1263
Message: Data truncated, NULL supplied to NOT NULL column 'a' at row 2
*************************** 3. row ***************************
  Level: Warning
   Code: 1264
Message: Data truncated, out of range for column 'a' at row 3
*************************** 4. row ***************************
  Level: Warning
   Code: 1265
Message: Data truncated for column 'b' at row 3
4 rows in set (0.00 sec)

El máximo número de errores, advertencias y notas a almacenar se controla mediante la variable de sistema max_error_count. Por defecto, su valor es 64. Para cambiar el número de mensajes que quiere almacenar, cambie el valor de max_error_count. En el siguiente ejemplo, el comando ALTER TABLE produce tres mensajes de advertencia, pero sólo se almacena uno porque max_error_count vale 1:

mysql> SHOW VARIABLES LIKE 'max_error_count';
+-----------------+-------+
| Variable_name   | Value |
+-----------------+-------+
| max_error_count | 64    |
+-----------------+-------+
1 row in set (0.00 sec)

mysql> SET max_error_count=1;
Query OK, 0 rows affected (0.00 sec)

mysql> ALTER TABLE t1 MODIFY b CHAR;
Query OK, 3 rows affected, 3 warnings (0.00 sec)
Records: 3  Duplicates: 0  Warnings: 3

mysql> SELECT @@warning_count;
+-----------------+
| @@warning_count |
+-----------------+
|               3 |
+-----------------+
1 row in set (0.01 sec)

mysql> SHOW WARNINGS;
+---------+------+----------------------------------------+
| Level   | Code | Message                                |
+---------+------+----------------------------------------+
| Warning | 1263 | Data truncated for column 'b' at row 1 |
+---------+------+----------------------------------------+
1 row in set (0.00 sec)

Para deshabilitar las advertencias, ponga max_error_count a 0. En este caso, warning_count indica cuántas advertencias ocurren, pero ninguno de los mensajes se almacenan.

Desde MySQL 5.0.3, puede poner la variable de sesión SQL_NOTES a 0 para que las advertencias del nivel Note no se guarden.