Guía de Comandos SQL*Plus
Referencia rápida y detallada — Capítulo 3
¿Qué es SQL*Plus?
SQL*Plus es una herramienta de Oracle que te permite escribir, editar y ejecutar comandos SQL.
Tiene sus propios comandos especiales (comandos SQL*Plus) que NO se guardan en el buffer ni
necesitan punto y coma (;). Los comandos SQL sí se guardan en el buffer.
1. El Buffer — ¿Qué es?
El buffer es una memoria temporal donde Oracle guarda el último comando SQL que escribiste. Los
comandos SQL*Plus NO se guardan ahí. Puedes ver, editar y re-ejecutar lo que está en el buffer.
2. Comando LIST (o L) — Ver el contenido del buffer
Sirve para visualizar las líneas del comando SQL que está almacenado en el buffer. La línea actual
se marca con un asterisco (*).
Opciones disponibles:
Comando / Sintaxis ¿Para qué sirve? Ejemplo
LIST o L Muestra el comando completo L
guardado en el buffer.
LIST n ej: LIST 2 Muestra solo la línea número n. LIST 2
LIST n m ej: LIST 2 6 Muestra desde la línea n hasta la LIST 2 6
línea m.
LIST n LAST ej: LIST Muestra desde la línea n hasta la LIST 2 LAST
2 LAST última línea.
LIST n* ej: LIST 2* Muestra desde la línea n hasta la LIST 2*
línea actual.
LIST * Muestra solo la línea actual LIST *
(marcada con *).
LIST * n ej: LIST * 2 Desde la línea actual hasta la línea LIST * 2
n.
LIST * LAST Desde la línea actual hasta la última. LIST * LAST
LIST LAST Muestra solo la última línea del LIST LAST
comando.
3. Comando RUN (o /) — Ejecutar el comando del buffer
Sirve para ejecutar el último comando SQL guardado en el buffer.
Comando / Sintaxis ¿Para qué sirve? Ejemplo
RUN Muestra el comando en pantalla y SQL> RUN
luego lo ejecuta.
/ Ejecuta el comando directamente SQL> /
SIN mostrarlo en pantalla.
4. Comando CHANGE (o C) — Corregir errores en el buffer
Sirve para reemplazar texto erróneo en una línea del buffer sin reescribir toda la instrucción.
Sintaxis:
L<número de línea con error>
CHANGE /texto_erróneo/texto_nuevo/
Ejemplo — Corregir 'APELLDO' por 'APELLIDO':
SQL> L2 ← seleccionas la línea 2
SQL> C /APELLDO/APELLIDO/ ← corriges el error
Reglas importantes:
• CHANGE es un comando SQL*Plus: NO se guarda en el buffer ni necesita punto y coma.
• Las diagonales / son los separadores (también puedes usar ! como separador).
• NO dejes espacios entre los separadores y el texto — los espacios se tomarían como parte del
texto a buscar.
• Si solo pones CHANGE /texto/ sin texto nuevo, se elimina el texto de esa línea.
5. Comando INPUT (o I) — Agregar líneas al buffer
Sirve para añadir una o varias líneas al comando que ya está en el buffer, ya sea al final o
después de una línea específica.
Comando / Sintaxis ¿Para qué sirve? Ejemplo
INPUT INPUT texto o I Agrega una línea después de la línea INPUT ORDER BY
texto actual. Si escribes texto APELLIDO;
directamente, lo agrega en esa
misma línea.
Ejemplo completo:
SQL> SELECT APELLIDO, NOMBRE, CIUDAD
2 FROM DIR_EMP ← línea actual
SQL> INPUT ORDER BY APELLIDO; ← agrega esta línea al final
6. Comando APPEND (o A) — Agregar texto al final de una línea
Sirve para añadir texto al final de la línea actual del buffer (no crea una línea nueva, solo extiende la
existente).
APPEND texto o A texto
⚠️Debes dejar un espacio entre APPEND y el texto que quieres agregar.
7. Comando DEL — Eliminar la línea actual
Sirve para borrar la línea actual del buffer. La línea actual es la que está marcada con asterisco (*).
DEL
8. Comando CLEAR BUFFER (o CL BUFF) — Vaciar el buffer
Sirve para borrar completamente todo el contenido del buffer. Útil antes de escribir un nuevo
comando desde cero.
CLEAR BUFFER o CL BUFF
9. Comandos SAVE y GET — Guardar y cargar archivos de
comandos
SAVE — Guardar el buffer en un archivo:
Sirve para guardar el comando del buffer en un archivo .SQL para poder reutilizarlo después.
Oracle agrega la extensión .SQL automáticamente.
SAVE nombre_archivo
Ejemplo:
SAVE INSERT ← crea el archivo [Link]
GET — Cargar un archivo al buffer:
Sirve para cargar un archivo de comandos guardado previamente al buffer.
GET nombre_archivo
10. Comandos Interactivos: PROMPT, ACCEPT y PAUSE
Estos tres comandos trabajan juntos para crear una comunicación amigable con el usuario al momento
de ingresar datos.
Comando / Sintaxis ¿Para qué sirve? Ejemplo
PROMPT texto Muestra un mensaje en pantalla al PROMPT Ingrese número de
usuario (como instrucciones o empleado:
advertencias). NO espera respuesta.
ACCEPT variable TYPE Muestra un mensaje Y espera que el ACCEPT NUMEMP NUMBER
PROMPT 'mensaje' usuario escriba un valor. Guarda lo PROMPT 'Número:'
que escribe en una variable.
PAUSE Detiene la ejecución y espera a que PAUSE
el usuario presione Enter para
continuar.
Ejemplo completo usando los tres:
SQL> CLEAR BUFFER
SQL> INPUT
1 PROMPT Introduzca un número válido de empleado
2 PROMPT Por ejemplo: 001, 002, 003
3 ACCEPT NUMEMP NUMBER PROMPT "Número de empleado:"
4 PROMPT Antes de continuar, asegúrese del número correcto
Resumen rápido — Todos los comandos
Comando / Sintaxis ¿Para qué sirve? Ejemplo
LIST o L Ver el contenido del buffer. L
RUN Ejecutar y mostrar el comando del RUN
buffer.
/ Ejecutar el comando del buffer sin /
mostrarlo.
CHANGE /x/y/ Reemplazar texto x por y en la línea C /ERRROR/ERROR/
actual.
INPUT texto Agregar una línea después de la I ORDER BY NOMBRE;
línea actual.
APPEND texto Agregar texto al final de la línea A , CIUDAD
actual.
DEL Eliminar la línea actual del buffer. DEL
CLEAR BUFFER Vaciar completamente el buffer. CL BUFF
SAVE archivo Guardar el buffer en un SAVE CONSULTA
archivo .SQL.
GET archivo Cargar un archivo .SQL al buffer. GET CONSULTA
PROMPT texto Mostrar un mensaje al usuario. PROMPT Ingrese dato:
ACCEPT var TYPE Pedir datos al usuario y guardarlos ACCEPT ID NUMBER
PROMPT 'msg' en variable. PROMPT 'ID:'
PAUSE Pausar hasta que el usuario presione PAUSE
Enter.
Recuerda: Los comandos SQL*Plus NO usan punto y coma ( ; ) y NO se guardan en el buffer.