Aller au contenu principal

Types d’asset pris en charge dans les dossiers Git

Les dossiers Git prennent en charge le contrôle de version pour des types d'assets Databricks spécifiques. Lorsqu'un type d'asset est pris en charge dans les dossiers Git, vous pouvez le commit vers un repository Git distant, suivre les modifications au fil du temps et collaborer avec d'autres utilisateurs via le contrôle de version.

remarque

Les Git folders sont des Workspace folders. Les fichiers et Notebooks d'un dossier Git sont stockés au même emplacement que les autres assets du Workspace. Pour plus d’information sur l’endroit où Databricks stocke les données, consultez Où Databricks écrit-il les données ?.

Le tableau suivant décrit les types d'asset pris en charge et leurs exigences :

Type d'asset

Détails

Fichier

Données sérialisées telles que des bibliothèques, des binaires, du code ou des images. Consultez Qu'est-ce qu'un fichier de workspace ?.

Notebook

Formats de fichiers Notebook pris en charge par Databricks. Les dossiers Git identifient les Notebooks par extension de fichier (.ipynb) ou par un marqueur spécial dans le contenu du fichier, tel qu'un commentaire # Databricks notebook source au début des fichiers .py. Les Notebooks ne sont pas sérialisés comme les autres types de fichiers. Voir les formats de Notebook.

Dossier

Un groupement logique de fichiers qui apparaît comme un dossier dans le Workspace Databricks et la CLI.

Query (Aperçu public)

Requêtes Databricks SQL enregistrées sous forme de fichiers .dbquery.ipynb. Nécessite le nouvel éditeur SQL. Vous ne pouvez pas commit les requêtes créées avec l'éditeur SQL hérité.

Tableau de bord (version préliminaire)

Brouillons de Databricks AI/BI dashboard enregistrés en tant que fichiers .lvdash.json. Les configurations de publication et de planification ne sont pas suivies.

Alerte (Aperçu public)

Alertes enregistrées sous forme de .dbalert.json fichiers. Les dossiers Git suivent les plannings d'alerte, mais les alertes clonées start en pause et vous devez les reprendre manuellement.

Type d'asset

Détails

Fichier

Données sérialisées telles que des bibliothèques, des binaires, du code ou des images. Consultez Qu'est-ce qu'un fichier de workspace ?.

Notebook

Formats de fichiers Notebook pris en charge par Databricks. Les dossiers Git identifient les Notebooks par extension de fichier (.ipynb) ou par un marqueur spécial dans le contenu du fichier, tel qu'un commentaire # Databricks notebook source au début des fichiers .py. Les Notebooks ne sont pas sérialisés comme les autres types de fichiers. Voir les formats de Notebook.

Dossier

Un groupement logique de fichiers qui apparaît comme un dossier dans le Workspace Databricks et la CLI.

Query (Aperçu public)

Requêtes Databricks SQL enregistrées sous forme de fichiers .dbquery.ipynb. Nécessite le nouvel éditeur SQL. Vous ne pouvez pas commit les requêtes créées avec l'éditeur SQL hérité.

Tableau de bord (version préliminaire)

Brouillons de Databricks AI/BI dashboard enregistrés en tant que fichiers .lvdash.json. Les configurations de publication et de planification ne sont pas suivies.

Alerte (Aperçu public)

Alertes enregistrées sous forme de .dbalert.json fichiers. Les dossiers Git suivent les plannings d'alerte, mais les alertes clonées start en pause et vous devez les reprendre manuellement.

Exigences en matière de dénomination des fichiers

Lorsque vous travaillez avec des assets dans les dossiers Git, suivez ces règles de nommage de fichiers :

  • Noms de notebook uniques : un dossier ne peut pas contenir un notebook portant le même nom qu’un autre notebook, fichier ou dossier, même avec des extensions différentes. Par exemple, un notebook au format source test1.py et un notebook au format .ipynb ne peuvent pas coexister, car les deux se sérialisent en test1.
  • Pas de barres obliques : Les noms de fichier ne peuvent pas contenir le caractère /. Par exemple, i/o.py n'est pas un nom de fichier valide.
  • Longueur maximale du nom : Chaque nom de fichier ou de dossier dans un chemin ne peut pas dépasser 255 octets.

Si vous enfreignez ces règles, les Opérations Git échouent avec un message d'erreur. Pour résoudre l'erreur, renommez les fichiers en conflit dans votre repository.

Types d'asset non pris en charge

Les types d'actifs suivants ne sont pas pris en charge dans les dossiers Git :

remarque

Vous pouvez déplacer les actifs non pris en charge dans un dossier Git, mais vous ne pouvez pas commit les modifications vers le repository distant.

Formats de Notebook

Pour obtenir des informations sur les formats de notebook pour le contrôle de code source, consultez les formats de notebook.