DocumentaciónExperience PlatformGuía del servicio de consultas

Conectar GitHub Copilot y Visual Studio Code al servicio de consultas

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Creado para:

  • Usuario
  • Desarrollador
IMPORTANT
Antes de utilizar esta herramienta integrada, debe comprender qué datos se comparten con GitHub. Los datos compartidos incluyen información contextual sobre el código y los archivos que se están editando ("indicadores") y detalles sobre las acciones del usuario ("datos de participación del usuario"). Revise la declaración de privacidad de GitHub Copilot para obtener más información sobre los datos que recopilan. También debe tener en cuenta las implicaciones de seguridad de la participación en servicios de terceros, ya que es responsable de garantizar el cumplimiento de las políticas de gobernanza de datos de su organización. Adobe no se responsabiliza por cualquier preocupación o problema relacionado con los datos que pueda surgir del uso de esta herramienta. Consulte la documentación de GitHub para obtener más información.

GitHub Copilot, con tecnología OpenAI Codex, es una herramienta impulsada por IA que mejora su experiencia de codificación al sugerir fragmentos de código y funciones completas directamente dentro de su editor. Integrado con Visual Studio Code (VS Code), Copilot puede acelerar significativamente el flujo de trabajo, especialmente cuando se trabaja con consultas complejas. Siga esta guía para aprender a conectar GitHub Copilot y VS Code al servicio de consultas para escribir y administrar las consultas con mayor eficacia. Para obtener más información sobre Copilot, visite la página de productos Copilot de GitHub y la documentación oficial Copilot 5}.

Este documento describe los pasos necesarios para conectar GitHub Copilot y VS Code con Adobe Experience Platform Query Service.

Introducción get-started

Esta guía requiere que ya tenga acceso a una cuenta de GitHub y que se haya registrado en GitHub Copilot. Puede registrarse en el sitio web de GitHub. También necesita VS Code. Puedes descargar VS Code desde su sitio web oficial.

Una vez que haya instalado VS Code y activado su suscripción a Copilot, adquiera sus credenciales de conexión para Experience Platform. Estas credenciales se encuentran en la ficha Credentials del área de trabajo de Queries en la interfaz de usuario de Experience Platform. Lea la guía de credenciales de para obtener información sobre cómo encontrar estos valores en la interfaz de usuario de Experience Platform. Póngase en contacto con el administrador de su organización si actualmente no tiene acceso al área de trabajo Consultas.

Extensiones Visual Studio Code requeridas required-extensions

Se requieren las siguientes extensiones Visual Studio Code para administrar y consultar de forma eficaz las bases de datos SQL de Experience Platform directamente en el editor de código. Descargue e instale estas extensiones.

  • SQLTools: utilice la extensión SQLTools para administrar y consultar varias bases de datos SQL. Incluye funciones como un ejecutor de consultas, un formateador SQL y un explorador de conexiones, con compatibilidad con controladores adicionales para aumentar la productividad del desarrollador. Lea la información general sobre Visual Studio Marketplace para obtener más detalles.
  • Controlador PostgreSQL/Cockroach de SQLTools: Esta extensión le permite conectar, consultar y administrar bases de datos PostgreSQL y CockroachDB directamente en el editor de código.

Las siguientes extensiones habilitan GitHub Copilot y sus características de chat.

  • GitHub Copilot: proporciona sugerencias de codificación en línea a medida que escribe.
  • GitHub Copilot Chat: una extensión complementaria que proporciona asistencia de inteligencia artificial aplicada a la conversación.

Crear conexión create-connection

Seleccione el icono del cilindro ( El icono del cilindro. ) en el panel de navegación izquierdo de VS Code, seguido de Add New Connection o el icono de cilindro más ( El icono de cilindro más. ).

Se ha resaltado la interfaz de usuario de código de Visual Studio con la extensión SQL Tool y Agregar nueva conexión.

Aparece Connection Assistant. Seleccione el controlador de base de datos PostgreSQL.

Página de configuración de SQLTools en VS Code con PostgreSQl resaltado.

Configuración de conexión de entrada input-connection-settings

Aparecerá la vista Connection Settings. Escriba las credenciales de conexión de Experience Platform en los campos apropiados de SQLTools Connection Assistant. Los valores requeridos se explican en la tabla siguiente.

Propiedad
Descripción
Connection name

Proporcione un "Connection name" como Prod_MySQL_Server que sea descriptivo y que indique claramente su propósito (por ejemplo, un entorno de producción para un servidor MySQL). Las prácticas recomendadas incluyen:

  • Siga las convenciones de nomenclatura de su organización para asegurarse de que sea único dentro del sistema.
  • Mantenga la concisión para mantener la claridad y evitar confusiones con otras conexiones.
  • Incluya detalles relevantes acerca de la función o el entorno de la conexión en el nombre.
Connect using
Utilice la opción Server and Port para especificar la dirección del servidor (nombre de host) y el número de puerto para establecer una conexión directa con Experience Platform
Server address
Escriba el valor Host proporcionado en las credenciales de Experience Platform Postgres, como acmeprod.platform-query.adobe.io.
Port
Este valor suele ser 80 para los servicios de Experience Platform.
Database
Escriba el valor Database proporcionado en sus credenciales de Experience Platform Postgres, como prod:all.
Username
Esta propiedad hace referencia a su ID de organización de. Introduzca el valor Username proporcionado en sus credenciales de Experience Platform Postgres.
Password
Esta propiedad es su token de acceso. Escriba el valor Password proporcionado en las credenciales de Experience Platform Postgres.

Área de trabajo del Asistente para la conexión con varios valores resaltados.

A continuación, seleccione Use Password, seguido de Save as plaintext in settings en el menú desplegable que aparece. Aparece el campo Password. Utilice este campo de entrada de texto para introducir el token de acceso.

Se resaltaron el campo Usar contraseña, el menú desplegable y Contraseña.

Finalmente, para habilitar SSL, seleccione el campo de entrada SSL y elija Enabled en el menú desplegable que aparece.

Se ha resaltado el campo SSL con Habilitado en el menú desplegable.

TIP
Una vez que haya introducido todas las credenciales, puede probar la conexión antes de guardarla. Desplácese hacia abajo hasta la parte inferior del área de trabajo y seleccione Test Connection.
Área de trabajo del Asistente de conexión con Test Connection resaltado. {width="100" modal="regular"}

Una vez que haya escrito correctamente los detalles de la conexión, seleccione Save Connection para confirmar la configuración.

Área de trabajo del Asistente para la conexión con Guardar conexión resaltada.

Aparecerá la vista Review connection details y se mostrarán las credenciales de conexión. Cuando esté seguro de que los detalles de la conexión son correctos, seleccione Connect Now.

Vista de detalles de la conexión de revisión con Connect Now resaltado.

Su área de trabajo VS Code aparece con una sugerencia de GitHub Copilot.

Sesión SQL conectada en VS Code.

Guía rápida de GitHub Copilot

Una vez que se haya conectado a su instancia de Experience Platform, puede usar Copilot como asistente de codificación de IA para ayudarle a escribir código de forma más rápida y con más confianza. Esta sección describe sus funciones principales y cómo utilizarlas.

Introducción a GitHub Copilot get-started-with-copilot

Primero, asegúrese de que tiene instalada la versión más reciente de VS Code. Una versión VS Code obsoleta puede impedir que las características de la clave Copilot funcionen según lo previsto. A continuación, asegúrese de que la configuración Enable Auto Completions esté habilitada. Si Copilot se está ejecutando correctamente, el icono Copilot ( El icono Copiloto ) aparecerá en la barra de estado (si hay un problema, en su lugar se mostrará el icono de error Copilot). Seleccione el icono Copilot para abrir el menú GitHub Copilot. En el menú GitHub Copilot, seleccione Edit Settings

Editor de VS Code con GitHub Copilot Menu mostrado y el icono Copilot y Editar configuración resaltados.

Desplácese hacia abajo por las opciones y compruebe que la casilla de verificación está habilitada para la configuración Enable Auto Completions.

Panel de configuración de GitHub Copilot con la casilla de verificación Habilitar finalizaciones automáticas seleccionada y resaltada.

Finalizaciones de código code-completions

Una vez que instala la extensión GitHub Copilot e inicia sesión, se activa automáticamente una característica denominada Texto fantasma, que sugiere que el código se complete mientras escribe. Estas sugerencias le ayudan a escribir código de forma más eficaz y con menos interrupciones. También puede utilizar comentarios para guiar las sugerencias de código de IA. Esto significa que los usuarios no técnicos pueden convertir voz sin formato en código para explorar sus datos.

Se ha resaltado la interfaz de usuario de VSCode con una sugerencia de código y el icono GitHub Copilot.

TIP
Si desea deshabilitar Copilot para un archivo o idioma específico, seleccione el icono en la barra de estado y desactívelo.

Aceptar sugerencias de texto fantasma completas o parciales accept-suggestions

Cuando GitHub Copilot sugiere que el código se complete, puede aceptar sugerencias parciales o completas. Seleccione Tab para aceptar toda la sugerencia o mantenga presionada la tecla Control (o Comando en Mac) y presione la flecha derecha para aceptar texto parcial. Para rechazar una sugerencia, presione Escape.

TIP
Si no recibe sugerencias, asegúrese de que Copilot esté habilitado en el idioma del archivo.

El editor VS Code muestra una sugerencia de texto gris tenue de GitHub Copilot como texto fantasma junto a código parcialmente escrito.

Sugerencias alternativas alternative-suggestions

Para recorrer las sugerencias de código alternativo, seleccione las flechas en el cuadro de diálogo Copilot.

Editor de VS Code que muestra el panel Sugerencias alternativas de Copilot.

Usar el chat en línea inline-chat

También puede chatear con Copilot directamente acerca de su código. Use Control (o Comando) + I para almacenar en déclencheur el cuadro de diálogo de chat en línea. Esta función se utiliza para repetir el código y refinar las sugerencias en contexto. Puede resaltar un bloque de código y utilizar un chat en línea para ver una solución diferente propuesta por la IA antes de aceptarla.

La ventana de chat en línea con vista de diferencia

Vista de chat dedicada dedicated-chat

Puede utilizar una interfaz de chat más tradicional con una barra lateral de chat dedicada para formar ideas y estrategias, resolver problemas de codificación y discutir detalles de implementación. Seleccione el icono de chat ( El icono de Copilot Chat. ) en la barra lateral VS Code para abrir una ventana de chat dedicada.

Barra lateral de chat de GitHub Copilot con el icono de chat resaltado.

También puede acceder al historial de chat seleccionando el icono del historial ( El icono del historial. ) en la parte superior del panel de chat.

Pasos siguientes

Ahora está listo para consultar de manera eficiente sus bases de datos de Experience Platform directamente desde su editor de código y usar las sugerencias de código con tecnología de IA de GitHub Copilot para agilizar la escritura y optimizar las consultas SQL. Para obtener más información sobre cómo escribir y ejecutar consultas, consulte las instrucciones para la ejecución de consultas.

recommendation-more-help
ccf2b369-4031-483f-af63-a93b5ae5e3fb