Udostępnij przez


Integracja bazy danych SQL w Microsoft Fabric za pomocą łącznika usługi

Na tej stronie przedstawiono obsługiwane metody uwierzytelniania i klientów oraz pokazano przykładowy kod, którego można użyć do łączenia aplikacji z bazą danych SQL w usłudze Microsoft Fabric przy użyciu łącznika usługi Service Connector. Ta strona zawiera również domyślne nazwy zmiennych środowiskowych i wartości uzyskiwane podczas tworzenia połączenia z usługą.

Obsługiwane usługi obliczeniowe

Łącznik usługi może służyć do łączenia następujących usług obliczeniowych z bazą danych SQL w sieci szkieletowej:

  • Azure App Service
  • Azure Container Apps (aplikacje kontenerowe Azure)
  • Funkcje platformy Azure
  • Azure Kubernetes Service (AKS)

Obsługiwane typy uwierzytelniania i typy klientów

W poniższej tabeli pokazano, które kombinacje metod uwierzytelniania i klientów są obsługiwane do łączenia usługi obliczeniowej z bazą danych SQL w sieci szkieletowej przy użyciu łącznika usługi Service Connector. Wartość "Tak" wskazuje, że kombinacja jest obsługiwana, a wartość "Nie" wskazuje, że nie jest obsługiwana.

Typ klienta Zarządzana tożsamość przypisana przez system Tożsamość zarządzana przypisana użytkownikowi Tajny klucz/ciąg połączenia Jednostka usługi
.SIEĆ Tak Tak Nie. Nie.
Idź Tak Tak Nie. Nie.
Jawa Tak Tak Nie. Nie.
Java — Spring Boot Tak Tak Nie. Nie.
Pyton Tak Tak Nie. Nie.
Żaden Tak Tak Nie. Nie.

Ta tabela wskazuje, że zgodnie z zachowaniem sieci szkieletowej dozwolone jest tylko uwierzytelnianie za pośrednictwem tożsamości zarządzanych.

Przypisane przez system metody tożsamości zarządzanej i tożsamości zarządzanej przypisanej przez użytkownika są obsługiwane w przypadku typów klientów .NET, Java, Java — Spring Boot, Python, Go i None. Te metody nie są obsługiwane dla żadnych innych typów.

Ważne

Ręczne udostępnianie dostępu jest obecnie wymagane do pełnego wdrożenia. Zobacz Udostępnianie dostępu do bazy danych SQL w platformie Fabric.

Domyślne nazwy zmiennych środowiskowych lub właściwości aplikacji i przykładowy kod

Zapoznaj się ze szczegółami połączenia i przykładowym kodem przedstawionym na poniższych kartach, aby połączyć usługi obliczeniowe z bazą danych SQL w sieci szkieletowej. Aby uzyskać więcej informacji na temat konwencji nazewnictwa, zapoznaj się z artykułem Dotyczącym wewnętrznych łączników usług .

Uwaga / Notatka

Mimo że baza danych SQL w usłudze Fabric różni się od usługi Azure SQL Database, możesz nawiązać połączenie z bazą danych SQL i wykonywać zapytania względem bazy danych SQL w usłudze Fabric w taki sam sposób, jak usługa Azure SQL Database. Dowiedz się więcej.

Zarządzana tożsamość przypisana przez system

Domyślna nazwa zmiennej środowiskowej Opis Przykładowa wartość
FABRIC_SQL_CONNECTIONSTRING Parametry połączenia usługi Azure SQL Database Data Source=tcp:<Fabric-SQL-Identifier>.msit-database.fabric.microsoft.com,1433;Initial Catalog=<SQL-DB-name>-<Fabric-DB-Identifier>;Authentication=ActiveDirectoryManagedIdentity

Przykładowy kod

Poniżej przedstawiono kroki i fragmenty kodu służące do nawiązywania połączenia z bazą danych SQL w usłudze Fabric przy użyciu tożsamości zarządzanej przypisanej przez system.

  1. Instalowanie zależności.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Pobierz ciąg połączenia do bazy danych SQL w Microsoft Fabric ze zmiennej środowiskowej dodanej przez łącznik usługi Service Connector.

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("FABRIC_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

    Aby uzyskać więcej informacji, zobacz Używanie uwierzytelniania tożsamości zarządzanej usługi Active Directory.

Aby uzyskać więcej informacji, zobacz Nawiązywanie połączenia z bazą danych SQL w usłudze Microsoft Fabric.

Tożsamość zarządzana przypisana przez użytkownika

Domyślna nazwa zmiennej środowiskowej Opis Przykładowa wartość
FABRIC_SQL_CONNECTIONSTRING Parametry połączenia usługi Azure SQL Database Data Source=tcp:<Fabric-SQL-Identifier>.msit-database.fabric.microsoft.com,1433;Initial Catalog=<SQL-DB-name>-<Fabric-DB-Identifier>;User ID=<msiClientId>;Authentication=ActiveDirectoryManagedIdentity

Przykładowy kod

Poniżej przedstawiono kroki i fragmenty kodu służące do nawiązywania połączenia z bazą danych SQL w usłudze Fabric przy użyciu tożsamości zarządzanej przypisanej przez użytkownika.

  1. Instalowanie zależności.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Pobierz ciąg połączenia do bazy danych SQL w Microsoft Fabric ze zmiennej środowiskowej dodanej przez łącznik usługi Service Connector.

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("FABRIC_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

    Aby uzyskać więcej informacji, zobacz Używanie uwierzytelniania tożsamości zarządzanej usługi Active Directory.

Aby uzyskać więcej informacji, zobacz Nawiązywanie połączenia z bazą danych SQL w usłudze Microsoft Fabric.

Udostępnianie dostępu do bazy danych SQL w usłudze Fabric

  1. Ukończ tworzenie połączenia z usługą w Cloud Shell lub na lokalnym Azure CLI.

  2. Po utworzeniu połączenia otwórz zasób Twojej usługi obliczeniowej w portalu Azure, otwórz menu Łącznika usług i znajdź swoją bazę danych SQL w połączeniu usługi Fabric. Wybierz Baza danych SQL, aby przejść do portalu Fabric.

    Zrzut ekranu przedstawiający portal Azure, z wybranym linkiem do bazy danych SQL, aby przejść do portalu Fabric.

  3. W portalu sieci szkieletowej znajdź kartę Zabezpieczenia i wybierz pozycję Zarządzaj zabezpieczeniami SQL.

    Zrzut ekranu przedstawiający Fabric portal z wybraną pozycją

  4. Wybierz rolę db_ddladmin, a następnie pozycję Zarządzaj dostępem.

    Zrzut ekranu przedstawiający portal Fabric, wybieranie roli db_ddladmin, a następnie klikanie pozycji Zarządzaj dostępem.

  5. Powinna być widoczna nazwa tożsamości zarządzanej przypisanej przez system i/lub dowolnych tożsamości zarządzanych przypisanych przez użytkownika z połączeniem usługi z tą bazą danych SQL w Fabric. Wybierz pozycję Udostępnij bazę danych. Jeśli nie widzisz opcji Udostępnij bazę danych , nie musisz kontynuować wykonywania pozostałych kroków.

    Zrzut ekranu przedstawiający portal Fabric, wyświetlający listę grup dodanych do roli, z kliknięciem opcji „Udostępnij bazę danych”.

  6. Wprowadź i wybierz nazwę nowo utworzonej tożsamości zarządzanej przypisanej przez system i/lub dowolne tożsamości zarządzane przypisane przez użytkownika, które są wyświetlane w okienku Zarządzanie dostępem . Dodaj wszelkie inne tożsamości w razie potrzeby. Zaznacz pole wyboru Odczytaj wszystkie dane przy użyciu bazy danych SQL , a następnie wybierz pozycję Udziel.

    Zrzut ekranu przedstawiający portal Fabric, w którym wpisywane są nazwy przypisanych tożsamości zarządzanych, wybranie opcji Odczytaj wszystkie dane przy użyciu bazy danych SQL, a następnie kliknięcie przycisku Udziel.

  7. Teraz możesz użyć nowego łącza do bazy danych SQL w usłudze Fabric.

Następny krok

Zapoznaj się z następującym artykułem, aby dowiedzieć się więcej o Service Connector.