Current Path : /usr/opt/mysql57/man/man1/ |
FreeBSD hs32.drive.ne.jp 9.1-RELEASE FreeBSD 9.1-RELEASE #1: Wed Jan 14 12:18:08 JST 2015 root@hs32.drive.ne.jp:/sys/amd64/compile/hs32 amd64 |
Current File : //usr/opt/mysql57/man/man1/mysqlshow.1 |
'\" t .\" Title: mysqlshow .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/> .\" Date: 11/29/2021 .\" Manual: MySQL Database System .\" Source: MySQL 5.7 .\" Language: English .\" .TH "MYSQLSHOW" "1" "11/29/2021" "MySQL 5\&.7" "MySQL Database System" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" mysqlshow \- display database, table, and column information .SH "SYNOPSIS" .HP \w'\fBmysqlshow\ [\fR\fB\fIoptions\fR\fR\fB]\ [\fR\fB\fIdb_name\fR\fR\fB\ [\fR\fB\fItbl_name\fR\fR\fB\ [\fR\fB\fIcol_name\fR\fR\fB]]]\fR\ 'u \fBmysqlshow [\fR\fB\fIoptions\fR\fR\fB] [\fR\fB\fIdb_name\fR\fR\fB [\fR\fB\fItbl_name\fR\fR\fB [\fR\fB\fIcol_name\fR\fR\fB]]]\fR .SH "DESCRIPTION" .PP The \fBmysqlshow\fR client can be used to quickly see which databases exist, their tables, or a table\*(Aqs columns or indexes\&. .PP \fBmysqlshow\fR provides a command\-line interface to several SQL SHOW statements\&. See Section\ \&13.7.5, \(lqSHOW Statements\(rq\&. The same information can be obtained by using those statements directly\&. For example, you can issue them from the \fBmysql\fR client program\&. .PP Invoke \fBmysqlshow\fR like this: .sp .if n \{\ .RS 4 .\} .nf mysqlshow [\fIoptions\fR] [\fIdb_name\fR [\fItbl_name\fR [\fIcol_name\fR]]] .fi .if n \{\ .RE .\} .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} If no database is given, a list of database names is shown\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} If no table is given, all matching tables in the database are shown\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} If no column is given, all matching columns and column types in the table are shown\&. .RE .PP The output displays only the names of those databases, tables, or columns for which you have some privileges\&. .PP If the last argument contains shell or SQL wildcard characters (*, ?, %, or _), only those names that are matched by the wildcard are shown\&. If a database name contains any underscores, those should be escaped with a backslash (some Unix shells require two) to get a list of the proper tables or columns\&. * and ? characters are converted into SQL % and _ wildcard characters\&. This might cause some confusion when you try to display the columns for a table with a _ in the name, because in this case, \fBmysqlshow\fR shows you only the table names that match the pattern\&. This is easily fixed by adding an extra % last on the command line as a separate argument\&. .PP \fBmysqlshow\fR supports the following options, which can be specified on the command line or in the [mysqlshow] and [client] groups of an option file\&. For information about option files used by MySQL programs, see Section\ \&4.2.2.2, \(lqUsing Option Files\(rq\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-help\fR, \fB\-?\fR Display a help message and exit\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-bind\-address=\fR\fB\fIip_address\fR\fR On a computer having multiple network interfaces, use this option to select which interface to use for connecting to the MySQL server\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-character\-sets\-dir=\fR\fB\fIdir_name\fR\fR The directory where character sets are installed\&. See Section\ \&10.15, \(lqCharacter Set Configuration\(rq\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-compress\fR, \fB\-C\fR Compress all information sent between the client and the server if possible\&. See Section\ \&4.2.6, \(lqConnection Compression Control\(rq\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-count\fR Show the number of rows per table\&. This can be slow for non\-MyISAM tables\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-debug[=\fR\fB\fIdebug_options\fR\fR\fB]\fR, \fB\-# [\fR\fB\fIdebug_options\fR\fR\fB]\fR Write a debugging log\&. A typical \fIdebug_options\fR string is d:t:o,\fIfile_name\fR\&. The default is d:t:o\&. .sp This option is available only if MySQL was built using \fBWITH_DEBUG\fR\&. MySQL release binaries provided by Oracle are \fInot\fR built using this option\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-debug\-check\fR Print some debugging information when the program exits\&. .sp This option is available only if MySQL was built using \fBWITH_DEBUG\fR\&. MySQL release binaries provided by Oracle are \fInot\fR built using this option\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-debug\-info\fR Print debugging information and memory and CPU usage statistics when the program exits\&. .sp This option is available only if MySQL was built using \fBWITH_DEBUG\fR\&. MySQL release binaries provided by Oracle are \fInot\fR built using this option\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-default\-character\-set=\fR\fB\fIcharset_name\fR\fR Use \fIcharset_name\fR as the default character set\&. See Section\ \&10.15, \(lqCharacter Set Configuration\(rq\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-default\-auth=\fR\fB\fIplugin\fR\fR A hint about which client\-side authentication plugin to use\&. See Section\ \&6.2.13, \(lqPluggable Authentication\(rq\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-defaults\-extra\-file=\fR\fB\fIfile_name\fR\fR Read this option file after the global option file but (on Unix) before the user option file\&. If the file does not exist or is otherwise inaccessible, an error occurs\&. If \fIfile_name\fR is not an absolute path name, it is interpreted relative to the current directory\&. .sp For additional information about this and other option\-file options, see Section\ \&4.2.2.3, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-defaults\-file=\fR\fB\fIfile_name\fR\fR Use only the given option file\&. If the file does not exist or is otherwise inaccessible, an error occurs\&. If \fIfile_name\fR is not an absolute path name, it is interpreted relative to the current directory\&. .sp Exception: Even with \fB\-\-defaults\-file\fR, client programs read \&.mylogin\&.cnf\&. .sp For additional information about this and other option\-file options, see Section\ \&4.2.2.3, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-defaults\-group\-suffix=\fR\fB\fIstr\fR\fR Read not only the usual option groups, but also groups with the usual names and a suffix of \fIstr\fR\&. For example, \fBmysqlshow\fR normally reads the [client] and [mysqlshow] groups\&. If this option is given as \fB\-\-defaults\-group\-suffix=_other\fR, \fBmysqlshow\fR also reads the [client_other] and [mysqlshow_other] groups\&. .sp For additional information about this and other option\-file options, see Section\ \&4.2.2.3, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-enable\-cleartext\-plugin\fR Enable the mysql_clear_password cleartext authentication plugin\&. (See Section\ \&6.4.1.6, \(lqClient-Side Cleartext Pluggable Authentication\(rq\&.) .sp This option was added in MySQL 5\&.7\&.10\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-get\-server\-public\-key\fR Request from the server the RSA public key that it uses for key pair\-based password exchange\&. This option applies to clients that connect to the server using an account that authenticates with the caching_sha2_password authentication plugin\&. For connections by such accounts, the server does not send the public key to the client unless requested\&. The option is ignored for accounts that do not authenticate with that plugin\&. It is also ignored if RSA\-based password exchange is not needed, as is the case when the client connects to the server using a secure connection\&. .sp If \fB\-\-server\-public\-key\-path=\fR\fB\fIfile_name\fR\fR is given and specifies a valid public key file, it takes precedence over \fB\-\-get\-server\-public\-key\fR\&. .sp For information about the caching_sha2_password plugin, see Section\ \&6.4.1.4, \(lqCaching SHA-2 Pluggable Authentication\(rq\&. .sp The \fB\-\-get\-server\-public\-key\fR option was added in MySQL 5\&.7\&.23\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-host=\fR\fB\fIhost_name\fR\fR, \fB\-h \fR\fB\fIhost_name\fR\fR Connect to the MySQL server on the given host\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-keys\fR, \fB\-k\fR Show table indexes\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-login\-path=\fR\fB\fIname\fR\fR Read options from the named login path in the \&.mylogin\&.cnf login path file\&. A \(lqlogin path\(rq is an option group containing options that specify which MySQL server to connect to and which account to authenticate as\&. To create or modify a login path file, use the \fBmysql_config_editor\fR utility\&. See mysql_config_editor(1)\&. .sp For additional information about this and other option\-file options, see Section\ \&4.2.2.3, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-no\-defaults\fR Do not read any option files\&. If program startup fails due to reading unknown options from an option file, \fB\-\-no\-defaults\fR can be used to prevent them from being read\&. .sp The exception is that the \&.mylogin\&.cnf file is read in all cases, if it exists\&. This permits passwords to be specified in a safer way than on the command line even when \fB\-\-no\-defaults\fR is used\&. To create \&.mylogin\&.cnf, use the \fBmysql_config_editor\fR utility\&. See mysql_config_editor(1)\&. .sp For additional information about this and other option\-file options, see Section\ \&4.2.2.3, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-password[=\fR\fB\fIpassword\fR\fR\fB]\fR, \fB\-p[\fR\fB\fIpassword\fR\fR\fB]\fR The password of the MySQL account used for connecting to the server\&. The password value is optional\&. If not given, \fBmysqlshow\fR prompts for one\&. If given, there must be \fIno space\fR between \fB\-\-password=\fR or \fB\-p\fR and the password following it\&. If no password option is specified, the default is to send no password\&. .sp Specifying a password on the command line should be considered insecure\&. To avoid giving the password on the command line, use an option file\&. See Section\ \&6.1.2.1, \(lqEnd-User Guidelines for Password Security\(rq\&. .sp To explicitly specify that there is no password and that \fBmysqlshow\fR should not prompt for one, use the \fB\-\-skip\-password\fR option\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-pipe\fR, \fB\-W\fR On Windows, connect to the server using a named pipe\&. This option applies only if the server was started with the named_pipe system variable enabled to support named\-pipe connections\&. In addition, the user making the connection must be a member of the Windows group specified by the named_pipe_full_access_group system variable\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-plugin\-dir=\fR\fB\fIdir_name\fR\fR The directory in which to look for plugins\&. Specify this option if the \fB\-\-default\-auth\fR option is used to specify an authentication plugin but \fBmysqlshow\fR does not find it\&. See Section\ \&6.2.13, \(lqPluggable Authentication\(rq\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-port=\fR\fB\fIport_num\fR\fR, \fB\-P \fR\fB\fIport_num\fR\fR For TCP/IP connections, the port number to use\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-print\-defaults\fR Print the program name and all options that it gets from option files\&. .sp For additional information about this and other option\-file options, see Section\ \&4.2.2.3, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-protocol={TCP|SOCKET|PIPE|MEMORY}\fR The transport protocol to use for connecting to the server\&. It is useful when the other connection parameters normally result in use of a protocol other than the one you want\&. For details on the permissible values, see Section\ \&4.2.5, \(lqConnection Transport Protocols\(rq\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-secure\-auth\fR Do not send passwords to the server in old (pre\-4\&.1) format\&. This prevents connections except for servers that use the newer password format\&. .sp As of MySQL 5\&.7\&.5, this option is deprecated; expect it to be removed in a future MySQL release\&. It is always enabled and attempting to disable it (\fB\-\-skip\-secure\-auth\fR, \fB\-\-secure\-auth=0\fR) produces an error\&. Before MySQL 5\&.7\&.5, this option is enabled by default but can be disabled\&. .if n \{\ .sp .\} .RS 4 .it 1 an-trap .nr an-no-space-flag 1 .nr an-break-flag 1 .br .ps +1 \fBNote\fR .ps -1 .br Passwords that use the pre\-4\&.1 hashing method are less secure than passwords that use the native password hashing method and should be avoided\&. Pre\-4\&.1 passwords are deprecated and support for them was removed in MySQL 5\&.7\&.5\&. For account upgrade instructions, see Section\ \&6.4.1.3, \(lqMigrating Away from Pre-4.1 Password Hashing and the mysql_old_password Plugin\(rq\&. .sp .5v .RE .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-server\-public\-key\-path=\fR\fB\fIfile_name\fR\fR The path name to a file in PEM format containing a client\-side copy of the public key required by the server for RSA key pair\-based password exchange\&. This option applies to clients that authenticate with the sha256_password or caching_sha2_password authentication plugin\&. This option is ignored for accounts that do not authenticate with one of those plugins\&. It is also ignored if RSA\-based password exchange is not used, as is the case when the client connects to the server using a secure connection\&. .sp If \fB\-\-server\-public\-key\-path=\fR\fB\fIfile_name\fR\fR is given and specifies a valid public key file, it takes precedence over \fB\-\-get\-server\-public\-key\fR\&. .sp For sha256_password, this option applies only if MySQL was built using OpenSSL\&. .sp For information about the sha256_password and caching_sha2_password plugins, see Section\ \&6.4.1.5, \(lqSHA-256 Pluggable Authentication\(rq, and Section\ \&6.4.1.4, \(lqCaching SHA-2 Pluggable Authentication\(rq\&. .sp The \fB\-\-server\-public\-key\-path\fR option was added in MySQL 5\&.7\&.23\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-shared\-memory\-base\-name=\fR\fB\fIname\fR\fR On Windows, the shared\-memory name to use for connections made using shared memory to a local server\&. The default value is MYSQL\&. The shared\-memory name is case\-sensitive\&. .sp This option applies only if the server was started with the shared_memory system variable enabled to support shared\-memory connections\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-show\-table\-type\fR, \fB\-t\fR Show a column indicating the table type, as in SHOW FULL TABLES\&. The type is BASE TABLE or VIEW\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-socket=\fR\fB\fIpath\fR\fR, \fB\-S \fR\fB\fIpath\fR\fR For connections to localhost, the Unix socket file to use, or, on Windows, the name of the named pipe to use\&. .sp On Windows, this option applies only if the server was started with the named_pipe system variable enabled to support named\-pipe connections\&. In addition, the user making the connection must be a member of the Windows group specified by the named_pipe_full_access_group system variable\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-ssl*\fR Options that begin with \fB\-\-ssl\fR specify whether to connect to the server using encryption and indicate where to find SSL keys and certificates\&. See the section called \(lqCommand Options for Encrypted Connections\(rq\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-status\fR, \fB\-i\fR Display extra information about each table\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-tls\-version=\fR\fB\fIprotocol_list\fR\fR The permissible TLS protocols for encrypted connections\&. The value is a list of one or more comma\-separated protocol names\&. The protocols that can be named for this option depend on the SSL library used to compile MySQL\&. For details, see Section\ \&6.3.2, \(lqEncrypted Connection TLS Protocols and Ciphers\(rq\&. .sp This option was added in MySQL 5\&.7\&.10\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-user=\fR\fB\fIuser_name\fR\fR, \fB\-u \fR\fB\fIuser_name\fR\fR The user name of the MySQL account to use for connecting to the server\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-verbose\fR, \fB\-v\fR Verbose mode\&. Print more information about what the program does\&. This option can be used multiple times to increase the amount of information\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-version\fR, \fB\-V\fR Display version information and exit\&. .RE .SH "COPYRIGHT" .br .PP Copyright \(co 1997, 2021, Oracle and/or its affiliates. .PP This documentation is free software; you can redistribute it and/or modify it only under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License. .PP This documentation is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. .PP You should have received a copy of the GNU General Public License along with the program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA or see http://www.gnu.org/licenses/. .sp .SH "SEE ALSO" For more information, please refer to the MySQL Reference Manual, which may already be installed locally and which is also available online at http://dev.mysql.com/doc/. .SH AUTHOR Oracle Corporation (http://dev.mysql.com/).