Documentation Home
MySQL 5.7 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 35.1Mb
PDF (A4) - 35.2Mb
Man Pages (TGZ) - 256.4Kb
Man Pages (Zip) - 361.2Kb
Info (Gzip) - 3.4Mb
Info (Zip) - 3.4Mb
Excerpts from this Manual

MySQL 5.7 Reference Manual  / ...  / MySQL NDB Cluster 7.5 and NDB Cluster 7.6  / NDB Cluster Programs  /  ndb_show_tables — Display List of NDB Tables

21.5.27 ndb_show_tables — Display List of NDB Tables

ndb_show_tables displays a list of allNDB database objects in the cluster. By default, this includes not only both user-created tables andNDB system tables, butNDB-specific indexes, internal triggers, and NDB Cluster Disk Data objects as well.

Options that can be used withndb_show_tables are shown in the following table. Additional descriptions follow the table.

Table 21.43 Command-line options used with the program ndb_show_tables

FormatDescriptionAdded, Deprecated, or Removed

--character-sets-dir=path

Directory containing character sets

(Supported in all NDB releases based on MySQL 5.7)

--connect-retries=#

Number of times to retry connection before giving up

(Supported in all NDB releases based on MySQL 5.7)

--connect-retry-delay=#

Number of seconds to wait between attempts to contact management server

(Supported in all NDB releases based on MySQL 5.7)

--connect-string=connection_string,

-c connection_string

Same as --ndb-connectstring

(Supported in all NDB releases based on MySQL 5.7)

--core-file

Write core file on error; used in debugging

(Supported in all NDB releases based on MySQL 5.7)

--database=name,

-d name

Specifies database in which table is found; database name must be followed by table name

(Supported in all NDB releases based on MySQL 5.7)

--defaults-extra-file=path

Read given file after global files are read

(Supported in all NDB releases based on MySQL 5.7)

--defaults-file=path

Read default options from given file only

(Supported in all NDB releases based on MySQL 5.7)

--defaults-group-suffix=string

Also read groups with concat(group, suffix)

(Supported in all NDB releases based on MySQL 5.7)

--login-path=path

Read given path from login file

(Supported in all NDB releases based on MySQL 5.7)

--loops=#,

-l #

Number of times to repeat output

(Supported in all NDB releases based on MySQL 5.7)

--help,

-?

Display help text and exit

(Supported in all NDB releases based on MySQL 5.7)

--ndb-connectstring=connection_string,

-c connection_string

Set connect string for connecting to ndb_mgmd. Syntax: "[nodeid=id;][host=]hostname[:port]". Overrides entries in NDB_CONNECTSTRING and my.cnf

(Supported in all NDB releases based on MySQL 5.7)

--ndb-mgmd-host=connection_string,

-c connection_string

Same as --ndb-connectstring

(Supported in all NDB releases based on MySQL 5.7)

--ndb-nodeid=#

Set node ID for this node, overriding any ID set by --ndb-connectstring

(Supported in all NDB releases based on MySQL 5.7)

--ndb-optimized-node-selection

Enable optimizations for selection of nodes for transactions. Enabled by default; use --skip-ndb-optimized-node-selection to disable

(Supported in all NDB releases based on MySQL 5.7)

--no-defaults

Do not read default options from any option file other than login file

(Supported in all NDB releases based on MySQL 5.7)

--parsable,

-p

Return output suitable for MySQL LOAD DATA statement

(Supported in all NDB releases based on MySQL 5.7)

--print-defaults

Print program argument list and exit

(Supported in all NDB releases based on MySQL 5.7)

--show-temp-status

Show table temporary flag

(Supported in all NDB releases based on MySQL 5.7)

--type=#,

-t #

Limit output to objects of this type

(Supported in all NDB releases based on MySQL 5.7)

--unqualified,

-u

Do not qualify table names

(Supported in all NDB releases based on MySQL 5.7)

--usage,

-?

Display help text and exit; same as --help

(Supported in all NDB releases based on MySQL 5.7)

--version,

-V

Display version information and exit

(Supported in all NDB releases based on MySQL 5.7)


Usage

ndb_show_tables [-cconnection_string]
  • --character-sets-dir

    Command-Line Format--character-sets-dir=path

    Directory containing character sets.

  • --connect-retries

    Command-Line Format--connect-retries=#
    TypeInteger
    Default Value12
    Minimum Value0
    Maximum Value12

    Number of times to retry connection before giving up.

  • --connect-retry-delay

    Command-Line Format--connect-retry-delay=#
    TypeInteger
    Default Value5
    Minimum Value0
    Maximum Value5

    Number of seconds to wait between attempts to contact management server.

  • --connect-string

    Command-Line Format--connect-string=connection_string
    TypeString
    Default Value[none]

    Same as--ndb-connectstring.

  • --core-file

    Command-Line Format--core-file

    Write core file on error; used in debugging.

  • --database,-d

    Specifies the name of the database in which the desired table is found. If this option is given, the name of a table must follow the database name.

    If this option has not been specified, and no tables are found in theTEST_DB database,ndb_show_tables issues a warning.

  • --defaults-extra-file

    Command-Line Format--defaults-extra-file=path
    TypeString
    Default Value[none]

    Read given file after global files are read.

  • --defaults-file

    Command-Line Format--defaults-file=path
    TypeString
    Default Value[none]

    Read default options from given file only.

  • --defaults-group-suffix

    Command-Line Format--defaults-group-suffix=string
    TypeString
    Default Value[none]

    Also read groups with concat(group, suffix).

  • --help

    Command-Line Format--help

    Display help text and exit.

  • --login-path

    Command-Line Format--login-path=path
    TypeString
    Default Value[none]

    Read given path from login file.

  • --loops,-l

    Specifies the number of times the utility should execute. This is 1 when this option is not specified, but if you do use the option, you must supply an integer argument for it.

  • --ndb-connectstring

    Command-Line Format--ndb-connectstring=connection_string
    TypeString
    Default Value[none]

    Set connect string for connecting to ndb_mgmd. Syntax: "[nodeid=id;][host=]hostname[:port]". Overrides entries in NDB_CONNECTSTRING and my.cnf.

  • --ndb-mgmd-host

    Command-Line Format--ndb-mgmd-host=connection_string
    TypeString
    Default Value[none]

    Same as--ndb-connectstring.

  • --ndb-nodeid

    Command-Line Format--ndb-nodeid=#
    TypeInteger
    Default Value[none]

    Set node ID for this node, overriding any ID set by--ndb-connectstring.

  • --ndb-optimized-node-selection

    Command-Line Format--ndb-optimized-node-selection

    Enable optimizations for selection of nodes for transactions. Enabled by default; use--skip-ndb-optimized-node-selection to disable.

  • --no-defaults

    Command-Line Format--no-defaults

    Do not read default options from any option file other than login file.

  • --parsable,-p

    Using this option causes the output to be in a format suitable for use withLOAD DATA.

  • --print-defaults

    Command-Line Format--print-defaults

    Print program argument list and exit.

  • --show-temp-status

    If specified, this causes temporary tables to be displayed.

  • --type,-t

    Can be used to restrict the output to one type of object, specified by an integer type code as shown here:

    • 1: System table

    • 2: User-created table

    • 3: Unique hash index

    Any other value causes allNDB database objects to be listed (the default).

  • --unqualified,-u

    If specified, this causes unqualified object names to be displayed.

  • --usage

    Command-Line Format--usage

    Display help text and exit; same as--help.

  • --version

    Command-Line Format--version

    Display version information and exit.

Note

Only user-created NDB Cluster tables may be accessed from MySQL; system tables such asSYSTAB_0 are not visible tomysqld. However, you can examine the contents of system tables usingNDB API applications such asndb_select_all (seeSection 21.5.25, “ndb_select_all — Print Rows from an NDB Table”).

Prior to NDB 7.5.18 and 7.6.14, this program printedNDBT_ProgramExit -status upon completion of its run, due to an unnecessary dependency on theNDBT testing library. This dependency is has now been removed, eliminating the extraneous output.