No se han encontrado resultados

Su búsqueda no coincide con ningún resultado.

Le sugerimos que pruebe lo siguiente para poder encontrar lo que está buscando:

  • Verifique la ortografía de su búsqueda de palabras clave.
  • Utilice sinónimos para la palabra clave que escribió; por ejemplo, intente con “aplicación” en lugar de “software”.
  • Pruebe con una de las búsquedas populares que se muestran a continuación.
  • Comience una nueva búsqueda.
Tendencias de preguntas

primeros pasos con Oracle Developer Tools for VS Code

¡Bienvenidos! Oracle Developer Tools for VS Code permite a los desarrolladores de Visual Studio Code conectarse a Oracle Database y Oracle Autonomous Database, editar SQL y PL/SQL con autocompletar, intellisense, coloreado de sintaxis y fragmentos de código, ejecutar SQL y PL/SQL y ver y guardar los resultados en formatos como .CSV y JSON. El control de jerarquía de Oracle Database Explorer le permite explorar rápidamente el esquema de su base de datos, ver los datos de la tabla y editar, ejecutar y guardar PL/SQL.

Este guía rápida le ayudará a instalar, conectar, configurar y comenzar a usar Oracle Developer Tools for VS Code.

Nota: Este documento asume que está utilizando la versión 19.3.3 (publicada el 30/09/2019). Siga las siguientes instrucciones de actualización si está utilizando una versión anterior.

Inicio rápido

 

Instalar

  • Haga clic en el icono Extensions en la barra de actividad en un lateral de VS Code o use el comando View: Show Extensions (Ctrl+Shift+X)
  • Escriba Oracle en la barra de búsqueda de extensiones
  • Busque Oracle Developer Tools for VS Code y haga clic en Install
  • Cuando se complete la instalación, reinicie Visual Studio Code
  • Durante la instalación, es posible que deba instalar .NET Core Runtime. (.NET Core Runtime versión 2.1 funcionará, pero la versión 3.1 es preferible. Cualquier otra versión de ejecución no será suficiente. Se requiere la versión 3.1 para los usuarios de macOS que deseen conectarse a Oracle Autonomous Database). A continuación se muestran los enlaces para la instalación:

Actualizar esta extensión

  • Visual Studio Code busca automáticamente actualizaciones de extensiones y las instala. Después de actualizar, se le pedirá que reinicie Visual Studio Code.
  • Si ha deshabilitado las actualizaciones automáticas, presione F1 para abrir la Paleta de comandos, introduzca el comando Check for Extension Updates y haga clic en el botón Update..., que aparece en la lista de extensiones instaladas. Para más información, haga clic aquí.
  • Los usuarios de macOS que deseen conectarse a Oracle Autonomous Database deben instalar .NET Core Runtime versión 3.1.

Explore el esquema de base de datos con Oracle Database Explorer

  • Para ver el explorador de bases de datos, haga clic en el icono de la base de datos, en la barra de actividades que se encuentra en el extremo izquierdo en Visual Studio Code.
    • Conectar: Haga clic en el botón "+" para crear una nueva conexión siguiendo los pasos a continuación para conectarse a Oracle Database o para conectarse usando un alias de conexión TNSNAMES.ORA. Cuando aparezcan los nodos de conexión, puede hacer clic en el nodo para ver el esquema de la base de datos.
    • Eliminar conexión: Haga clic con el botón derecho en cualquier nodo de conexión y seleccione Delete
    • Actualizar información de conexión: Haga clic con el botón derecho en cualquier nodo de conexión y seleccione Update
    • Desconectar: Haga clic con el botón derecho en cualquier nodo de conexión y seleccione Disconnect
    • Ver Otros usuarios/Otros esquemas: Haga clic para expandir el nodo Other Users. Seleccione el esquema que quiera ver. También puede hacer clic en el nodo de conexión y seleccionar Update. En el cuadro de diálogo de conexión, marque la casilla Show more options y, a continuación, seleccione un esquema diferente en el menú desplegable Current Schema. Pulse el botón Update Connection.
    • Ver y guardar tabla/Ver datos: En el menú de un nodo Table and View, seleccione Show Data. Para más información, consulte Ver y guardar conjuntos de resultados, que encontrará más abajo.
    • Editar PL/SQL: En procedimientos, funciones, paquetes o nodos de activación almacenados, seleccione Edit/Edit Package Body/Edit Specification para abrir PL/SQL en un archivo y editarlo. Consulte Edición de PL/SQL existentes en su base de datos, a continuación, para obtener más detalles.
    • Guardar PL/SQL en la base de datos: Si el archivo PL/SQL se abrió con el elemento de menú Edit PL/SQL, puede guardar los cambios en la base de datos haciendo clic con el botón derecho en el código PL/SQL y seleccionando Save to Database
    • Guardar PL/SQL en archivo: Seleccione la pestaña con el código PL/SQL. En el menú Visual Studio Code, seleccione File->Save As
    • Ejecute PL/SQL: Desde el menú, seleccione Run para ejecutar un procedimiento o función almacenados
    • Actualizar: Haga clic derecho en cualquier nodo y seleccione Refresh para actualizar ese nodo y todos los nodos secundarios
    • Filtrar: Tras expandir una larga lista de nodos (por ejemplo, todas las tablas relacionales) puede filtrarlos pasando el ratón sobre cualquier parte de Oracle Database Explorer y escribiendo una cadena; a continuación, pulse Intro. Esto resaltará todas las coincidencias para esa cadena. A continuación, puede hacer clic en el icono de hamburguesa para mostrar solo coincidencias en Oracle Database Explorer.

Conexión a Oracle Database

  • (Si su base de datos está en Oracle Cloud, vaya a  Conexión a Oracle Autonomous Database , abajo)
  • Para conectarse a Oracle Database desde un archivo .SQL o .PL/SQL, pulse F1 para abrir la Paleta de comandos y seleccione Oracle:Connect en el menú desplegable
  • Para conectarse desde Oracle Database Explorer, haga clic en el botón con el signo "+"
  • Se abrirá un cuadro de diálogo de conexión. En el menú desplegable Connection Type, seleccione Basic
  • Introduzca el nombre de host, el número de puerto y el nombre del servicio de la base de datos
  • Seleccione el rol de la base de datos desde la lista desplegable Role
  • Introduzca el nombre de usuario y contraseña
  • Si está utilizando la autenticación de proxy, marque la casilla Show more options y proporcione el nombre de usuario y la contraseña de proxy
  • Si desea utilizar un esquema diferente al esquema predeterminado asociado con su nombre de usuario, marque la casilla Show more options y seleccione el nombre del esquema en el menú desplegable Current Schema
  • Suministre un nombre de conexión a utilizar para hacer referencia a esta conexión en Database Explorer y en otros lugares
  • Haga clic en el botón Create Connection

Conexión usando un alias de conexión TNSNAMES.ORA

  • Copie el archivo TNSNAMES.ORA que desea usar en el directorio configurado como Config Files Folder en Oracle Developer Tools for VS Code Extension Settings, o cambie esta configuración si lo prefiere. De manera predeterminada, la ubicación es ~/Oracle/network/admin en Linux y Mac, y %USERPROFILE%\Oracle\network\admin en Windows.
  • Si no tiene un TNSNAMES.ORA pero quisiera crear uno, vea el ejemplo ubicado en ~/.vscode/extensions/oracle.oracledevtools-19.3.3/sample/network en Linux y Mac, y %USERPROFILE%\.vscode\extensions\oracle.oracledevtools-19.3.3\sample\network en Windows .
  • Para conectarse a Oracle Database desde un archivo .SQL o .PL/SQL, pulse F1 para abrir la Paleta de comandos y seleccione Oracle:Connect en el menú desplegable
  • Para conectarse desde Oracle Database Explorer, haga clic en el botón con el signo "+"
  • Se abrirá un cuadro de diálogo de conexión. En el menú desplegable Connection Type, seleccione TNS Alias
  • Asegúrese de que el campo TNS Admin Location está configurado como el directorio en el que se encuentra el archivo TNSNAMES.ORA. Si no es así, cámbielo.
  • Seleccione un  alias de la lista desplegable TNS Alias
  • Seleccione el rol de la base de datos desde la lista desplegable Role
  • Introduzca el nombre de usuario y contraseña
  • Si está utilizando la autenticación de proxy, marque la casilla Show more options y proporcione el nombre de usuario y la contraseña de proxy
  • Si desea utilizar un esquema diferente al esquema predeterminado asociado con su nombre de usuario, marque la casilla Show more options y seleccione el nombre del esquema en el menú desplegable Current Schema
  • Suministre un nombre de conexión a utilizar para hacer referencia a esta conexión en Database Explorer y en otros lugares
  • Haga clic en el botón Create Connection

Conexión a Oracle Autonomous Database

  • Obtenga su archivo de credenciales de cliente: vaya a la Consola de administración para su Oracle Autonomous Database y haga clic en Download Client Credentials  . También se lo puede proporcionar su administrador.
  • Descomprima los archivos de credenciales en el directorio configurado como Config Files Folder en Oracle Developer Tools for VS Code Extension Settings. De manera predeterminada, la ubicación es ~/Oracle/network/admin en Linux y Mac, y %USERPROFILE%\Oracle\network\admin en Windows.
  • Para conectarse a Oracle Database desde un archivo .SQL o .PL/SQL, pulse F1 para abrir la Paleta de comandos y seleccione Oracle:Connect en el menú desplegable
  • Para conectarse desde Oracle Database Explorer, haga clic en el botón con el signo "+"
  • Se abrirá un cuadro de diálogo de conexión. En el menú desplegable Connection Type, seleccione TNS Alias
  • Asegúrese de que el campo TNS Admin Location esté configurado como el directorio en el que descomprimió los archivos de credenciales. Si no es así, cámbielo.
  • Compruebe la casilla Use Wallet File
  • Asegúrese de que el campo Wallet File Location esté configurado como el directorio en el que descomprimió los archivos de credenciales. Si no es así, cámbielo.
  • Seleccione el nombre de alias al que desea conectarse; por ejemplo mydb_high , desde la lista desplegable TNS Alias.
  • Seleccione Non-Administrator en la lista desplegable Role
  • Introduzca el nombre de usuario y contraseña. (Si usa Oracle Autonomous Database por primera vez, utilice el nombre de usuario ADMIN)
  • Si está utilizando la autenticación de proxy, marque la casilla Show more options y proporcione el nombre de usuario y la contraseña de proxy
  • Si desea utilizar un esquema diferente al esquema predeterminado asociado con su nombre de usuario, selecciónelo en el menú desplegable Current Schema
  • Suministre un nombre de conexión a utilizar para hacer referencia a esta conexión en Database Explorer y en otros lugares
  • Haga clic en el botón Create Connection
  • Si está utilizando macOS y recibe un error Connection request timed out (tiempo de solicitud de conexión agotado) al intentar conectarse, actualice .NET Core Runtime a la versión 3.1. Cualquier otra versión no será suficiente.

Conexión con un usuario proxy

  • Siga los pasos anteriores en Conexión a la base de datos OracleConexión usando un alias de conexión TNSNAMES.ORA para abrir el cuadro de diálogo de conexión y proporcionar la información de conexión
  • En el cuadro de diálogo de conexión, marque la casilla Show more options y proporcione el nombre de usuario y la contraseña de proxy

Conectar usando la autenticación del sistema operativo

  • Si usa el cliente de Windows y el servidor de base de datos de Windows, configure SQLNET.AUTHENTICATION_SERVICES=(NTS) en un archivo SQLNET.ORA ubicado en el directorio establecido como Config Files Folder en Oracle Developer Tools for VS Code Extension Settings. Por defecto, esta ubicación es %USERPROFILE%\Oracle\network\admin
  • Siga los pasos anteriores en Conexión a Oracle DatabaseConexión usando un alias de conexión TNSNAMES.ORA, excepto
  • si se le pide que introduzca un id de usuario "/" (sin las comillas).

Cambie el esquema predeterminado para una conexión

  • Para utilizar un esquema diferente al predeterminado para el usuario con el que inició sesión (por ejemplo, inició sesión como ADMIN pero desea utilizar de forma predeterminada el esquema RH al ejecutar SQL o al navegar con Oracle Explorer), siga los pasos anteriores en Conexión a la base de datos OracleConexión usando un alias de conexión TNSNAMES.ORA para abrir el cuadro de diálogo de conexión y proporcionar la información de conexión
  • En el cuadro de diálogo de conexión, marque la casilla Show more options y, a continuación, seleccione un esquema diferente en el menú desplegable Current Schema.
  • .

Ver otros esquemas en Oracle Explorer

  • En Oracle Explorer, haga clic para expandir el nodo Other Users. Seleccione el esquema que quiera ver.
  • Si va a utilizar principalmente el esquema alternativo y desea que sea el esquema predeterminado que se muestra en Oracle Explorer, siga los pasos anteriores para Cambiar el esquema predeterminado para una conexión
  • .

Editar PL/SQL existentes en su base de datos

  • Para ver el explorador de bases de datos, haga clic en el icono de la base de datos, en la barra de actividades que se encuentra en el extremo izquierdo en Visual Studio Code.
  • Si el panel del explorador de la base de datos está vacío (no aparecen nodos de conexión), haga clic en el botón de signo "+" para crear una nueva conexión, siguiendo los pasos anteriores de Conexión a Oracle Database o Conexión usando un alias de conexión TNSNAMES.ORA. Cuando aparezcan los nodos de conexión, puede hacer clic en el nodo para ver el esquema de la base de datos.
  • Navegue en el control de jerarquía hasta el paquete PL/SQL, función/procedimiento almacenado o disparador que desee editar.
  • Haga clic con el botón derecho en el paquete PL/SQL, función/procedimiento almacenado o disparador y seleccione Edit/Edit Package Body/Edit Specification para abrir PL/SQL en un archivo y editarlo.
  • Cuando termine la edición, haga clic con el botón derecho en el código PL/SQL y seleccione Save to Database

Abrir archivos .SQL o .PL/SQL existentes

  • En Oracle Explorer, haga clic con el botón derecho en un nodo de conexión y seleccione Open Existing SQL File.
  • Si no existe una conexión, cree una nueva presionando el icono más (+) y siga los pasos Conexión a Oracle Database o Conexión usando un alias de conexión TNSNAMES.ORA anteriores.
  • (Nota: Puede guardar PL/SQL en su base de datos en un archivo; para hacerlo, vaya a Oracle Database Explorer, abra un paquete, procedimiento, función o disparador en el explorador y, a continuación, en el menú Visual Studio Code seleccione File->Save As)

Cambiar la conexión de la base de datos para un archivo Open .SQL o .PL/SQL

  • Pulse F1 para abrir la Paleta de comandos y seleccione Oracle Update Connection en el menú desplegable
  • Si se le solicita, seleccione Oracle-SQL and PLSQL en el menú desplegable de idiomas.
  • Seleccione un perfil de conexión existente de la lista o cree uno nuevo siguiendo los pasos anteriores Conexión a Oracle Database o Conexión usando un alias de conexión TNSNAMES.ORA.

Crear un nuevo archivo .SQL o .PLSQL

  • En Oracle Explorer, haga clic con el botón derecho en un nodo de conexión existente y seleccione Open New SQL File. Si no existe una conexión, cree una nueva presionando el icono más (+) y siga los pasos Conexión a Oracle Database o Conexión usando un alias de conexión TNSNAMES.ORA anteriores.
  • También puede pulsar F1 para abrir la paleta de comandos y seleccionar Oracle:Develop New SQL or PLSQL en el menú desplegable. Seleccione un perfil de conexión existente de la lista o cree uno nuevo
  • Cuando termine la edición, en el menú VS Code, seleccione File->Save As para guardar el archivo.
  • También puede ejecutar el comando SQL*Plus CONNECT. Este comando asociará el archivo con la conexión especificada en el comando.

Ejecutar SQL y PL/SQL

  • Escriba el SQL o PL/SQL que desee ejecutar en el archivo .SQL o .PLSQL
  • Mientras escribe, la función autocompletar le mostrará sugerencias; por ejemplo, nombres de columnas. Puedes hacer clic en el icono i en las sugerencias para obtener más detalles, como los objetos de esquema con los que está asociada la sugerencia. Use las teclas de flecha para navegar por las sugerencias y la tecla Intro para seleccionar una.
  • Escriba un nombre de esquema seguido de un punto; por ejemplo HR. para usar intellisense a fin de ver y seleccionar objetos de base de datos.
  • Mientras escribe, es posible que aparezcan algunas sugerencias de fragmentos de código. Puede ver más fragmentos escribiendo oracle en una nueva línea.
  • Coloque el cursor en una línea que contenga el SQL o PL/SQL que desea ejecutar. También puede seleccionar (resaltar) una o más expresiones SQL o PL/SQL. Haga clic con el botón derecho y seleccione Execute SQL en el menú. Seleccione Execute All si desea ejecutar todos los SQL y PL/SQL en el archivo actual.
  • Después de ejecutar SQL, se abrirá un nuevo documento (ventana de resultados) o los resultados se agregarán a una ventana de resultados abierta. El número máximo de filas que se pueden devolver está controlado por la configuración de la extensión Max Rows. Se irán recuperando más filas a medida que se desplace por ellas, hasta este máximo.
  • Para borrar la ventana de resultados, haga clic en el botón Clear Results Window ubicado en el área cerca de las pestañas del documento. Para cambiar el valor predeterminado para borrar siempre la ventana de resultados después de cada ejecución, cambie la configuración de la extensión Ventana de resultados claros.
  • De forma predeterminada, las instrucciones SQL se confirmarán automáticamente (la confirmación automática está activada). Para cambiar esto, consulte Desactivar/Activar confirmación automática en la sección siguiente.
  • Además de SQL y PL/SQL, también puede introducir comandos SQL*Plus. Para obtener más información, consulte la sección Ejecución de comandos SQL*Plus a continuación y visite Uso de comandos SQL*Plus con Oracle Developer Tools for VS Code

Ejecución de comandos SQL*Plus

  • Los comandos SQL*Plus brindan funciones útiles como conectarse y desconectarse, habilitar y deshabilitar la confirmación automática, ejecutar otros scripts SQL*Plus, describir metadatos de objetos de base de datos, definir y usar variables de sustitución, definir y usar variables de vinculación, controlar el tamaño de visualización de salida, guardar la salida de script a un archivo y mucho más. Para ejecutar comandos SQL*Plus, haga lo siguiente:
  • Escriba un comando SQL*Plus en el archivo .SQL o .PLSQL
  • Aparecerán sugerencias de autocompletado a medida que vaya escribiendo
  • Seleccione (resalte) uno o más comandos SQL*Plus e instrucciones SQL o PL/SQL. Haga clic con el botón derecho y seleccione Execute SQL en el menú. Seleccione Execute All si desea ejecutar todos los comandos SQL*Plus, SQL y PL/SQL en el archivo actual.
  • Si no se admiten uno más comandos SQL*Plus, recibirá un mensaje de advertencia
  • El comando SQL*Plus CONNECT asociará el archivo con la conexión especificada en el comando. Después de ejecutar este comando, IntelliSense/autocompletado usará la nueva conexión y esquema.
  • Para obtener más información, incluida una guía de referencia de los comandos SQL*Plus compatibles, visite Uso de comandos SQL*Plus con Oracle Developer Tools for VS Code

Desactivar/Activar confirmación automática

  • Al ejecutar varias instrucciones SQL (por ejemplo, ejecutar un script), la confirmación automática confirma automáticamente el trabajo después de cada instrucción. Si la confirmación automática está deshabilitada, se puede usar una instrucción COMMIT o ROLLBACK explícita para controlar el comportamiento
  • En su archivo SQL, introduzca SET AUTOCOMMIT OFF o SET AUTOCOMMIT ON, haga clic con el botón derecho y seleccione Execute SQL en el menú. Esta configuración de confirmación automática estará vigente durante la vida útil de su conexión y anulará la configuración de extensión predeterminada.
  • Para establecer el valor predeterminado para todos los archivos SQL abiertos con esta extensión, pulse F1 para abrir la paleta de comandos e introduzca el comando Preferences: Open Settings (UI)
  • Expanda el nodo Extensions y seleccione Oracle Developer Tools for VS Code Configuration.
  • Marque la casilla SQLPlus:Auto Commit para habilitar la confirmación automática y desmárquela para deshabilitarla

Ver y guardar conjuntos de resultados

  • Después de ejecutar SQL, se abrirá un nuevo documento (ventana de resultados) con el conjunto de resultados o los resultados se agregarán a una ventana de resultados abierta. El número máximo de filas que se pueden devolver está controlado por la configuración de la extensión Max Rows. Se irán recuperando más filas a medida que se desplace por ellas, hasta este máximo.
  • Para guardar los resultados, elija el formato: .CSV o JSON. Luego, haga clic en el icono para Save Selected Rows o Save All Rows. Después de proporcionar el nombre y la ubicación del archivo, el archivo se abrirá en Visual Studio Code.
  • Para copiar las filas seleccionadas al portapapeles, haga clic en el icono Copy Selected Row(s) to Clipboard
  • Para borrar la ventana de resultados, haga clic en el botón Clear Results Window ubicado en el área cerca de las pestañas del documento. Para cambiar el valor predeterminado para borrar siempre la ventana de resultados después de cada ejecución, cambie la configuración de la extensión Ventana de resultados claros.

Ver historial de SQL

  • En Oracle Explorer, haga clic en el control History para abrirlo.
  • Expanda el nombre de la conexión para la que quiera ver el historial. Se enumerarán los comandos SQL ejecutados previamente desde esta sesión.
  • Coloque el cursor sobre un marcador para ver información sobre herramientas que contenga la instrucción completa.
  • Para ejecutar una instrucción SQL directamente desde el historial, haga clic con el botón derecho sobre ella y seleccione Run.
  • Para copiar el SQL a un editor abierto, haga clic con el botón derecho sobre él y seleccione Copy to Editor.
  • El historial de SQL no persiste entre sesiones. Para almacenamiento permanente, guarde el SQL como marcador haciendo clic con el botón derecho y seleccionando Bookmark SQL en el menú.

Crear un marcador SQL

  • Seleccione una o más líneas de SQL o PL/SQL en el editor, haga clic con el botón derecho y seleccione Bookmark SQL en el menú
  • Proporcione un nombre para el marcador y otro para la carpeta
  • En Oracle Explorer, haga clic en el control Bookmarks para abrirlo.
  • Expanda el nombre de la carpeta. Se mostrarán los marcadores.
  • Coloque el cursor sobre un marcador para ver información sobre herramientas que contenga la instrucción completa.
  • Para ejecutar la instrucción SQL directamente, haga clic con el botón derecho en el marcador y seleccione Run.
  • Para copiar el SQL a un editor abierto, haga clic en el marcador.
  • Para copiar el SQL a un nuevo archivo SQL, haga clic con el botón derecho en el marcador y elija Open in Editor en el menú.

Usar un patrón de edición horizontal

  • Para modificar el diseño de ventana predeterminado en Visual Studio Code y dividir la pantalla horizontalmente; por ejemplo, para tener un archivo .SQL en un panel superior y los resultados de la ejecución SQL en un panel inferior, haga lo siguiente:
  • En el menú VS Code, seleccione View->Editor Layout->Two Rows.
  • Ejecute algunos SQL o PL/SQL como se describe arriba en Execute SQL and PL/SQL
  • Arrastre la pestaña de resultados SQL al panel inferior.
  • Cualquier ejecución adicional de SQL continuará apareciendo en esta pestaña, en el panel inferior, hasta que se cierre.

Crear o modificar atajos de teclado

  • Para crear atajos de teclado (combinaciones de teclas) o modificar los existentes, vaya al menú File en VS Code y seleccione Preferences->Keyboard Shortcuts
  • En el cuadro de texto de búsqueda, introduzca una parte del nombre de la extensión cuyo acceso directo desea modificar; por ejemplo "oracle".
  • Aparecerá una lista de comandos y sus accesos directos. Haga clic en el ícono de lápiz en el lado izquierdo de una fila para editar un acceso directo, o en  + (signo más) para crear uno nuevo.
  • Cuando se le solicite, introduzca la combinación de teclas y, si no está ya en uso, pulse Intro. Si ya hay otra extensión que usa esa combinación, pulse escape e inténtelo de nuevo.
  • Para eliminar un acceso directo, haga clic con el botón derecho en el acceso y seleccione Remove Keybinding

Conozca las novedades de la versión 19.3.3

Obtener ayuda o dar comentarios