Compartir vía

Inicio rápido: Conexión y consulta de una base de datos con la extensión PostgreSQL para Visual Studio Code

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.

Prerequisites

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.

Cuando se instala la extensión, 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.

Authentication

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 extensión postgreSQL para Visual Studio 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 automáticamente y aparece en la ventana de 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 para ver las opciones para:
    • Iniciar una nueva consulta
    • Chatear 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 los 1000 principales 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.
  • Use el resaltado de sintaxis y el formato automático para mejorar la legibilidad y la 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 ayuda a simplificar el flujo de trabajo, reducir el tiempo de desarrollo y a 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 seleccione Chat con esta base de datos para interactuar con Copilot.

Escriba avisos como en 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, consulte Configuración de GitHub Copilot.

Conexión a Azure Database for PostgreSQL con Visual Studio Code

Conéctese a una instancia de servidor flexible de Azure Database for PostgreSQL mediante Visual Studio Code siguiendo 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 Visual Studio Code

La opción "Conectar con Visual Studio Code" en Azure Portal simplifica la conexión a la instancia de 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 Visual Studio Code destacado en la página Información general .
  • Aparece un panel lateral que muestra los requisitos para conectarse mediante Visual Studio Code.

Captura de pantalla de Azure Portal en la que se muestra una instancia de Azure Database for PostgreSQL con el botón Conectar con Visual Studio Code.

Confirmación de los requisitos

  • En el panel lateral, confirme que se cumplen todos los requisitos previos (extensión de Visual Studio 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 que muestra una instancia de Azure Database for PostgreSQL con el panel Conectar con Visual Studio 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.
  • Si Visual Studio Code y la extensión tardan más de 40 segundos en abrirse, aparece un botón Volver a intentar abrir en Visual Studio Code en el panel lateral.

Iniciar Visual Studio Code

  • Si Visual Studio 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 Visual Studio 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 del diálogo de conexión de la extensión de PostgreSQL para Visual Studio Code, con los detalles del nombre del servidor ya rellenados.

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.

Troubleshoot

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

  • Compruebe que Visual Studio 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 cumple 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 completar este proceso de comentarios a través del menú Ayuda de Visual Studio 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

  • Last updated on