La sentencia SHOW TABLES muestra el esquema, el nombre de la tabla, el tipo de tabla, el propietario y el número estimado de filas de las tablas o vistas de un esquema o base de datos.
Mientras se elimina una tabla o vista, SHOW TABLES listará el objeto con un sufijo (dropped).
Sinopsis
Privilegios requeridos
Se requiere el privilegio SELECT sobre una tabla para listarla con SHOW TABLES.
Parámetros
| Parámetro | Descripción |
|---|---|
database_name |
El nombre de la base de datos para la que mostrar las tablas. |
schema_name |
El nombre del esquema para el que mostrar las tablas. |
Cuando se omite un database_name y schema_name se listan las tablas del esquema actual en la base de datos actual.
SHOW TABLES intentará encontrar primero un esquema con el nombre especificado. Si eso falla, intentará encontrar una base de datos con ese nombre en su lugar, y listará las tablas de su public esquema. Para más detalles, consulte Resolución de nombres.
Ejemplos
Configuración
Los siguientes ejemplos utilizan MovR, una aplicación ficticia para compartir vehículos, para demostrar las sentencias SQL de CockroachDB. Para obtener más información sobre la aplicación de ejemplo MovR y el conjunto de datos, consulte MovR: A Global Vehicle-sharing App.
Para seguir, ejecuta cockroach demo para iniciar un clúster temporal en memoria con el conjunto de datos movr precargado:
$ cockroach demoMostrar las tablas de la base de datos actual
SHOW TABLES utiliza el esquema actual public establecido por defecto en search_path:
> SHOW TABLES; schema_name | table_name | type | estimated_row_count--------------+----------------------------+-------+---------------------- public | promo_codes | table | 1000 public | rides | table | 500 public | user_promo_codes | table | 0 public | users | table | 50 public | vehicle_location_histories | table | 1000 public | vehicles | table | 15(6 rows)Alternativamente, dentro de la shell SQL incorporada, puede utilizar el comando de la shell \dt:
> \dt schema_name | table_name | type | estimated_row_count--------------+----------------------------+-------+---------------------- public | promo_codes | table | 1000 public | rides | table | 500 public | user_promo_codes | table | 0 public | users | table | 50 public | vehicle_location_histories | table | 1000 public | vehicles | table | 15(6 rows)Mostrar tablas en un esquema diferente
Puede mostrar las tablas en esquemas distintos al actual. También puedes mostrar el esquema por tabla:
> SHOW TABLES FROM movr.information_schema;> SHOW TABLES FROM information_schema;Porque movr es la base de datos actual, estas sentencias devuelven la misma salida:
schema_name | table_name | type | estimated_row_count---------------------+-----------------------------------+-------+---------------------- information_schema | administrable_role_authorizations | table | NULL information_schema | applicable_roles | table | NULL information_schema | check_constraints | table | NULL information_schema | column_privileges | table | NULL ...(23 rows)Mostrar tablas en una base de datos diferente
También puedes mostrar tablas de una base de datos diferente.
> SHOW TABLES FROM system.public;> SHOW TABLES FROM system;Porque public es el esquema actual, estas sentencias devuelven la misma salida:
schema_name | table_name | type | estimated_row_count--------------+---------------------------------+-------+---------------------- public | comments | table | NULL public | descriptor | table | NULL public | eventlog | table | NULL public | jobs | table | NULL ...(29 rows)Puedes usar COMMENT ON para añadir comentarios en una tabla.
> COMMENT ON TABLE users IS 'This table contains information about users.';Para ver los comentarios de una tabla:
> SHOW TABLES FROM movr WITH COMMENT; schema_name | table_name | type | estimated_row_count | comment--------------+----------------------------+-------+---------------------+----------------------------------------------- public | promo_codes | table | 1000 | public | rides | table | 500 | public | user_promo_codes | table | 0 | public | users | table | 50 | This table contains information about users. public | vehicle_location_histories | table | 1000 | public | vehicles | table | 15 |(6 rows)También puedes ver los comentarios de una tabla con SHOW CREATE:
> SHOW CREATE TABLE users; table_name | create_statement-------------+--------------------------------------------------------------------------- users | CREATE TABLE users ( | id UUID NOT NULL, | city VARCHAR NOT NULL, | name VARCHAR NULL, | address VARCHAR NULL, | credit_card VARCHAR NULL, | CONSTRAINT "primary" PRIMARY KEY (city ASC, id ASC), | FAMILY "primary" (id, city, name, address, credit_card) | ); | COMMENT ON TABLE users IS 'This table contains information about users.'(1 row)Para más información, consulta COMMENT ON.
Las tablas virtuales de los esquemas pg_cataloginformation_schema y crdb_internal contienen comentarios útiles, a menudo con enlaces a más documentación.
Para ver las tablas virtuales con comentarios y enlaces de documentación, utiliza SHOW TABLES FROM <virtual schema> WITH COMMENT:
> SHOW TABLES FROM information_schema WITH COMMENT;