Nastavení možností ovladače pro ovladač Databricks JDBC (Simba)

Poznámka:

Tato stránka se vztahuje na ovladač Simba JDBC (starší verze), verze níže verze 3. Databricks důrazně doporučuje migraci na ovladač Databricks JDBC pro připojení JDBC. Zahrnuje vylepšení, jako je podpora zobrazení metrik Katalogu Unity, transakce, které zahrnují více příkazů SQL, uložené procedury, rychlejší načítání velkých výsledků a integrovanou telemetrii klienta.

Tato stránka popisuje, jak nakonfigurovat speciální a pokročilá nastavení možností ovladače pro ovladač Databricks JDBC.

Ovladač Databricks JDBC poskytuje následující speciální a pokročilá nastavení možností ovladačů.

Podpora dotazů ANSI SQL-92 v JDBC

Starší ovladače Spark JDBC přijímají dotazy SQL v dialektu ANSI SQL-92 a před jejich odesláním na server je přeloží do Databricks SQL.

Pokud vaše aplikace generuje Databricks SQL přímo nebo používá syntaxi BEZ ANSI SQL-92 specifickou pro Azure Databricks, nastavte v konfiguraci připojení UseNativeQuery=1. Toto nastavení předá doslovné doslovné dotazy SQL Azure Databricks bez překladu.

Výchozí katalog a schéma

Chcete-li zadat výchozí katalog a schéma, přidejte ConnCatalog=<catalog-name>;ConnSchema=<schema-name> na adresu URL připojení JDBC.

Značky dotazů pro sledování

Důležité

Tato funkce je ve verzi Private Preview. Pokud chcete požádat o přístup, obraťte se na svůj tým účtů.

Připojte značky klíč-hodnota k dotazům SQL pro účely sledování a analýzy. Značky dotazů se zobrazí v system.query.history tabulce pro identifikaci a analýzu dotazů.

Pokud chcete do připojení přidat značky dotazů, vložte parametr ssp_query_tags do URL připojení JDBC:

jdbc:databricks://<server-hostname>:443;httpPath=<http-path>;ssp_query_tags=key1:value1,key2:value2

Definujte značky dotazů jako dvojice klíč-hodnota oddělené čárkami, kde každý klíč a hodnota jsou oddělené dvojtečkou. Například: key1:value1,key2:value2.

Extrahování velkých výsledků dotazů v JDBC

Pokud chcete dosáhnout nejlepšího výkonu při extrahování velkých výsledků dotazů, použijte nejnovější verzi ovladače JDBC, která zahrnuje následující optimalizace.

Serializace šipky v JDBC

Ovladač JDBC verze 2.6.16 a vyšší podporuje optimalizovaný formát serializace výsledků dotazu, který používá Apache Arrow.

Načtení dat z cloudu v JDBC

Ovladač JDBC verze 2.6.19 a vyšší podporuje funkci Cloudového načítání, která načítá výsledky dotazů prostřednictvím cloudového úložiště nakonfigurovaného ve vašem nasazení Azure Databricks.

Když spustíte dotaz, Azure Databricks uloží výsledky do cloudového úložiště vašeho pracovního prostoru jako soubory se šipkami o velikosti až 20 MB. Po dokončení dotazu ovladač odešle požadavky na načtení a Azure Databricks vrátí adresy URL sdílené adresy URL přístupového podpisu do výsledných souborů. Ovladač pak pomocí těchto adres URL stáhne výsledky přímo z úložiště Azure.

Cloudové načítání se vztahuje pouze na výsledky dotazů větší než 1 MB. Ovladač načte menší výsledky přímo z Azure Databricks.

Azure Databricks automaticky uvolňování paměti shromažďuje soubory tím, že je označíte k odstranění po 24 hodinách a trvale je odeberete 24 hodin později.

Předpoklady pro sítě

Pokud je vaše síť soukromá, musíte nakonfigurovat následující nastavení, aby funkce Cloud Fetch fungovala:

• Povolte *.blob.core.windows.net a *.store.core.windows.net v síťovém prostředí.
• Přidejte požadované certifikáty ke stažení a odvolání do seznamu povolených certifikátů .
• Pokud je pro účet úložiště pracovního prostoru Azure Databricks povolená podpora brány firewall, nakonfigurujte bránu dat virtual network data gateway nebo on-premises data gateway a povolte privátní přístup k účtu úložiště.

Pokud chcete zakázat cloudové načítání, nastavte EnableQueryResultDownload=0 konfiguraci připojení.

Diagnostika pomalých stahování

Nastavte LogLevel hodnotu 4 (INFO) a LogPath úplnou cestu ke složce protokolu, abyste viděli metriky rychlosti stahování Cloud Fetch. Ovladač protokoluje rychlost stahování na blok dat, takže velké sady výsledků generují více řádků protokolu. Ovladač také zaznamená upozornění, když rychlost klesne pod přibližně 1 MB/s. Tato funkce je dostupná ve verzích ovladačů JDBC (Simba) vydaných po prosinci 2025.

Pokud jsou stahování pomalé nebo zastavené, platnost tokenů SAS může vypršet, než ovladač dokončí stahování všech souborů výsledků. Zkontrolujte omezování šířky pásma nebo zahlcení sítě mezi klientem a Azure Blob Storage.

Povolit protokolování

Pokud chcete povolit protokolování v ovladači JDBC, nastavte LogLevel vlastnost na hodnotu mezi 1 (pouze závažné události) a 6 (všechny aktivity řidiče). LogPath Nastavte vlastnost na úplnou cestu ke složce, do které chcete ukládat soubory protokolu.

Další informace naleznete v tématu Konfigurace protokolování v Průvodci ovladačem Databricks JDBC.