Utilisation des dossiers Git avec l'extension Databricks pour Visual Studio Code

remarque

Databricks recommande d'utiliser les fichiers Workspace lors de la configuration de l'extension Databricks pour Visual Studio Code.

Cette documentation a été retirée et pourrait ne pas être mise à jour. Les produits, services ou technologies mentionnés dans ce contenu ne sont plus pris en charge. La documentation fournie ici couvre uniquement les spécificités de la configuration des dossiers Git pour l’extension Databricks pour Visual Studio Code. Pour une documentation complète, consultez l'extension Databricks pour Visual Studio Code.

L'extension Databricks pour Visual Studio Code prend en charge le travail avec des fichiers dans les dossiers Git Databricks au sein de l'espace de travail Databricks. Les dossiers Databricks Git étaient la synchronisation par default avant la version 0.3.15, mais n'est plus recommandé.

Les fichiers dans les dossiers Git sont activés par default dans tous les Databricks Workspaces, mais peuvent être désactivés par les administrateurs à l'aide de l'API REST. Contactez l'administrateur de votre workspace si vous ne pouvez pas accéder à cette fonctionnalité.

important

L'extension Databricks pour Visual Studio Code fonctionne uniquement avec les repositories qu'elle crée. Vous devez disposer des autorisations d'exécution pour un cluster Databricks afin d'exécuter du code, ainsi que des autorisations pour créer un repository dans les dossiers Git de Databricks.

Définir le repository

Si vous choisissez d'utiliser un dossier Git Databricks plutôt qu'un répertoire de Workspace dans votre Workspace Databricks, alors avec l'extension et votre projet de code ouverts, et un profil de configuration Databricks déjà défini, utilisez l'extension Databricks pour Visual Studio Code pour créer un nouveau repository dans les dossiers Git Databricks et l'utiliser, ou sélectionnez un repository existant dans les dossiers Git Databricks que vous avez créé précédemment avec l'extension Databricks pour Visual Studio Code et que vous souhaitez réutiliser à la place.

remarque

L'extension Databricks pour Visual Studio Code fonctionne uniquement avec les repositories qu'elle crée. Vous ne pouvez pas utiliser un repository existant dans votre Workspace.

Pour permettre à l'extension Databricks pour Visual Studio Code d'utiliser des repository dans les dossiers Git Databricks au sein d'un Workspace Databricks, vous devez d'abord définir le paramètre Synchronisation : Type de destination de l'extension sur repository comme suit :

1. L'extension et votre projet de code étant ouverts, et un profil de configuration Databricks étant déjà défini, dans la Palette de commandes ( Affichage > Palette de commandes ), tapez Preferences: Open User Settings, puis cliquez sur Préférences : Ouvrir les paramètres utilisateur .
2. Sous l'onglet **Utilisateur**, développez **Extensions** et cliquez sur **Databricks**.
3. Pour Synchronisation : Type de destination , sélectionnez référentiel .
4. Quittez et redémarrez Visual Studio Code.

Créer un nouveau repository

Pour créer un nouveau repository, veuillez faire ce qui suit :

1. Dans le volet Configuration , à côté de Sync Destination , cliquez sur l'icône d'engrenage ( Configurer la destination de la synchronisation ).

   

2. Dans la **Palette de commandes**, cliquez sur **Créer une nouvelle destination de synchronisation**.

3. Saisissez un nom pour le nouveau repository dans les dossiers Git de Databricks, puis appuyez sur Entrée .

   L'extension ajoute les caractères .ide à la fin du nom du dépôt, puis ajoute le chemin du workspace du dépôt au fichier .databricks/project.json du projet de code, par exemple "workspacePath": "/Workspace/Repos/someone@example.com/my-repo.ide".

remarque

Si le nom du repo distant ne correspond pas au nom de votre projet de code local, une icône d'avertissement s'affiche avec le message suivant : Le nom de la destination de synchronisation distante ne correspond pas au nom actuel du Visual Studio Code Workspace. Vous pouvez ignorer cet avertissement si vous n'avez pas besoin que les noms correspondent.

4. Après avoir configuré le repository, commencez la synchronisation avec le repository en cliquant sur l’icône en forme de cercle fléché ( Start synchronization ) à côté de Destination de synchronisation .

   

important

L'extension Databricks pour Visual Studio Code n'effectue qu'une synchronisation automatique et unidirectionnelle des modifications de fichiers de votre projet Visual Studio Code local vers le repository associé dans votre workspace Databricks distant. Ces fichiers de repository distant sont destinés à être transitoires. N'initiez pas de modifications à ces fichiers depuis votre repository distant, car ces modifications ne seront pas synchronisées avec votre projet local.

Réutiliser un dépôt existant

Si vous avez un repository existant dans les dossiers Git Databricks que vous avez créé précédemment avec l'extension Databricks pour Visual Studio Code et que vous souhaitez réutiliser dans votre projet Visual Studio Code actuel, veuillez faire ce qui suit :

1. Dans le volet Configuration , à côté de Sync Destination , cliquez sur l'icône d'engrenage ( Configurer la destination de la synchronisation ).

   

2. Dans la Palette de commandes , veuillez sélectionner le nom du repository dans la liste.

   L'extension ajoute le chemin du workspace du repo au fichier .databricks/project.json du projet de code, par exemple "workspacePath": "/Workspace/Repos/someone@example.com/my-repo.ide".

remarque

Si le nom du repo distant ne correspond pas au nom de votre projet de code local, une icône d'avertissement s'affiche avec le message suivant : Le nom de la destination de synchronisation distante ne correspond pas au nom actuel du Visual Studio Code Workspace. Vous pouvez ignorer cet avertissement si vous n'avez pas besoin que les noms correspondent.

3. Après avoir configuré le repository, commencez la synchronisation avec le repository en cliquant sur l’icône en forme de cercle fléché ( Start synchronization ) à côté de Destination de synchronisation .

   

important

L'extension Databricks pour Visual Studio Code n'effectue qu'une synchronisation automatique et unidirectionnelle des modifications de fichiers de votre projet Visual Studio Code local vers le repository associé dans votre workspace Databricks distant. Ces fichiers de repository distant sont destinés à être transitoires. N'initiez pas de modifications à ces fichiers depuis votre repository distant, car ces modifications ne seront pas synchronisées avec votre projet local.