Ejecución de código SQL, PL/SQL y JavaScript en el editor de hojas de trabajo

Puede ejecutar sentencias SQL, scripts PL/SQL y código JavaScript en el editor de SQL Worksheet. Algunas funciones destacadas del editor son la finalización de código en contexto, el resaltado de sintaxis y la depuración de errores.

Nota

Los modos de editor PL/SQL y JavaScript no están disponibles para los servicios de base de datos MySQL.

Puede introducir sentencias SQL o bloques de código PL/SQL para especificar acciones como crear una tabla, insertar datos, seleccionar datos o suprimir datos de una tabla. Las palabras clave SQL se resaltan automáticamente. Para varias sentencias, debe terminar:

  • Cada sentencia no PL/SQL con un punto y coma (;) o una barra (/) en una nueva línea
  • Cada sentencia PL/SQL con una barra (/) en una nueva línea

Para las sentencias SQL*Plus y SQLcl soportadas en la hoja de trabajo, consulte Comandos SQL*Plus y SQLcl soportados en la hoja de trabajo SQL.

El modo de editor PL/SQL se dispara en la hoja de trabajo al abrir los siguientes tipos de objetos: funciones, procedimientos, paquetes y tipos. Este editor le ayuda a detectar errores en el código PL/SQL durante la compilación. La salida incluye detalles de error como la línea y la columna específicas donde se detecta el error, junto con un enlace para ir a la posición relevante en el bloque de código.

El modo de hoja de trabajo JavaScript soporta la función Multilingual Engine introducida en Oracle Database versión 21c. Para obtener más información, consulte Soporte para Multilingual Engine.

Ayuda del editor de código

Si pulsa Ctrl+Space, el editor le proporciona una lista de posibles finalizaciones en el punto de inserción que puede utilizar para completar automáticamente el código que está editando. Esta lista se basa en el contexto del código en el punto de inserción.

En esta imagen se muestra una lista de las posibles compleciones que puede utilizar para autocompletar el código.

El editor también ofrece una lista completa de comandos disponibles a través de la paleta de comandos. Para abrir la paleta de comandos, pulse Ctrl+Shift+P. Para obtener una lista de las teclas de método abreviado del teclado, consulte Keyboard Shortcuts.

Un error en el código está indicado por un punto rojo en el canalón izquierdo y una línea de conmutación debajo del texto específico. Al pasar el cursor sobre él, verá una ventana emergente que muestra posibles correcciones para resolver el error.

En esta imagen se muestra cómo se identifica un error en el código junto con una lista de sugerencias sobre cómo resolver el error.

Arrastrar y soltar objetos para generar sentencias SQL automáticamente

Nota

Esta función no está disponible para los servicios de base de datos MySQL.

Puede arrastrar objetos desde el panel izquierdo y soltarlos en el editor de hojas de trabajo del panel derecho.

  • Si arrastra y suelta una tabla o vista, se le pedirá que seleccione una de las siguientes sentencias SQL: Insertar, Actualizar, Seleccionar o Suprimir.

    Por ejemplo, si selecciona Seleccionar, se crea una sentencia Select con todas las columnas de la tabla o vista. A continuación, puede editar la sentencia, por ejemplo, modificando la lista de columnas o agregando una cláusula WHERE.

    En esta imagen se muestra el código SQL que se genera para un objeto en el editor de hojas de trabajo cuando se selecciona la sentencia SELECT.

    Si selecciona Nombre de objeto, el nombre del objeto precedido por el nombre de esquema se agrega a la hoja de trabajo.

  • Si arrastra y suelta una función o procedimiento, puede optar por insertar el nombre o el código PL/SQL de la función o procedimiento en la hoja de trabajo. Si selecciona código PL/SQL, puede introducir los parámetros antes de insertar el código en la hoja de trabajo.

Definir Preferencias del Editor

Puede definir las preferencias del editor de código mediante la opción Preferencias disponible en la barra lateral izquierda. Algunas de las opciones del editor de código que puede personalizar son Theme (Light, Dark y High contrast Dark), Font size and family, Tab size, Word wrap, Ruler, Line numbers, etc.

Iconos de barra de herramientas

La barra de herramientas del editor de hoja de trabajo de SQL contiene iconos para las siguientes operaciones:

  • Hoja de trabajo lista desplegable

    • Abrir: abra un archivo desde el explorador, el dispositivo o el almacenamiento de objetos.
    • Abrir reciente: muestra los archivos a los que se ha accedido recientemente. Si hay más de cinco archivos en la lista reciente, se muestra un enlace Más para ver los archivos adicionales.
    • Guardar como: guarde un archivo en el explorador, el dispositivo o el almacenamiento de objetos.
  • Nuevo archivo
    • Seleccione Hoja de trabajo: cree una hoja de trabajo.
    • Seleccione PL/SQL: cree un tipo de objeto PL/SQL. El editor cambia a un modo PL/SQL.
  • Abrir: abra un archivo desde el explorador, el dispositivo o el almacenamiento de objetos. Para abrir un archivo desde el dispositivo, en el control deslizante Abrir archivo, haga clic en Abrir archivo y busque seleccionar el archivo, o arrastre y suelte el archivo en el control deslizante.
  • Ejecutar sentencia: ejecute las sentencias seleccionadas o la sentencia en el puntero del mouse en el editor de la hoja de trabajo. Las sentencias SQL pueden incluir variables de enlace y variables de sustitución del tipo VARCHAR2. Se muestra un cuadro de diálogo para introducir valores de variables.

  • Ejecutar script: ejecute todas las sentencias en el editor de la hoja de trabajo mediante el programa Script Runner. Las sentencias SQL pueden incluir variables de enlace (pero no variables de sustitución) de tipo VARCHAR2. Se muestra un cuadro de diálogo para introducir valores de variables de enlace.

  • Compilar (para la barra de herramientas PL/SQL): realice una compilación PL/SQL del subprograma.

    Nota

    El icono Compilar no está disponible para los servicios de base de datos MySQL.
  • Explorar plan: genere el plan de ejecución para la sentencia. La salida se muestra en el separador Explain Plan del panel de salida. Consulte Uso del diagrama Explain Plan

    Nota

    El icono Explicar plan no está disponible para los servicios de base de datos MySQL.
  • Rastreo automático: ejecute la sentencia y muestre las estadísticas de ejecución de la sentencia SQL y el plan de ejecución real. La salida se muestra en el separador Autotrace del panel de salida.

    Nota

    El icono de rastreo automático no está disponible para los servicios de base de datos MySQL.
  • Descargar contenido del editor: descargue el contenido de la hoja de trabajo como archivo SQL en el sistema local.

  • Formato: formatear la sentencia SQL en el editor, como capitalizar los nombres de sentencias, cláusulas, palabras clave y agregar saltos de línea y sangría.

  • Borrar: elimine las sentencias del editor.

  • Abrir en pantalla completa: abra el editor en modo de pantalla completa.

  • Carga de datos: abra el asistente de carga de datos. Consulte Carga de datos.

    Nota

    El icono Carga de datos no está disponible para los servicios de base de datos MySQL.