A Databricks JDBC-illesztőprogram (Simba) illesztőprogram-képességeinek beállításai

Megjegyzés:

Ez a lap a Simba JDBC-illesztőre (legacy) vonatkozik, a 3. verzió alatti verziókra. A Databricks határozottan javasolja a Databricks JDBC-illesztőbe való migrálást a JDBC-kapcsolatokhoz. Olyan fejlesztéseket tartalmaz, mint a Unity Catalog metrikanézeteinek támogatása, a több SQL-utasítást felölelő tranzakciók, a tárolt eljárások, a gyorsabb nagy eredményű lekérés és a beépített ügyféltelemetria.

Ez a lap bemutatja, hogyan konfigurálhat speciális és speciális illesztőprogram-képességeket a Databricks JDBC-illesztőprogramhoz.

A Databricks JDBC-illesztőprogram az alábbi speciális és speciális illesztőprogram-képességeket biztosítja.

ANSI SQL-92 lekérdezéstámogatás a JDBC-ben

Az örökölt Spark JDBC-illesztőprogramok elfogadják az SQL-lekérdezéseket az ANSI SQL-92 dialektusában, és lefordítják őket a Databricks SQL-be, mielőtt elküldené őket a kiszolgálóra.

Ha az alkalmazás közvetlenül hozza létre a Databricks SQL-t, vagy nem ANSI SQL-92 szintaxist használ Azure Databricks, állítsa be UseNativeQuery=1 a kapcsolat konfigurációjában. Ez a beállítás szó szerint átadja az SQL-lekérdezéseket Azure Databricks fordítás nélkül.

Alapértelmezett katalógus és séma

Az alapértelmezett katalógus és séma megadásához adjon hozzá ConnCatalog=<catalog-name>;ConnSchema=<schema-name> a JDBC-kapcsolat URL-címéhez.

Nyomkövetési címkék lekérdezése

Kulcs-érték címkék csatolása AZ SQL-lekérdezésekhez nyomkövetési és elemzési célokra. A lekérdezéscímkék a táblában jelennek meg a system.query.history lekérdezések azonosításához és elemzéséhez.

Ha lekérdezéscímkéket szeretne hozzáadni a kapcsolathoz, adja meg a paramétert a ssp_query_tags JDBC-kapcsolat URL-címében:

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

A lekérdezéscímkéket vesszővel tagolt kulcs-érték párként definiálhatja, ahol az egyes kulcsokat és értékeket kettőspont választja el egymástól. Például: key1:value1,key2:value2.

Nagy lekérdezési eredmények kinyerése JDBC-vel

A nagy lekérdezési eredmények kinyerésekor a legjobb teljesítmény érdekében használja a JDBC-illesztő legújabb verzióját, amely az alábbi optimalizálásokat tartalmazza.

Nyíl szerializálása a JDBC-ben

A JDBC-illesztő 2.6.16-os és újabb verziója támogatja az Apache Arrowt használó optimalizált lekérdezési eredmények szerializálási formátumát.

A Cloud Fetch funkció a JDBC-ben

A JDBC-illesztőprogram 2.6.19-es és újabb verziója támogatja a Cloud Fetcht, amely a lekérdezési eredményeket a Azure Databricks üzemelő példányban konfigurált felhőalapú tárolón keresztül olvassa be.

Lekérdezés futtatásakor Azure Databricks az eredményeket a munkaterület felhőbeli tárolójában 20 MB-os nyíl-szerializált fájlként tárolja. A lekérdezés befejezése után az illesztő lekéréses kérelmeket küld, és Azure Databricks a hozzáférés-aláírás (SAS) URL-címeit adja vissza az eredményfájloknak. Az illesztőprogram ezután ezeket az URL-címeket használja az eredmények közvetlenül Azure tárolóból való letöltéséhez.

A Cloud Fetch csak az 1 MB-nál nagyobb lekérdezési eredményekre vonatkozik. Az illesztőprogram közvetlenül a Azure Databricks kéri le a kisebb eredményeket.

Azure Databricks automatikusan szemét gyűjti össze a felhalmozott fájlokat azáltal, hogy megjelöli őket törlésre 24 óra után, és véglegesen eltávolítja őket 24 órával később.

Hálózati előfeltételek

Ha a hálózat privát, a Cloud Fetch működéséhez a következő beállításokat kell konfigurálnia:

• Engedélyezze *.blob.core.windows.net és *.store.core.windows.net használja a hálózati környezetet.
• Adja hozzá a szükséges tanúsítványletöltéseket és -visszavonásokat az engedélyezési listához.
• Ha a tűzfaltámogatás engedélyezve van a Azure Databricks munkaterület tárfiókján, konfiguráljon egy virtual hálózati adatátjárót vagy egy on-premises adatátjárót a tárfiókhoz való privát hozzáférés engedélyezéséhez.

A Cloud Fetch letiltásához állítsa be EnableQueryResultDownload=0 a kapcsolat konfigurációját.

Lassú letöltések diagnosztizálása

A Cloud Fetch letöltési sebességének metrikáinak LogLevel megtekintéséhez állítsa be 4 az (INFO) és LogPath a naplómappa teljes elérési útját. Az illesztőprogram adattömbönként naplózza a letöltési sebességet, így a nagy eredményhalmazok több naplósort hoznak létre. Az illesztőprogram figyelmeztetést is naplóz, ha a sebesség körülbelül 1 MB/s alá csökken. Ez a funkció a 2025 decembere után kiadott JDBC (Simba) illesztőprogram-verziókban érhető el.

Ha a letöltések lassúak vagy elakadtak, az SAS-jogkivonatok lejárhatnak, mielőtt az illesztőprogram befejezi az összes eredményfájl letöltését. Ellenőrizze, hogy van-e sávszélesség-szabályozás vagy hálózati torlódás az ügyfél és a Azure Blob Storage között.

Naplózás engedélyezése

A JDBC-illesztőprogramban való naplózás engedélyezéséhez állítsa a LogLevel tulajdonságot egy értékre (csak súlyos események) és 1 (az összes illesztőprogram-tevékenység) között 6 . Állítsa a LogPath tulajdonságot annak a mappának a teljes elérési útjára, ahová a naplófájlokat menteni szeretné.

További információ: Naplózás konfigurálása a Databricks JDBC illesztőprogram-útmutatójában.