Paramètres de capacité du Driver pour le Driver JDBC Databricks (Simba)
Cette page s'applique au Driver JDBC Simba (hérité), versions inférieures à la version 3. Databricks recommande vivement de migrer vers le Driver JDBC Databricks pour la connectivité JDBC. Il inclut des améliorations telles que la prise en charge des vues des indicateurs Unity Catalog, des transactions couvrant plusieurs instructions SQL, des procédures stockées, une récupération plus rapide des grands résultats et la télémétrie client intégrée.
Cette page décrit comment configurer les paramètres de capacités spéciales et avancées du Driver JDBC Databricks.
Le Driver JDBC Databricks fournit les paramètres de capacité de Driver spéciaux et avancés suivants.
Prise en charge des query ANSI SQL-92 en JDBC
Les pilotes JDBC Spark hérités acceptent les requêtes 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.
Catalogue et schéma par default
Pour spécifier le catalogue et le schéma default, ajoutez ConnCatalog=<catalog-name>;ConnSchema=<schema-name> à l'URL de connexion JDBC.
Balises de query pour le suivi
Aperçu
Cette fonctionnalité est en préversion privée. Pour demander l'accès, contactez votre équipe de compte.
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 query tags à votre connexion, incluez le parameter ssp_query_tags dans l'URL de votre connexion JDBC :
jdbc:databricks://<server-hostname>:443;httpPath=<http-path>;ssp_query_tags=key1:value1,key2:value2
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, key1:value1,key2:value2.
Extraire des résultats de query volumineux dans JDBC
Pour obtenir les meilleures performances lors de l'extraction de grands résultats de query, utilisez la dernière version du driver JDBC, qui inclut les optimisations suivantes.
Sérialisation Arrow dans JDBC
La version 2.6.16 et supérieure du driver JDBC prend en charge un format de sérialisation des résultats de query optimisé qui utilise Apache Arrow.
Activer la journalisation
Pour activer la journalisation dans le driver JDBC, définissez la propriété LogLevel sur une valeur entre 1 (événements 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 Configuring Logging dans le Guide du Driver JDBC Databricks.