Aller au contenu principal

Paramètres de capacité du Driver pour le Driver ODBC Databricks

Cette page explique comment configurer les paramètres spéciaux et avancés de capacité de Driver pour le Databricks ODBC Driver.

Le Driver ODBC Databricks fournit les paramètres de capacité de driver spéciaux et avancés suivants.

Définir le schéma initial dans ODBC​

Le driver ODBC vous permet de spécifier le schéma en définissant Schema=<schema-name> comme configuration de connexion. Cela équivaut à l'exécution de USE <schema-name>.

Balises de query pour le suivi​

Attachez des tags clé-valeur à vos requêtes SQL à des fins de suivi et d'analytique. Les tags query apparaissent dans la table system.query.history pour l'identification et l'analyse des query.

Pour ajouter des tags de query à votre connexion, incluez le paramètre ssp_query_tags dans votre configuration de connexion ODBC :

Définissez les tags de query sous forme de paires clé-valeur séparées par des virgules, où chaque clé et valeur est séparée par deux points. Par exemple, ssp_query_tags=team:engineering,env:prod.

Vous devez également définir ApplySSPWithQueries=0 dans la configuration de connexion de votre driver ODBC.

Prise en charge des query ANSI SQL-92 dans ODBC​

Les drivers Spark ODBC hérités acceptent les queries SQL dans le dialecte ANSI SQL-92 et les traduisent en Databricks SQL avant de les envoyer au serveur.

Si votre application génère directement du Databricks SQL ou utilise une syntaxe non ANSI SQL-92 spécifique à Databricks, définissez UseNativeQuery=1 dans votre configuration de connexion. Ce paramètre transmet les requêtes SQL telles quelles à Databricks sans traduction.

Extraire les résultats de grandes query dans ODBC​

Pour obtenir les meilleures performances lorsque vous extrayez des résultats de query volumineux, utilisez la dernière version du driver ODBC, qui inclut les optimisations suivantes.

Sérialisation Arrow dans ODBC​

Le Driver ODBC version 2.6.15 et supérieure prend en charge un format de sérialisation des résultats de query optimisé qui utilise Apache Arrow.

Extraction de cloud dans ODBC​

La version 2.6.17 et supérieure du Driver ODBC prend en charge Cloud Fetch, une capacité qui récupère les résultats de query via le stockage cloud configuré dans votre déploiement Databricks.

Lorsque vous exécutez une query, Databricks stocke les résultats dans le stockage cloud de votre workspace sous forme de fichiers sérialisés Arrow pouvant aller jusqu'à 20 Mo. Une fois la query terminée, le driver envoie des demandes d'extraction et Databricks retourne des URL signées vers les fichiers de résultats. Le Driver utilise ensuite ces URL pour download les résultats directement à partir de Google Cloud Storage (GCS).

Cloud Fetch ne s'applique qu'aux résultats de query supérieurs à 1 Mo. Le Driver récupère les résultats plus petits directement à partir de Databricks.

Databricks effectue automatiquement le nettoyage des fichiers accumulés en les marquant pour suppression après 24 heures et en les supprimant définitivement 24 heures plus tard.

Prérequis réseau​

cloud Fetch download les fichiers de résultats directement à partir de GCS. Si la machine cliente ne peut pas accéder à GCS, Cloud Fetch échoue. Vérifiez les points suivants :

  • Les règles de proxy et de pare-feu doivent autoriser le trafic HTTPS vers storage.googleapis.com.
  • Si le bucket de stockage de votre workspace utilise le filtrage IP de bucket, le filtre doit autoriser les adresses IP de la machine cliente.
  • Si le bucket de stockage de votre workspace se trouve à l'intérieur d'un périmètre VPC Service Controls, ce dernier doit disposer d'un niveau d'accès ou d'une règle d'entrée qui autorise les requêtes provenant de la machine cliente.

Pour désactiver Cloud Fetch, définissez EnableQueryResultDownload=0 dans votre configuration de connexion.

Diagnostiquer les download lents​

Définissez LogLevel sur 4 (INFO) et LogPath sur le chemin complet d'un dossier de Logs pour voir les mesures de vitesse de download de Cloud Fetch. Le Driver enregistre également la vitesse de download par bloc, ainsi, les grands ensembles de résultats génèrent plusieurs lignes de Logs. Le Driver Logs également un avertissement lorsque la vitesse tombe en dessous d'environ 1 Mo/s. Cette fonctionnalité est disponible dans les versions du driver ODBC publiées après novembre 2025.

Si les download sont lents ou bloqués, les URL signées peuvent expirer avant que le Driver n'ait fini de download tous les fichiers de résultat. Vérifiez s'il y a une limitation de la bande passante ou un encombrement du réseau entre le client et GCS.

Activer la journalisation​

Pour activer la journalisation dans le Driver ODBC, définissez la propriété LogLevel sur une valeur comprise entre 1 (manifestations graves uniquement) et 6 (toute l'activité du Driver). Définissez la propriété LogPath sur le chemin complet du dossier où vous souhaitez enregistrer les Logs.

Pour plus d'informations, consultez Configuration des options de journalisation sur une machine non-Windows dans le Guide du Driver ODBC Databricks.