SQL Plus

<h2 id="command-types">Command types</h2>
<p>SQL Plus understands five categories of text:<a class="footnote-ref" id="fnref:1" href="#fn:1"><sup>1</sup></a>
</p>
<ol><li>SQL statements</li>
<li><a href="/facts/PL%2fSQL/LLghPhdc">PL/SQL</a> blocks</li>
<li>SQL Plus internal commands, for example:
<ul><li>environment control commands such as SET</li>
<li>environment monitoring commands such as SHOW</li></ul></li>
<li>Comments</li>
<li>External commands prefixed by the ! char</li></ol>
<p>Scripts can include all of these components.
</p><p>An Oracle programmer in the appropriately configured software environment can launch SQL Plus, for example, by entering:
</p>
$ sqlplus scott/tiger

<p>where the Oracle user scott has the password tiger. SQL Plus then presents a prompt with the default form of:
</p>
SQL>

<p>Interactive use can then start by entering a SQL statement (terminated by a semicolon), a PL/SQL block, or another command. For example:
</p>
SQL> select 'Hello world' as example from dual;

EXAMPLE
--------------------------------
Hello world

<h2 id="history">History</h2>
<p>The first version of SQL Plus was called <i>UFI</i> ("User Friendly Interface"). UFI appeared in Oracle database releases up to Version 4.
</p><p>After Oracle programmers had added new features to UFI, its  name became <i>Advanced UFI</i>.  The name "Advanced UFI" changed to "SQL Plus" with the release of the version 5 of Oracle.<a class="footnote-ref" id="fnref:2" href="#fn:2"><sup>2</sup></a>
</p>
<h2 id="usage">Usage</h2>
<p>Graphical interfaces from Oracle or third parties have diminished the proportion of <a href="/facts/Oracle_Database/FHv5g732">Oracle database</a> end-users who depend on the SQL Plus environment. Oracle shops typically continue to use SQL Plus scripts for batch updating or simple reports.
</p><p>Oracle Corporation's wrappers/gui-fications/replacements for SQL Plus include:
</p>
<ul><li>Oracle SQL Plus Worksheet, a component of <a href="/facts/Oracle_Enterprise_Manager/BhMYatbD">OEM</a><a class="footnote-ref" id="fnref:3" href="#fn:3"><sup>3</sup></a></li>
<li>iSQL Plus or iSQLPlus, a web-based utility<a class="footnote-ref" id="fnref:4" href="#fn:4"><sup>4</sup></a></li>
<li>SQL Worksheet,<a class="footnote-ref" id="fnref:5" href="#fn:5"><sup>5</sup></a> a component of <a href="/facts/Oracle_SQL_Developer/DVSut3Xe">Oracle SQL Developer</a></li>
<li>SQL Workshop (part of <a href="/facts/Oracle_Application_Express/e0DemPNu">Oracle Application Express</a>)<a class="footnote-ref" id="fnref:6" href="#fn:6"><sup>6</sup></a></li></ul>
<h3>Oracle 11g</h3>
<p>Starting from Oracle database 11g, iSqlplus (web based) and sqlplus GUI no longer ship with Oracle database software.<a class="footnote-ref" id="fnref:7" href="#fn:7"><sup>7</sup></a>
The command-line SQL Plus interface continues in use, mostly for non-interactive scripting or for administrative purposes. The Server Manager Command Line — a replacement of SQL*DBA — is obsolete and SQL Plus 8i and later allows the user to issue statements like STARTUP and SHUTDOWN when connected as SYSDBA. Server Manager 7.1 introduced the command CONNECT / AS SYSDBA to replace CONNECT INTERNAL.<a class="footnote-ref" id="fnref:8" href="#fn:8"><sup>8</sup></a> SQL Plus 8i and later allows the use of CONNECT / AS SYSDBA
</p>
<h2 id="compatibility">Compatibility</h2>
<p>Other vendors have made their software somewhat compatible with SQL Plus script commands or offer a SQL Plus mode of operation. Relevant products include <a href="/facts/TOAD_(software)/dc3ozRbm">TOAD</a> from <a href="/facts/Quest_Software/lNUrFVqJ">Quest Software</a>.<a class="footnote-ref" id="fnref:9" href="#fn:9"><sup>9</sup></a>
</p>
<h2 id="integration">Integration</h2>

<h3>Variables</h3>
<p>SQL Plus-internal variables, accessible within an SQL Plus session, include:
</p>
<ul><li>user variables, displayable with the DEFINE command and referenceable with one or two cases of a prefixed character (default prefixes: '&' and '&&'). Oracle Corporation calls these variables "substitution variables". Programmers can use them anywhere in a SQL or PL/SQL statement or in SQL Plus commands. They can be populated by a literal using DEFINE or from the database using the column command.
<ul><li>predefined variables, prefixed with an underscore ('_')<a class="footnote-ref" id="fnref:10" href="#fn:10"><sup>10</sup></a></li>
<li>substitution variables, useful for interacting with user-input<a class="footnote-ref" id="fnref:11" href="#fn:11"><sup>11</sup></a></li></ul></li>
<li>bind variables, prefixed by a colon (':'), which can interact with the PL/SQL environment. Displayable with the VARIABLE and PRINT commands<a class="footnote-ref" id="fnref:12" href="#fn:12"><sup>12</sup></a></li></ul>
<h3>Error trapping</h3>
<p>The WHENEVER command specifies an action to perform in the event of the system detecting an SQL error<a class="footnote-ref" id="fnref:13" href="#fn:13"><sup>13</sup></a>
or an operating-system error<a class="footnote-ref" id="fnref:14" href="#fn:14"><sup>14</sup></a>
while running a subsequent SQL Plus command.
</p>
<h3>Installation and configuration</h3>
<p>SQL*Plus needs to be installed and configured on the machine where you intend to use it. This usually involves setting up Oracle client software and configuring network connections to Oracle databases.<a class="footnote-ref" id="fnref:15" href="#fn:15"><sup>15</sup></a>
</p>
<h2 id="supplementary-software">Supplementary software</h2>
<ul><li><a href="http://www.softtree.com">SQL Assistant</a> SQL Assistant add-on for SQL Plus Windows version extends SQL Plus with SQL automatic word completion, in-line Oracle SQL Reference, data export/import, code unit testing, data browsing, and code development functions.</li>
<li><a href="https://web.archive.org/web/20101128023958/http://utopia.knoware.nl/~hlub/uck/rlwrap/">rlwrap</a> rlwrap does <a href="/facts/GNU/EpSzvJGJ">GNU</a> <a href="/facts/Readline/tEBE5Mam">Readline</a> like command completion for SQL Plus on <a href="/facts/UNIX/0pNL2seI">UNIX</a> and <a href="/facts/Linux/9FvCKSTq">Linux</a>.</li></ul>
<h2 id="see-also">See also</h2>
<ul><li><a href="/facts/Oracle_SQL_Developer/DVSut3Xe">Oracle SQL Developer</a></li>
<li>Oracle SQL/PLSQL Developer</li>
<li>techaid71/most-common-sqlplus-commands</li></ul>

<h2 id="external-links">External links</h2>
<ul><li><a href="http://download.oracle.com/docs/cd/B19306_01/server.102/b14357/toc.htm">SQL Plus documentation</a></li>
<li><a href="http://www.orafaq.com/wiki/SQL">Plus FAQ SQL Plus FAQ</a></li>
<li><a href="http://www.sql-plus.com/">SQL Plus tutorial</a></li></ul>

<h2 id="references">References</h2>

<ol>
<li id="fn:1"><p>"SQL Plus at orafaq.com". Archived from the original on 2007-11-09. Retrieved 2007-11-26. <a href="https://web.archive.org/web/20071109104758/http://www.orafaq.com/faq/sqlplus" target="_blank">https://web.archive.org/web/20071109104758/http://www.orafaq.com/faq/sqlplus</a> <a href="#fnref:1" class="footnote-back-ref">↩</a></p></li>
<li id="fn:2"><p>Millsap, Cary; Kolk, Anjo; McDonald, Connor; Gorman, Tim; Hailey, Kyle; Ensor, David; Lewis, Jonathan; Vaidyanatha, Gaja Krishna; Ruthven, David; Morle, James (2004). Oracle Insights (1st ed.). Apress. p. 35. ISBN 978-1590593875. Retrieved March 18, 2014. <a href="978-1590593875" target="_blank">978-1590593875</a> <a href="#fnref:2" class="footnote-back-ref">↩</a></p></li>
<li id="fn:3"><p>Evans, Robert (2008-10-01). "The SQL Plus Worksheet". Cardiff University. Archived from the original on 2008-12-01. Retrieved 2008-11-21. Oracle's SQL Plus Worksheet is a straight-forward, easy-to-use, graphical user interface for SQL. <a href="https://web.archive.org/web/20081201065932/http://docs.cs.cf.ac.uk/html/601/node4.html" target="_blank">https://web.archive.org/web/20081201065932/http://docs.cs.cf.ac.uk/html/601/node4.html</a> <a href="#fnref:3" class="footnote-back-ref">↩</a></p></li>
<li id="fn:4"><p>"ISQLPlus". Oracle FAQ. 2008-02-29. Retrieved 2008-11-21. iSQLPlus (iSQL Plus) is a web-based utility similar to the SQL Plus command line utility for executing SQL and PL/SQL commands (available up to Oracle 10gR2). <a href="http://www.orafaq.com/wiki/ISQLPlus" target="_blank">http://www.orafaq.com/wiki/ISQLPlus</a> <a href="#fnref:4" class="footnote-back-ref">↩</a></p></li>
<li id="fn:5"><p>"Oracle SQL Developer 1.5: Feature List". Oracle Corporation. Archived from the original on 2008-07-24. Retrieved 2008-11-21. The SQL Plus commands supported by Oracle SQL Developer SQL Worksheet are listed [...] <a href="https://web.archive.org/web/20080724133233/http://www.oracle.com/technology/products/database/sql_developer/files/featurelist_1_5.htm#nf_sql" target="_blank">https://web.archive.org/web/20080724133233/http://www.oracle.com/technology/products/database/sql_developer/files/featurelist_1_5.htm#nf_sql</a> <a href="#fnref:5" class="footnote-back-ref">↩</a></p></li>
<li id="fn:6"><p>"Oracle Application Express". Oracle Corporation. Archived from the original on 2006-10-21. Retrieved 2008-11-21. SQL Workshop provides tools to enable you to view and manage database objects from a Web browser.  Use SQL Commands to run SQL and PL/SQL statements. ... <a href="https://web.archive.org/web/20061021062241/http://www.oracle.com/technology/products/database/application_express/html/what_is_apex.html" target="_blank">https://web.archive.org/web/20061021062241/http://www.oracle.com/technology/products/database/application_express/html/what_is_apex.html</a> <a href="#fnref:6" class="footnote-back-ref">↩</a></p></li>
<li id="fn:7"><p>Deprecated Components in Oracle Database 11g Release 1 (11.1), retrieve by 25-Jun-2009 <a href="http://download.oracle.com/docs/cd/B28359_01/install.111/b32006/whatsnew.htm#BGGBABGJ" target="_blank">http://download.oracle.com/docs/cd/B28359_01/install.111/b32006/whatsnew.htm#BGGBABGJ</a> <a href="#fnref:7" class="footnote-back-ref">↩</a></p></li>
<li id="fn:8"><p>[1] Oracle 7 doc, 1994 <a href="http://docs.oracle.com/cd/A57673_01/DOC/server/doc/SAD73/ch1.htm#selectmethod" target="_blank">http://docs.oracle.com/cd/A57673_01/DOC/server/doc/SAD73/ch1.htm#selectmethod</a> <a href="#fnref:8" class="footnote-back-ref">↩</a></p></li>
<li id="fn:9"><p>Hotka, Dan; Scalzo, Bert (2003-04-18). TOAD SQL Editor. <a href="http://www.informit.com/articles/article.aspx?p=31544&seqNum=17" target="_blank">http://www.informit.com/articles/article.aspx?p=31544&seqNum=17</a> <a href="#fnref:9" class="footnote-back-ref">↩</a></p></li>
<li id="fn:10"><p>Alapati, Sam R. (2008). "4". Expert Oracle Database 11g Administration. Apress. pp. 118–119. ISBN 978-1-4302-1015-3. Retrieved 2009-07-29. <a href="978-1-4302-1015-3" target="_blank">978-1-4302-1015-3</a> <a href="#fnref:10" class="footnote-back-ref">↩</a></p></li>
<li id="fn:11"><p>Roshak, Natalka (2005-11-06). "Spice up your SQL Scripts with Variables". Oracle FAQ. Retrieved 2009-07-29. & and && indicate substitution variables in SQL Plus scripts or commands. <a href="http://www.orafaq.com/node/515" target="_blank">http://www.orafaq.com/node/515</a> <a href="#fnref:11" class="footnote-back-ref">↩</a></p></li>
<li id="fn:12"><p>Nyffenegger, René. "Using bind variables in SQL Plus". René Nyffenegger's collection of things on the web. Retrieved 2009-07-29. In SQL Plus, a bind variable is declared with variable [...] The value of the bind variable can then be printed with print <a href="http://www.adp-gmbh.ch/ora/sqlplus/use_vars.html" target="_blank">http://www.adp-gmbh.ch/ora/sqlplus/use_vars.html</a> <a href="#fnref:12" class="footnote-back-ref">↩</a></p></li>
<li id="fn:13"><p>Watt, Simon. "SQL Plus User's Guide and Reference". Oracle Help Center. Oracle Database Online Documentation, 10g Release 2 (10.2) / Administration. Oracle. p. 74. Retrieved 2015-11-04. WHENEVER SQLERROR [...] [d]irects SQL Plus to perform the specified action as soon as it detects a SQL command or PL/SQL block error (but after printing the error message). <a href="https://docs.oracle.com/cd/B19306_01/server.102/b14357/ch12052.htm" target="_blank">https://docs.oracle.com/cd/B19306_01/server.102/b14357/ch12052.htm</a> <a href="#fnref:13" class="footnote-back-ref">↩</a></p></li>
<li id="fn:14"><p>Watt, Simon. "SQL Plus User's Guide and Reference". Oracle Help Center. Oracle Database Online Documentation, 10g Release 2 (10.2) / Administration. Oracle. p. 73. Retrieved 2015-11-04. WHENEVER OSERROR [...] [d]irects SQL Plus to perform the specified action as soon as an operating system error is detected. <a href="https://docs.oracle.com/cd/B19306_01/server.102/b14357/ch12051.htm" target="_blank">https://docs.oracle.com/cd/B19306_01/server.102/b14357/ch12051.htm</a> <a href="#fnref:14" class="footnote-back-ref">↩</a></p></li>
<li id="fn:15"><p>"Oracle database services and products offer customers cost-optimized and high-performance versions of Oracle Database, the world's leading converged, multi-model database management system". <a href="https://www.oracle.com/database/" target="_blank">https://www.oracle.com/database/</a> <a href="#fnref:15" class="footnote-back-ref">↩</a></p></li>
</ol>

SQL Plus open-in-new

SQL Plus