home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _a750a9c0e8336fffac48132bba7d00e3 < prev    next >
Text File  |  2000-03-23  |  9KB  |  233 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>DBI::Shell - Interactive command shell for the DBI</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> DBI::Shell - Interactive command shell for the DBI</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#to do">TO DO</A></LI>
  26.     <LI><A HREF="#commands">COMMANDS</A></LI>
  27.     <LI><A HREF="#authors and acknowledgements">AUTHORS and ACKNOWLEDGEMENTS</A></LI>
  28.     <LI><A HREF="#copyright">COPYRIGHT</A></LI>
  29. </UL>
  30. <!-- INDEX END -->
  31.  
  32. <HR>
  33. <P>
  34. <H1><A NAME="name">NAME</A></H1>
  35. <P>DBI::Shell - Interactive command shell for the DBI</P>
  36. <P>
  37. <HR>
  38. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  39. <UL>
  40. <LI>Linux</LI>
  41. <LI>Solaris</LI>
  42. <LI>Windows</LI>
  43. </UL>
  44. <HR>
  45. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  46. <PRE>
  47.   perl -MDBI::Shell -e shell [<DBI data source> [<user> [<password>]]]</PRE>
  48. <P>or</P>
  49. <PRE>
  50.   dbish [<DBI data source> [<user> [<password>]]]</PRE>
  51. <P>
  52. <HR>
  53. <H1><A NAME="description">DESCRIPTION</A></H1>
  54. <P>The DBI::Shell module (and dbish command, if installed) provide a
  55. simple but effective command line interface for the Perl DBI module.</P>
  56. <P>DBI::Shell is very new, very experimental and very subject to change.
  57. Your milage <EM>will</EM> vary. Interfaces <EM>will</EM> change with each release.</P>
  58. <P>
  59. <HR>
  60. <H1><A NAME="to do">TO DO</A></H1>
  61. <P>Proper docs - but not yet, too much is changing.</P>
  62. <P>``/source file'' command to read command file.
  63. Allow to nest via stack of command file handles.
  64. Add command log facility to create batch files.</P>
  65. <P><TABLE CELLSPACING=0 CELLPADDING=0><TR><TD>Commands:
  66. <TR><TD><TD>load (query?) from file
  67. <TR><TD><TD>save (query?) to file</TABLE></P>
  68. <P>Use Data::ShowTable if available.</P>
  69. <P><TABLE CELLSPACING=0 CELLPADDING=0><TR><TD>Define DBI::Shell plug-in semantics.
  70. <TR><TD><TD>Implement import/export as plug-in module</TABLE></P>
  71. <P>Clarify meaning of batch mode</P>
  72. <P>Completion hooks</P>
  73. <P>Set/Get DBI handle attributes</P>
  74. <P>Portability</P>
  75. <P>Emulate popular command shell modes (Oracle, Ingres etc)?</P>
  76. <P>
  77. <HR>
  78. <H1><A NAME="commands">COMMANDS</A></H1>
  79. <P>Many commands - few documented, yet!</P>
  80. <DL>
  81. <DT><STRONG><A NAME="item_help">help</A></STRONG><BR>
  82. <DD>
  83. <PRE>
  84.   /help</PRE>
  85. <DT><STRONG><A NAME="item_chistory">chistory</A></STRONG><BR>
  86. <DD>
  87. <PRE>
  88.   /chistory          (display history of all commands entered)
  89.   /chistory | YourPager (display history with paging)</PRE>
  90. <DT><STRONG><A NAME="item_clear">clear</A></STRONG><BR>
  91. <DD>
  92. <PRE>
  93.   /clear             (Clears the current command buffer)</PRE>
  94. <DT><STRONG><A NAME="item_commit">commit</A></STRONG><BR>
  95. <DD>
  96. <PRE>
  97.   /commit            (commit changes to the database)</PRE>
  98. <DT><STRONG><A NAME="item_connect">connect</A></STRONG><BR>
  99. <DD>
  100. <PRE>
  101.   /connect           (pick from available drivers and sources)
  102.   /connect dbi:Oracle (pick source from based on driver)
  103.   /connect dbi:YourDriver:YourSource i.e. dbi:Oracle:mysid</PRE>
  104. <P>Use this option to change userid or password.</P>
  105. <DT><STRONG><A NAME="item_current">current</A></STRONG><BR>
  106. <DD>
  107. <PRE>
  108.   /current            (Display current statement in the buffer)</PRE>
  109. <DT><STRONG><A NAME="item_do">do</A></STRONG><BR>
  110. <DD>
  111. <PRE>
  112.   /do                 (execute the current (non-select) statement)</PRE>
  113. <PRE>
  114.         dbish> create table foo ( mykey integer )
  115.         dbish> /do</PRE>
  116. <PRE>
  117.         dbish> truncate table OldTable /do (Oracle truncate)</PRE>
  118. <DT><STRONG><A NAME="item_drivers">drivers</A></STRONG><BR>
  119. <DD>
  120. <PRE>
  121.   /drivers            (Display available DBI drivers)</PRE>
  122. <DT><STRONG><A NAME="item_edit">edit</A></STRONG><BR>
  123. <DD>
  124. <PRE>
  125.   /edit               (Edit current statement in an external editor)</PRE>
  126. <P>Editor is defined using the enviroment variable $VISUAL or
  127. $EDITOR or default is vi.  Use /option editor=new editor to change
  128. in the current session.</P>
  129. <P>To read a file from the operating system invoke the editor (/edit)
  130. and read the file into the editor buffer.</P>
  131. <DT><STRONG><A NAME="item_exit">exit</A></STRONG><BR>
  132. <DD>
  133. <PRE>
  134.   /exit              (Exits the shell)</PRE>
  135. <DT><STRONG><A NAME="item_get">get</A></STRONG><BR>
  136. <DD>
  137. <PRE>
  138.   /get               (Retrieve a previous command to the current buffer)</PRE>
  139. <DT><STRONG><A NAME="item_go">go</A></STRONG><BR>
  140. <DD>
  141. <PRE>
  142.   /go                (Execute the current statement)</PRE>
  143. <P>Run (execute) the statement in the current buffer.  This is the default
  144. action if the statement ends with /</P>
  145. <PRE>
  146.         dbish> select * from user_views/</PRE>
  147. <PRE>
  148.         dbish> select table_name from user_tables
  149.         dbish> where table_name like 'DSP%'
  150.         dbish> /</PRE>
  151. <PRE>
  152.         dbish> select table_name from all_tables/ | more</PRE>
  153. <DT><STRONG><A NAME="item_history">history</A></STRONG><BR>
  154. <DD>
  155. <PRE>
  156.   /history            (Display combined command and result history)
  157.   /history | more</PRE>
  158. <DT><STRONG><A NAME="item_option">option</A></STRONG><BR>
  159. <DD>
  160. <PRE>
  161.   /option [option1[=value]] [option2 ...]
  162.   /option            (Displays the current options)
  163.   /option   MyOption (Displays the value, if exists, of MyOption)
  164.   /option   MyOption=4 (defines and/or sets value for MyOption)</PRE>
  165. <DT><STRONG><A NAME="item_perl">perl</A></STRONG><BR>
  166. <DD>
  167. <PRE>
  168.   /perl               (Evaluate the current statement as perl code)</PRE>
  169. <DT><STRONG><A NAME="item_quit">quit</A></STRONG><BR>
  170. <DD>
  171. <PRE>
  172.   /quit               (Leaves shell.  Same as exit)</PRE>
  173. <DT><STRONG><A NAME="item_redo">redo</A></STRONG><BR>
  174. <DD>
  175. <PRE>
  176.   /redo               (Re-execute the previously executed statement)</PRE>
  177. <DT><STRONG><A NAME="item_rhistory">rhistory</A></STRONG><BR>
  178. <DD>
  179. <PRE>
  180.   /rhistory           (Display result history)</PRE>
  181. <DT><STRONG><A NAME="item_rollback">rollback</A></STRONG><BR>
  182. <DD>
  183. <PRE>
  184.   /rollback           (rollback changes to the database)</PRE>
  185. <P>For this to be useful, turn the autocommit off. /option autocommit=0</P>
  186. <DT><STRONG><A NAME="item_table_info">table_info</A></STRONG><BR>
  187. <DD>
  188. <PRE>
  189.   /table_info         (display all tables that exist in current database)
  190.   /table_info | more  (for paging)</PRE>
  191. <DT><STRONG><A NAME="item_trace">trace</A></STRONG><BR>
  192. <DD>
  193. <PRE>
  194.   /trace              (set DBI trace level for current database)</PRE>
  195. <P>Adjust the trace level for DBI 0 - 4.  0 off.  4 lots of information.
  196. Useful for determining what is really happening in DBI.  See DBI.</P>
  197. <DT><STRONG><A NAME="item_type_info">type_info</A></STRONG><BR>
  198. <DD>
  199. <PRE>
  200.   /type_info          (display data types supported by current server)</PRE>
  201. </DL>
  202. <P>
  203. <HR>
  204. <H1><A NAME="authors and acknowledgements">AUTHORS and ACKNOWLEDGEMENTS</A></H1>
  205. <P>The DBI::Shell has a long lineage.</P>
  206. <P>It started life around 1994-1997 as the pmsql script written by Andreas
  207. K÷nig. Jochen Wiedmann picked it up and ran with it (adding much along
  208. the way) as <EM>dbimon</EM>, bundled with his DBD::mSQL driver modules. In
  209. 1998, around the time I wanted to bundle a shell with the DBI, Adam
  210. Marks was working on a dbish modeled after the Sybase sqsh utility.</P>
  211. <P>Wanting to start from a cleaner slate than the feature-full but complex
  212. dbimon, I worked with Adam to create a fairly open modular and very
  213. configurable DBI::Shell module. Along the way Tom Lowery chipped in
  214. ideas and patches. As we go further along more useful code and concepts
  215. from Jochen's dbimon is bound to find it's way back in.</P>
  216. <P>
  217. <HR>
  218. <H1><A NAME="copyright">COPYRIGHT</A></H1>
  219. <P>The DBI::Shell module is Copyright (c) 1998 Tim Bunce. England.
  220. All rights reserved. Portions are Copyright by Jochen Wiedmann,
  221. Adam Marks and Tom Lowery.</P>
  222. <P>You may distribute under the terms of either the GNU General Public
  223. License or the Artistic License, as specified in the Perl README file.</P>
  224. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  225. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  226. <STRONG><P CLASS=block> DBI::Shell - Interactive command shell for the DBI</P></STRONG>
  227. </TD></TR>
  228. </TABLE>
  229.  
  230. </BODY>
  231.  
  232. </HTML>
  233.