Installer Databricks Connect pour Python

remarque

Cet article couvre Databricks Connect pour Databricks Runtime 13.3 LTS et les versions ultérieures.

Cet article décrit comment installer Databricks Connect pour Python. See Databricks Connect.

Exigences

Avant d'installer Databricks Connect, assurez-vous que votre Workspace et votre environnement local répondent aux exigences. Consultez les exigences d'utilisation de Databricks Connect.

Activer un environnement virtuel Python

Databricks vous recommande vivement d'activer un environnement virtuel Python pour chaque version de Python que vous utilisez avec Databricks Connect. Les environnements virtuels Python permettent de s'assurer que vous utilisez les versions correctes de Python et de Databricks Connect ensemble. Pour plus d'information sur ces outils et comment les activer, consultez venv ou Poetry.

Installez le client Databricks Connect

Cette section explique comment installer le client Databricks Connect avec venv ou Poetry.

remarque

Si vous avez déjà installé l'extension Databricks pour Visual Studio Code, vous pouvez installer Databricks Connect pour Databricks Runtime 13.3 LTS et versions ultérieures à l'aide de l'extension. Consultez Déboguer du code à l'aide de Databricks Connect pour l'extension Databricks pour Visual Studio Code.

Installer le client Databricks Connect avec venv

1. Une fois votre environnement virtuel activé, désinstallez PySpark, s'il est déjà installé, en exécutant la commande uninstall. Ceci est requis car le package databricks-connect est en conflit avec PySpark. Pour plus de détails, voir Installations PySpark conflictuelles. Pour vérifier si PySpark est déjà installé, exécutez la commande show.

   Bash

   # Is PySpark already installed?
   pip3 show pyspark
   
   # Uninstall PySpark
   pip3 uninstall pyspark

2. Avec votre environnement virtuel toujours activé, installez le client Databricks Connect en exécutant la commande install. Utilisez l'option --upgrade pour mettre à niveau toute installation client existante vers la version spécifiée.

   Bash

   pip3 install --upgrade "databricks-connect==17.3.*"  # Or X.Y.* to match your cluster version.

remarque

Databricks vous recommande d'ajouter la notation « point-astérisque » pour spécifier databricks-connect==X.Y.* au lieu de databricks-connect=X.Y, pour s'assurer que le package le plus récent est installé. Bien que ce ne soit pas une exigence, cela permet de s'assurer que vous pouvez utiliser les dernières fonctionnalités prises en charge pour ce cluster.

Installez le client Databricks Connect avec Poetry

1. Une fois votre environnement virtuel activé, désinstallez PySpark, s'il est déjà installé, en exécutant la commande remove. Ceci est requis car le package databricks-connect est en conflit avec PySpark. Pour plus de détails, voir Installations PySpark conflictuelles. Pour vérifier si PySpark est déjà installé, exécutez la commande show.

   Bash

   # Is PySpark already installed?
   poetry show pyspark
   
   # Uninstall PySpark
   poetry remove pyspark

2. Avec votre environnement virtuel toujours activé, installez le client Databricks Connect en exécutant la commande add.

   Bash

   poetry add databricks-connect@~17.3  # Or X.Y to match your cluster version.

remarque

Databricks vous recommande d’utiliser la notation « at-tilde » pour spécifier databricks-connect@~17.3 au lieu de databricks-connect==17.3, afin de garantir l’installation du package le plus récent. Bien que ce ne soit pas une exigence, cela permet de s'assurer que vous pouvez utiliser les dernières fonctionnalités prises en charge pour ce cluster.