Delen via


Connectiviteit met datawarehousing in Microsoft Fabric

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

In Microsoft Fabric is een Lakehouse SQL-analyse-eindpunt of -warehouse toegankelijk via een Tabellaire gegevensstroom of TDS-eindpunt, die bekend zijn met alle moderne webtoepassingen die communiceren met een SQL Server TDS-eindpunt. Dit wordt de SQL-verbindingsreeks genoemd in de gebruikersinterface van Microsoft Fabric.

In dit artikel wordt uitgelegd hoe u verbinding maakt met uw SQL Analytics-eindpunt of -warehouse.

Om aan de slag te gaan, moet u aan de volgende vereisten voldoen:

Verificatie voor magazijnen in Fabric

In Microsoft Fabric worden twee typen geverifieerde gebruikers ondersteund via de SQL-verbindingsreeks:

  • Microsoft Entra ID (voorheen Azure Active Directory) gebruikers-principals of gebruikersidentiteiten
  • Service-principals voor Microsoft Entra ID (voorheen Azure Active Directory)

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. Gegevens kunnen worden verkregen voor alle objecten waartoe een gebruiker toegang heeft.

Power BI-service tags via firewall toestaan

Om de juiste toegang te garanderen, moet u de Power BI-service tags voor firewalltoegang toestaan. Zie Power BI-servicetags voor meer informatie. U kunt de FQDN (Fully Qualified Domain Name) van het TDS-eindpunt alleen niet gebruiken. Het toestaan van de Power BI-service tags is nodig voor connectiviteit via de firewall.

De SQL-verbindingsreeks ophalen

Voer de volgende stappen uit om de verbindingsreeks op te halen:

  1. Navigeer naar uw werkruimte en selecteer het magazijn.
  2. Selecteer de knop Kopiëren in het vak SQL verbindingsreeks om de verbindingsreeks naar het Klembord te kopiëren.

Of in de OneLake Data Hub:

  1. Selecteer het magazijn en selecteer het ... beletselteken voor Meer opties.
  2. Selecteer SQL-verbindingsreeks kopiëren om de verbindingsreeks naar het klembord te kopiëren.

Aan de slag met SQL Server Management Studio (SSMS)

In de volgende stappen wordt beschreven hoe u begint bij de Microsoft Fabric-werkruimte en hoe u een magazijn verbindt met SQL Server Management Studio (SSMS).

  1. Wanneer u SSMS opent, wordt het venster Verbinding maken met server weergegeven. Als u dit al hebt geopend, kunt u handmatig verbinding maken door Objectverkenner> Database-engine verbinden>te selecteren.

    Schermopname die laat zien waar database-engine moet worden geselecteerd in het menu Verbinding maken.

  2. Nadat het venster Verbinding maken met server is geopend, plakt u de verbindingsreeks gekopieerd uit de vorige sectie van dit artikel in het vak Servernaam. Selecteer Verbinding maken en ga verder met de juiste referenties voor verificatie. Houd er rekening mee dat alleen Microsoft Entra multifactor authentication (MFA) wordt ondersteund via de optie Microsoft Entra MFA.

    Schermopname van het venster Verbinding maken met de server.

  3. Zodra de verbinding tot stand is gebracht, Objectverkenner het verbonden magazijn uit de werkruimte en de bijbehorende tabellen en weergaven weergeeft, die allemaal gereed zijn om te worden opgevraagd.

    Schermopname die laat zien waar de naam van de verbonden server wordt weergegeven in het deelvenster Objectverkenner.

Wanneer u verbinding maakt via SSMS (of ADS), ziet u zowel een SQL-analyse-eindpunt als warehouses. Het is moeilijk om onderscheid te maken tussen de twee itemtypen en de bijbehorende functionaliteit. Daarom raden we u sterk aan om een naamconventie aan te nemen waarmee u eenvoudig onderscheid kunt maken tussen de twee itemtypen wanneer u in hulpprogramma's buiten de Microsoft Fabric-portal werkt. Alleen SSMS 19 of hoger wordt ondersteund.

Verbinding maken met behulp van Power BI

Een eindpunt voor warehouse- of Lakehouse SQL-analyse is een volledig ondersteunde en systeemeigen gegevensbron in Power BI en u hoeft de SQL-verbindingsreeks niet te gebruiken. In het deelvenster Gegevens worden alle magazijnen weergegeven waar u rechtstreeks toegang tot hebt. Hierdoor kunt u eenvoudig uw magazijnen vinden op werkruimte en:

  1. Selecteer het magazijn.
  2. Kies entiteiten.
  3. Gegevens laden: kies een gegevensconnectiviteitsmodus: importeren of DirectQuery.

Zie Rapporten maken in Microsoft Fabric voor meer informatie.

Verbinding maken met OLE DB

We ondersteunen connectiviteit met het warehouse- of SQL-analyse-eindpunt met behulp van OLE DB. Zorg ervoor dat u het nieuwste Microsoft OLE DB-stuurprogramma voor SQL Server uitvoert.

Verbinding maken met behulp van ODBC

Microsoft Fabric biedt ondersteuning voor connectiviteit met het warehouse- of SQL-analyse-eindpunt met behulp van ODBC. Zorg ervoor dat u het nieuwste ODBC-stuurprogramma voor SQL Server uitvoert. Gebruik Microsoft Entra ID-verificatie (voorheen Azure Active Directory). Alleen ODBC 18 of hogere versies worden ondersteund.

Verbinding maken met behulp van JDBC

Microsoft Fabric biedt ook ondersteuning voor connectiviteit met het warehouse- of SQL-analyse-eindpunt met behulp van een JDBC-stuurprogramma (Java Database Connectivity).

Controleer bij het tot stand brengen van connectiviteit via JDBC de volgende afhankelijkheden:

  1. Artefacten toevoegen. Kies Artefact toevoegen en voeg de volgende vier afhankelijkheden toe en selecteer Vervolgens Downloaden/Bijwerken om alle afhankelijkheden te laden. Voorbeeld:

    Schermopname die laat zien waar u Downloaden/bijwerken selecteert.

  2. Selecteer Verbinding testen en Voltooien.

    Schermopname van het tabblad Afhankelijkheidsdeclaratie.

    <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>
    

Verbinding maken met behulp van dbt

De dbt adapter is een framework voor gegevenstransformatie dat gebruikmaakt van best practices voor software-engineering, zoals testen en versiebeheer om code te verminderen, afhankelijkheidsbeheer te automatiseren en betrouwbaardere gegevens te verzenden, allemaal met SQL.

Met de dbt invoegtoepassingen voor gegevensplatformspecifieke adapter kunnen gebruikers verbinding maken met het gewenste gegevensarchief. Als u verbinding wilt maken met Synapse Data Warehouse in Microsoft Fabric, gebruikt u de dbt adapter dbt-fabric . Op dezelfde manier heeft de toegewezen SQL-poolbron van Azure Synapse Analytics een eigen adapter. dbt-synapse

Beide adapters ondersteunen Verificatie van Microsoft Entra ID (voorheen Azure Active Directory) en bieden ontwikkelaars de mogelijkheid om te gebruiken az cli authentication. SQL-verificatie wordt echter niet ondersteund voor dbt-fabric

De DBT Fabric DW-adapter maakt gebruik van de pyodbc bibliotheek om verbinding te maken met het magazijn. De pyodbc bibliotheek is een ODBC-implementatie in Python-taal die gebruikmaakt van Python Database API Specification v2.0. De pyodbc bibliotheek geeft verbindingsreeks rechtstreeks door aan het databasestuurprogramma via SQLDriverConnect in de msodbc verbindingsstructuur met Microsoft Fabric met behulp van een TDS-proxyservice (Tabular Data Streaming).

Zie de dbt-adapterconfiguratie van Microsoft Fabric Synapse Data Warehouse en de dbt-adapterconfiguratie van Microsoft Fabric Synapse Data Warehouse voor meer informatie.

Connectiviteit op andere manieren

Elk niet-Microsoft-hulpprogramma kan ook gebruikmaken van de SQL-verbindingsreeks via ODBC- of OLE DB-stuurprogramma's om verbinding te maken met een Microsoft Fabric Warehouse- of SQL-analyse-eindpunt, met behulp van Microsoft Entra ID-verificatie (voorheen Azure Active Directory). Zie Microsoft Entra-verificatie als alternatief voor SQL-verificatie voor meer informatie en voorbeelden van verbindingsreeks s.

Aangepaste toepassingen

In Microsoft Fabric bieden een warehouse- en een Lakehouse SQL-analyse-eindpunt een SQL-verbindingsreeks. Gegevens zijn toegankelijk vanuit een uitgebreid ecosysteem van SQL-hulpprogramma's, mits ze zich kunnen verifiëren met behulp van Microsoft Entra ID (voorheen Azure Active Directory). Zie Verbindingsbibliotheken voor Microsoft SQL Database voor meer informatie. Zie Microsoft Entra-verificatie als alternatief voor SQL-verificatie voor meer informatie en voorbeelden van verbindingsreeks s.

Aanbevolen procedures

We raden u aan nieuwe pogingen toe te voegen aan uw toepassingen/ETL-taken om tolerantie te bouwen. Zie de volgende documenten voor meer informatie:

Overwegingen en beperkingen

  • SQL-verificatie wordt niet ondersteund.
  • Mars (Multiple Active Result Sets) wordt niet ondersteund voor Microsoft Fabric Warehouse. MARS is standaard uitgeschakeld, maar als MultipleActiveResultSets deze is opgenomen in de verbindingsreeks, moet deze worden verwijderd of ingesteld op onwaar.
  • Als u deze fout krijgt: 'Kan de bewerking niet voltooien omdat we een systeemlimiet hebben bereikt', is dit het gevolg van het bereiken van de limiet van het systeemtoken. Dit probleem kan worden veroorzaakt als de werkruimte te veel warehouses/SQL-analyse-eindpunten heeft, als de gebruiker deel uitmaakt van te veel Microsoft Entra-groepen of een combinatie van de twee. We raden u aan om 40 of minder magazijnen en SQL-analyse-eindpunten per werkruimte te gebruiken om deze fout te voorkomen. Neem contact op met de ondersteuning als het probleem zich blijft voordoen.
  • 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 voor meer informatie over het bouwen van tolerantie en nieuwe pogingen in uw toepassing.
  • Als u de foutcode 18456 ontvangt: 'Uitvoering is mislukt voor SQL Server, neemt u contact op met het SQL Server-team als u verdere ondersteuning nodig hebt.' raadpleegt u Bekend probleem: de datawarehouseverbinding of de uitvoering van query's mislukt.
  • Gekoppelde serververbindingen van SQL Server worden niet ondersteund.