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.
Zusammenfassung
Artikel | Beschreibung |
---|---|
Freigabestatus | Allgemeine Verfügbarkeit |
Produkte | Power BI (Semantikmodelle) Power BI (Datenflüsse) Fabric (Dataflow Gen2) Power Apps (Dataflows) |
Unterstützte Authentifizierungsarten | Snowflake (Benutzername/Kennwort), Microsoft-Konto (Microsoft Entra ID) |
Funktionsreferenz-Dokumentation | — |
Hinweis
Die Snowflake Connector Implementierung 2.0 ist seit Juli 2025 allgemein verfügbar. Weitere Informationen über diese Funktion.
Hinweis
Einige Funktionen können in einem Produkt vorhanden sein, in anderen jedoch nicht, was an den Bereitstellungsplänen und hostspezifischen Funktionen liegt.
Unterstützte Funktionen
- Importieren
- DirectQuery (semantische Power BI-Modelle)
- Advanced Options (Erweiterte Optionen)
- Geben Sie einen Textwert an, der als Rollenname verwendet werden soll
- Beziehungsspalten
- Verbindungstimeout in Sekunden
- Befehlstimeout in Sekunden
- Datenbank
- Native SQL-Anweisung
Verbindung mit dem Snowflake Data Warehouse über Power Query Desktop herstellen
Hinweis
Seit März 2025 ist die Implementierung 2.0 der Option Snowflake-Connector in Power BI Desktop standardmäßig aktiviert.
Führen Sie die folgenden Schritte aus, um eine Verbindung zu einem Snowflake computing warehouse herzustellen:
Wählen Sie Get Data aus dem Menüband Home in Power BI Desktop, wählen Sie Database aus den Kategorien auf der linken Seite, wählen Sie Snowflake und wählen Sie dann Connect.
Geben Sie im Fenster Snowflake den Namen Ihres Snowflake-Servers in Server und den Namen Ihres Snowflake-Computing-Warehouse in Warehouse ein.
Geben Sie optional Werte in alle erweiterten Optionen ein, mit denen Sie die Verbindungsabfrage ändern möchten, z. B. einen Textwert, der als Rollenname verwendet werden soll, oder eine Befehlszeitüberschreitung. Weitere Informationen: Herstellen einer Verbindung mithilfe der erweiterten Optionen
Wählen Sie OK aus.
Geben Sie Ihren Benutzernamen und Ihr Passwort ein, um sich bei Ihrem Snowflake Computing Warehouse anzumelden, und wählen Sie dann Connect.
Hinweis
Sobald Sie Ihren Benutzernamen und Ihr Passwort für einen bestimmten Snowflake Server eingegeben haben, verwendet Power BI Desktop dieselben Anmeldedaten bei nachfolgenden Verbindungsversuchen. Sie können diese Anmeldeinformationen unter Datei > Optionen und Einstellungen > Datenquelleneinstellungen ändern. Weitere Informationen: Ändern Sie die Authentifizierungsmethode
Wenn Sie die Option des Microsoft-Kontos verwenden möchten, muss die Snowflake-Microsoft Entra ID-Integration auf der Snowflake-Seite konfiguriert werden. Weitere Informationen: Power BI SSO zu Snowflake - Erste Schritte
Wählen Sie im Navigator ein oder mehrere Elemente aus, die Sie importieren und in Power BI Desktop verwenden möchten. Wählen Sie dann entweder Load, um die Tabelle in Power BI Desktop zu laden, oder Transform Data, um den Power Query Editor zu öffnen, in dem Sie den gewünschten Datensatz filtern und verfeinern können, und laden Sie dann diesen verfeinerten Datensatz in Power BI Desktop.
Wählen Sie Import, um Daten direkt in Power BI zu importieren, oder wählen Sie DirectQuery, und wählen Sie dann OK. Weitere Informationen: DirectQuery in Power BI Desktop verwenden
Hinweis
Microsoft Entra ID Single Sign-On (SSO) unterstützt nur DirectQuery.
Herstellen einer Verbindung mit einer Snowflake-Datenbank aus Power Query Online
Gehen Sie wie folgt vor, um die Verbindung herzustellen:
Wählen Sie in der Connectorauswahl die Option Snowflake.
Geben Sie im daraufhin angezeigten Dialogfeld Snowflake den Namen des Servers und des Lagers ein.
Geben Sie die gewünschten Werte für die erweiterten Optionen ein. Wenn es erweiterte Optionen gibt, die nicht in der Benutzeroberfläche dargestellt werden, können Sie diese später im Advanced Editor in Power Query bearbeiten.
Geben Sie Ihre Anmeldedaten für die Verbindung ein, einschließlich der Auswahl oder Erstellung einer neuen Verbindung, des Gateways, das Sie verwenden möchten, sowie eines Benutzernamens und Passworts.
Wählen Sie Weiter, um eine Verbindung mit der Datenbank herzustellen.
Wählen Sie in Navigator die erforderlichen Daten aus, und wählen Sie dann Daten transformieren aus, um die Daten in Power Query-Editor zu transformieren.
Verbinden mithilfe erweiterter Optionen
Power Query bietet eine Reihe von erweiterten Optionen, die Sie bei Bedarf zu Ihrer Abfrage hinzufügen können.
In der folgenden Tabelle sind alle erweiterten Optionen aufgeführt, die Sie in Power Query einstellen können.
Erweiterte Option | Beschreibung |
---|---|
Rollenname | Gibt die Rolle an, die der Bericht über den Treiber verwendet. Diese Rolle muss dem Benutzer zur Verfügung stehen, ansonsten ist keine Rolle festgelegt. |
Beziehungsspalten einbeziehen | Wenn aktiviert, werden Spalten einbezogen, die möglicherweise Beziehungen zu anderen Tabellen haben. Wenn dieses Feld deaktiviert ist, werden diese Spalten nicht angezeigt. |
Verbindungstimeout in Sekunden | Gibt an, wie lange bei der Interaktion mit dem Snowflake-Dienst auf eine Antwort gewartet werden soll, bevor ein Fehler zurückgegeben wird. Der Standardwert ist 0 (kein Timeout). |
Befehlstimeout in Sekunden | Gibt an, wie lange auf den Abschluss einer Abfrage gewartet werden soll, bevor ein Fehler zurückgegeben wird. Der Standardwert ist 0 (kein Timeout). |
Datenbank | Gibt eine bestimmte Datenbank im Lager an. Diese Option ist nur in Power Query Desktop verfügbar. |
SQL-Anweisung | Informationen hierzu erhalten Sie unter Importieren von Daten aus einer Datenbank mithilfe einer nativen Datenbankabfrage. Diese Option ist nur in Power Query Desktop verfügbar. |
Nachdem Sie die erforderlichen erweiterten Optionen ausgewählt haben, wählen Sie OK in Power Query Desktop oder Next in Power Query Online aus, um eine Verbindung mit Ihrer Snowflake-Datenbank herzustellen.
Implementierung des Snowflake-Konnektors 2.0
Im Januar 2025 haben wir eine neue Implementierung für den Snowflake Connector eingeführt, um die Integration mit Snowflake zu verbessern. Dieser Connector ist seit Juli 2025 allgemein verfügbar. Sie werden empfohlen, das Power BI Desktop- und lokale Datengateway auf die neueste Version zu aktualisieren, um von den aktuellsten Funktionen zu profitieren. Geben Sie uns Feedback , damit wir den Connector weiter verbessern können.
Die Snowflake Connector-Implementierung 2.0 wird mithilfe des ADBC-Treibers (Open-Source Arrow Database Connectivity ) erstellt. ADBC bietet eine Reihe von Standardschnittstellen für die Interaktion mit Pfeildaten, die besonders effizient beim Abrufen großer Datasets mit minimalem Aufwand und ohne Serialisierung oder Kopieren ist. Der ADBC-Treiber enthält auch Sicherheitsverbesserungen wie Speichersicherheit und Garbage Collection. Darüber hinaus ermöglicht die Zusammenarbeit mit der Open-Source-Community schnellere Updates, indem moderne Tools und sdl-Prozesse (Secure Development Lifecycle) verwendet werden.
Damit Sie diese Leistungs- und Sicherheitsverbesserungen nutzen können, verwenden ab Juli 2025 alle neu erstellten Verbindungen automatisch die 2.0-Implementierung. Darüber hinaus werden wir bestehende Kunden schrittweise in Phasen auf die 2.0-Implementierung umstellen, wobei Updates für verschiedene Regionen bis November 2025 angewendet werden. Während dieses Zeitraums können Sie die 2.0-Implementierung testen, indem Sie Ihre vorhandenen Abfragen aktualisieren und das Implementation="2.0"
-Flag in Snowflake.Databases
wie folgt hinzufügen. Nach dem Übergang werden Verbindungen, die keine Implementierung angeben, automatisch auf die 2.0-Implementierung aktualisiert.
Source = Snowflake.Databases("contoso.snowflakecomputing.com", "CONTOSO_WH", [Implementation="2.0"])
Um bei der Diagnose potenzieller Probleme zu helfen, finden Sie die Implementation
und DriverType
details in Ihren Mashup-Protokollen wie im folgenden Beispiel. Wenn während des Übergangs Probleme auftreten, wenden Sie sich an den Support. Um das Problem selbst abzumildern, können Sie Implementation="1.0"
angeben, um den 1.0 Connector weiterhin zu verwenden und Geschäftsunterbrechungen zu vermeiden, bevor das Problem behoben wird.
{"Start":"2024-11-02T00:14:02.7968686Z","Action":"Engine/Module/Snowflake/IO/Snowflake/Implementation","ResourceKind":"Snowflake","ResourcePath":"powerbi.snowflakecomputing.com ;DEMO_WH","HostProcessId":"29200","Implementation":"2.0","DriverType":"ADBC","ProductVersion":"2.139.0.0 (Main)+eda56ecd858054173a4d11db9c63a6da5cf92a99","ActivityId":"106f16b6-cfbb-4853-9f20-ed45486486d2","Process":"Microsoft.Mashup.Container.NetFX45","Pid":38560,"Tid":1,"Duration":"00:00:00.0000291"}
Die folgenden Optionen sind seit der Version vom Juli 2025 verfügbar:
-
UseHighPrecision
: Steuert die Genauigkeit der Behandlung von Snowflake NUMBER(38,0)-Feldern. Wenn kein Wert angegeben ist, fragt der Connector Snowflake mithilfe derSHOW PARAMETERS LIKE 'ODBC_TREAT_DECIMAL_AS_INT'
Abfrage ab. Wenn der Wert nicht festgelegt ist, verwendet der Verbinder die durch die Spalte angegebene Skalierung. Eintrue
Wert behandelt ZAHL(38;0) als Dezimaltyp. Der Wertfalse
behandelt ZAHL(38,0) als Int64-Typ. Wenn die Skala höher als 0 ist, wird die Spalte als Datentyp Double betrachtet. -
DateTimePrecision
: Steuert die Genauigkeit der Behandlung von Snowflake-Zeitstempelwerten. Snowflake speichert in der Regel Zeitstempelwerte mit Nanosekundengenauigkeit. In ADBC kann dies eine Überlaufausnahme für Datumsangaben vor 1677 oder nach 2262 laut Snowflake verursachen. Gültige Werte für diese Option sind NULLnanoseconds
odermicroseconds
. Ein Nullwert verwendet standardmäßignanoseconds
. Benutzer, die Datumsangaben vor 1677 oder nach 2262 benötigen, werden empfohlen, diemicroseconds
Einstellung zu verwenden. Wenn Benutzer vor 1677 oder nach 2262 die Genauigkeit bis zur zehnmillionstel Stelle beibehalten müssen, wird empfohlen, beim ODBC-Treiber zu bleiben.
Wenn Sie proxy verwenden müssen, um eine Verbindung mit Snowflake herzustellen, lesen Sie die Proxyeinstellungsanweisung. Der Treiber verwendet Umgebungsvariablen für die Proxyeinstellungen.
Nachfolgend finden Sie eine Zusammenfassung der In den letzten Versionen veröffentlichten Connectorerweiterungen:
Freigabe | Verbinderverbesserung |
---|---|
Juli 2025 | - Boolesche Spalten geben boolesche Typen zurück, um das Problem zu beheben, bei dem boolesche Spalten in einem leeren Datensatzsatzschema (einschließlich Metadaten) als String-Typen behandelt wurden. - Neue Einstellung zum Festlegen der maximalen Zeitstempelgenauigkeit auf Mikrosekunden. - Verbesserte Dauerunterstützung. – Unterstützung für Navigationseigenschaften zu ADBC hinzugefügt. - Verbesserte Nachverfolgung im ADBC-Treiber, wo die "ActivityId" jetzt innerhalb der Treiberebene nachverfolgt werden kann. |
der April 2025 | – Unterstützung für Snowflake-Abfragetag hinzugefügt. Beispiel: {"PowerQuery":true,"Host":"PBI_SemanticModel_MWC","HostContext":"PowerBIPremium-DirectQuery"} |
März 2025 | – Verbesserte Leistung beim Abrufen von Daten aus Snowflake. – Standardmäßig in Power BI Desktop aktiviert, sodass die neu erstellten Verbindungen automatisch die neue Connectorimplementierung verwenden. – Das Problem der nicht sichtbaren Ansichten, das seit der Veröffentlichung im März bestand, wurde behoben. |
Februar 2025 | – Verbesserte Leistung durch Verringern der Anzahl von Metadatenaufrufen. – Problem mit doppelten Werten für große Resultsets behoben. |
Hinweis
Wenn Sie das lokale Datengateway verwenden, beachten Sie, dass die minimale unterstützte Version Januar 2025 ist. Es wird empfohlen, die neueste Version mit den aktuellsten Funktionen zu verwenden.
Hinweis
Dieses Feature wird in der 64-Bit-Version von Power BI Desktop unterstützt und funktioniert nicht in der 32-Bit-Version.
Problembehandlung
Fehler: SQL-Kompilierungsfehler: Objekt ist nicht vorhanden oder der Vorgang kann nicht ausgeführt werden.
Dieser Fehler tritt auf, wenn das System das angegebene Objekt nicht finden kann. Das liegt häufig daran, dass der Benutzer einen ungültigen Datenbanknamen für die Standarddatenbank festgelegt hat.
Achten Sie darauf, dass ein gültiger Standarddatenbankname für die Eigenschaft DEFAULT_NAMESPACE verwendet wird: DESC USER
username
So aktualisieren Sie den Standarddatenbanknamen: alter user
username
set DEFAULT_NAMESPACE=<database name>.<schema name>
. Weitere Informationen finden Sie in der Snowflake-Dokumentation - https://docs.snowflake.com/en/sql-reference/sql/alter-user
Einschränkungen und bekannte Probleme
Bindestriche in Datenbanknamen
Wenn ein Datenbankname einen Bindestrich enthält, können Sie auf einen ODBC: ERROR[42000] SQL compilation error
treffen. Dieses Problem wird in der Version vom September 2024 behoben.
Datenschnitt visuell für booleschen Datentyp
Die Slicer-Visualisierung für den Boolean-Datentyp funktioniert in der Version vom Juni 2024 nicht wie erwartet. Diese Nichtfunktionalität ist ein bekanntes Problem. Als temporäre Lösung können Benutzer den booleschen Datentyp in ihren Berichten in Text konvertieren, indem sie hierhin navigieren: Übertragung -> Datentyp -> Text. Ein Fix wird in der Version vom Oktober 2024 bereitgestellt.
Ansichten mit Implementation="2.0" nicht sichtbar
In einer Version vom März 2025 von Power BI Desktop treten möglicherweise Probleme auf, bei denen Ansichten bei Verwendung der Snowflake Connector-Implementierung 2.0 (Implementation="2.0"
) nicht sichtbar sind. Dieses Problem wurde seit der neuesten Version vom März 2025 von Power BI Desktop behoben. Führen Sie ein Upgrade der Installation durch, um es erneut zu versuchen.
TIMESTAMP_NTZ Werte sind UTC mit Implementierung="2.0"
TIMESTAMP_LTZ Typen werden nicht in die lokale Zeitzone konvertiert, sondern geben bei Verwendung der Snowflake Connector-Implementierung 2.0 (Implementation="2.0"
) den UTC-Wert zurück. Beispielsweise führt SELECT CURRENT_TIMESTAMP
in Snowflake dazu, dass die UTC-Zeit und nicht die lokale Zeitzone des Benutzers zurückgegeben wird. Dieses Problem wird in der Version vom Juli 2025 behoben.
Index lag außerhalb der Grenzen des Arrays bei Verwendung von Implementation="2.0"
In einigen Szenarien wird ein Fehler ausgelöst, der Index was outside the bounds of the array
angibt, wann die Snowflake Connector-Implementierung 2.0 (Implementation="2.0"
) verwendet wird. Dieses Problem wird in der Version vom Juni 2025 behoben.