ndb_select_all

Langue: en

Version: 07/04/2007 (mandriva - 22/10/07)

Section: 1 (Commandes utilisateur)

NAME

ndb_select_all - print rows from NDB table

SYNOPSIS

ndb_select_all -c connect_string tbl_name -d db_name [> file_name]

DESCRIPTION

ndb_select_all

prints all rows from an NDB table to stdout.

Usage:

 ndb_select_all -c connect_string tbl_name -d db_name [> file_name]
 

Additional Options:

--lock=lock_type, -l lock_type

Employs a lock when reading the table. Possible values for lock_type are:

0: Read lock
1: Read lock with hold
2: Exclusive read lock
There is no default value for this option.
--order=index_name, -o index_name

Orders the output according to the index named index_name. Note that this is the name of an index, not of a column, and that the index must have been explicitly named when created.

--descending, -z

Sorts the output in descending order. This option can be used only in conjunction with the -o (--order) option.

--header=FALSE

Excludes column headers from the output.

--useHexFormat -x

Causes all numeric values to be displayed in hexadecimal format. This does not affect the output of numerals contained in strings or datetime values.

--delimiter=character, -D character

Causes the character to be used as a column delimiter. Only table data columns are separated by this delimiter.

The default delimiter is the tab character.

--rowid

Adds a ROWID column providing information about the fragments in which rows are stored.

--gci

Adds a column to the output showing the global checkpoint at which each row was last updated. See Section 12, "MySQL Cluster Glossary", and Section 6.3.2, "Log Events", for more information about checkpoints.

--tupscan, -t

Scan the table in the order of the tuples.

--nodata

Causes any table data to be omitted.

Sample Output:

Output from a MySQL SELECT statement:

 mysql> SELECT * FROM ctest1.fish;
 +----+-----------+
 | id | name      |
 +----+-----------+
 |  3 | shark     |
 |  6 | puffer    |
 |  2 | tuna      |
 |  4 | manta ray |
 |  5 | grouper   |
 |  1 | guppy     |
 +----+-----------+
 6 rows in set (0.04 sec)
 

Output from the equivalent invocation of ndb_select_all:

 shell> ./ndb_select_all -c localhost fish -d ctest1
 id      name
 3       [shark]
 6       [puffer]
 2       [tuna]
 4       [manta ray]
 5       [grouper]
 1       [guppy]
 6 rows returned
 NDBT_ProgramExit: 0 - OK
 

Note that all string values are enclosed by square brackets ("[...]") in the output of ndb_select_all. For a further example, consider the table created and populated as shown here:

 CREATE TABLE dogs (
     id INT(11) NOT NULL AUTO_INCREMENT,
     name VARCHAR(25) NOT NULL,
     breed VARCHAR(50) NOT NULL,
     PRIMARY KEY pk (id),
     KEY ix (name)
 ) 
 ENGINE=NDB;
 INSERT INTO dogs VALUES 
     ('', 'Lassie', 'collie'),
     ('', 'Scooby-Doo', 'Great Dane'),
     ('', 'Rin-Tin-Tin', 'German Shepherd'),
     ('', 'Rosscoe', 'Mutt');
 

This demonstrates the use of several additional ndb_select_all options:

 shell> ./ndb_select_all -d ctest1 dogs -o ix -z --gci        
 GCI     id name           breed
 834461  2  [Scooby-Doo]   [Great Dane]
 834878  4  [Rosscoe]      [Mutt]
 834463  3  [Rin-Tin-Tin]  [German Shepherd]
 835657  1  [Lassie]       [Collie]
 4 rows returned
 NDBT_ProgramExit: 0 - OK
 

Copyright 1997-2007 MySQL AB

This documentation is NOT distributed under a GPL license. Use of this documentation is subject to the following terms: You may create a printed copy of this documentation solely for your own personal use. Conversion to other formats is allowed as long as the actual content is not altered or edited in any way. You shall not publish or distribute this documentation in any form or on any media, except if you distribute the documentation in a manner similar to how MySQL disseminates it (that is, electronically for download on a Web site with the software) or on a CD-ROM or similar medium, provided however that the documentation is disseminated together with the software on the same medium. Any other use, such as any dissemination of printed copies or use of this documentation, in whole or in part, in another publication, requires the prior written consent from an authorized representative of MySQL AB. MySQL AB reserves any and all rights to this documentation not expressly granted above.

Please email <docs@mysql.com> for more information.

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/.

AUTHOR

MySQL AB (http://www.mysql.com/). This software comes with no warranty.