Commencer

Ce guide nécessite que vous ayez déjà accès à un compte GitHub et que vous vous soyez inscrit pour GitHub Copilot. Vous pouvez vous inscrire sur le site web GitHub. Vous avez également besoin de VS Code. Vous pouvez télécharger VS Code depuis leur site officiel.

Une fois que vous avez installé VS Code et activé votre abonnement Copilot, obtenez vos informations d’identification de connexion pour Experience Platform. Ces informations d’identification se trouvent dans l’onglet ​ Informations d’identification ​ de l’espace de travail Requêtes de l’interface utilisateur d’Experience Platform. Lisez le guide des informations d’identification pour savoir comment trouver ces valeurs dans l’interface utilisateur d’Experience Platform. Veuillez contacter l’administrateur de votre organisation si vous n’avez pas actuellement accès à l’espace de travail Requêtes.

Extensions de Visual Studio Code requises

Les extensions Visual Studio Code suivantes sont nécessaires pour gérer et interroger efficacement vos bases de données SQL Experience Platform directement dans l’éditeur de code. Téléchargez et installez ces extensions.

  • SQLTools : utilisez l’extension SQLTools pour gérer et interroger plusieurs bases de données SQL. Il comprend des fonctionnalités telles qu’un exécuteur de requête, un formateur SQL et un explorateur de connexions, avec la prise en charge de pilotes supplémentaires pour améliorer la productivité des développeurs. Lisez la présentation de Visual Studio Marketplace pour plus d’informations.
  • Pilote SQLTools PostgreSQL/Cockroach : cette extension vous permet de connecter, d’interroger et de gérer les bases de données PostgreSQL et CockroachDB directement dans votre éditeur de code.

Les extensions suivantes activent GitHub Copilot et ses fonctionnalités de chat.

  • GitHub Copilot : fournit des suggestions de codage en ligne au fur et à mesure que vous tapez.
  • GitHub Copilot Chat : extension d’accompagnement qui fournit une assistance d’IA conversationnelle.

Créer une connexion

Sélectionnez l’icône de cylindre ( Icône de cylindre. ) dans le volet de navigation de gauche de VS Code, suivi de Add New Connection ou de l’icône cylindre plus ( icône cylindre plus. ).

L’interface utilisateur Visual Studio Code avec l’extension SQL Tool et Ajouter une nouvelle connexion mise en surbrillance.

L’Connection Assistant apparaît. Sélectionnez le pilote de base de données PostgreSQL.

Page des paramètres SQLTools en VS Code avec PostgreSQl en surbrillance.

Paramètres de connexion d’entrée

La vue Connection Settings s’affiche. Saisissez vos informations d’identification de connexion Experience Platform dans les champs appropriés du Connection Assistant SQLTools. Les valeurs requises sont expliquées dans le tableau ci-dessous.

Propriété
Description
Connection name

Fournissez un « Connection name » comme Prod_MySQL_Server, qui est descriptif et indique clairement son objectif (par exemple, un environnement de production pour un serveur MySQL). Les bonnes pratiques incluent

  • Respectez les conventions de dénomination de votre organisation pour vous assurer qu’elle est unique dans le système.
  • Veillez à ce qu’il soit concis pour maintenir la clarté et éviter toute confusion avec d’autres connexions.
  • Incluez des détails pertinents sur la fonction ou l’environnement de la connexion dans le nom.
Connect using
Utilisez l’option Server and Port pour spécifier l’adresse du serveur (nom d’hôte) et le numéro de port afin d’établir une connexion directe à Experience Platform
Server address
Saisissez la valeur Host fournie dans vos informations d’identification Experience Platform Postgres, telles que acmeprod.platform-query.adobe.io.
Port
Cette valeur est généralement 80 pour les services Experience Platform.
Database
Saisissez la valeur Base de données fournie dans vos informations d’identification Experience Platform Postgres, par exemple prod:all.
Username
Cette propriété fait référence à votre ID d’organisation. Saisissez la valeur Nom d’utilisateur fournie dans vos informations d’identification Experience Platform Postgres.
Password
Cette propriété est votre jeton d’accès. Saisissez la valeur Mot de passe fournie dans vos informations d’identification Experience Platform Postgres.

Espace de travail de l’assistant Connexion avec plusieurs paramètres mis en surbrillance.

Sélectionnez ensuite Use Password, puis Save as plaintext in settings dans le menu déroulant qui s’affiche. Le champ Password s’affiche. Utilisez ce champ de saisie de texte pour saisir votre jeton d’accès.

Le mot de passe utilisé, son menu déroulant et le champ Mot de passe mis en surbrillance.

Enfin, pour activer le protocole SSL, sélectionnez le champ de saisie SSL et choisissez Enabled dans le menu déroulant qui s’affiche.

Le champ SSL avec Activé dans le menu déroulant est mis en surbrillance.

TIP
Une fois que vous avez saisi toutes vos informations d’identification, vous pouvez tester votre connexion avant d’enregistrer la connexion. Faites défiler l’écran jusqu’au bas de l’espace de travail, puis sélectionnez Test Connection.
Espace de travail de l’assistant Connexion avec Tester la connexion en surbrillance.

Une fois que vous avez correctement saisi les détails de votre connexion, sélectionnez Save Connection pour confirmer vos paramètres.

Espace de travail de l’assistant Connexion avec Enregistrer la connexion mis en surbrillance.

La vue Review connection details s’affiche et affiche vos informations d’identification de connexion. Lorsque vous êtes sûr que les détails de votre connexion sont exacts, sélectionnez Connect Now.

La vue Vérifier les détails de la connexion avec Se connecter maintenant mise en surbrillance.

Votre espace de travail VS Code s’affiche avec une suggestion de GitHub Copilot.

Une session SQL connectée dans VS Code.

guide rapide GitHub Copilot

Une fois connecté à votre instance Experience Platform, vous pouvez utiliser Copilot comme assistant de codage d’IA pour vous aider à écrire du code plus rapidement et en toute confiance. Cette section couvre ses fonctionnalités clés et leur utilisation.

Prise en main de GitHub Copilot

Tout d’abord, assurez-vous que la dernière version de VS Code est installée. Une version VS Code obsolète peut empêcher les principales fonctionnalités Copilot de fonctionner comme prévu. Assurez-vous ensuite que le paramètre Enable Auto Completions est activé. Si Copilot s’exécute correctement, l’icône Copilot ( Icône Copilote ) s’affiche dans la barre d’état (en cas de problème, l’icône d’erreur Copilot s’affiche à la place). Sélectionnez l’icône Copilotpour le GitHub Copilot Menu. Dans le GitHub Copilot Menu, sélectionnez Edit Settings

Éditeur de VS Code avec la GitHub Copilot Menu affichée et l’icône Copilot et les paramètres d’édition mis en surbrillance.

Faites défiler les options vers le bas et assurez-vous que la case est cochée pour le paramètre Enable Auto Completions.

Le panneau des paramètres de GitHub Copilot avec la case à cocher Activer les déclarations de production automatiques sélectionnée et mise en surbrillance.

Saisies de code

Une fois que vous avez installé l’extension GitHub Copilot et que vous vous êtes connecté, elle active automatiquement une fonctionnalité appelée Texte fantôme, qui vous suggère de compléter le code au fur et à mesure que vous le tapez. Ces suggestions vous aident à écrire du code plus efficacement et avec moins d’interruptions. Vous pouvez également utiliser des commentaires pour guider les suggestions de code de l’IA. Cela signifie que les utilisateurs n’ayant pas de connaissances techniques peuvent convertir du langage clair en code pour explorer leurs données.

Interface utilisateur de VSCode avec une suggestion de code et l’icône GitHub Copilot mise en surbrillance.

TIP
Si vous souhaitez désactiver le Copilot pour un fichier ou une langue spécifique, sélectionnez l’icône dans la barre d’état et désactivez-la.

Accepter les suggestions de texte fantôme en tout ou en partie

Lorsque GitHub Copilot suggère des compléments de code, vous pouvez accepter des suggestions partielles ou complètes. Sélectionnez Tab pour accepter l’intégralité de la suggestion, ou maintenez la touche Ctrl (ou Commande sous Mac) enfoncée et appuyez sur la flèche de droite pour accepter une partie du texte. Pour ignorer une suggestion, appuyez sur Échap.

TIP
Si vous n’obtenez aucune suggestion, assurez-vous que Copilot est activé dans la langue de votre fichier.

Éditeur de VS Code affichant une suggestion de texte gris pâle de GitHub Copilot en tant que texte fantôme à côté du code partiellement tapé.

Suggestions alternatives

Pour passer en revue les autres suggestions de code, sélectionnez les flèches dans la boîte de dialogue Copilot.

Éditeur de VS Code affichant le panneau de suggestions alternatives Copilote.

Utiliser le chat en ligne

Vous pouvez également discuter directement avec Copilot à propos de votre code. Utilisez Contrôle (ou Commande) + I pour déclencher la boîte de dialogue de conversation en ligne. Cette fonctionnalité est utilisée pour effectuer une itération sur votre code et affiner les suggestions en contexte. Vous pouvez mettre en surbrillance un bloc de code et utiliser le chat en ligne pour voir une solution différente proposée par l’IA avant d’accepter.

Fenêtre de conversation intégrée avec vue diff

Vue de conversation dédiée

Vous pouvez utiliser une interface de chat plus traditionnelle avec une barre latérale de chat dédiée pour former des idées et une stratégie, résoudre des problèmes de codage et discuter des détails de mise en œuvre. Sélectionnez l’icône de chat ( l’icône Copilote de chat). ) dans la barre latérale VS Code pour ouvrir une fenêtre de conversation dédiée.

Barre latérale de conversation GitHub Copilot avec l’icône de conversation mise en surbrillance.

Vous pouvez également accéder à l’historique de la conversation en sélectionnant l’icône d’historique ( L’icône d’historique. ) en haut du panneau de conversation.