Tilkobling til datalagring i Microsoft Fabric
Gjelder for:✅ SQL Analytics-endepunkt og Warehouse i Microsoft Fabric
I Microsoft Fabric er et endepunkt for SQL-analyse i Lakehouse eller Warehouse tilgjengelig via en tabelldatastrøm, eller TDS-endepunkt, kjent for alle moderne nettprogrammer som samhandler med et SQL Server TDS-endepunkt. Dette kalles SQL-tilkoblingsstrengen i Microsoft Fabric-brukergrensesnittet.
Denne artikkelen inneholder en veiledning om hvordan du kobler til SQL Analytics-endepunktet eller Lager.
Du må fullføre følgende forutsetninger for å komme i gang:
- Du trenger tilgang til et SQL Analytics-endepunkt eller et lager i et Premium-kapasitetsområde med bidragsytere eller høyere tillatelser.
Godkjenning til lagre i Fabric
I Microsoft Fabric støttes to typer godkjente brukere gjennom SQL tilkoblingsstreng:
- Microsoft Entra ID (tidligere Azure Active Directory)-brukerkontohavere eller brukeridentiteter
- Tjenestekontohavere for Microsoft Entra-ID (tidligere Azure Active Directory)
Hvis du vil ha mer informasjon, kan du se Microsoft Entra-godkjenning som et alternativ til SQL-godkjenning i Microsoft Fabric.
SQL-tilkoblingsstreng krever TCP-port 1433 for å være åpen. TCP 1433 er standard portnummer for SQL Server. SQL-tilkoblingsstreng respekterer også sikkerhetsmodellen warehouse eller Lakehouse SQL analytics endpoint for datatilgang. Data kan hentes for alle objekter som en bruker har tilgang til.
Tillat Power Bi-tjeneste merker gjennom brannmuren
Hvis du vil sikre riktig tilgang, må du tillate Power Bi-tjeneste koder for brannmurtilgang. Hvis du vil ha mer informasjon, kan du se Power BI-tjenestekoder. Du kan ikke bruke det fullstendige domenenavnet (FQDN) bare for TDS-endepunktet. Det er nødvendig å tillate Power Bi-tjeneste-koder for tilkobling gjennom brannmuren.
Hent SQL-tilkoblingsstreng
Følg disse trinnene for å hente tilkoblingsstreng:
- Gå til arbeidsområdet, og velg Lager.
- Velg Kopier-knappen i BOKSEN SQL tilkoblingsstreng for å kopiere tilkoblingsstreng til utklippstavlen.
Eller i OneLake Data Hub:
- Velg Lager, og velg ellipsen
...
for Flere alternativer. - Velg Kopier SQL-tilkoblingsstreng for å kopiere tilkoblingsstreng til utklippstavlen.
Kom i gang med SQL Server Management Studio (SSMS)
Følgende trinn beskriver hvordan du starter på Microsoft Fabric-arbeidsområdet og kobler et lager til SQL Server Management Studio (SSMS).
Når du åpner SSMS, vises vinduet Koble til server . Hvis du allerede er åpen, kan du koble til manuelt ved å velge Koble til>databasemotor for Objektutforsker.>
Når vinduet Koble til server er åpent, limer du inn tilkoblingsstreng kopiert fra forrige del av denne artikkelen i boksen Servernavn. Velg Koble til , og fortsett med riktig legitimasjon for godkjenning. Husk at bare Microsoft Entra-godkjenning med flere faktorer (MFA) støttes via alternativet Microsoft Entra MFA.
Når tilkoblingen er opprettet, viser Objektutforsker det tilkoblede lageret fra arbeidsområdet og de respektive tabellene og visningene, som alle er klare til å spørres.
Når du kobler til via SSMS (eller ADS), ser du både et SQL Analytics-endepunkt og Warehouse oppført som lagre, og det er vanskelig å skille mellom de to elementtypene og funksjonaliteten deres. Derfor oppfordrer vi deg på det sterkeste til å vedta en navnekonvensjon som gjør det enkelt å skille mellom de to elementtypene når du arbeider i verktøy utenfor Microsoft Fabric Portal-opplevelsen. Bare SSMS 19 eller nyere støttes.
Koble til ved hjelp av Power BI
Et Lager- eller Lakehouse SQL-analyseendepunkt er en fullstendig støttet og opprinnelig datakilde i Power BI, og det er ikke nødvendig å bruke SQL Connection-strengen. Dataruten viser alle lagrene du har tilgang til direkte. Dette gjør det enkelt å finne lagrene etter arbeidsområde, og:
- Velg lageret.
- Velg enheter.
- Last inn data – velg en datatilkoblingsmodus: import eller DirectQuery.
Hvis du vil ha mer informasjon, kan du se Opprette rapporter i Microsoft Fabric.
Koble til ved hjelp av OLE DB
Vi støtter tilkobling til lager- eller SQL-analyseendepunktet ved hjelp av OLE DB. Kontroller at du kjører den nyeste Microsoft OLE DB-driveren for SQL Server.
Koble til ved hjelp av ODBC
Microsoft Fabric støtter tilkobling til lager- eller SQL-analyseendepunktet ved hjelp av ODBC. Kontroller at du kjører den nyeste ODBC-driveren for SQL Server. Bruk Microsoft Entra ID (tidligere Azure Active Directory)-godkjenning. Bare ODBC 18 eller nyere versjoner støttes.
Koble til ved hjelp av JDBC
Microsoft Fabric støtter også tilkobling til lager- eller SQL-analyseendepunktet ved hjelp av en JDBC-driver (Java Database Connectivity).
Når du etablerer tilkobling via JDBC, kan du se etter følgende avhengigheter:
Legg til artefakter. Velg Legg til artefakt , og legg til følgende fire avhengigheter, og velg deretter Last ned/Oppdater for å laste inn alle avhengigheter. Eksempel:
Velg Test tilkobling og Fullfør.
<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>
Koble til ved hjelp av dbt
Adapteren dbt
er et rammeverk for datatransformasjon som bruker anbefalte fremgangsmåter for programvareteknikk, for eksempel testing og versjonskontroll for å redusere kode, automatisere avhengighetsbehandling og sende mer pålitelige data – alt med SQL.
Plugin-modulene dbt
for dataplattformspesifikke adaptere gjør det mulig for brukere å koble seg til det valgte datalageret. Koble til Synapse Data Warehouse i Microsoft Fabric fra dbt
bruksadapteren dbt-fabric
. På samme måte har azure Synapse Analytics-dedikert sql pool-datakilde sin egen adapter. dbt-synapse
Begge adapterne støtter Godkjenning av Microsoft Entra ID (tidligere Azure Active Directory) og tillater utviklere å bruke az cli authentication
. SQL-godkjenning støttes imidlertid ikke for dbt-fabric
DBT Fabric DW Adapter bruker pyodbc
biblioteket til å etablere tilkobling med lageret. Biblioteket pyodbc
er en ODBC-implementering på Python-språk som bruker Python Database API Specification v2.0. Biblioteket pyodbc
sender direkte tilkoblingsstreng til databasedriveren gjennom SQLDriverConnect i tilkoblingsstrukturen msodbc
til Microsoft Fabric ved hjelp av en proxy-tjeneste for TDS (Tabular Data Streaming).
Hvis du vil ha mer informasjon, kan du se konfigurasjonen av Microsoft Fabric Synapse Data Warehouse-dbt-adapteren og konfigurasjonen av Microsoft Fabric Synapse Data Warehouse-dbt-adapteren.
Tilkobling på andre måter
Alle ikke-Microsoft-verktøy kan også bruke SQL-tilkoblingsstreng via ODBC- eller OLE DB-drivere til å koble til et Microsoft Fabric Warehouse- eller SQL Analytics-endepunkt ved hjelp av Microsoft Entra ID -godkjenning (tidligere Azure Active Directory). Hvis du vil ha mer informasjon og eksempel på tilkoblingsstreng, kan du se Microsoft Entra-godkjenning som et alternativ til SQL-godkjenning.
Egendefinerte programmer
I Microsoft Fabric gir et lager og et Sql Analytics-endepunkt i Lakehouse en SQL-tilkoblingsstreng. Data er tilgjengelig fra et stort økosystem av SQL-verktøy, forutsatt at de kan godkjenne ved hjelp av Microsoft Entra ID (tidligere Azure Active Directory). Hvis du vil ha mer informasjon, kan du se Tilkoblingsbiblioteker for Microsoft SQL Database. Hvis du vil ha mer informasjon og eksempel på tilkoblingsstreng, kan du se Microsoft Entra-godkjenning som et alternativ til SQL-godkjenning.
Beste fremgangsmåter
Vi anbefaler at du legger til nye oppføringer i programmer/ETL-jobber for å bygge robusthet. Hvis du vil ha mer informasjon, kan du se følgende dokumenter:
- Prøv mønster på nytt – Azure Architecture Center
- Arbeide med midlertidige feil – Azure SQL Database
- Trinn 4: Koble robust til SQL med ADO.NET – ADO.NET leverandør for SQL Server
- Trinn 4: Koble til SQL med PHP – PHP-drivere for SQL Server
Hensyn og begrensninger
- SQL-godkjenning støttes ikke.
- Flere aktive resultatsett (MARS) støttes ikke for Microsoft Fabric Warehouse. MARS er deaktivert som standard, men hvis
MultipleActiveResultSets
det er inkludert i tilkoblingsstreng, bør det fjernes eller settes til usann. - Hvis du får denne feilen «Kan ikke fullføre operasjonen fordi vi nådde en systemgrense», er den på grunn av at systemtokenstørrelsen når grensen. Dette problemet kan oppstå hvis arbeidsområdet har for mange endepunkter for lager/SQL-analyse, hvis brukeren er en del av for mange Microsoft Entra-grupper, eller en kombinasjon av de to. Vi anbefaler at du har 40 eller færre lagre og SQL Analytics-endepunkt per arbeidsområde for å forhindre denne feilen. Hvis problemet vedvarer, kontakter du kundestøtte.
- Hvis du får feilkode 24804 med meldingen «Kan ikke fullføre operasjonen på grunn av en systemoppdatering. Avslutt denne tilkoblingen, logg på igjen, og prøv operasjonen på nytt eller feilkode 6005 med meldingen «AVSLUTNING pågår. Kjøring mislykkes mot SQL Server. Kontakt SQL Server-teamet hvis du trenger ytterligere støtte.", det skyldes midlertidig tilkoblingstap, sannsynligvis på grunn av en systemdistribusjon eller rekonfigurering. Hvis du vil løse dette problemet, logger du på på nytt og prøver på nytt. Hvis du vil lære hvordan du bygger robusthet og nye forsøk i programmet, kan du se Anbefalte fremgangsmåter.
- Hvis du får feilkoden 18456: «Kjøring mislyktes mot SQL Server, kan du kontakte SQL Server-teamet hvis du trenger mer støtte.», se Kjente problemer – Datalagertilkobling eller kjøring av spørring mislykkes.
- Koblede servertilkoblinger fra SQL Server støttes ikke.