Udostępnij za pośrednictwem

Łączność z magazynowaniem danych w usłudze Microsoft Fabric

  • Artykuł

Dotyczy:✅ punkt końcowy analizy SQL i magazyn w usłudze Microsoft Fabric

W usłudze Microsoft Fabric punkt końcowy analizy SQL usługi Lakehouse lub magazyn jest dostępny za pośrednictwem strumienia danych tabelarycznych lub punktu końcowego TDS, znanego wszystkim nowoczesnym aplikacjom internetowym korzystającym z punktu końcowego TDS programu SQL Server. Jest to nazywane parametrami połączenia SQL w interfejsie użytkownika usługi Microsoft Fabric.

Ten artykuł zawiera instrukcje dotyczące nawiązywania połączenia z punktem końcowym analizy SQL lub magazynem.

Aby rozpocząć pracę, należy spełnić następujące wymagania wstępne:

  • Potrzebujesz dostępu do punktu końcowego analizy SQL lub magazynu w obszarze roboczym pojemności Premium z uprawnieniami współautora lub wyższymi uprawnieniami.

Uwierzytelnianie w magazynach w sieci szkieletowej

W usłudze Microsoft Fabric dwa typy uwierzytelnionych użytkowników są obsługiwane za pośrednictwem parametry połączenia SQL:

  • Microsoft Entra ID (dawniej Azure Active Directory) podmioty zabezpieczeń użytkowników lub tożsamości użytkowników
  • Jednostki usługi Microsoft Entra ID (dawniej Azure Active Directory)

Aby uzyskać więcej informacji, zobacz Microsoft Entra authentication as an alternative to SQL authentication in Microsoft Fabric (Uwierzytelnianie entra firmy Microsoft jako alternatywa dla uwierzytelniania SQL w usłudze Microsoft Fabric).

Parametry połączenia SQL wymaga otwarcia portu TCP 1433. TCP 1433 to standardowy numer portu programu SQL Server. Usługa SQL parametry połączenia uwzględnia również model zabezpieczeń punktu końcowego analizy SQL usługi Warehouse lub Lakehouse na potrzeby dostępu do danych. Dane można uzyskać dla wszystkich obiektów, do których użytkownik ma dostęp.

Zezwalaj na usługa Power BI tagów za pośrednictwem zapory

Aby zapewnić odpowiedni dostęp, należy zezwolić na dostęp do usługa Power BI tagów zapory. Aby uzyskać więcej informacji, zobacz Tagi usługi Power BI. Nie można użyć w pełni kwalifikowanej nazwy domeny (FQDN) samego punktu końcowego TDS. Zezwolenie na usługa Power BI tagów jest niezbędne do łączności przez zaporę.

Pobieranie parametry połączenia SQL

Aby pobrać parametry połączenia, wykonaj następujące kroki:

  1. Przejdź do obszaru roboczego, wybierz pozycję Magazyn.
  2. Wybierz przycisk Kopiuj w polu parametry połączenia SQL, aby skopiować parametry połączenia do schowka.

Lub, w OneLake:

  1. Wybierz pozycję Magazyn i wybierz wielokropek dla pozycji ... Więcej opcji.
  2. Wybierz pozycję Kopiuj parametry połączenia SQL, aby skopiować parametry połączenia do schowka.

Wprowadzenie do programu SQL Server Management Studio (SSMS)

W poniższych krokach szczegółowo opisano sposób uruchamiania w obszarze roboczym usługi Microsoft Fabric i łączenia magazynu z programem SQL Server Management Studio (SSMS).

  1. Po otwarciu programu SSMS zostanie wyświetlone okno Łączenie z serwerem . Jeśli jest już otwarty, możesz nawiązać połączenie ręcznie, wybierając pozycję Eksplorator obiektów> Łączenie>aparatu bazy danych.

    Zrzut ekranu przedstawiający miejsce wybierania pozycji Aparat bazy danych w menu Połącz.

  2. Po otwarciu okna Połącz z serwerem wklej parametry połączenia skopiowaną z poprzedniej sekcji tego artykułu w polu Nazwa serwera. Wybierz pozycję Połącz i przejdź do odpowiednich poświadczeń na potrzeby uwierzytelniania. Pamiętaj, że obsługiwane jest tylko uwierzytelnianie wieloskładnikowe (MFA) firmy Microsoft za pośrednictwem opcji Microsoft Entra MFA.

    Zrzut ekranu przedstawiający okno Łączenie z serwerem.

  3. Po nawiązaniu połączenia Eksplorator obiektów wyświetla połączony magazyn z obszaru roboczego oraz odpowiednie tabele i widoki, z których wszystkie są gotowe do odpytowania.

    Zrzut ekranu przedstawiający miejsce wyświetlania nazwy połączonego serwera w okienku Eksplorator obiektów.

Podczas nawiązywania połączenia za pośrednictwem programu SSMS (lub ADS) zobaczysz zarówno punkt końcowy analizy SQL, jak i magazyn jako magazyny, i trudno jest odróżnić dwa typy elementów i ich funkcjonalność. Z tego powodu zdecydowanie zachęcamy do przyjęcia konwencji nazewnictwa, która umożliwia łatwe rozróżnienie między dwoma typami elementów podczas pracy w narzędziach spoza środowiska portalu Microsoft Fabric. Obsługiwany jest tylko program SSMS 19 lub nowszy.

Łączenie za pomocą usługi Power BI

Punkt końcowy analizy SQL magazynu lub usługi Lakehouse jest w pełni obsługiwanym i natywnym źródłem danych w usłudze Power BI i nie ma potrzeby używania parametrów połączenia SQL. Okienko Dane uwidacznia wszystkie magazyny, do których masz dostęp bezpośrednio. Dzięki temu można łatwo znaleźć magazyny według obszaru roboczego i:

  1. Wybierz pozycję Magazyn.
  2. Wybierz jednostki.
  3. Ładowanie danych — wybierz tryb łączności danych: import lub DirectQuery.

Aby uzyskać więcej informacji, zobacz Tworzenie raportów w usłudze Microsoft Fabric.

Nawiązywanie połączenia przy użyciu bazy danych OLE DB

Obsługujemy łączność z punktem końcowym magazynu lub analizy SQL przy użyciu ole DB. Upewnij się, że używasz najnowszego sterownika MICROSOFT OLE DB dla programu SQL Server.

Nawiązywanie połączenia przy użyciu odBC

Usługa Microsoft Fabric obsługuje łączność z punktem końcowym magazynu lub analizy SQL przy użyciu odBC. Upewnij się, że używasz najnowszego sterownika ODBC dla programu SQL Server. Użyj uwierzytelniania microsoft Entra ID (dawniej Azure Active Directory). Obsługiwane są tylko wersje ODBC 18 lub nowsze.

Nawiązywanie połączenia przy użyciu JDBC

Usługa Microsoft Fabric obsługuje również łączność z punktem końcowym magazynu lub analizy SQL przy użyciu sterownika łączności bazy danych Java (JDBC).

Podczas nawiązywania łączności za pośrednictwem JDBC sprawdź następujące zależności:

  1. Dodaj artefakty. Wybierz pozycję Dodaj artefakt i dodaj następujące cztery zależności, a następnie wybierz pozycję Pobierz/Aktualizuj , aby załadować wszystkie zależności. Na przykład:

    Zrzut ekranu przedstawiający, gdzie wybrać pozycję Pobierz/Aktualizuj.

  2. Wybierz pozycję Testuj połączenie i Zakończ.

    Zrzut ekranu przedstawiający kartę Deklaracja zależności. 

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

Nawiązywanie połączenia przy użyciu bazy danych dbt

Adapter dbt to struktura przekształcania danych, która używa najlepszych rozwiązań dotyczących inżynierii oprogramowania, takich jak testowanie i kontrola wersji, aby zmniejszyć kod, zautomatyzować zarządzanie zależnościami i dostarczać bardziej niezawodne dane — wszystko to za pomocą języka SQL.

dbt Wtyczki kart specyficznych dla platformy danych umożliwiają użytkownikom łączenie się z wybranym magazynem danych. Aby nawiązać połączenie z magazynem z dbtprogramu , użyj dbt-fabric adaptera . Podobnie dedykowane źródło danych puli SQL usługi Azure Synapse Analytics ma własną kartę dbt-synapse.

Obie karty obsługują uwierzytelnianie identyfikatora Entra firmy Microsoft i umożliwiają deweloperom korzystanie z programu az cli authentication. Jednak uwierzytelnianie SQL nie jest obsługiwane w przypadku dbt-fabric

Adapter DW usługi DBT Fabric używa pyodbc biblioteki do nawiązywania łączności z magazynem. Biblioteka pyodbc jest implementacją ODBC w języku Python, która używa specyfikacji interfejsu API bazy danych języka Python w wersji 2.0. Biblioteka pyodbc przekazuje bezpośrednio parametry połączenia do sterownika bazy danych za pośrednictwem programu SQLDriverConnect w msodbc strukturze połączenia z usługą Microsoft Fabric przy użyciu usługi serwera proxy TDS (przesyłanie strumieniowe danych tabelarycznych).

Aby uzyskać więcej informacji, zobacz Konfiguracja adaptera dbt magazynu danych usługi Microsoft Fabric i Konfiguracja adaptera dbt magazynu danych usługi Microsoft Fabric.

Łączność za pomocą innych środków

Każde narzędzie innej firmy niż Microsoft może również używać parametry połączenia SQL za pośrednictwem sterowników ODBC lub OLE DB w celu nawiązania połączenia z punktem końcowym usługi Microsoft Fabric Warehouse lub punktu końcowego analizy SQL przy użyciu uwierzytelniania microsoft Entra ID (dawniej Azure Active Directory). Aby uzyskać więcej informacji i przykładowych parametry połączenia, zobacz Microsoft Entra authentication as an alternative to SQL authentication (Uwierzytelnianie entra firmy Microsoft jako alternatywa dla uwierzytelniania SQL).

Aplikacje niestandardowe

W usłudze Microsoft Fabric punkt końcowy analizy SQL Warehouse i Lakehouse udostępniają parametry połączenia SQL. Dane są dostępne z rozległego ekosystemu narzędzi SQL, pod warunkiem, że mogą uwierzytelniać się przy użyciu identyfikatora Entra firmy Microsoft (dawniej Azure Active Directory). Aby uzyskać więcej informacji, zobacz Biblioteki połączeń dla usługi Microsoft SQL Database. Aby uzyskać więcej informacji i przykładowych parametry połączenia, zobacz Microsoft Entra authentication as an alternative to SQL authentication (Uwierzytelnianie entra firmy Microsoft jako alternatywa dla uwierzytelniania SQL).

Najlepsze rozwiązania

Zalecamy dodanie ponownych prób w zadaniach aplikacji/ETL w celu utworzenia odporności. Aby uzyskać więcej informacji, zobacz następujące dokumenty:

Rozważania i ograniczenia

  • Uwierzytelnianie SQL nie jest obsługiwane.
  • Wiele aktywnych zestawów wyników (MARS) nie jest obsługiwanych w usłudze Microsoft Fabric Warehouse. Usługa MARS jest domyślnie wyłączona, jednak jeśli MultipleActiveResultSets jest uwzględniona w parametry połączenia, powinna zostać usunięta lub ustawiona na wartość false.
  • Jeśli zostanie wyświetlony ten błąd "Nie można ukończyć operacji, ponieważ osiągnięto limit systemu", jest to spowodowane osiągnięciem limitu rozmiaru tokenu systemowego. Ten problem może być spowodowany tym, że obszar roboczy ma zbyt wiele magazynów/punktów końcowych analizy SQL, jeśli użytkownik jest częścią zbyt wielu grup firmy Microsoft Entra lub kombinacji tych dwóch. Zalecamy posiadanie co najmniej 40 magazynów i punktu końcowego analizy SQL na obszar roboczy, aby zapobiec temu błędowi. Jeśli problem będzie nadal występować, skontaktuj się z działem pomocy technicznej.
  • Jeśli zostanie wyświetlony kod błędu 24804 z komunikatem "Nie można ukończyć operacji z powodu aktualizacji systemu. Zamknij to połączenie, zaloguj się ponownie i ponów próbę wykonania operacji" lub kod błędu 6005 z komunikatem "ZAMKNIJ jest w toku. Wykonywanie kończy się niepowodzeniem względem programu SQL Server. Jeśli potrzebujesz dodatkowej pomocy technicznej, skontaktuj się z zespołem programu SQL Server. Przyczyną jest tymczasowa utrata połączenia, prawdopodobnie ze względu na wdrożenie systemu lub ponowną konfigurację. Aby rozwiązać ten problem, zaloguj się ponownie i spróbuj ponownie. Aby dowiedzieć się, jak tworzyć odporność i ponawianie prób w aplikacji, zobacz Najlepsze rozwiązania.
  • Jeśli zostanie wyświetlony kod błędu 18456: "Wykonanie nie powiodło się na serwerze SQL, skontaktuj się z zespołem programu SQL Server, jeśli potrzebujesz dalszej pomocy technicznej"., zapoznaj się z tematem Znany problem — połączenie magazynu danych lub wykonywanie zapytań nie powiedzie się.
  • Połączenia serwera połączonego z programu SQL Server nie są obsługiwane.

Powiązana zawartość