Warehouse-connectiviteit

Van toepassing op:✅ SQL Analytics-eindpunt en -magazijn in Microsoft Fabric

In Microsoft Fabric hebben gebruikers toegang tot een SQL Analytics-eindpunt of Warehouse via een TDS-eindpunt (Tabular Data Stream). Moderne webtoepassingen communiceren met a SQL Server TDS-eindpunt. Binnen Microsoft Fabric-instellingen wordt dit eindpunt gelabeld als de SQL-verbindingsreeks.

Aanbeveling

Zie Verbinding maken met Fabric Data Warehouse voor een zelfstudie over het maken van verbinding met veelgebruikte hulpprogramma's.

Authenticatie bij magazijnen in Fabric

In Microsoft Fabric ondersteunt de SQL-verbindingsreeks twee typen geverifieerde gebruikers:

  • Microsoft Entra ID-gebruikersprincipalen of gebruikersidentiteiten
  • Service-principals voor Microsoft Entra ID

Zie Microsoft Entra-verificatie als alternatief voor SQL-verificatie in Microsoft Fabric voor meer informatie.

Voor de SQL-verbindingsreeks moet TCP-poort 1433 zijn geopend. TCP 1433 is het standaardpoortnummer van SQL Server. De SQL-verbindingsreeks respecteert ook het eindpuntbeveiligingsmodel Warehouse of Lakehouse SQL Analytics voor gegevenstoegang. Gebruikers hebben toegang tot gegevens voor alle objecten waarvoor ze zijn gemachtigd.

Voor meer informatie over beveiliging in het SQL Analytics-eindpunt, zie OneLake-beveiliging voor SQL Analytics-eindpunten.

Beste praktijken

Voeg hertries toe aan uw toepassingen en ETL-taken om ze robuuster te maken. Voor meer informatie raadpleegt u de volgende documentatie:

Azure-servicetags via firewall toestaan

Als u connectiviteit via de firewall wilt inschakelen, moet u Power BI-servicetags en SQL-servicetags toestaan. Zie Power BI-servicetags en servicetags voor meer informatie.

U kunt de FQDN (Fully Qualified Domain Name) van het TDS-eindpunt niet alleen gebruiken.

Overwegingen en beperkingen

  • SQL-verificatie wordt niet ondersteund.
  • Mars (Multiple Active Result Sets) wordt niet ondersteund voor Microsoft Fabric Warehouse. MARS is standaard uitgeschakeld. Als MultipleActiveResultSets is opgenomen in de verbindingsreeks, verwijder deze of stel deze in op onwaar.
  • Als u foutcode 24804 ontvangt met het bericht 'Kan de bewerking niet voltooien vanwege een systeemupdate. Sluit deze verbinding af, meld u opnieuw aan en voer de bewerking opnieuw uit" of foutcode 6005 met het bericht "AFSLUITEN wordt uitgevoerd. Uitvoering mislukt voor SQL Server. Neem contact op met het SQL Server-team als u verdere ondersteuning nodig hebt.' dit komt door tijdelijk verbindingsverlies, waarschijnlijk vanwege een systeemimplementatie of herconfiguratie. Meld u opnieuw aan en probeer het opnieuw om dit probleem op te lossen. Zie Aanbevolen procedures om te leren hoe u veerkracht en herhalingen in uw toepassing kunt inbouwen.
  • Gekoppelde serververbindingen van SQL Server worden niet ondersteund.

Verbindingsgedrag voor InitialCatalog

In mei 2026 heeft Microsoft het verbindingsgedrag voor Fabric Data Warehouse- en SQL-analyse-eindpunt bijgewerkt om de eigenschap InitialCatalog verbindingsreeks optioneel te maken. Momenteel maken gebruikers verbinding met de master systeemdatabase wanneer de InitialCatalog eigenschap niet is opgegeven. In Fabric Data Warehouse kunt u alleen verbinding maken met de master-database, kunt u de master-database niet wijzigen en kunt u geen gebruikersobjecten maken, wijzigen of verwijderen in de master-database.

U kunt de syntaxis USE Transact-SQL gebruiken om de context van het verbindingswarehouse te wijzigen nadat deze is verbonden met master en de functie DB_NAME() om uw huidige magazijn te bepalen. Voorbeeld:

SELECT DB_NAME(); --returns name of current warehouse context
GO
USE [ContosoWarehouse];
GO
SELECT DB_NAME(); --returns name of current warehouse context
GO

De volgende tabel bevat een overzicht van het bijgewerkte verbindingsgedrag voor Fabric Data Warehouse- en SQL Analytics-eindpunt wanneer u de eigenschap InitialCatalog in verbindingsreeksen opgeeft of weglaat.

Invoerscenario Vóór mei 2026 Huidig gedrag
Bestaande magazijnnaam opgegeven Maakt verbinding met het opgegeven magazijn Geen wijziging - maakt verbinding met het opgegeven magazijn
Bestaande magazijn-id opgegeven Maakt verbinding met het opgegeven magazijn Geen wijziging - maakt verbinding met het opgegeven magazijn
InitialCatalog eigenschap niet opgegeven Maakt verbinding met een niet-determinant magazijn in de werkruimte Maakt verbinding met master
InitialCatalog = master Maakt verbinding met een niet-determinant magazijn in de werkruimte Maakt verbinding met master
Magazijn in de eigenschap InitialCatalog bestaat niet Maakt verbinding met een niet-determinant magazijn in de werkruimte Genereert een fout die aangeeft dat er geen magazijn bestaat

Foutafhandeling

Als er geen magazijnen in de werkruimte aanwezig zijn en er een verbinding wordt geprobeerd zonder een geldig magazijn op te geven, zien gebruikers de volgende fout: 'Aanmelden is mislukt voor gebruiker '<token-identified principal>'. Reden: verificatie is geslaagd, maar de database is niet gevonden of u hebt onvoldoende machtigingen om er verbinding mee te maken.

In de volgende schermopname ziet u de fout zoals deze wordt weergegeven in SSMS wanneer er een ongeldige magazijnnaam wordt opgegeven als:InitialCatalog

Schermopname van het SSMS-foutbericht wanneer er geen geldige initiële catalogus is opgegeven.

Volgende stap