Konfigurowanie połączenia indeksatora z Azure SQL Managed Instance przy użyciu tożsamości zarządzanej

Note

Foundry IQ (Wyszukiwanie AI platformy Azure) udostępnia bezpośrednie interfejsy API indeksowania i zapytań, a także interfejsy API wyższego poziomu dla źródeł wiedzy i baz wiedzy do zarządzanego pobierania. Użyj portalu Azure, interfejsów API REST lub Azure SDKs, aby skonfigurować te możliwości lub połączyć agentów z bazami wiedzy w portalu Microsoft Foundry.

W tym artykule opisano sposób konfigurowania połączenia indeksatora IQ (Wyszukiwanie AI platformy Azure) foundry z SQL Managed Instance przy użyciu tożsamości zarządzanej zamiast podawania poświadczeń w parametry połączenia.

Można użyć tożsamości zarządzanej przypisanej przez system lub tożsamości zarządzanej przypisanej przez użytkownika. Tożsamości zarządzane to loginy Microsoft Entra i wymagają przypisania ról w Azure, aby uzyskać dostęp do danych w SQL Managed Instance.

Zanim dowiesz się więcej o tej funkcji, należy zrozumieć, czym jest indeksator i jak skonfigurować indeksator dla źródła danych. Aby uzyskać więcej informacji, zobacz Indexers in Foundry IQ i Indeksowanie danych z Azure SQL Database.

Wymagania wstępne

Przypisywanie uprawnień do odczytywania bazy danych

Wykonaj następujące kroki, aby przypisać uprawnienie tożsamości zarządzanej przez system usługi Foundry IQ do odczytu bazy danych zarządzanej SQL.

  1. Nawiąż połączenie z SQL Managed Instance za pośrednictwem SQL Server Management Studio (SSMS) przy użyciu jednej z następujących metod:

  2. Uwierzytelnianie przy użyciu konta Microsoft Entra.

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

  3. W okienku po lewej stronie znajdź bazę danych SQL używaną jako źródło danych do indeksowania i kliknij ją prawym przyciskiem myszy. Wybierz pozycję Nowe zapytanie.

    Zrzut ekranu przedstawiający nowe zapytanie SQL.

  4. W oknie języka T-SQL skopiuj następujące polecenia i uwzględnij nawiasy wokół nazwy usługi IQ rozwiązania Foundry. Wybierz pozycję Wykonaj.

    CREATE USER [insert your search service name here or user-assigned managed identity name] FROM EXTERNAL PROVIDER;
    EXEC sp_addrolemember 'db_datareader', [insert your search service name here or user-assigned managed identity name];
    

    Zrzut ekranu przedstawiający sposób wykonywania zapytania SQL.

Jeśli później zmienisz tożsamość systemu usługi Foundry IQ po przypisaniu uprawnień, musisz usunąć członkostwo roli i usunąć użytkownika w bazie danych SQL, a następnie powtórzyć przypisanie uprawnień. Aby usunąć członkostwo w roli i użytkownika, uruchom następujące polecenia:

sp_droprolemember 'db_datareader', [insert your search service name or user-assigned managed identity name];

DROP USER IF EXISTS [insert your search service name or user-assigned managed identity name];

Dodawanie przypisania roli

W tym kroku przyznasz usłudze Foundry IQ uprawnienie do odczytywania danych z SQL Managed Instance.

  1. W portalu Azure przejdź do strony SQL Managed Instance.

  2. Wybierz pozycję Kontrola dostępu (IAM).

  3. Wybierz Dodaj>Dodaj przypisanie roli.

    Zrzut ekranu przedstawiający stronę Access Control.

  4. Wybierz rolę Czytelnik .

  5. Pozostaw Przypisanie dostępu do jako użytkownika, grupy lub obiektu zabezpieczeń Microsoft Entra.

  6. Jeśli używasz tożsamości zarządzanej przypisanej przez system, wyszukaj usługę Foundry IQ i wybierz ją. Jeśli używasz tożsamości zarządzanej przypisanej przez użytkownika, wyszukaj nazwę tożsamości zarządzanej przypisanej przez użytkownika i wybierz ją. Wybierz pozycję Zapisz.

    Oto przykład SQL Managed Instance przy użyciu tożsamości zarządzanej przypisanej przez system:

    Zrzut ekranu przedstawiający przypisanie roli członka.

Tworzenie źródła danych

Utwórz źródło danych i podaj tożsamość zarządzaną przypisaną przez system.

Tożsamość zarządzana przypisana przez system

Interfejs API REST, portal Azure oraz .NET SDK obsługują tożsamość zarządzaną przypisaną przez system.

Podczas nawiązywania połączenia przy użyciu tożsamości zarządzanej przypisanej przez system jedyną zmianą definicji źródła danych jest format właściwości "credentials". Należy podać nazwę początkowego katalogu lub bazy danych oraz ResourceId, które nie ma klucza konta ani hasła. ResourceId musi zawierać identyfikator subskrypcji SQL Managed Instance, grupę zasobów SQL Managed instance i nazwę bazy danych SQL.

Oto przykład, jak utworzyć źródło danych do indeksowania danych z instancji zarządzanej SQL za pomocą interfejsu API REST Tworzenie źródła danych i ciągu połączenia tożsamości zarządzanej. Format ciągu połączenia dla tożsamości zarządzanej jest taki sam dla interfejsu API REST, pakietu SDK .NET i portalu Azure.

POST https://[service name].search.windows.net/datasources?api-version=2026-10-01
Content-Type: application/json
api-key: [admin key]

{
    "name" : "sql-mi-datasource",
    "type" : "azuresql",
    "credentials" : { 
        "connectionString" : "Database=[SQL database name];ResourceId=/subscriptions/[subscription ID]/resourcegroups/[resource group name]/providers/Microsoft.Sql/managedInstances/[SQL Managed Instance name];Connection Timeout=100;"
    },
    "container" : { 
        "name" : "my-table" 
    }
} 

Tworzenie indeksu

Indeks określa pola w dokumencie, atrybutach i innych konstrukcjach, które kształtuje środowisko wyszukiwania.

Oto wywołanie REST API Create Index z przeszukiwalnym polem booktitle:

POST https://[service name].search.windows.net/indexes?api-version=2026-10-01
Content-Type: application/json
api-key: [admin key]

{
    "name" : "my-target-index",
    "fields": [
        { "name": "id", "type": "Edm.String", "key": true, "searchable": false },
        { "name": "booktitle", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false }
    ]
}

Tworzenie indeksatora

Indeksator łączy źródło danych z docelowym indeksem wyszukiwania i udostępnia harmonogram automatyzowania odświeżania danych. Po utworzeniu indeksu i źródła danych utwórz indeksator.

Oto wywołanie Tworzenie indeksatora interfejsu API REST z definicją indeksatora Azure SQL. Indeksator jest uruchamiany podczas przesyłania żądania.

POST https://[service name].search.windows.net/indexers?api-version=2026-10-01
Content-Type: application/json
api-key: [admin key]

{
    "name" : "sql-mi-indexer",
    "dataSourceName" : "sql-mi-datasource",
    "targetIndexName" : "my-target-index"
}

Rozwiązywanie problemów

Jeśli wystąpi błąd, gdy indeksator spróbuje nawiązać połączenie ze źródłem danych z informacją, że klient nie może uzyskać dostępu do serwera, zobacz typowe błędy indeksatora.

Możesz również wykluczyć wszelkie problemy z zaporą, próbując nawiązać połączenie zarówno z włączonymi, jak i wyłączonymi ograniczeniami.

Zobacz też