Partager via

Qu’est-ce que l’extension Synapse pour Visual Studio Code ?

  • Article

L’extension Synapse pour Visual Studio Code prend en charge une expérience de développeur professionnel pour l’exploration des lakehouses de Microsoft Fabric, ainsi que la création de notebooks Fabric et de définitions de travaux Spark. En savoir plus sur l’extension, notamment sur la prise en main des prérequis nécessaires.

Visual Studio (VS) Code est l’un des plus légers éditeurs de code source utilisés. Il s’exécute sur votre machine et est disponible pour Windows, macOS et Linux. Après l’installation de Synapse pour VS Code, vous pouvez créer, exécuter et déboguer votre notebook et votre définition de travail Spark localement dans VS Code. Vous pouvez également publier le code sur le calcul Spark à distance dans votre espace de travail Fabric pour l’exécuter ou le déboguer. L’extension vous permet également de parcourir vos données lakehouse, y compris les tables et les fichiers bruts, dans VS Code.

Prérequis

Prérequis pour l’extension Synapse pour VS Code :

Une fois que vous avez installé le logiciel nécessaire, vous devez mettre à jour les propriétés du système d’exploitation.

Windows

  1. Ajoutez JAVA_HOME aux variables d’environnement et pointez-les vers le répertoire où java 1.8 est installé. Par exemple, si vous installez JDK sur ce chemin d’accès C:\Program Files\Java\jdk-1.8, définissez la valeur de la variable JAVA_HOME sur ce chemin d’accès.

  2. Ajoutez %JAVA_HOME%/bin et le sous-dossier condabin de l’installation Conda au répertoire du chemin d’accès système. Le dossier condabin peut se trouver dans le dossier d’installation et dans ce format \miniconda3\condsbin. Ouvrez les variables d’environnement et ajoutez les chemins %JAVA_HOME%/bin et condabin à la variable Path.

macOS

Exécutez conda.sh dans le terminal :

  1. Ouvrez la fenêtre du terminal, remplacez le répertoire pour le dossier où conda est installé, puis accédez au sous-répertoire etc/profile.d. Le sous-répertoire doit contenir un fichier nommé conda.sh.

  2. Exécutez source conda.sh.

  3. Dans la même fenêtre de terminal, exécutez sudo conda init.

  4. Tapez Java --version. La version doit être Java 1.8.

Installer l’extension et préparer votre environnement

  1. Recherchez Synapse VS Code dans la Place de marché de l’extension VS Code et installez l’extension.

  2. Une fois l’installation de l’extension terminée, redémarrez VS Code. L’icône de l’extension est répertoriée dans la barre d’activité VS Code.

Répertoire de travail local

Pour modifier un notebook, vous devez disposer d’une copie locale de son contenu. Le répertoire de travail local de l’extension sert de dossier racine local pour tous les notebooks téléchargés, même les notebooks de différents espaces de travail. À partir de la commande Synapse:Set Local Work Folder, vous pouvez spécifier un dossier comme répertoire de travail local pour l’extension.

Pour valider l’installation, ouvrez les paramètres de l’extension et vérifiez les détails :

Capture d’écran de la fenêtre de paramètres montrant le répertoire de travail local sélectionné.

Vous connecter et vous déconnecter de votre compte

  1. Dans la palette de commandes VS Code, entrez la commande Synapse:Sign in pour vous connecter à l’extension. Une page de connexion de navigateur distincte s’affichera.

  2. Tapez votre nom d’utilisateur et votre mot de passe.

  3. Une fois que vous vous êtes connecté, votre nom d’utilisateur s’affiche dans la barre d’état de VS Code pour indiquer que vous êtes connecté.

    Capture d’écran de la barre d’état de VS Code montrant l’emplacement de l’état de votre connexion.

  4. Pour vous déconnecter de l’extension, entrez la commande Synapse: Sign off.

Choisir un espace de travail

Pour sélectionner un espace de travail Fabric, vous devez disposer d’un espace de travail déjà créé. Si vous n’en possédez pas, vous pouvez en créer un sur le portail Fabric. Pour plus d’informations, consultez Créer un espace de travail.

Une fois que vous avez un espace de travail, choisissez-le en sélectionnant l’option Sélectionner un espace de travail. Une liste de tous les espaces de travail auxquels vous avez accès s’affichera ; sélectionnez celui que vous souhaitez dans la liste.

Capture d'écran de VS Code Explorer, montrant l'emplacement de l’option Sélectionner un espace de travail.

Limitations actuelles

  • L’extension en mode bureau ne prend pas encore en charge les Utilitaires Microsoft Spark
  • La commande Shell commençant par « ! » n’est pas prise en charge.

Contenu connexe

Dans cette vue d’ensemble, vous allez comprendre les bases de l’installation et de la configuration de l’extension Synapse pour VS Code. Les articles suivants expliquent comment développer vos notebooks et définitions de travaux Spark localement dans VS Code.