Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Auf dieser Seite wird beschrieben, wie Sie spezielle und erweiterte Treiberfunktionen für den Databricks ODBC-Treiber konfigurieren.
Der Databricks-ODBC-Treiber stellt die folgenden speziellen und erweiterten Einstellungen für Treiberfunktionen bereit.
- Festlegen des Anfangsschemas in ODBC
- Abfragetags für die Nachverfolgung
- Unterstützung für ANSI SQL-92-Abfragen in ODBC
- Extrahieren umfangreicher Abfrageergebnisse in ODBC
- Arrow-Serialisierung in ODBC
- Cloud-Abruf in ODBC
- Aktivieren der Protokollierung
Festlegen des Anfangsschemas in ODBC
Mithilfe des ODBC-Treibers können Sie das Schema angeben, indem Sie Schema=<schema-name> als Verbindungskonfiguration festlegen. Dies entspricht der Ausführung von USE <schema-name>.
Abfragetags für die Nachverfolgung
Von Bedeutung
Dieses Feature befindet sich in Privater Vorschau. Wenden Sie sich an Ihr Kontoteam, um den Zugriff anzufordern.
Fügen Sie Schlüsselwert-Tags zu Tracking- und Analysezwecken an Ihre SQL-Abfragen an. Abfragetags werden in der system.query.history Tabelle für die Abfrageidentifikation und -analyse angezeigt.
Um Ihrer Verbindung Abfragetags hinzuzufügen, fügen Sie den ssp_query_tags Parameter in die ODBC-Verbindungskonfiguration ein:
Definieren Sie Abfragetags als kommagetrennte Schlüsselwertpaare, wobei jeder Schlüssel und Wert durch einen Doppelpunkt getrennt ist. Beispiel: ssp_query_tags=team:engineering,env:prod.
Unterstützung für ANSI SQL-92-Abfragen in ODBC
Ältere Spark ODBC-Treiber akzeptieren SQL-Abfragen im ANSI SQL-92-Dialekt und übersetzen sie in Databricks SQL, bevor sie an den Server gesendet werden.
Wenn Ihre Anwendung Databricks SQL direkt generiert oder eine nicht-ANSI SQL-92-Syntax verwendet, die für Azure Databricks spezifisch ist, legen Sie UseNativeQuery=1 in Ihrer Verbindungskonfiguration fest. Diese Einstellung übergibt SQL-Abfragen an Azure Databricks ohne Übersetzung.
Extrahieren umfangreicher Abfrageergebnisse in ODBC
Um die beste Leistung zu erzielen, wenn Sie große Abfrageergebnisse extrahieren, verwenden Sie die neueste Version des ODBC-Treibers, die die folgenden Optimierungen enthält.
Arrow-Serialisierung in ODBC
Ab Version 2.6.15 unterstützt der ODBC-Treiber ein optimiertes Serialisierungsformat für Abfrageergebnisse, das Apache Arrow verwendet.
Hinweis
Cloud Fetch ist nur für AWS- und Azure-Arbeitsbereiche verfügbar.
Cloud-Abruf in ODBC
ODBC-Treiber, Version 2.6.17 und höher, unterstützt Cloud Fetch, eine Funktion, die Abfrageergebnisse über den in Ihrer Azure Databricks Bereitstellung konfigurierten Cloudspeicher abruft.
Wenn Sie eine Abfrage ausführen, speichert Azure Databricks die Ergebnisse im Cloudspeicher Ihres Arbeitsbereichs als Pfeil serialisierte Dateien von bis zu 20 MB. Nach Abschluss der Abfrage sendet der Treiber Abrufanforderungen und Azure Databricks gibt shared access signature (SAS)-URLs an die Ergebnisdateien zurück. Der Treiber verwendet dann diese URLs, um Ergebnisse direkt aus Azure Speicher herunterzuladen.
Cloud Fetch gilt nur für Abfrageergebnisse, die größer als 1 MB sind. Der Treiber ruft kleinere Ergebnisse direkt aus Azure Databricks ab.
Azure Databricks automatisch gesammelte Dateien sammelt, markieren sie nach 24 Stunden zum Löschen und endgültig löschen sie nach weiteren 24 Stunden.
Netzwerkvoraussetzungen
Wenn Ihr Netzwerk privat ist, müssen Sie die folgenden Einstellungen konfigurieren, damit Cloud Fetch funktioniert:
- Zulassen
*.blob.core.windows.netund*.store.core.windows.netin Ihrer Netzwerkumgebung. - Fügen Sie der Zulassungsliste die erforderlichen Zertifikatdownloads und Sperrungen hinzu.
- Wenn die Firewallunterstützung für Ihr Azure Databricks Arbeitsbereichsspeicherkonto aktiviert ist, konfigurieren Sie ein virtual Network Data Gateway oder ein on-premises-Datengateway, um privaten Zugriff auf das Speicherkonto zu ermöglichen.
Um Cloud Fetch zu deaktivieren, legen Sie in Ihrer Verbindungskonfiguration fest EnableQueryResultDownload=0 .
Aktivieren der Protokollierung
Um die Protokollierung im ODBC-Treiber zu aktivieren, legen Sie die LogLevel Eigenschaft auf einen Wert zwischen 1 (nur schwerwiegende Ereignisse) und 6 (alle Treiberaktivitäten) fest. Legen Sie die LogPath Eigenschaft auf den vollständigen Pfad des Ordners fest, in dem Protokolldateien gespeichert werden sollen.
Weitere Informationen finden Sie unter Configuring Logging Options in a Non-Windows Machine in the Databricks ODBC Driver Guide.