Compartir a través de

Inicio rápido: Conexión y consulta de una base de datos con la extensión PostgreSQL para visual Studio Code (versión preliminar)

La extensión postgreSQL para Visual Studio Code es una herramienta eficaz diseñada para simplificar el desarrollo y la administración de bases de datos PostgreSQL. En esta guía se explica cómo conectarse a una base de datos postgreSQL y ejecutar consultas en el entorno de Visual Studio Code.

Prerrequisitos

Antes de empezar, compruebe que tiene las herramientas y los recursos adecuados descargados e instalados.

Estas herramientas y recursos le ayudan a seguir este artículo y a aprovechar la integración de GitHub Copilot para la extensión PostgreSQL en Visual Studio Code.

Instalación de la extensión PostgreSQL

Para instalar la extensión PostgreSQL:

  1. Abra Visual Studio Code y vaya a la vista Extensiones seleccionando el icono Extensiones en la barra de actividad o mediante el comando Ver: Extensiones .
  2. Busque PostgreSQL en El Marketplace de extensiones.
  3. Seleccione la extensión postgreSQL que ha creado Microsoft y seleccione Instalar.

Una vez instalada, la página PostgreSQL, representada por un icono de elefante, aparece en la barra lateral de Visual Studio Code.

Adición de una conexión a PostgreSQL

Tanto si se hospeda localmente como en un servidor remoto, la conexión a una base de datos postgreSQL es un paso fundamental para administrar e interactuar con los datos. Este proceso implica proporcionar los detalles de conexión necesarios, como la dirección del servidor, el puerto y las credenciales de autenticación, para establecer un vínculo seguro entre la aplicación cliente y la base de datos. Con la extensión PostgreSQL para Visual Studio Code, puede conectarse sin problemas a la base de datos y usar herramientas eficaces para consultar, administrar y explorar los datos de forma eficaz.

  1. Seleccione el icono de elefante en la barra lateral para abrir la página de extensión postgreSQL.

  2. Seleccione el botón Agregar conexión .

  3. Escriba los detalles de conexión manualmente o use el formato de cadena de conexión:

      psql -h <server>.postgres.database.azure.com -p 5432 -U

  4. Si usa Azure, inicie sesión en su cuenta de Azure y busque la instancia de base de datos. Filtre por suscripción, grupo de recursos, servidor y nombre de base de datos.

Autenticación

La extensión admite dos métodos de autenticación:

  • Nombre de usuario y contraseña: escriba las credenciales de la base de datos directamente en los campos de conexión.
  • Autenticación de Microsoft Entra ID: agregue la cuenta de id. de Microsoft Entra para las bases de datos hospedadas en Azure.

Captura de pantalla del cuadro de diálogo de conexión de la extensión postgreSQL para VS Code.

Probar y guardar la conexión

  1. Seleccione "Probar conexión" para comprobar los detalles de la conexión.
  2. Tras realizar pruebas correctas, la casilla muestra una marca de verificación.
  3. Seleccione "Conectar" para establecer la conexión.
  4. Tu conexión se guarda y aparece automáticamente en la ventana Conexiones.

Exploración de objetos de base de datos

El Explorador de objetos proporciona una vista jerárquica de los objetos de base de datos:

  • Expanda el elemento de base de datos para ver esquemas, tablas, vistas, funciones y procedimientos almacenados.
  • Haga clic con el botón derecho en la base de datos y verá opciones para: - Iniciar una nueva consulta - Chat con esta base de datos (inicia la experiencia de chat pgsql): conexión con PSQL para iniciar una conexión de terminal psql
  • Haga clic con el botón derecho en una tabla y seleccione "Seleccionar top 1000" para ver sus datos. La consulta se abre en el Editor de consultas y los resultados aparecen en la pestaña Visor de resultados.

Ejecutar consultas

Use el Editor de consultas para redactar y ejecutar consultas SQL:

  • Aproveche IntelliSense compatible con el contexto para autocompletar las palabras clave de SQL y los nombres de objeto.
  • El resaltado de sintaxis y el formato automático garantizan una mejor legibilidad y precisión.
  • Acceda a las consultas ejecutadas anteriormente a través del panel Historial de consultas.

Revisión de los resultados de la consulta

El Visor de resultados ofrece características avanzadas para interactuar con los resultados de la consulta:

  • Exporte los resultados a formatos CSV, JSON o Excel para su posterior análisis.
  • Use opciones de búsqueda, filtro y ordenación para refinar los datos.
  • Las vistas de datos persistentes mantienen el contexto al cambiar entre pestañas.

Uso de GitHub Copilot para obtener asistencia avanzada

La integración de GitHub Copilot mejora la experiencia de desarrollo de PostgreSQL al proporcionar sugerencias de código con tecnología de inteligencia artificial, sugerencias de optimización de consultas y asistencia interactiva para bases de datos. Esta característica le permite simplificar el flujo de trabajo, reducir el tiempo de desarrollo y obtener información más detallada sobre las operaciones de la base de datos. Esta sección le guía por los pasos para activar y usar Copilot dentro de la extensión PostgreSQL para Visual Studio Code.

Asegúrese de que están instaladas las extensiones De GitHub Copilot y Copilot Chat.

Inicie sesión en su cuenta de GitHub y habilite el @pgsql agente de Chat de Copilot en la configuración de la extensión.

Mensajes interactivos de base de datos

Haga clic con el botón derecho en una base de datos y elija Chat con esta base de datos para interactuar con Copilot.

Escriba mensajes como el ejemplo siguiente para recibir información detallada y sugerencias.

@pgsql tell me about the tables in the HR schema

Para obtener más información, visite Configuración de GitHub Copilot

Conexión a una instancia de servidor flexible de Azure Database for PostgreSQL con VS Code desde Azure Portal

Para conectarse a una instancia de servidor flexible de Azure Database for PostgreSQL mediante Visual Studio Code, siga estos pasos:

  1. Inicie sesión en Azure Portal y busque la instancia de servidor flexible de Azure Database for PostgreSQL.
  2. Vaya a la página Información general de la instancia del servidor.

Conexión con VS Code

La opción "Conectar con Visual Studio Code" en Azure Portal simplifica la conexión al servidor flexible de Azure Database for PostgreSQL. Esta característica simplifica la configuración guiándole por los requisitos previos necesarios y configurando automáticamente los detalles de conexión. Con esta integración, puede establecer rápidamente una conexión y administrar la base de datos directamente en el entorno de Visual Studio Code.

  • Seleccione el botón Conectar con VS Code destacado en la página Información general.
  • Aparece un panel lateral en el que se enumeran los requisitos para conectarse mediante VS Code.

Captura de pantalla de Azure Portal que muestra una instancia de Azure Database for PostgreSQL con el botón Conectar con VS Code.

Confirmación de los requisitos

  • En el panel lateral, confirme que se cumplen todos los requisitos previos (extensión vs Code y PostgreSQL) activando las casillas adecuadas.

  • Si es necesario, descargue Visual Studio Code y la extensión mediante los vínculos del panel lateral.

  • Opcionalmente, rellene los parámetros de conexión, como el nombre predeterminado de la base de datos, el método de autenticación y la agrupación de conexiones.

    Captura de pantalla de Azure Portal en la que se muestra una instancia de Azure Database for PostgreSQL con el panel Conectar con VS Code. El botón Abrir en Visual Studio Code está resaltado.

Abrir en Visual Studio Code

  • Seleccione el botón Abrir en Visual Studio Code en el panel lateral.
  • Aparece un botón "Volver a intentar abrir en Visual Studio Code" en el panel lateral en caso de que Visual Studio Code y la extensión tarda más de 40 segundos en abrirse.

Iniciar Visual Studio Code

  • Si VS Code está instalado y en ejecución, el cuadro de diálogo de conexión de la extensión postgreSQL se inicia automáticamente.
  • Si VS Code está instalado pero no abierto, se inicia en aproximadamente 40 segundos, seguido del cuadro de diálogo de conexión.

Autocompletar los detalles de conexión

Se abre el cuadro de diálogo de conexión de la extensión PostgreSQL y el campo Nombre del servidor rellena automáticamente el punto de conexión del servidor.

Captura de pantalla de la extensión postgreSQL para el cuadro de diálogo de conexión de VS Code con los detalles del nombre del servidor rellenados previamente.

Proporcionar detalles de autenticación

Seleccione el método de autenticación preferido:

  • Autenticación de contraseña: escriba manualmente el nombre de usuario y la contraseña.
  • Entra Autenticación: Escriba las credenciales de la cuenta de Azure.

Especifique otros detalles de conexión, como nombre de perfil, nombre de base de datos (opcional), grupo de servidores y número de puerto.

Guardar y conectar

Seleccione el botón Guardar y conectar para establecer la conexión. Una vez conectado, expanda el servidor en el árbol del Explorador de objetos para ver bases de datos, esquemas y tablas, o use la herramienta de consulta integrada para administrar los objetos de base de datos.

Solución de problemas

Si se producen problemas durante el proceso de conexión:

  • Compruebe que VS Code y la extensión postgreSQL están instaladas y habilitadas.

  • Asegúrese de que la dirección IP está permitida en la configuración del firewall de Azure Database for PostgreSQL.

  • Si no se cumplen los requisitos previos, el panel lateral proporciona comentarios y pasos para resolver el problema, incluida la reintento de la conexión.

Comentarios y soporte técnico

Para errores, solicitudes de características y problemas, use la herramienta de comentarios integrada en Visual Studio Code. Puede completarlo mediante el menú Ayuda de VS Code o la paleta de comandos PGSQL.

  • Menú Ayuda

    • Vaya a Ayuda > Informar de Problema

  • Paleta de comandos

    • Abra la paleta de comandos con Ctrl + Shift + P y ejecute: PGSQL: Report Issue

Contenido relacionado