Databricks ODBC 驅動程式的驅動程式功能設定
本文說明如何設定 Databricks ODBC 驅動程式的特殊和進階驅動程式功能設定。
Databricks ODBC 驅動程式提供下列特殊和進階的驅動程式功能設定。
在 ODBC 中設定初始架構
ODBC 驅動程式可讓您藉由將 設定 Schema=<schema-name>
為聯機組態來指定架構。 這相當於執行 USE <schema-name>
。
ODBC 中的 ANSI SQL-92 查詢支援
ODBC 驅動程式接受 ANSI SQL-92 方言中的 SQL 查詢,並將查詢轉譯為 Databricks SQL 方言。 不過,如果您的應用程式直接產生 Databricks SQL,或您的應用程式使用 Azure Databricks 特有的任何非 ANSI SQL-92 標準 SQL 語法,Databricks 建議您設定 UseNativeQuery=1
為聯機組態。 使用該設定,驅動程式會將 SQL 查詢逐字傳遞至 Azure Databricks。
在 ODBC 中擷取大型查詢結果
若要在擷取大型查詢結果時達到最佳效能,請使用包含下列優化的最新版 ODBC 驅動程式。
ODBC 中的箭號串行化
ODBC 驅動程式 2.6.15 版和更新版本支援使用 Apache Arrow 的優化查詢結果串行化格式。
ODBC 中的雲端擷取
ODBC Driver 2.6.17 版和更新版本支援 Cloud Fetch,此功能可透過 Azure Databricks 部署中設定的雲端記憶體來擷取查詢結果。
查詢結果會上傳至內部 DBFS 儲存位置 ,做為最多 20 MB 的箭號串行化檔案。 當驅動程式在查詢完成之後傳送擷取要求時,Azure Databricks 會產生並傳回 上傳檔案的共用存取簽章 。 然後 ODBC 驅動程式會使用 URL 直接從 DBFS 下載結果。
雲端擷取僅用於大於 1 MB 的查詢結果。 較小的結果會直接從 Azure Databricks 擷取。
Azure Databricks 會自動垃圾收集累積的檔案,這些檔案會在 24 小時後標示為要刪除。 這些標示的檔案會在額外 24 小時後完全刪除。
若要深入瞭解雲端擷取架構,請參閱 如何使用BI工具實現高頻寬連線。
啟用 記錄
若要在適用於 Windows 的 ODBC 驅動程式中啟用記錄功能,請在相關 DSN 的 ODBC 數據來源管理員中設定下列欄位:
- 將 [ 記錄層級] 字段從 [嚴重 ] 設定為僅透過 TRACE 記錄嚴重事件,以記錄所有驅動程序活動。
- 將 [ 記錄路徑] 欄位設定為您要儲存記錄檔之資料夾的完整路徑。
- 將 [ 最大數目檔案 ] 字段設定為要保留的記錄檔數目上限。
- 將 [ 檔案大小上限] 字段設定為每個記錄檔的大小上限,以 MB 為單位。
若要在非 Windows 機器的 ODBC 驅動程式中啟用記錄功能,請在相關的 DSN 或無 DSN 連接字串 中設定下列屬性:
LogLevel
將 屬性1
從 設定為只記錄嚴重事件6
,以記錄所有驅動程序活動。- 將
LogPath
屬性設定為您要儲存記錄檔之資料夾的完整路徑。 - 將
LogFileCount
屬性設定為要保留的記錄檔數目上限。 - 將
LogFileSize
屬性設定為位元組中每個記錄檔的大小上限。
如需詳細資訊,請參閱 Databricks JDBC 驅動程式指南中的章節Configuring Logging Options on Windows
和 Configuring Logging Options on a Non-Windows Machine
。