### 23.5.9 ndb\_desc — Describe NDB Tables

[]()

[**ndb\_desc**](mysql-cluster-programs-ndb-desc.html) provides a detailed description of one or more [`NDB`](mysql-cluster.html) tables.

#### Usage

```
ndb_desc -c connection_string tbl_name -d db_name [options]

ndb_desc -c connection_string index_name -d db_name -t tbl_name
```

 Additional options that can be used with [**ndb\_desc**](mysql-cluster-programs-ndb-desc.html) are listed later in this section.

#### Sample Output

 MySQL table creation and population statements:

```
USE test;

CREATE TABLE fish (
    id INT NOT NULL AUTO_INCREMENT,
    name VARCHAR(20) NOT NULL,
    length_mm INT NOT NULL,
    weight_gm INT NOT NULL,

    PRIMARY KEY pk (id),
    UNIQUE KEY uk (name)
) ENGINE=NDB;

INSERT INTO fish VALUES
    (NULL, 'guppy', 35, 2), (NULL, 'tuna', 2500, 150000),
    (NULL, 'shark', 3000, 110000), (NULL, 'manta ray', 1500, 50000),
    (NULL, 'grouper', 900, 125000), (NULL ,'puffer', 250, 2500);
```

 Output from [**ndb\_desc**](mysql-cluster-programs-ndb-desc.html):

```
$> ./ndb_desc -c localhost fish -d test -p
-- fish --
Version: 2
Fragment type: HashMapPartition
K Value: 6
Min load factor: 78
Max load factor: 80
Temporary table: no
Number of attributes: 4
Number of primary keys: 1
Length of frm data: 337
Max Rows: 0
Row Checksum: 1
Row GCI: 1
SingleUserMode: 0
ForceVarPart: 1
PartitionCount: 2
FragmentCount: 2
PartitionBalance: FOR_RP_BY_LDM
ExtraRowGciBits: 0
ExtraRowAuthorBits: 0
TableStatus: Retrieved
Table options:
HashMap: DEFAULT-HASHMAP-3840-2
-- Attributes --
id Int PRIMARY KEY DISTRIBUTION KEY AT=FIXED ST=MEMORY AUTO_INCR
name Varchar(20;latin1_swedish_ci) NOT NULL AT=SHORT_VAR ST=MEMORY DYNAMIC
length_mm Int NOT NULL AT=FIXED ST=MEMORY DYNAMIC
weight_gm Int NOT NULL AT=FIXED ST=MEMORY DYNAMIC
-- Indexes --
PRIMARY KEY(id) - UniqueHashIndex
PRIMARY(id) - OrderedIndex
uk(name) - OrderedIndex
uk$unique(name) - UniqueHashIndex
-- Per partition info --
Partition       Row count       Commit count    Frag fixed memory       Frag varsized memory    Extent_space    Free extent_space
0               2               2               32768                   32768                   0               0
1               4               4               32768                   32768                   0               0

NDBT_ProgramExit: 0 - OK
```

 Information about multiple tables can be obtained in a single invocation of [**ndb\_desc**](mysql-cluster-programs-ndb-desc.html) by using their names, separated by spaces. All of the tables must be in the same database.

 You can obtain additional information about a specific index using the `--table` (short form: `-t`) option and supplying the name of the index as the first argument to [**ndb\_desc**](mysql-cluster-programs-ndb-desc.html), as shown here:

```
$> ./ndb_desc uk -d test -t fish
-- uk --
Version: 2
Base table: fish
Number of attributes: 1
Logging: 0
Index type: OrderedIndex
Index status: Retrieved
-- Attributes --
name Varchar(20;latin1_swedish_ci) NOT NULL AT=SHORT_VAR ST=MEMORY
-- IndexTable 10/uk --
Version: 2
Fragment type: FragUndefined
K Value: 6
Min load factor: 78
Max load factor: 80
Temporary table: yes
Number of attributes: 2
Number of primary keys: 1
Length of frm data: 0
Max Rows: 0
Row Checksum: 1
Row GCI: 1
SingleUserMode: 2
ForceVarPart: 0
PartitionCount: 2
FragmentCount: 2
FragmentCountType: ONE_PER_LDM_PER_NODE
ExtraRowGciBits: 0
ExtraRowAuthorBits: 0
TableStatus: Retrieved
Table options:
-- Attributes --
name Varchar(20;latin1_swedish_ci) NOT NULL AT=SHORT_VAR ST=MEMORY
NDB$TNODE Unsigned [64] PRIMARY KEY DISTRIBUTION KEY AT=FIXED ST=MEMORY
-- Indexes --
PRIMARY KEY(NDB$TNODE) - UniqueHashIndex

NDBT_ProgramExit: 0 - OK
```

 When an index is specified in this way, the [`--extra-partition-info`](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_extra-partition-info) and [`--extra-node-info`](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_extra-node-info) options have no effect.

 The `Version` column in the output contains the table's schema object version. For information about interpreting this value, see [NDB Schema Object Versions](https://dev.mysql.com/doc/ndb-internals/en/ndb-internals-schema-object-versions.html).

 Three of the table properties that can be set using `NDB_TABLE` comments embedded in [`CREATE TABLE`](create-table.html) and [`ALTER TABLE`](alter-table.html) statements are also visible in [**ndb\_desc**](mysql-cluster-programs-ndb-desc.html) output. The table's `FRAGMENT_COUNT_TYPE` is always shown in the `FragmentCountType` column. `READ_ONLY` and `FULLY_REPLICATED`, if set to 1, are shown in the `Table options` column. You can see this after executing the following [`ALTER TABLE`](alter-table.html) statement in the [**mysql**](mysql.html) client:

```
mysql> ALTER TABLE fish COMMENT='NDB_TABLE=READ_ONLY=1,FULLY_REPLICATED=1';
1 row in set, 1 warning (0.00 sec)

mysql> SHOW WARNINGS\G
+---------+------+---------------------------------------------------------------------------------------------------------+
| Level   | Code | Message                                                                                                 |
+---------+------+---------------------------------------------------------------------------------------------------------+
| Warning | 1296 | Got error 4503 'Table property is FRAGMENT_COUNT_TYPE=ONE_PER_LDM_PER_NODE but not in comment' from NDB |
+---------+------+---------------------------------------------------------------------------------------------------------+
1 row in set (0.00 sec)
```

 The warning is issued because `READ_ONLY=1` requires that the table's fragment count type is (or be set to) `ONE_PER_LDM_PER_NODE_GROUP`; `NDB` sets this automatically in such cases. You can check that the `ALTER TABLE` statement has the desired effect using [`SHOW CREATE TABLE`](show-create-table.html):

```
mysql> SHOW CREATE TABLE fish\G
*************************** 1. row ***************************
       Table: fish
Create Table: CREATE TABLE `fish` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `name` varchar(20) NOT NULL,
  `length_mm` int(11) NOT NULL,
  `weight_gm` int(11) NOT NULL,
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk` (`name`)
) ENGINE=ndbcluster DEFAULT CHARSET=latin1
COMMENT='NDB_TABLE=READ_BACKUP=1,FULLY_REPLICATED=1'
1 row in set (0.01 sec)
```

 Because `FRAGMENT_COUNT_TYPE` was not set explicitly, its value is not shown in the comment text printed by `SHOW CREATE TABLE`. [**ndb\_desc**](mysql-cluster-programs-ndb-desc.html), however, displays the updated value for this attribute. The `Table options` column shows the binary properties just enabled. You can see this in the output shown here (emphasized text):

```
$> ./ndb_desc -c localhost fish -d test -p
-- fish --
Version: 4
Fragment type: HashMapPartition
K Value: 6
Min load factor: 78
Max load factor: 80
Temporary table: no
Number of attributes: 4
Number of primary keys: 1
Length of frm data: 380
Max Rows: 0
Row Checksum: 1
Row GCI: 1
SingleUserMode: 0
ForceVarPart: 1
PartitionCount: 1
FragmentCount: 1
FragmentCountType: ONE_PER_LDM_PER_NODE_GROUP
ExtraRowGciBits: 0
ExtraRowAuthorBits: 0
TableStatus: Retrieved
Table options: readbackup, fullyreplicated
HashMap: DEFAULT-HASHMAP-3840-1
-- Attributes --
id Int PRIMARY KEY DISTRIBUTION KEY AT=FIXED ST=MEMORY AUTO_INCR
name Varchar(20;latin1_swedish_ci) NOT NULL AT=SHORT_VAR ST=MEMORY DYNAMIC
length_mm Int NOT NULL AT=FIXED ST=MEMORY DYNAMIC
weight_gm Int NOT NULL AT=FIXED ST=MEMORY DYNAMIC
-- Indexes --
PRIMARY KEY(id) - UniqueHashIndex
PRIMARY(id) - OrderedIndex
uk(name) - OrderedIndex
uk$unique(name) - UniqueHashIndex
-- Per partition info --
Partition       Row count       Commit count    Frag fixed memory       Frag varsized memory    Extent_space    Free extent_space

NDBT_ProgramExit: 0 - OK
```

 For more information about these table properties, see [Section 13.1.20.11, “Setting NDB Comment Options”](create-table-ndb-comment-options.html).

 The `Extent_space` and `Free extent_space` columns are applicable only to `NDB` tables having columns on disk; for tables having only in-memory columns, these columns always contain the value `0`.

 To illustrate their use, we modify the previous example. First, we must create the necessary Disk Data objects, as shown here:

```
CREATE LOGFILE GROUP lg_1
    ADD UNDOFILE 'undo_1.log'
    INITIAL_SIZE 16M
    UNDO_BUFFER_SIZE 2M
    ENGINE NDB;

ALTER LOGFILE GROUP lg_1
    ADD UNDOFILE 'undo_2.log'
    INITIAL_SIZE 12M
    ENGINE NDB;

CREATE TABLESPACE ts_1
    ADD DATAFILE 'data_1.dat'
    USE LOGFILE GROUP lg_1
    INITIAL_SIZE 32M
    ENGINE NDB;

ALTER TABLESPACE ts_1
    ADD DATAFILE 'data_2.dat'
    INITIAL_SIZE 48M
    ENGINE NDB;
```

 (For more information on the statements just shown and the objects created by them, see [Section 23.6.10.1, “NDB Cluster Disk Data Objects”](mysql-cluster-disk-data-objects.html), as well as [Section 13.1.16, “CREATE LOGFILE GROUP Statement”](create-logfile-group.html), and [Section 13.1.21, “CREATE TABLESPACE Statement”](create-tablespace.html).)

 Now we can create and populate a version of the `fish` table that stores 2 of its columns on disk (deleting the previous version of the table first, if it already exists):

```
DROP TABLE IF EXISTS fish;

CREATE TABLE fish (
    id INT NOT NULL AUTO_INCREMENT,
    name VARCHAR(20) NOT NULL,
    length_mm INT NOT NULL,
    weight_gm INT NOT NULL,

    PRIMARY KEY pk (id),
    UNIQUE KEY uk (name)
) TABLESPACE ts_1 STORAGE DISK
ENGINE=NDB;

INSERT INTO fish VALUES
    (NULL, 'guppy', 35, 2), (NULL, 'tuna', 2500, 150000),
    (NULL, 'shark', 3000, 110000), (NULL, 'manta ray', 1500, 50000),
    (NULL, 'grouper', 900, 125000), (NULL ,'puffer', 250, 2500);
```

 When run against this version of the table, [**ndb\_desc**](mysql-cluster-programs-ndb-desc.html) displays the following output:

```
$> ./ndb_desc -c localhost fish -d test -p
-- fish --
Version: 1
Fragment type: HashMapPartition
K Value: 6
Min load factor: 78
Max load factor: 80
Temporary table: no
Number of attributes: 4
Number of primary keys: 1
Length of frm data: 1001
Max Rows: 0
Row Checksum: 1
Row GCI: 1
SingleUserMode: 0
ForceVarPart: 1
PartitionCount: 2
FragmentCount: 2
PartitionBalance: FOR_RP_BY_LDM
ExtraRowGciBits: 0
ExtraRowAuthorBits: 0
TableStatus: Retrieved
Table options: readbackup
HashMap: DEFAULT-HASHMAP-3840-2
Tablespace id: 16
Tablespace: ts_1
-- Attributes --
id Int PRIMARY KEY DISTRIBUTION KEY AT=FIXED ST=MEMORY AUTO_INCR
name Varchar(80;utf8mb4_0900_ai_ci) NOT NULL AT=SHORT_VAR ST=MEMORY
length_mm Int NOT NULL AT=FIXED ST=DISK
weight_gm Int NOT NULL AT=FIXED ST=DISK
-- Indexes --
PRIMARY KEY(id) - UniqueHashIndex
PRIMARY(id) - OrderedIndex
uk(name) - OrderedIndex
uk$unique(name) - UniqueHashIndex
-- Per partition info --
Partition       Row count       Commit count    Frag fixed memory       Frag varsized memory    Extent_space    Free extent_space
0               2               2               32768                   32768                   1048576         1044440
1               4               4               32768                   32768                   1048576         1044400

NDBT_ProgramExit: 0 - OK
```

 This means that 1048576 bytes are allocated from the tablespace for this table on each partition, of which 1044440 bytes remain free for additional storage. In other words, 1048576 - 1044440 = 4136 bytes per partition is currently being used to store the data from this table's disk-based columns. The number of bytes shown as `Free extent_space` is available for storing on-disk column data from the `fish` table only; for this reason, it is not visible when selecting from the [`INFORMATION_SCHEMA.FILES`](information-schema-files-table.html) table.

`Tablespace id` and `Tablespace` are displayed for Disk Data tables beginning with NDB 8.0.21.

 For fully replicated tables, [**ndb\_desc**](mysql-cluster-programs-ndb-desc.html) shows only the nodes holding primary partition fragment replicas; nodes with copy fragment replicas (only) are ignored. You can obtain such information, using the [**mysql**](mysql.html) client, from the [`table_distribution_status`](mysql-cluster-ndbinfo-table-distribution-status.html), [`table_fragments`](mysql-cluster-ndbinfo-table-fragments.html), [`table_info`](mysql-cluster-ndbinfo-table-info.html), and [`table_replicas`](mysql-cluster-ndbinfo-table-replicas.html) tables in the [`ndbinfo`](mysql-cluster-ndbinfo.html) database.

 All options that can be used with [**ndb\_desc**](mysql-cluster-programs-ndb-desc.html) are shown in the following table. Additional descriptions follow the table.

[]()

**Table 23.31 Command-line options used with the program ndb\_desc**

|                                                                                                            Format                                                                                                            |                                                                  Description                                                                   |           Added, Deprecated, or Removed           |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------|
|                               `[--auto-inc](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_auto-inc)`,<br/><br/>` [-a](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_auto-inc) `                                |                                          Show next value for AUTO\_INCREMENT oolumn if table has one                                           |                 ADDED: NDB 8.0.21                 |
|                              `[--blob-info](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_blob-info)`,<br/><br/>` [-b](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_blob-info) `                              |                       Include partition information for BLOB tables in output. Requires that the -p option also be used                        | (Supported in all NDB releases based on MySQL 8.0)|
|                                                           ` [--character-sets-dir=path](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_character-sets-dir) `                                                           |                                                      Directory containing character sets                                                       | (Supported in all NDB releases based on MySQL 8.0)|
|                                                               ` [--connect-retries=#](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_connect-retries) `                                                                |                                              Number of times to retry connection before giving up                                              | (Supported in all NDB releases based on MySQL 8.0)|
|                                                           ` [--connect-retry-delay=#](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_connect-retry-delay) `                                                            |                                    Number of seconds to wait between attempts to contact management server                                     | (Supported in all NDB releases based on MySQL 8.0)|
|    `[--connect-string=connection_string](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_connect-string)`,<br/><br/>` [-c connection_string](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_connect-string) `     |                                                          Same as --ndb-connectstring                                                           | (Supported in all NDB releases based on MySQL 8.0)|
|                                 `[--context](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_context)`,<br/><br/>` [-x](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_context) `                                 |                                Show extra information for table such as database, schema, name, and internal ID                                |                 ADDED: NDB 8.0.21                 |
|                                                                      ` [--core-file](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_core-file) `                                                                       |                                                  Write core file on error; used in debugging                                                   | (Supported in all NDB releases based on MySQL 8.0)|
|                          `[--database=name](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_database)`,<br/><br/>` [-d name](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_database) `                           |                                                       Name of database containing table                                                        | (Supported in all NDB releases based on MySQL 8.0)|
|                                                          ` [--defaults-extra-file=path](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_defaults-extra-file) `                                                          |                                                  Read given file after global files are read                                                   | (Supported in all NDB releases based on MySQL 8.0)|
|                                                                ` [--defaults-file=path](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_defaults-file) `                                                                |                                                   Read default options from given file only                                                    | (Supported in all NDB releases based on MySQL 8.0)|
|                                                       ` [--defaults-group-suffix=string](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_defaults-group-suffix) `                                                       |                                                  Also read groups with concat(group, suffix)                                                   | (Supported in all NDB releases based on MySQL 8.0)|
|                     `[--extra-node-info](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_extra-node-info)`,<br/><br/>` [-n](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_extra-node-info) `                     |                               Include partition-to-data-node mappings in output; requires --extra-partition-info                               | (Supported in all NDB releases based on MySQL 8.0)|
|             `[--extra-partition-info](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_extra-partition-info)`,<br/><br/>` [-p](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_extra-partition-info) `              |                                                      Display information about partitions                                                      | (Supported in all NDB releases based on MySQL 8.0)|
|                                     `[--help](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_help)`,<br/><br/>` [-?](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_help) `                                      |                                                           Display help text and exit                                                           | (Supported in all NDB releases based on MySQL 8.0)|
|                                                                   ` [--login-path=path](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_login-path) `                                                                   |                                                        Read given path from login file                                                         | (Supported in all NDB releases based on MySQL 8.0)|
|`[--ndb-connectstring=connection_string](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_ndb-connectstring)`,<br/><br/>` [-c connection_string](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_ndb-connectstring) `|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 8.0)|
|      `[--ndb-mgmd-host=connection_string](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_ndb-mgmd-host)`,<br/><br/>` [-c connection_string](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_ndb-mgmd-host) `      |                                                          Same as --ndb-connectstring                                                           | (Supported in all NDB releases based on MySQL 8.0)|
|                                                                    ` [--ndb-nodeid=#](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_ndb-nodeid) `                                                                     |                                    Set node ID for this node, overriding any ID set by --ndb-connectstring                                     | (Supported in all NDB releases based on MySQL 8.0)|
|                                                   ` [--ndb-optimized-node-selection](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_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 8.0)|
|                                                                    ` [--no-defaults](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_no-defaults) `                                                                     |                                     Do not read default options from any option file other than login file                                     | (Supported in all NDB releases based on MySQL 8.0)|
|                                                                 ` [--print-defaults](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_print-defaults) `                                                                  |                                                      Print program argument list and exit                                                      | (Supported in all NDB releases based on MySQL 8.0)|
|                               `[--retries=#](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_retries)`,<br/><br/>` [-r #](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_retries) `                               |                                           Number of times to retry the connection (once per second)                                            | (Supported in all NDB releases based on MySQL 8.0)|
|                               `[--table=name](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_table)`,<br/><br/>` [-t name](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_table) `                               |                Specify the table in which to find an index. When this option is used, -p and -n have no effect and are ignored                 | (Supported in all NDB releases based on MySQL 8.0)|
|                           `[--unqualified](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_unqualified)`,<br/><br/>` [-u](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_unqualified) `                           |                                                          Use unqualified table names                                                           | (Supported in all NDB releases based on MySQL 8.0)|
|                                    `[--usage](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_usage)`,<br/><br/>` [-?](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_usage) `                                    |                                                   Display help text and exit; same as --help                                                   | (Supported in all NDB releases based on MySQL 8.0)|
|                                 `[--version](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_version)`,<br/><br/>` [-V](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_version) `                                 |                                                      Display version information and exit                                                      | (Supported in all NDB releases based on MySQL 8.0)|

* []() `--auto-inc`, `-a`

  []()[]()

   Show the next value for a table's `AUTO_INCREMENT` column, if it has one.

* []() `--blob-info`, `-b`

  []()[]()

   Include information about subordinate [`BLOB`](blob.html) and [`TEXT`](blob.html) columns.

   Use of this option also requires the use of the [`--extra-partition-info`](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_extra-partition-info) (`-p`) option.

* []() `--character-sets-dir`

  []()[]()

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

   Directory containing character sets.

* []() `--connect-retries`

  []()[]()

  |Command-Line Format|`--connect-retries=#`|
  |-------------------|---------------------|
  |       Type        |       Integer       |
  |   Default Value   |        `12`         |
  |   Minimum Value   |         `0`         |
  |   Maximum Value   |        `12`         |

   Number of times to retry connection before giving up.

* []() `--connect-retry-delay`

  []()[]()

  |Command-Line Format|`--connect-retry-delay=#`|
  |-------------------|-------------------------|
  |       Type        |         Integer         |
  |   Default Value   |           `5`           |
  |   Minimum Value   |           `0`           |
  |   Maximum Value   |           `5`           |

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

* []() `--connect-string`

  []()[]()

  |Command-Line Format|`--connect-string=connection_string`|
  |-------------------|------------------------------------|
  |       Type        |               String               |
  |   Default Value   |              `[none]`              |

   Same as [`--ndb-connectstring`](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_ndb-connectstring).

* []() `--context`, `-x`

  []()[]()

   Show additional contextual information for the table such as schema, database name, table name, and the table's internal ID.

* []() `--core-file`

  []()[]()

  |Command-Line Format|`--core-file`|
  |-------------------|-------------|

   Write core file on error; used in debugging.

* []() `--database=*`db_name`*`, `-d`

  []()[]()

   Specify the database in which the table should be found.

* []() `--defaults-extra-file`

  []()[]()

  |Command-Line Format|`--defaults-extra-file=path`|
  |-------------------|----------------------------|
  |       Type        |           String           |
  |   Default Value   |          `[none]`          |

   Read given file after global files are read.

* []() `--defaults-file`

  []()[]()

  |Command-Line Format|`--defaults-file=path`|
  |-------------------|----------------------|
  |       Type        |        String        |
  |   Default Value   |       `[none]`       |

   Read default options from given file only.

* []() `--defaults-group-suffix`

  []()[]()

  |Command-Line Format|`--defaults-group-suffix=string`|
  |-------------------|--------------------------------|
  |       Type        |             String             |
  |   Default Value   |            `[none]`            |

   Also read groups with concat(group, suffix).

* []() `--extra-node-info`, `-n`

  []()[]()

   Include information about the mappings between table partitions and the data nodes upon which they reside. This information can be useful for verifying distribution awareness mechanisms and supporting more efficient application access to the data stored in NDB Cluster.

   Use of this option also requires the use of the [`--extra-partition-info`](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_extra-partition-info) (`-p`) option.

* []() `--extra-partition-info`, `-p`

  []()[]()

   Print additional information about the table's partitions.

* []() `--help`

  []()[]()

  |Command-Line Format|`--help`|
  |-------------------|--------|

   Display help text and exit.

* []() `--login-path`

  []()[]()

  |Command-Line Format|`--login-path=path`|
  |-------------------|-------------------|
  |       Type        |      String       |
  |   Default Value   |     `[none]`      |

   Read given path from login file.

* []() `--ndb-connectstring`

  []()[]()

  |Command-Line Format|`--ndb-connectstring=connection_string`|
  |-------------------|---------------------------------------|
  |       Type        |                String                 |
  |   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`|
  |-------------------|-----------------------------------|
  |       Type        |              String               |
  |   Default Value   |             `[none]`              |

   Same as [`--ndb-connectstring`](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_ndb-connectstring).

* []() `--ndb-nodeid`

  []()[]()

  |Command-Line Format|`--ndb-nodeid=#`|
  |-------------------|----------------|
  |       Type        |    Integer     |
  |   Default Value   |    `[none]`    |

   Set node ID for this node, overriding any ID set by [`--ndb-connectstring`](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_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.

* []() `--print-defaults`

  []()[]()

  |Command-Line Format|`--print-defaults`|
  |-------------------|------------------|

   Print program argument list and exit.

* []() `--retries=*`#`*`, `-r`

  []()[]()

   Try to connect this many times before giving up. One connect attempt is made per second.

* []() `--table=*`tbl_name`*`, `-t`

  []()[]()

   Specify the table in which to look for an index.

* []() `--unqualified`, `-u`

  []()[]()

   Use unqualified table names.

* []() `--usage`

  []()[]()

  |Command-Line Format|`--usage`|
  |-------------------|---------|

   Display help text and exit; same as [`--help`](mysql-cluster-programs-ndb-desc.html#option_ndb_desc_help).

* []() `--version`

  []()[]()

  |Command-Line Format|`--version`|
  |-------------------|-----------|

   Display version information and exit.

 Table indexes listed in the output are ordered by ID.

