Comentarios de Oracle PL/SQL

En bases de datos, los comentarios se refieren al texto que no se ejecuta como parte de un comando o consulta. Los comentarios de la base de datos se utilizan principalmente para agregar notas explicativas, documentación u otra información meta a una base de datos y pueden ayudar a aclarar el propósito y la intención del código.

También encontrará los comentarios en varios contextos de bases de datos, como procedimientos almacenados, funciones, desencadenantes y vistas. Pueden proporcionar las explicaciones del código, los cambios o modificaciones de documentos, o dejar notas para los otros desarrolladores que trabajan en la misma base de código.

En este tutorial, aprenderá cómo usar y trabajar con los diversos tipos de comentarios en lenguaje PL/SQL.

Comentarios de una sola línea

El primer tipo de comentario en las bases de datos de Oracle son los comentarios de una sola línea. Los comentarios de una sola línea son comentarios que abarcan una sola línea.

En PL/SQL, un comentario de una sola línea comienza con dos guiones (-) y se extiende hasta el final de la línea. El motor de la base de datos ignora cualquier texto o caracteres que viene después de las guiones cuando se ejecuta el código.

Lo siguiente muestra el ejemplo de un comentario de una sola línea en Oracle:

COMENZAR
-- Este es un comentario de una sola línea
DECLARAR
nombre VARCHAR2 (30);
COMENZAR
nombre: = 'Peter';
FIN;
FIN;

En este caso, el texto después del comentario se trata como un comentario y se ignora durante la ejecución de comandos.

Además de agregar la meta información a un bloque de código determinado, los comentarios de una sola línea ayudan a deshabilitar un código.

Un ejemplo es el siguiente:

-- Insertar en productos (Product_Name, Cantidad, precio) Valores ('Microsoft Volterra', 0, 599);

Aunque la declaración anterior es un comando PL/SQL válido, el motor de la base de datos no la ejecuta, ya que se trata como un comentario.

Comentario de Oracle múltiples

El segundo tipo de comentarios en las bases de datos de Oracle son los comentarios de múltiples líneas. Estos son el tipo de comentarios que pueden abarcar múltiples líneas.

Un comentario de múltiples líneas en Oracle comienza con un corte hacia adelante y un asterisco (/*). El comentario puede abarcar tantas líneas como sea posible. Para finalizar un comentario de múltiples líneas, comience con un asterisco y una barra de avance (*/).

Ejemplo:

COMENZAR
/*
Este es un comentario de múltiples líneas.
Puede abarcar múltiples líneas y puede usarse para proporcionar explicaciones o documentación más detalladas.
*/
DECLARAR
nombre VARCHAR2 (30);
COMENZAR
nombre: = Peter ';
FIN;
FIN;

También podemos usar un comentario de múltiples líneas como comentario de una sola línea:

Seleccionar * de los empleados; / * Este es un comentario de varias líneas que abarca una sola línea */

Allí, aprendiste a trabajar con comentarios de una sola línea y de múltiples líneas en PL/SQL.

Es bueno tener en cuenta que Oracle no admite los comentarios múltiples anidados. Por ejemplo, el siguiente código no es válido:

COMENZAR
/* Este es un comentario de múltiples líneas
/ * Este es un comentario múltiple anidado */
*/
DECLARAR
nombre VARCHAR2 (30);
COMENZAR
nombre: = 'Peter';
FIN;
FIN;

La consulta anterior falla ya que los comentarios de varias líneas anidados no son compatibles.

Si desea agregar un comentario anidado, puede combinar los comentarios de múltiples líneas y de una sola línea como se muestra a continuación:

COMENZAR
/* Este es un comentario de múltiples líneas
-- Este es un comentario de una sola línea dentro del comentario de múltiples líneas
*/
DECLARAR
nombre VARCHAR2 (30);
COMENZAR
nombre: = 'Peter';
FIN;
FIN;

Conclusión

En este tutorial, aprendió cómo usar los diversos tipos de comentarios en PL/SQL para agregar una documentación a su código.