Indexelőkapcsolat beállítása Azure SQL Managed Instance felügyelt identitás használatával

Ez a cikk ismerteti, hogyan állíthat be egy Azure AI Keresés indexelő kapcsolatot a SQL Managed Instance használatával felügyelt identitás révén, a hitelesítő adatok helyett a kapcsolati karakterláncban.

Használhat rendszer által hozzárendelt felügyelt identitást vagy felhasználó által hozzárendelt felügyelt identitást. A Microsoft Entra bejelentkezések felügyelt identitások, és Azure szerepkör-hozzárendeléseket igényelnek az SQL Managed Instance-ban található adatok eléréséhez.

Mielőtt többet tudhat meg erről a funkcióról, meg kell ismernie, hogy mi az indexelő, és hogyan állíthat be indexelőt az adatforráshoz. További információ: Indexers in Azure AI Keresés és Index data from Azure SQL Database.

Előfeltételek

• Felügyelt identitás létrehozása a keresési szolgáltatáshoz.

• Microsoft Entra rendszergazdai szerepkör az SQL Kezelt Példány esetén:

  Ha olvasási engedélyeket szeretne hozzárendelni egy SQL Managed Instance-hez, akkor egy Azure globális rendszergazdának kell lennie az SQL Managed Instance esetében. Lásd: Konfiguráció és Microsoft Entra hitelesítés kezelése SQL Managed Instance és kövesse a Microsoft Entra rendszergazda (SQL Managed Instance) kiépítésének lépéseit.

• Konfiguráljon nyilvános végpontot és hálózati biztonsági csoportot SQL Managed Instance a Azure AI Keresés-ból való kapcsolatok engedélyezéséhez. A megosztott privát kapcsolaton keresztüli csatlakozás felügyelt identitás használata esetén jelenleg nem támogatott.

Engedélyek hozzárendelése az adatbázis olvasásához

Az alábbi lépéseket követve hozzárendelheti a keresési szolgáltatásrendszer felügyelt identitásengedélyét a felügyelt SQL-adatbázis olvasásához.

1. Csatlakozzon SQL Managed Instance-hoz az alábbi módszerek egyikével az SQL Server Management Studio (SSMS) segítségével.

   • Pont–hely kapcsolat konfigurálása helyszíniről
   • Konfigurálj egy Azure virtuális gépet

2. Hitelesítés a Microsoft Entra-fiókjával.

   

3. A bal oldali panelen keresse meg az indexelés adatforrásaként használt SQL-adatbázist, és kattintson rá a jobb gombbal. Válassza az Új lekérdezés lehetőséget.

   

4. A T-SQL ablakban másolja ki a következő parancsokat, és adja meg a zárójeleket a keresési szolgáltatás neve köré. Válassza a Végrehajtás lehetőséget.

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

   

Ha később az engedélyek hozzárendelése után módosítja a keresési szolgáltatási rendszer identitását, el kell távolítania a szerepkör-tagságot, és el kell távolítania a felhasználót az SQL-adatbázisban, majd meg kell ismételnie az engedély-hozzárendelést. A szerepkör-tagság és a felhasználó eltávolításához futtassa a következő parancsokat:

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

Szerepkör-hozzárendelés hozzáadása

Ebben a lépésben engedélyt ad a Azure AI Keresés szolgáltatásnak arra, hogy adatokat olvasson be a SQL Managed Instance.

1. A Azure portálon nyissa meg a SQL Managed Instance lapot.

2. Válassza a Hozzáférés-vezérlés (IAM) lehetőséget.

3. Válassza a Szerepkör-hozzárendelés hozzáadása> lehetőséget.

   

4. Válassza ki az Olvasó szerepkört.

5. Hagyja A hozzáférés hozzárendelése Microsoft Entra felhasználóhoz, csoporthoz vagy szolgáltatási főszereplőhöz.

6. Ha rendszer által hozzárendelt felügyelt identitást használ, keresse meg a keresési szolgáltatást, és válassza ki. Ha felhasználó által hozzárendelt felügyelt identitást használ, keresse meg a felhasználó által hozzárendelt felügyelt identitás nevét, és válassza ki. Válassza a Mentés lehetőséget.

   Íme egy példa a rendszer által hozzárendelt felügyelt identitást használó SQL Managed Instance:

   

Az adatforrás létrehozása

Hozza létre az adatforrást, és adjon meg egy rendszer által hozzárendelt felügyelt identitást.

Rendszer által hozzárendelt felügyelt identitás

A REST API, Azure portál és a .NET SDK támogatja a rendszer által hozzárendelt felügyelt identitást.

Ha rendszer által hozzárendelt felügyelt identitással csatlakozik, az adatforrás definíciójának egyetlen módosítása a "hitelesítő adatok" tulajdonság formátuma. Meg kell adnia egy kezdeti katalógust vagy adatbázisnevet, valamint egy ResourceId olyan nevet, amely nem rendelkezik fiókkulcsgal vagy jelszóval. A ResourceId tartalmaznia kell a SQL Managed Instance előfizetési azonosítóját, a SQL Managed instance erőforráscsoportját és az SQL-adatbázis nevét.

Íme egy példa arra, hogyan hozhat létre adatforrást egy SQL Managed Instance adatainak indexeléséhez az Adatforrás létrehozása REST API és felügyelt identitás kapcsolati karakterlánc használatával. A felügyelt identitás kapcsolati karakterlánc formátuma megegyezik a REST API, .NET SDK és az Azure portál esetében.

POST https://[service name].search.windows.net/datasources?api-version=2026-04-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" 
    }
} 

Az index létrehozása

Az index meghatározza a dokumentum mezőit, attribútumait és a keresési felületet formázó egyéb szerkezeteket.

Az index létrehozása REST API-hívás egy kereshető booktitle mezővel:

POST https://[service name].search.windows.net/indexes?api-version=2026-04-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 }
    ]
}

Az indexelő létrehozása

Az indexelők egy adatforrást csatlakoztatnak egy célkeresési indexhez, és ütemezést biztosítanak az adatfrissítés automatizálásához. Az index és az adatforrás létrehozása után hozza létre az indexelőt.

Íme egy Create Indexer REST API-hívás Azure SQL indexelő definícióval. Az indexelő a kérés elküldésekor fut.

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

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

Hibaelhárítás

Ha hibaüzenet jelenik meg, amikor az indexelő megpróbál csatlakozni ahhoz az adatforráshoz, amely szerint az ügyfél nem fér hozzá a kiszolgálóhoz, tekintse meg az indexelő gyakori hibáit.

A tűzfallal kapcsolatos problémákat úgy is kizárhatja, ha a kapcsolatot korlátozásokkal és azok nélkül is kipróbálja.

Lásd még:

• SQL Managed Instance és Azure SQL Database indexelő