add dbmgmt/db_commands.rst

Author: kenjis

user_guide_src/source/database/metadata.rst

@@ -25,15 +25,6 @@ you are currently connected to. Example:
 
 .. note:: Some drivers have additional system tables that are excluded from this return.
 
-db:table --show command
------------------------
-
-CodeIgniter supports show list the tables in your database straight from your favorite terminal using the dedicated ``db:table --show`` command. By using this command it is assumed that the tables is   existing. Otherwise, CodeIgniter will complain that tables list show has failed.
-
-To start, just type ::
-
-    > php spark db:table --show
-
 Determine If a Table Exists
 ===========================
 
@@ -114,18 +105,6 @@ database:
 -  primary_key - 1 if the column is a primary key
 -  type - the type of the column
 
-db:table --metadata command
----------------------------
-
-CodeIgniter supports show table containing field information in your database straight from your favorite terminal using the dedicated ``db:table my_table --metadata`` command. By using this command it is assumed that the table ``my_table`` is existing. Otherwise, CodeIgniter will show that tables list for select.
-Also, you can use this command as ``db:table --metadata``.
-
-.. note:: You can use the optional ``--desc``, ``--limit-rows``, ``--limit-field-value`` options at any time when using command ``db:table`` .
-
-Command ``db:table --limit-rows 50``, for example, limits the number of rows to 50 rows.
-Command ``db:table --desc``, set the sort direction to "DESC". 
-And Command ``db:table --limit-field-value 10`` limits the length of the field values to 10 characters, to prevent confusion of the table output in the terminal.
-
 List the Indexes in a Table
 ===========================
 

user_guide_src/source/dbmgmt/db_commands.rst

@@ -0,0 +1,61 @@
+#################
+Database Commands
+#################
+
+CodeIgniter provides some simple commands for databse management.
+
+.. contents::
+    :local:
+    :depth: 2
+
+*************************
+Showing Table Information
+*************************
+
+List the Tables in Your Database
+================================
+
+db:table --show
+---------------
+
+To list all the tables in your database straight from your favorite terminal,
+you can use the ``db:table --show`` command::
+
+    > php spark db:table --show
+
+When using this command it is assumed that a table exists.
+Otherwise, CodeIgniter will complain that the database has no tables.
+
+Retrieve Some Records
+=====================
+
+db:table
+--------
+
+When you have a table named ``my_table``, you can see the field names and the records of a table::
+
+    > php spark db:table my_table
+
+You can also pass a few options::
+
+    > php spark db:table my_table --limit-rows 50 --limit-field-value 20 --desc
+
+The option ``--limit-rows 50`` limits the number of rows to 50 rows.
+
+The option  ``--limit-field-value 20`` limits the length of the field values to 20 characters, to prevent confusion of the table output in the terminal.
+
+The option ``--desc`` sets the sort direction to "DESC".
+
+Retrieve Field Metadata
+=======================
+
+db:table --metadata
+-------------------
+
+When you have a table named ``my_table``, you can see metadata like the column type, max length of the table with the ``--metadata`` option::
+
+    > php spark db:table my_table --metadata
+
+When using this command it is assumed that the table exists.
+Otherwise, CodeIgniter will show a table list to select.
+Also, you can use this command as ``db:table --metadata``.

user_guide_src/source/dbmgmt/index.rst

@@ -10,3 +10,4 @@ CodeIgniter comes with tools to restructure or seed your database.
     Database Manipulation with Database Forge <forge>
     Database Migrations <migration>
     Database Seeding <seeds>
+    db_commands