A Databricks ODBC-illesztőprogram illesztőprogram-képességeinek beállításai

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

A Databricks ODBC-illesztőprogram a következő speciális és speciális illesztőprogram-képességeket biztosítja.

A kezdeti séma beállítása az ODBC-ben

Az ODBC-illesztő lehetővé teszi a séma megadását kapcsolatkonfigurációként való beállítással Schema=<schema-name> . Ez a futtatásnak USE <schema-name>felel meg.

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

Fontos

A funkció privát előzetes verzióban érhető el. A hozzáférés kéréséhez lépjen kapcsolatba a fiókcsapattal.

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 hozzá a paramétert az ssp_query_tags ODBC-kapcsolat konfigurációjához:

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: ssp_query_tags=team:engineering,env:prod.

Az ODBC-illesztőprogram kapcsolati konfigurációját is be kell állítania ApplySSPWithQueries=0 .

ANSI SQL-92-lekérdezés támogatása az ODBC-ben

Az örökölt Spark ODBC-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.

Nagy lekérdezési eredmények kinyerés az ODBC-ben

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

Nyíl szerializálása az ODBC-ben

Az ODBC-illesztő 2.6.15-ös és újabb verziója támogatja az Apache Arrowt használó optimalizált lekérdezési eredmények szerializálási formátumát.

Cloud Fetch az ODBC-ben

Az ODBC-illesztőprogram 2.6.17-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 novembere után kiadott ODBC-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

Ha engedélyezni szeretné a naplózást az ODBC-illesztőprogramban, á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ó: Nem Windows gépek konfigurációs naplózási beállításai a Databricks ODBC illesztőprogram-útmutatójában.