Documentação Experience Platform Guia do Serviço de consulta

Conectar GitHub Copilot e Visual Studio Code ao Serviço de consulta

4 de abril de 2025

Tópicos:

Criado para:

Usuário
Desenvolvedor

IMPORTANT

Antes de usar essa ferramenta integrada, você deve entender quais dados são compartilhados com o GitHub. Os dados compartilhados incluem informações contextuais sobre o código e os arquivos que estão sendo editados ("prompts") e detalhes sobre as ações do usuário ("dados de envolvimento do usuário"). Revise a declaração de privacidade de GitHub Copilot para saber mais sobre os dados coletados. Você também deve considerar as implicações de segurança do envolvimento de serviços de terceiros, pois é responsável por garantir a conformidade com as políticas de governança de dados de sua organização. A Adobe não se responsabiliza por quaisquer preocupações ou problemas relacionados a dados que possam surgir com o uso dessa ferramenta. Consulte a documentação do GitHub para obter mais informações.

O GitHub Copilot, desenvolvido pelo OpenAI Codex, é uma ferramenta orientada por IA que melhora a sua experiência de codificação, sugerindo trechos de código e funções inteiras diretamente no seu editor. Integrado ao Visual Studio Code (VS Code), o Copilot pode acelerar muito seu fluxo de trabalho, principalmente ao trabalhar com consultas complexas. Siga este guia para saber como conectar o GitHub Copilot e o VS Code ao Serviço de Consulta para gravar e gerenciar suas consultas com mais eficiência. Para obter mais informações sobre Copilot, visite a página do produto Copilot do GitHub e a documentação oficial Copilot 5}.

Este documento aborda as etapas necessárias para conectar o GitHub Copilot e o VS Code ao Serviço de Consulta do Adobe Experience Platform.

Introdução

Este guia requer que você já tenha acesso a uma conta GitHub e tenha se inscrito em GitHub Copilot. Você pode se inscrever pelo site do GitHub. Você também precisa de VS Code. Você pode baixar VS Code de seu site oficial.

Depois de instalar o VS Code e ativar a assinatura do Copilot, adquira suas credenciais de conexão para o Experience Platform. Essas credenciais estão localizadas na guia Credenciais do espaço de trabalho Consultas na interface de usuário do Experience Platform. Leia o guia de credenciais para saber como localizar esses valores na interface do usuário do Experience Platform. Entre em contato com o administrador da organização se você não tiver acesso ao espaço de trabalho Consultas.

Extensões Visual Studio Code necessárias

As Visual Studio Code extensões a seguir são necessárias para gerenciar e consultar com eficácia seus bancos de dados Experience Platform SQL diretamente no editor de código. Baixe e instale essas extensões.

SQLTools: use a extensão SQLTools para gerenciar e consultar vários bancos de dados SQL. Ele inclui recursos como um executor de query, formatador SQL e explorador de conexões, com suporte para drivers adicionais para aumentar a produtividade do desenvolvedor. Leia a visão geral no Visual Studio Marketplace para obter mais detalhes.
SQLTools PostgreSQL/Driver de Barata: essa extensão permite conectar, consultar e gerenciar bancos de dados PostgreSQL e CockroachDB diretamente no editor de código.

As próximas extensões habilitam GitHub Copilot e seus recursos de chat.

GitHub Copilot: Fornece sugestões de codificação em linha à medida que você digita.
GitHub Copilot Chat: uma extensão complementar que fornece assistência à IA de conversação.

Criar conexão

Selecione o ícone do cilindro ( ) na navegação à esquerda de VS Code, seguido por Add New Connection ou pelo ícone de mais do cilindro ( ).

A interface do Visual Studio Code com a extensão Ferramenta SQL e a opção Adicionar nova conexão foram realçadas.

O Connection Assistant aparece. Selecione o driver de banco de dados PostgreSQL.

A página de configurações SQLTools em VS Code com PostgreSQl realçado.

Configurações de conexão de entrada

A exibição Connection Settings aparece. Insira suas credenciais de conexão do Experience Platform nos campos apropriados das SQLTools Connection Assistant. Os valores obrigatórios são explicados na tabela abaixo.

Propriedade

Descrição

Connection name

Forneça um "Connection name" como Prod_MySQL_Server que seja descritivo e indique claramente sua finalidade (por exemplo, um ambiente de produção para um servidor MySQL). As práticas recomendadas incluem:

Siga as convenções de nomenclatura de sua organização para garantir que ela seja exclusiva no sistema.
Mantenha-o conciso para manter a clareza e evitar confusão com outras conexões.
Inclua detalhes relevantes sobre a função ou o ambiente da conexão no nome.

Connect using

Use a opção Server and Port para especificar o endereço do servidor (nome do host) e o número da porta para estabelecer uma conexão direta com o Experience Platform

Server address

Insira o valor Host fornecido em suas credenciais do Experience Platform Postgres, como acmeprod.platform-query.adobe.io.

Port

Normalmente, esse valor é 80 para serviços da Experience Platform.

Database

Insira o valor do Banco de Dados fornecido em suas credenciais do Experience Platform Postgres, como prod:all.

Username

Essa propriedade se refere à ID da organização. Insira o valor Username fornecido em suas credenciais do Experience Platform Postgres.

Password

Essa propriedade é o token de acesso. Digite o valor Senha fornecido em suas credenciais do Experience Platform Postgres.

O espaço de trabalho do Assistente de Conexão com várias configurações realçadas.

Em seguida, selecione Use Password, seguido por Save as plaintext in settings no menu suspenso exibido. O campo Password é exibido. Use esse campo de entrada de texto para inserir seu token de acesso.

O campo Usar senha, o menu suspenso e a Senha são destacados.

Finalmente, para habilitar o SSL, selecione o campo de entrada SSL e escolha Enabled no menu suspenso exibido.

O campo SSL com Habilitado no menu suspenso foi realçado.

TIP

Depois de inserir todas as credenciais, você poderá testar a conexão antes de salvá-la. Role para baixo até a parte inferior do espaço de trabalho e selecione Test Connection.

O espaço de trabalho do Assistente de Conexão com Testar Conexão está realçado.

Depois de inserir corretamente os detalhes da conexão, selecione Save Connection para confirmar as configurações.

O espaço de trabalho do Assistente de Conexão com Salvar Conexão está realçado.

A exibição Review connection details aparece e mostra suas credenciais de conexão. Quando tiver certeza de que os detalhes da sua conexão são precisos, selecione Connect Now.

A exibição Revisar detalhes da conexão com Conectar Agora está realçada.

Seu espaço de trabalho VS Code aparece com uma sugestão de GitHub Copilot.

Uma sessão SQL conectada em VS Code.

Guia rápido do GitHub Copilot

Depois de conectado à sua instância do Experience Platform, você pode usar o Copilot como um assistente de codificação de IA para ajudá-lo a escrever código com mais rapidez e confiança. Esta seção aborda os principais recursos e como usá-los.

Introdução ao GitHub Copilot

Primeiro, verifique se você tem a versão mais recente do VS Code instalada. Uma versão desatualizada do VS Code pode impedir que os recursos da chave Copilot funcionem conforme o esperado. Em seguida, verifique se a configuração Enable Auto Completions está habilitada. Se Copilot estiver sendo executado corretamente, o ícone Copilot Selecione o ícone Copilot para abrir o GitHub Copilot Menu. No GitHub Copilot Menu, selecione Edit Settings

O editor VS Code com o GitHub Copilot Menu exibido e o ícone Copilot e as Configurações de Edição realçados.

Role para baixo nas opções e verifique se a caixa de seleção está habilitada para a configuração Enable Auto Completions.

O painel de configurações de GitHub Copilot com a caixa de seleção Habilitar Conclusões Automáticas marcada e realçada.

Conclusões de código

Depois que você instalar a extensão GitHub Copilot e fazer logon, ela ativará automaticamente um recurso chamado Texto Fantasma, que sugere a conclusão de código à medida que você digita. Essas sugestões ajudam você a escrever código de forma mais eficiente e com menos interrupções. Também é possível usar comentários para orientar as sugestões do código de IA. Isso significa que os usuários não técnicos podem converter fala simples em código para explorar seus dados.

A interface do usuário do VSCode com uma sugestão de código e o ícone GitHub Copilot realçado.

TIP

Se você quiser desabilitar Copilot para um arquivo ou idioma específico, selecione o ícone na barra de status e desabilite-o.

Aceitar sugestões completas ou parciais de Texto Fantasma

Quando GitHub Copilot sugere conclusão de código, você pode aceitar sugestões parciais ou completas. Selecione Tab para aceitar toda a sugestão ou mantenha pressionada a tecla Control (ou Command no Mac) e pressione a seta para a direita para aceitar texto parcial. Para descartar uma sugestão, pressione Escape.

TIP

Se você não estiver recebendo sugestões, verifique se Copilot está habilitado no idioma do arquivo.

O editor VS Code exibindo uma sugestão de texto cinza claro de GitHub Copilot como Texto Fantasma, ao lado do código parcialmente digitado.

Sugestões alternativas

Para percorrer as sugestões de código alternativo, selecione as setas na caixa de diálogo Copilot.

O editor VS Code mostrando o painel de sugestões alternativas do Copilot.

Usar chat em linha

Você também pode conversar com Copilot diretamente sobre o seu código. Use Control (ou Command) + I para acionar a caixa de diálogo de chat embutida. Esse recurso é usado para iterar no código e refinar sugestões no contexto. Você pode realçar um bloco de código e usar o bate-papo em linha para ver uma solução diferente proposta pela IA antes de aceitar.

A janela de chat embutida com exibição de comparação

Exibição de chat dedicada

Você pode usar uma interface de bate-papo mais tradicional com uma barra lateral de bate-papo dedicada para formar ideias e estratégias, resolver problemas de codificação e discutir detalhes de implementação. Selecione o ícone de bate-papo ( ) na barra lateral VS Code para abrir uma janela de chat dedicada.

A barra lateral de chat GitHub Copilot com o ícone de chat realçado.

Você também pode acessar o histórico do chat selecionando o ícone de histórico ( ) na parte superior do painel de chat.

Próximas etapas

Agora você está pronto para consultar com eficiência seus bancos de dados Experience Platform diretamente do editor de código, e usar as sugestões de código alimentadas por IA do GitHub Copilot para simplificar a gravação e a otimização de consultas SQL. Para obter mais informações sobre como gravar e executar consultas, consulte a orientação para a execução da consulta.

recommendation-more-help