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.
Gilt für:✅ SQL Analytics Endpoint und Warehouse in Microsoft Fabric
In Microsoft Fabric greifen Benutzer über einen TDS-Endpunkt (Tabular Data Stream) auf einen SQL-Analyseendpunkt oder Warehouse zu. Moderne Webanwendungen interagieren mit a SQL Server TDS-Endpunkt. In den Microsoft Fabric-Einstellungen wird dieser Endpunkt als SQL-Verbindungszeichenfolge bezeichnet.
Tipp
Ein Lernprogramm zum Herstellen einer Verbindung mit allgemeinen Tools finden Sie unter "Herstellen einer Verbindung mit Fabric Data Warehouse".
Authentifizierung bei Warehouses in Fabric
In Microsoft Fabric unterstützt die SQL-Verbindungszeichenfolge zwei Arten von authentifizierten Benutzern:
- Microsoft Entra ID-Benutzerprinzipale oder Benutzeridentitäten
- Microsoft Entra ID-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. Warehouse verwendet das Microsoft SQL Server Tabular Data Stream (TDS)-Protokoll über TCP-Port 1433. In Umgebungen, die protokollbewusste Firewalls oder Inspektionen auf Anwendungsebene verwenden, konfigurieren und inspizieren Sie SQL-Verkehr als Microsoft SQL Server (MSSQL/TDS)-Verkehr und nicht als HTTPS-Verkehr.
Einige Firewalls unterscheiden zwischen TCP-Portzugriff und Anwendungsprotokollinspektion. In diesen Umgebungen reicht es möglicherweise nicht aus, TCP-Port 1433 allein zuzulassen, wenn die Firewall so konfiguriert ist, dass sie HTTPS-Verkehr auf diesem Port erwartet.
Die SQL-Verbindungszeichenfolge berücksichtigt auch das Warehouse- oder Lakehouse SQL-Analyseendpunkt-Sicherheitsmodell für den Datenzugriff. Benutzer können auf Daten für alle Objekte zugreifen, für die sie über die Berechtigung verfügen.
Weitere Informationen zur Sicherheit im SQL-Analyseendpunkt finden Sie unter OneLake-Sicherheit für SQL-Analyseendpunkte.
Bewährte Methoden
Fügen Sie Ihren Anwendungen und ETL-Aufträgen Wiederholungsversuche hinzu, um sie stabiler zu machen. Weitere Informationen finden Sie in der folgenden Dokumentation:
- Wiederholungsmuster – Azure Architecture Center
- Arbeiten mit vorübergehenden Fehlern – Azure SQL-Datenbank
- Schritt 4: Zuverlässig mit SQL verbinden – ADO.NET – ADO.NET Provider für SQL Server
- Schritt 4: Resilient mit SQL verbinden – PHP-Treiber für SQL Server
- Verwenden Sie Diensttags für die Firewallfreigabe, wie im folgenden Abschnitt beschrieben.
- Sie sollten beim Herstellen einer Verbindung den Namen des Lagerelements als Ursprünglicher Katalog oder Datenbanknamen angeben. Wenn Sie nicht die
InitialCatalogEigenschaft der Verbindungszeichenfolge angeben, wird Ihr anfänglicher Verbindungskontext dasmasterWarehouse sein.
Zulassen von Azure-Diensttags über die Firewall
Um die Konnektivität über die Firewall zu aktivieren, müssen Sie Power BI-Diensttags und SQL-Diensttags zulassen. Weitere Informationen finden Sie unter Power BI-Diensttags und Diensttags.
Sie können den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des TDS-Endpunkts nicht allein verwenden.
Wichtig
Wenn Ihre Organisation Azure Firewall-Anwendungsregeln oder ähnliche protokollbewusste Firewalls verwendet, konfigurieren Sie Warehouse-Verkehr als MSSQL/TDS-Verkehr. Die Konfiguration von SQL-Verkehr als HTTPS-Verkehr am Port 1433 kann eine erfolgreiche Verbindung verhindern, selbst wenn der Netzwerkzugang zum Port erlaubt ist.
Überlegungen zur Firewall- und Anwendungsschicht-Inspektion
Einige Enterprise-Firewall-Lösungen führen zusätzlich zur traditionellen IP- und Port-Filterung eine Anwendungsschicht-Inspektion durch.
Wenn Sie Firewall-Richtlinien für Warehouse konfigurieren:
- Erlauben Sie ausgehende TCP-Verbindung auf Port 1433.
- Stellen Sie sicher, dass SQL-Verkehr als Microsoft SQL Server (MSSQL/TDS)-Verkehr behandelt wird.
- Konfiguriere keine SQL-Verbindungen zum Warehouse als HTTPS-Verkehr auf Port 1433.
- Überprüfen Sie die Konnektivität, nachdem Änderungen an den Firewall-Richtlinien implementiert wurden.
Note
Kunden, die Azure Firewall-Anwendungsregeln verwenden, sollten SQL-bewusste Filterung für SQL-Verkehr konfigurieren. Azure Firewall unterstützt die Behandlung von MSSQL-Protokollen und SQL-FQDN-Filterung für SQL-Workloads.
FQDN-basierte Firewall-Filterung
Organisationen, die den ausgehenden Zugriff mit vollständig qualifizierten Domainnamen (FQDNs) einschränken, können Firewall-Regeln verwenden, die nur genehmigte SQL-Ziele zulassen.
Für Umgebungen, die die Azure Firewall verwenden:
- SQL-bewusste FQDN-Filterung wird durch MSSQL-Anwendungsregeln unterstützt.
- FQDN-Filterung kann zusammen mit Port-1433-Einschränkungen verwendet werden, um die ausgehende SQL-Konnektivität zu begrenzen.
- Stellen Sie sicher, dass alle in diesem Artikel dokumentierten Warehouse-Endpunkte in der Firewall-Erlaubnisliste enthalten sind.
Für Implementierungsdetails siehe Configure Azure Firewall Application rules with SQL FQDNs.
Inaktivität einer Verbindung
Eine Verbindung zwischen einem Client und einem Warehouse ist inaktiv , wenn sie geöffnet ist, keine Anfrage läuft oder Ergebnisse zurückgibt, und der Client reicht keine neue Anfrage ein. Eine inaktive Verbindung ist weder getrennt noch ungesund. Es ist lediglich geöffnet und wird nicht verwendet.
Warehouse und SQL Analytics Endpoint schließen automatisch Verbindungen, die 15 Minuten lang untätig bleiben. Der Leerlauftimer startet, nachdem das Warehouse eine Antwort an den Kunden gesendet hat. Sie wird jedes Mal angehalten, wenn der Client eine neue Anfrage einreicht, wie etwa einen Abfragebatch, einen Remote-Prozeduraufruf (RPC), eine Transaktionsanfrage oder einen Massenladevorgang.
Zum Beispiel zeigt die folgende Zeitleiste eine Verbindung mit dem 15-minütigen Idle-Timeout:
- 10:00 Uhr: Ein Kunde verbindet sich mit dem Warehouse.
- 10:05 Uhr: Der Client führt eine Abfrage aus, und die Abfrage wird erfolgreich abgeschlossen.
- 10:05 Uhr bis 10:20 Uhr: Die Verbindung bleibt offen, aber der Client sendet keine weiteren Anfragen oder Anfragen. Dies ist ein Zeitraum der Inaktivität.
- 10:20 Uhr: Die Verbindung ist seit 15 Minuten untätig, also schließt das Warehouse sie.
- 10:25 Uhr: Der Client versucht, eine weitere Abfrage auszuführen. Der Client muss zunächst eine neue Verbindung herstellen.
Idle-Timeout, Verbindungs-Timeout und Abfrage-Timeout
Das Leerlauf-Timeout der Verbindung unterscheidet sich von den anderen Timeouts, die Sie möglicherweise in Ihrem Client oder Ihrer Verbindungszeichenfolge konfigurieren:
| Timeout | Was es begrenzt | Wer steuert sie |
|---|---|---|
| Leerlauf-Timeout der Verbindung | Wie lange eine Verbindung ohne Aktivität offen bleiben kann. | Von Warehouse auf 15 Minuten fixiert. |
| Verbindungstimeout | Wie lange ein Client wartet, während er eine Verbindung herstellt. | Der Client, beispielsweise die Eigenschaft Connect Timeout Verbindungszeichenfolge. |
| Zeitüberschreitung bei der Abfrage | Wie lange eine einzelne Abfrage laufen kann. | Der Client, zum Beispiel die Eigenschaft CommandTimeout in ADO.NET. |
Was Verbindungsleerlauf für Ihre Anwendungen bedeutet
- Langlaufende Abfragen sind nicht betroffen. Der Idle-Timer pausiert, während eine Anfrage läuft, sodass eine Abfrage, die länger als 15 Minuten läuft, durch das Idle-Timeout nicht geschlossen wird. Nur Verbindungen, die zwischen den Anfragen ungenutzt bleiben, werden geschlossen.
- Die Verbindungsresilienz funktioniert weiterhin. Der Idle-Timeout ändert weder die Verbindungsresilienz noch die anderen Optionen, mit denen Sie Verbindungen wiederherstellen. Treiberfunktionen wie die Resilienz von Idle-Verbindungen (zum Beispiel die Verbindungszeichenfolge-Eigenschaften
ConnectRetryCountundConnectRetryIntervalin Microsoft.Data.SqlClient), Verbindungspooling und Anwendungswiederholungslogik funktionieren weiterhin wie zuvor. Weitere Informationen finden Sie unter Bewährte Methoden. - Planen Sie eine beendete Verbindung ein. Wenn Ihre Anwendung eine Verbindung offen hält und sie nach einer langen Pause wiederverwendet, kann die nächste Anfrage fehlschlagen, weil die Verbindung geschlossen wurde. Öffnen Sie Verbindungen, wenn Sie sie benötigen, und schließen Sie sie, wenn Sie fertig sind, oder verwenden Sie die Wiederholungslogik, damit Ihre Anwendung sich automatisch wieder verbindet.
- Transaktionen umgehend abschließen. Wenn eine Verbindung mit einer offenen Transaktion 15 Minuten untätig bleibt, schließt das Warehouse die Verbindung und die nicht committierte Transaktion wird zurückgesetzt. Lass keine Transaktion offen, während deine Anwendung auf Benutzereingaben oder andere Arbeiten wartet.
- Verwalten Sie gleichzeitige Sitzungen. Warehouse- und SQL-Analytics-Endpunkt hat eine Begrenzung von 2048 Benutzersitzungen pro Arbeitsbereich. Das Schließen von inaktiven Verbindungen reduziert ungenutzte Sitzungen, verhindert aber nicht, dass dieses Limit erreicht wird. Inaktive Sitzungen zählen weiterhin, bis sie geschlossen werden, und Verbindungen, die häufiger als alle 15 Minuten genutzt werden, werden nicht durch das Leerlauf-Timeout geschlossen. Ein Verbindungsschub kann ebenfalls das Limit erreichen, bevor leere Verbindungen ablaufen. Verwalten Sie Verbindungslebenszeiten und gleichzeitige Sitzungen, anstatt sich auf Leerlaufbereinigung zu verlassen. Wenn das Limit erreicht ist, schlagen neue Verbindungsversuche mit einem Session-Limit-Fehler fehl. Weitere Informationen finden Sie unter Sitzungen.
Überlegungen und Einschränkungen
- DIE SQL-Authentifizierung wird nicht unterstützt.
- Mehrere aktive Resultsets (MARS) werden für Microsoft Fabric Warehouse nicht unterstützt. MARS ist standardmäßig deaktiviert. Wenn
MultipleActiveResultSetsin der Verbindungszeichenfolge enthalten ist, entfernen Sie es oder setzen Sie es auf "false". - 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 „SHUTDOWN ist im Gange. Ausführungsfehler gegen SQL Server. 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 6008 mit der Meldung „Der Arbeitsbereich ist vorübergehend nicht verfügbar.“ erhalten. Dies kann auf Systemwartung oder einen internen Betrieb zurückzuführen sein. Bitte stellen Sie Ihre Verbindung wieder ein." Dieser Fehler weist auf eine vorübergehende Verbindungsunterbrechung hin. Um dieses Problem zu beheben, stellen Sie ihre Verbindung erneut ein, melden Sie sich erneut an, und wiederholen Sie den Vorgang. Diese Bedingung ist vorübergehend und weist nicht auf einen Fehler in Ihrer Abfrage oder Anwendung hin.
- Verknüpfte Serververbindungen von SQL Server werden nicht unterstützt.
Verbindungsverhalten für InitialCatalog
Im Mai 2026 hat Microsoft das Verbindungsverhalten für Fabric Data Warehouse und den SQL-Analyseendpunkt aktualisiert, um die Eigenschaft InitialCatalog der Verbindungszeichenfolge optional zu machen. Derzeit stellen Benutzer eine Verbindung mit der master Systemdatenbank her, wenn die InitialCatalog Eigenschaft nicht bereitgestellt wird. In Fabric Data Warehouse können Sie nur eine Verbindung mit der Datenbank master herstellen, sie können die Datenbank master nicht ändern und keine Benutzerobjekte in der Datenbank master erstellen, ändern oder ablegen.
Sie können die Syntax USE Transact-SQL verwenden, um den Verbindungslagerkontext zu ändern, sobald sie mit master verbunden ist, und die funktion DB_NAME(), um Ihr aktuelles Lager zu ermitteln. Beispiel:
SELECT DB_NAME(); --returns name of current warehouse context
GO
USE [ContosoWarehouse];
GO
SELECT DB_NAME(); --returns name of current warehouse context
GO
In der folgenden Tabelle wird das aktualisierte Verbindungsverhalten für Fabric Data Warehouse- und SQL-Analyseendpunkt beschrieben, wenn Sie die eigenschaft InitialCatalog in Verbindungszeichenfolgen angeben oder weglassen.
| Eingabeszenario | Vor Mai 2026 | Aktuelles Verhalten |
|---|---|---|
| Vorhandener Lagername angegeben | Verbindet sich mit dem angegebenen Lager | Keine Änderung – verbindet sich mit dem angegebenen Lager |
| Vorhandene Lager-ID angegeben | Verbindet sich mit dem angegebenen Lager | Keine Änderung – verbindet sich mit dem angegebenen Lager |
InitialCatalog Eigenschaft nicht bereitgestellt |
Stellt eine Verbindung mit einem nicht bestimmten Lager im Arbeitsbereich dar. | Verbindet mit master |
InitialCatalog = master |
Stellt eine Verbindung mit einem nicht bestimmten Lager im Arbeitsbereich dar. | Verbindet mit master |
Das im Attribut InitialCatalog angegebene Lager ist nicht vorhanden. |
Stellt eine Verbindung mit einem nicht bestimmten Lager im Arbeitsbereich dar. | Gibt einen Fehler aus, dass kein Lager vorhanden ist. |
Fehlerbehandlung
Wenn im Arbeitsbereich keine Lagerhäuser vorhanden sind und eine Verbindung ohne Angabe eines gültigen Lagerlagers versucht wird, wird den Benutzern der folgende Fehler angezeigt: "Fehler bei der Anmeldung für den Benutzer "<Token-identifizierter Prinzipal>". Grund: Die Authentifizierung war erfolgreich, aber die Datenbank wurde nicht gefunden, oder Sie verfügen über unzureichende Berechtigungen, um eine Verbindung damit herzustellen."
Der folgende Screenshot zeigt den Fehler, wie er in SSMS angezeigt wird, wenn ein ungültiger Lagername als folgendes InitialCatalogangegeben wird: