Freigeben über


Konnektivität mit Data Warehousing in Microsoft Fabric

Gilt für:✅ SQL-Analyseendpunkt und Warehouse in Microsoft Fabric

In Microsoft Fabric ist eine Verbindung mit einem Lakehouse-SQL-Analyseendpunkt oder -Warehouse über einen Tabular Data Stream oder einen TDS-Endpunkt zugänglich, der allen modernen Webanwendungen vertraut ist, die mit einem SQL Server-Endpunkt interagieren. Dies wird auf der Microsoft Fabric-Benutzeroberfläche als SQL-Verbindungszeichenfolge bezeichnet.

In diesem Artikel erfahren Sie, wie Sie eine Verbindung mit Ihrem SQL-Analyseendpunkt oder Ihrem Warehouse herstellen.

Um zu beginnen, müssen die folgenden Voraussetzungen erfüllt sein:

Authentifizierung bei Warehouses in Fabric

In Microsoft Fabric werden zwei Typen authentifizierter Benutzer über die SQL-Verbindungszeichenfolge unterstützt:

  • Microsoft Entra ID (ehemals Azure Active Directory) Benutzerprinzipale oder Benutzeridentitäten
  • Microsoft Entra ID (ehemals Azure Active Directory)-Dienstprinzipale

Weitere Informationen zur Microsoft Entra-Authentifizierung als Alternative zur SQL-Authentifizierung in Microsoft Fabric.

Für die SQL-Verbindungszeichenfolge muss der TCP-Port 1433 geöffnet sein. TCP 1433 ist die Standardportnummer für SQL Server. Die SQL-Verbindungszeichenfolge berücksichtigt auch das Warehouse- oder Lakehouse SQL-Analyseendpunkt-Sicherheitsmodell für den Datenzugriff. Daten können für alle Objekte abgerufen werden, auf die ein Benutzer Zugriff hat.

Zulassen von Tags des Power BI-Diensts über die Firewall

Um den ordnungsgemäßen Zugriff sicherzustellen, müssen Sie die Tags des Power BI-Diensts für den Firewallzugriff zulassen. Weitere Informationen finden Sie unter Tags des Power BI-Diensts. Sie können den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des TDS-Endpunkts nicht allein verwenden. Das Zulassen der Tags des Power BI-Diensts ist für die Konnektivität über die Firewall erforderlich.

Abrufen der SQL-Verbindungszeichenfolge

Führen Sie die folgenden Schritte aus, um Ihre Verbindungszeichenfolge abzurufen:

  1. Navigieren Sie zu Ihrem Arbeitsbereich, wählen Sie das Lager aus.
  2. Wählen Sie die Schaltfläche Kopieren im SQL-Verbindungszeichenfolgenfeld aus, um die Verbindungszeichenfolge in die Zwischenablage zu kopieren.

Oder in OneLake:

  1. Wählen Sie das Lagerhaus aus, und wählen Sie die ... Auslassungspunkte für weitere Optionenaus.
  2. Wählen Sie SQL-Verbindungszeichenfolge kopieren aus, um die Verbindungszeichenfolge in die Zwischenablage zu kopieren.

Erste Schritte mit SQL Server Management Studio (SSMS)

In den folgenden Schritten wird beschrieben, wie Sie im Microsoft Fabric-Arbeitsbereich Ihre ersten Schritte machen und ein Warehouse mit SQL Server Management Studio (SSMS) verbinden.

  1. Wenn Sie SSMS öffnen, erscheint das Fenster Mit dem Server verbinden. Wenn das Fenster bereits geöffnet ist, können Sie manuell eine Verbindung herstellen, indem Sie Objekt-Explorer>Verbinden>Datenbank-Engine auswählen.

    Screenshot, der zeigt, wo die Datenbank-Engine im Menu „Verbinden“ ausgewählt werden kann.

  2. Nachdem das Fenster Mit Server verbinden geöffnet wurde, fügen Sie die im vorherigen Schritt dieses Artikels kopierte Verbindungszeichenfolge in das Feld Servername ein. Klicken Sie auf Verbinden, und fahren Sie mit den entsprechenden Anmeldeinformationen für die Authentifizierung fort. Denken Sie daran, dass nur die mehrstufige Authentifizierung (MFA) von Microsoft Entra über die Option Microsoft Entra MFA unterstützt wird.

    Screenshot, der das „Mit dem Server verbinden“-Fenster zeigt.

  3. Sobald die Verbindung hergestellt wurde, zeigt der Objekt-Explorer das verbundene Warehouse aus dem Arbeitsbereich sowie alle entsprechenden Tabellen und Ansichten an, die abgefragt werden können.

    Screenshot, der zeigt, wo der Name des verbundenen Servers Objekt-Explorer-Bereich erscheint.

Beim Herstellen einer Verbindung über SSMS (oder ADS) werden sowohl ein SQL-Analyseendpunkt als auch ein Warehouse als Warehouses aufgeführt und es ist schwierig, zwischen den beiden Elementtypen und ihrer Funktionalität zu unterscheiden. Aus diesem Grund empfehlen wir Ihnen dringend, eine Namenskonvention einzuführen, mit deren Hilfe Sie problemlos zwischen den beiden Elementtypen unterscheiden können, wenn Sie in Tools außerhalb des Microsoft Fabric-Portals arbeiten. Nur SSMS 19 oder höher wird unterstützt.

Herstellen einer Verbindung mithilfe von Power BI

Ein Warehouse- oder Lakehouse-SQL-Analyseendpunkt ist eine vollständig unterstützte und native Datenquelle in Power BI und es ist nicht erforderlich, die SQL-Verbindungszeichenfolge zu verwenden. Der Datenausschnitt macht alle Warehouses sichtbar, auf die Sie direkt Zugriff haben. Auf diese Weise können Sie Ihre Warehouses auf einfache Weise nach Arbeitsbereichen finden und Folgendes tun:

  1. Wählen Sie das Warehouse aus.
  2. Wählen Sie Entitäten aus.
  3. Daten laden: Wählen Sie einen Datenverbindungsmodus aus: Importieren oder DirectQuery

Weitere Informationen finden Sie unter Erstellen von Berichten in Microsoft Fabric.

Herstellen einer Verbindung mithilfe von OLE DB

Wir unterstützen die Konnektivität mit dem Warehouse- oder SQL-Analyseendpunkt mithilfe von OLE DB. Stellen Sie sicher, dass Sie den neuesten Microsoft OLE DB-Treiber für SQL Server nutzen.

Herstellen einer Verbindung mithilfe von ODBC

Microsoft Fabric unterstützt die Konnektivität mit dem Warehouse- oder SQL-Analyseendpunkt mithilfe von ODBC. Stellen Sie sicher, dass Sie den neuesten ODBC-Treiber für SQL Server ausführen. Verwenden Sie Microsoft Entra ID (ehemals Azure Active Directory)-Authentifizierung. Es werden nur ODBC 18 oder höhere Versionen unterstützt.

Herstellen einer Verbindung mithilfe von JDBC

Microsoft Fabric unterstützt auch die Konnektivität mit dem Warehouse- oder SQL-Analyseendpunkt mithilfe eines Java Database Connectivity-Treibers (JDBC).

Überprüfen Sie beim Einrichten der Konnektivität über JDBC die folgenden Abhängigkeiten:

  1. Hinzufügen von Artefakten. Wählen Sie Artefakt hinzufügen aus, fügen Sie die folgenden vier Abhängigkeiten hinzu und wählen Sie dann Herunterladen/Aktualisieren aus, um alle Abhängigkeiten zu laden. Zum Beispiel:

    Screenshot: Auswählen von Herunterladen/Aktualisieren.

  2. Wählen Sie Verbindung testen und dann Fertig stellen aus.

    Screenshot: Registerkarte „Abhängigkeitsdeklaration“.

    <dependency>
       <groupId>com.microsoft.azure</groupId>
       <artifactId>msal4j</artifactId>
       <version>1.13.3</version>
    
    </dependency>
    
    <dependency>
       <groupId>com.microsoft.sqlserver</groupId>
       <artifactId>mssql-jdbc_auth</artifactId>
       <version>11.2.1.x86</version>
    </dependency>
    
     <dependency>
       <groupId>com.microsoft.sqlserver</groupId>
       <artifactId>mssql-jdbc</artifactId>
       <version>12.1.0.jre11-preview</version>
    </dependency>
    
     <dependency>
       <groupId>com.microsoft.aad</groupId>
       <artifactId>adal</artifactId>
       <version>4.2.2</version>
    </dependency>
    

Herstellen einer Verbindung mithilfe von dbt

Der dbt-Adapter ist ein Datentransformationsframework, das bewährte Methoden der Softwareentwicklung wie Tests und Versionskontrolle verwendet, um Code zu reduzieren, die Abhängigkeitsverwaltung zu automatisieren und zuverlässigere Daten zu liefern – alles mithilfe von SQL.

Mit den datenplattformspezifischen dbt-Adapter-Plug-Ins können Benutzer eine Verbindung mit dem gewünschten Datenspeicher herstellen. Um eine Verbindung mit einem Lager von dbteinem Lager herzustellen, verwenden Sie dbt-fabric den Adapter. In ähnlicher Weise verfügt die dedizierte SQL-Pooldatenquelle Azure Synapse Analytics über einen eigenen Adapter: dbt-synapse.

Beide Adapter unterstützen die Microsoft Entra ID-Authentifizierung und ermöglichen Entwicklern die Verwendung az cli authentication. Die SQL-Authentifizierung wird jedoch für dbt-fabric nicht unterstützt.

Der DBT Fabric DW-Adapter verwendet die pyodbc-Bibliothek, um die Konnektivität mit dem Warehouse herzustellen. Die pyodbc-Bibliothek ist eine ODBC-Implementierung in der Sprache Python, die die Python-Datenbank-API-Spezifikation v2.0 verwendet. Die pyodbc-Bibliothek übergibt die Verbindungszeichenfolge über SQLDriverConnect direkt an den Datenbanktreiber in der msodbc-Verbindungsstruktur mithilfe eines TDS-Proxydiensts (Tabular Data Stream, Tabellarisches Datenstreaming) an Microsoft Fabric.

Weitere Informationen finden Sie unter Einrichten des dbt-Adapters für Microsoft Fabric Data Warehouse und Konfiguration des dbt-Adapters für Microsoft Fabric Data Warehouse.

Herstellen von Konnektivität mit anderen Methoden

Jedes Drittanbietertool kann die SQL-Verbindungszeichenfolge über ODBC- oder OLE DB-Treiber verwenden, um mithilfe der Microsoft Entra ID (ehemals Azure Active Directory)-Authentifizierung eine Verbindung mit einem Microsoft Fabric Warehouse- oder SQL-Analyseendpunkt herzustellen. Weitere Informationen und Beispielverbindungszeichenfolgen zur Microsoft Entra-Authentifizierung als Alternative zur SQL-Authentifizierung.

Benutzerdefinierte Anwendungen

In Microsoft Fabric stellen ein Warehouse- und ein Lakehouse-SQL-Analyseendpunkt eine SQL-Verbindungszeichenfolge bereit. Auf Daten kann über ein umfangreiches Ökosystem von SQL-Tools zugegriffen werden, vorausgesetzt, sie können sich mit Microsoft Entra ID (ehemals Azure Active Directory) authentifizieren. Weitere Informationen finden Sie unter Verbindungsbibliotheken für Microsoft SQL-Datenbank. Weitere Informationen und Beispielverbindungszeichenfolgen zur Microsoft Entra-Authentifizierung als Alternative zur SQL-Authentifizierung.

Bewährte Methoden

Es wird empfohlen, Wiederholungsversuche in Ihren Anwendungen/ETL-Aufträgen hinzuzufügen, um Resilienz zu schaffen. Weitere Informationen finden Sie in den folgenden Dokumenten:

Überlegungen und Einschränkungen

  • Die SQL-Authentifizierung wird nicht unterstützt.
  • Das Feature „Mehrere aktive Resultsets“ (Multiple Active Result Sets, MARS) wird für Microsoft Fabric Warehouse nicht unterstützt. MARS ist standardmäßig deaktiviert, sollte jedoch entfernt oder auf „FALSCH“ festgelegt werden, wenn MultipleActiveResultSets in der Verbindungszeichenfolge enthalten ist.
  • Wenn du diese Fehlermeldung erhältst: „Der Vorgang konnte nicht abgeschlossen werden, weil wir einen Systemgrenzwert erreicht haben“, liegt dies daran, dass die Größe des Systemtokens ihren Grenzwert erreicht hat. Dieses Problem kann verursacht werden, wenn der Arbeitsbereich über zu viele Lager/SQL-Analyseendpunkte verfügt, wenn der Benutzer Zu viele Microsoft Entra-Gruppen oder eine Kombination aus den beiden gruppen ist. Wir empfehlen, 40 oder weniger Lagerorte und SQL-Analyseendpunkte pro Arbeitsbereich zu haben, um diesen Fehler zu verhindern. Wenden Sie sich an den Support, wenn das Problem weiterhin besteht.
  • Wenn Fehlercode 24804 mit der Nachricht „Die Operation konnte aufgrund einer Systemaktualisierung nicht abgeschlossen werden“ angezeigt wird. Schließen Sie diese Verbindung, melden Sie sich erneut an, und wiederholen Sie den Vorgang“ oder Fehlercode 6005 mit der Meldung „HERUNTERFAHREN ist im Gange. Bei der Ausführung für SQL Server tritt ein Fehler auf. Wenden Sie sich an das SQL Server-Team, wenn Sie weitere Unterstützung benötigen." Die Ursache ist ein temporärer Verbindungsverlust, wahrscheinlich aufgrund einer Systembereitstellung oder Neukonfiguration. Um dieses Problem zu beheben, melden Sie sich erneut an, und versuchen Sie es erneut. Informationen zum Erstellen von Resilienz und Wiederholungen in Ihrer Anwendung finden Sie unter Bewährte Methoden.
  • Wenn Sie den Fehlercode 18456 erhalten: Fehler bei der Ausführung für SQL Server, wenden Sie sich an das SQL Server-Team, wenn Sie weitere Unterstützung benötigen., lesen Sie das bekannte Problem: Data Warehouse-Verbindung oder Abfrageausführung schlägt fehl.
  • Verknüpfte Serververbindungen von SQL Server werden nicht unterstützt.