Nastavení možností ovladače pro ovladač ODBC Databricks

Tato stránka popisuje, jak nakonfigurovat speciální a pokročilé nastavení schopností ovladače pro ovladač ODBC Databricks.

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

Nastavení počátečního schématu v rozhraní ODBC

Ovladač ODBC umožňuje zadat schéma nastavením Schema=<schema-name> jako konfigurace připojení. To je ekvivalentem spuštění USE <schema-name>.

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ů, zahrňte parametr ssp_query_tags do konfigurace připojení ODBC.

Definujte značky dotazů jako dvojice klíč-hodnota oddělené čárkami, kde každý klíč a hodnota jsou oddělené dvojtečkou. Například: ssp_query_tags=team:engineering,env:prod.

Podpora dotazů ANSI SQL-92 v rozhraní ODBC

Starší ovladače Spark ODBC přijímají dotazy SQL v dialektu ANSI SQL-92 a před jejich odesláním na server je přeloží na 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.

Extrahování velkých výsledků dotazů v rozhraní ODBC

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

Serializace šipek v rozhraní ODBC

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

Načtení cloudu v rozhraní ODBC

Ovladač ODBC verze 2.6.17 a vyšší podporuje cloudové načítání, schopnost, 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:

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čů ODBC vydaných po listopadu 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í

Chcete-li povolit protokolování v ovladači ODBC, 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 najdete v tématu Konfigurování možností protokolování v počítači bez Windows v průvodci ovladačem ODBC Databricks.

  • Last updated on