Documentazione Experience Platform Guida di Query Service

Connetti GitHub Copilot e Visual Studio Code a Query Service

4 aprile 2025

Argomenti:
Query

Creato per:

Utente
Sviluppatore

IMPORTANT

Prima di utilizzare questo strumento integrato, è necessario comprendere quali dati vengono condivisi con GitHub. I dati condivisi includono informazioni contestuali sul codice e sui file in fase di modifica ("prompt") e dettagli sulle azioni dell’utente ("dati sul coinvolgimento dell’utente"). Rivedi l'informativa sulla privacy di GitHub Copilot per informazioni sui dati raccolti. È inoltre necessario considerare le implicazioni di sicurezza derivanti dal coinvolgimento di servizi di terze parti, in quanto sei responsabile di garantire la conformità con i criteri di governance dei dati della tua organizzazione. Adobe non è responsabile per eventuali problemi relativi ai dati o problemi che possono sorgere dall’utilizzo di questo strumento. Per ulteriori informazioni, consulta la documentazione di GitHub.

GitHub Copilot, basato su OpenAI Codex, è uno strumento basato sull'intelligenza artificiale che migliora l'esperienza di codifica suggerendo frammenti di codice e intere funzioni direttamente nell'editor. Integrato con Visual Studio Code (VS Code), Copilot può accelerare notevolmente il flusso di lavoro, soprattutto quando si lavora con query complesse. Segui questa guida per scoprire come connettere GitHub Copilot e VS Code a Query Service per scrivere e gestire le query con maggiore efficienza. Per ulteriori informazioni su Copilot, visita la pagina del prodotto Copilot di GitHub e la documentazione Copilot ufficiale.

Questo documento descrive i passaggi necessari per connettere GitHub Copilot e VS Code a Adobe Experience Platform Query Service.

Introduzione

Questa guida richiede che tu abbia già accesso a un account GitHub e che ti sia registrato per GitHub Copilot. Puoi registrarti dal sito Web GitHub. Sono inoltre necessari VS Code. Puoi scaricare VS Code dal loro sito Web ufficiale.

Dopo aver installato VS Code e attivato la sottoscrizione a Copilot, acquisisci le credenziali di connessione per Experience Platform. Queste credenziali si trovano nella scheda Credenziali dell'area di lavoro Query nell'interfaccia utente di Experience Platform. Leggi la guida alle credenziali per scopri come trovare questi valori nell'interfaccia utente di Experience Platform. Contatta l'amministratore dell'organizzazione se al momento non hai accesso all'area di lavoro Query.

Estensioni Visual Studio Code richieste

Le seguenti estensioni Visual Studio Code sono necessarie per gestire in modo efficace ed eseguire query sui database Experience Platform SQL direttamente all'interno dell'editor di codice. Scarica e installa queste estensioni.

SQLTools: utilizzare l'estensione SQLTools per gestire ed eseguire query su più database SQL. Include funzionalità quali query runner, SQL formatter ed Esplora connessioni, con supporto per driver aggiuntivi per aumentare la produttività degli sviluppatori. Per ulteriori informazioni, vedere la panoramica di Visual Studio Marketplace.
SQLTools PostgreSQL/Cockroach Driver: questa estensione consente di connettersi, eseguire query e gestire database PostgreSQL e CockroachDB direttamente nell'editor di codice.

Le estensioni successive abilitano GitHub Copilot e le relative funzionalità di chat.

GitHub Copilot: fornisce suggerimenti di codifica in linea durante la digitazione.
GitHub Copilot Chat: estensione correlata che fornisce assistenza di IA per la conversazione.

Crea connessione

Selezionare l'icona del cilindro ( ) nel menu di navigazione a sinistra di VS Code, seguito da Add New Connection o dall'icona del cilindro più ( ).

Linterfaccia utente di Visual Studio Code con lestensione dello strumento SQL ed Aggiungi nuova connessione è evidenziata.

Verrà visualizzato Connection Assistant. Selezionare il driver di database PostgreSQL.

Pagina delle impostazioni SQLTools in VS Code con PostgreSQl evidenziato.

Impostazioni di connessione di input

Viene visualizzata la visualizzazione Connection Settings. Immettere le credenziali di connessione Experience Platform nei campi appropriati degli SQL Tools Connection Assistant. I valori richiesti sono illustrati nella tabella seguente.

Proprietà

Descrizione

Connection name

Fornire un "Connection name" come Prod_MySQL_Server descrittivo e indicante chiaramente lo scopo (ad esempio, un ambiente di produzione per un server MySQL). Le best practice includono:

Attenersi alle convenzioni di denominazione della propria organizzazione per assicurarsi che sia univoca all’interno del sistema.
Mantieni la concisione per mantenere la chiarezza ed evitare confusione con altre connessioni.
Includi nel nome i dettagli rilevanti sulla funzione o sull’ambiente della connessione.

Connect using

Utilizzare l'opzione Server and Port per specificare l'indirizzo del server (nome host) e il numero di porta per stabilire una connessione diretta ad Experience Platform

Server address

Immetti il valore Host fornito nelle credenziali Experience Platform Postgres, ad esempio acmeprod.platform-query.adobe.io.

Port

Questo valore è in genere 80 per i servizi Experience Platform.

Database

Immetti il valore Database fornito nelle credenziali Experience Platform Postgres, ad esempio prod:all.

Username

Questa proprietà fa riferimento al tuo ID organizzazione. Immetti il valore Nome utente fornito nelle credenziali Experience Platform Postgres.

Password

Questa proprietà è il token di accesso. Immetti il valore Password fornito nelle credenziali Experience Platform Postgres.

Area di lavoro dellAssistente connessione con diverse impostazioni evidenziate.

Selezionare Use Password, seguito da Save as plaintext in settings dal menu a discesa visualizzato. Viene visualizzato il campo Password. Utilizza questo campo di immissione testo per immettere il token di accesso.

Usa password, menu a discesa e campo Password evidenziati.

Infine, per abilitare SSL, selezionare il campo di input SSL e scegliere Enabled dal menu a discesa visualizzato.

Il campo SSL con Abilitato nel menu a discesa è evidenziato.

TIP

Dopo aver immesso tutte le credenziali, è possibile verificare la connessione prima di salvarla. Scorri verso il basso fino alla parte inferiore dell'area di lavoro e seleziona Test Connection.

Area di lavoro dell'Assistente connessione con Test connessione evidenziato.

Dopo aver immesso correttamente i dettagli di connessione, selezionare Save Connection per confermare le impostazioni.

Area di lavoro dellAssistente connessione con Salva connessione evidenziata.

Verrà visualizzata la visualizzazione Review connection details con le credenziali di connessione. Quando si è certi della correttezza dei dettagli di connessione, selezionare Connect Now.

Visualizzazione dei dettagli della connessione di revisione con Connect Now evidenziato.

L'area di lavoro VS Code viene visualizzata con un suggerimento di GitHub Copilot.

Sessione SQL connessa in VS Code.

Guida rapida di GitHub Copilot

Una volta connesso all'istanza Experience Platform, puoi utilizzare Copilot come assistente alla codifica AI per scrivere il codice più rapidamente e con maggiore sicurezza. Questa sezione descrive le sue funzioni chiave e come utilizzarle.

Guida introduttiva a GitHub Copilot

Verificare innanzitutto che sia installata la versione più recente di VS Code. Una versione VS Code obsoleta può impedire il funzionamento corretto delle funzionalità chiave Copilot. Verificare quindi che l'impostazione Enable Auto Completions sia abilitata. Se Copilot è in esecuzione correttamente, l'icona Copilot ( ) verrà visualizzata nella barra di stato (se si verifica un problema, verrà visualizzata l'icona di errore Copilot). Selezionare l'icona Copilot per aprire il menu GitHub Copilot. Dal menu GitHub Copilot, seleziona Edit Settings

Leditor VS Code con GitHub Copilot Menu visualizzato e licona Copilot e Modifica impostazioni evidenziate.

Scorrere le opzioni verso il basso e verificare che la casella di controllo sia abilitata per l'impostazione Enable Auto Completions.

Il pannello delle impostazioni per GitHub Copilot con la casella di controllo Abilita completamenti automatici selezionata ed evidenziata.

Completamenti del codice

Dopo aver installato l'estensione GitHub Copilot e aver effettuato l'accesso, viene attivata automaticamente una funzionalità denominata Testo fantasma, che suggerisce il completamento del codice durante la digitazione. Questi suggerimenti consentono di scrivere il codice in modo più efficiente e con meno interruzioni. Puoi anche utilizzare i commenti per guidare i suggerimenti sul codice di intelligenza artificiale. Ciò significa che gli utenti non tecnici possono convertire il linguaggio semplice in codice per esplorare i propri dati.

Linterfaccia utente di VSCode con un suggerimento di codice e licona GitHub Copilot evidenziata.

TIP

Se si desidera disabilitare Copilot per un file o una lingua specifica, selezionare l'icona sulla barra di stato e disabilitarla.

Accetta suggerimenti testo fantasma completi o parziali

Quando GitHub Copilot suggerisce il completamento del codice, puoi accettare suggerimenti parziali o completi. Selezionare Tab per accettare l'intero suggerimento oppure tenere premuto Control (o Command su Mac) e premere la freccia destra per accettare il testo parziale. Per ignorare un suggerimento, premere Esc.

TIP

Se non ricevi suggerimenti, assicurati che Copilot sia abilitato nella lingua del file.

Leditor VS Code visualizza un suggerimento di testo grigio debole di GitHub Copilot come testo fantasma accanto al codice parzialmente digitato.

Suggerimenti alternativi

Per scorrere i suggerimenti di codice alternativo, selezionare le frecce nella finestra di dialogo Copilot.

Leditor VS Code che mostra il pannello dei suggerimenti alternativi Copilot.

Usa chat in linea

Puoi anche chattare con Copilot direttamente sul tuo codice. Utilizza Controllo (o Comando) + I per attivare la finestra di dialogo della chat in linea. Questa funzione viene utilizzata per iterare il codice e perfezionare i suggerimenti nel contesto. Puoi evidenziare un blocco di codice e utilizzare la chat in linea per visualizzare una soluzione diversa proposta dall’intelligenza artificiale prima di accettare.

Finestra di chat in linea con visualizzazione differenze

Visualizzazione chat dedicata

Puoi utilizzare un’interfaccia di chat più tradizionale con una barra laterale dedicata alla chat per formare idee e strategie, risolvere problemi di codifica e discutere i dettagli di implementazione. Selezionare l'icona della chat ( ) nella barra laterale VS Code per aprire una finestra di chat dedicata.

Barra laterale della chat di GitHub Copilot con licona della chat evidenziata.

È inoltre possibile accedere alla cronologia delle chat selezionando l'icona della cronologia ( ) nella parte superiore del pannello chat.

Passaggi successivi

È ora possibile eseguire query sui database Experience Platform direttamente dall'editor di codice e utilizzare i suggerimenti di codice basati sull'intelligenza artificiale di GitHub Copilot per semplificare la scrittura e l'ottimizzazione delle query SQL. Per ulteriori informazioni su come scrivere ed eseguire query, consultare la guida per l'esecuzione delle query.

recommendation-more-help