관리 ID를 사용하여 Azure SQL 인덱서 연결 설정

메모

Azure AI 검색 Azure 포털, REST API 및 Azure SDK 통해 사용할 수 있습니다. 또한 엔터프라이즈 콘텐츠를 Microsoft Foundry 포털의 에이전트에 대해 재사용 가능한 사용 권한 인식 기술 자료로 변환하는 관리되는 기술 계층인 Foundry IQ를 뒷받침합니다.

이 문서에서는 연결 문자열 자격 증명을 제공하는 대신 관리 ID를 사용하여 Azure SQL Database 인덱서 연결을 설정하는 방법을 설명합니다.

시스템 할당 관리 ID 또는 사용자 할당 관리 ID를 사용할 수 있습니다. 관리 ID는 Microsoft Entra 로그인이며, Azure SQL 데이터에 액세스하려면 Azure 역할 할당이 필요합니다.

필수 구성 요소

검색 서비스에 대한 관리 ID를 만듭니다.
Azure SQL에 관리자 역할을 할당합니다. 인덱서 연결에 사용되는 ID에는 읽기 권한이 필요합니다. 데이터베이스에 대한 읽기 권한을 부여하려면 SQL Database 또는 SQL Managed Instance 서버가 있는 Microsoft Entra 관리자여야 합니다.
인덱서 개념 및 구성에 대해 잘 알고 있어야 합니다.

1 - 데이터베이스를 읽을 수 있는 권한 할당

아래 단계에 따라 검색 서비스 또는 사용자가 할당한 관리 ID 권한을 할당하여 데이터베이스를 읽습니다.

Visual Studio 연결합니다.
Microsoft Entra 계정으로 인증합니다.

다음 명령을 실행합니다.

검색 서비스 이름 또는 사용자 할당 관리 ID 이름 주위에 대괄호를 포함합니다.

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

나중에 권한을 할당한 후 검색 서비스 ID 또는 사용자 할당 ID를 변경하는 경우 역할 멤버 자격을 제거하고 SQL 데이터베이스에서 사용자를 제거한 다음 사용 권한 할당을 반복해야 합니다. 다음 명령을 실행하여 역할 멤버 자격 및 사용자를 제거할 수 있습니다.

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

2 - 역할 할당 추가

이 섹션에서는 SQL Server 데이터를 읽을 수 있는 Azure AI 검색 서비스 권한을 부여합니다. 자세한 단계는 Azure 포털을 사용하여 Azure 역할 할당 참조하세요.

Azure 포털에서 Azure SQL Server 페이지로 이동합니다.
액세스 제어(IAM)를 선택합니다.
역할 할당 추가를 >선택합니다.
역할 탭에서 적절한 읽기 권한자 역할을 선택합니다.
구성원 탭에서 관리 ID를 선택한 다음 멤버 선택을 선택합니다.
Azure 구독을 선택합니다.
시스템 할당 관리 ID를 사용하는 경우 시스템 할당 관리 ID를 선택하고 검색 서비스를 검색한 다음 선택합니다.
그렇지 않은 경우 사용자 할당 관리 ID를 사용하는 경우 사용자 할당 관리 ID를 선택하고 사용자 할당 관리 ID의 이름을 검색한 다음 선택합니다.
검토 + 할당 탭에서 검토 + 할당을 선택하여 역할을 할당합니다.

3 - 데이터 원본 만들기

데이터 원본을 만들고 시스템 할당 관리 ID 또는 사용자 할당 관리 ID를 제공합니다.

시스템 할당 관리 ID

REST API, Azure 포털 및 Azure SDK 시스템 할당 관리 ID를 지원합니다.

시스템 할당 관리 ID와 연결하는 경우 데이터 원본 정의에 대한 유일한 변경 내용은 "자격 증명" 속성의 형식입니다. 초기 카탈로그 또는 데이터베이스 이름과 계정 키 또는 암호가 없는 ResourceId를 제공합니다. ResourceId에는 Azure SQL Database 구독 ID, SQL Database의 리소스 그룹 및 SQL 데이터베이스의 이름이 포함되어야 합니다.

다음은 데이터 원본 만들기 REST API 및 관리 ID 연결 문자열 사용하여 스토리지 계정의 데이터를 인덱싱하는 데이터 원본을 만드는 방법의 예입니다. 관리 ID 연결 문자열 형식은 REST API, .NET SDK 및 Azure 포털에서 동일합니다.

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

{
    "name" : "sql-datasource",
    "type" : "azuresql",
    "credentials" : { 
        "connectionString" : "Database=[SQL database name];ResourceId=/subscriptions/[subscription ID]/resourceGroups/[resource group name]/providers/Microsoft.Sql/servers/[SQL Server name];Connection Timeout=30;"
    },
    "container" : { 
        "name" : "my-table" 
    }
}

사용자 할당 관리 ID

REST API 버전 2026-04-01 이상은 사용자 할당 관리 ID를 기반으로 연결을 지원합니다. 사용자 할당 관리 ID와 연결하는 경우 데이터 원본 정의에 두 가지 변경 내용이 있습니다.

첫째, "자격 증명" 속성의 형식은 초기 카탈로그 또는 데이터베이스 이름 및 계정 키 또는 암호가 없는 ResourceId입니다. ResourceId에는 Azure SQL Database 구독 ID, SQL Database의 리소스 그룹 및 SQL 데이터베이스의 이름이 포함되어야 합니다. 시스템 할당 관리 ID와 동일한 형식입니다.
둘째, 사용자 할당 관리 ID의 컬렉션을 포함하는 "ID" 속성을 추가합니다. 데이터 원본을 만들 때는 사용자 할당 관리 ID를 하나만 제공해야 합니다. "userAssignedIdentities"를 입력하도록 설정합니다.

다음은 데이터 원본을 사용하여 인덱서 데이터 원본 개체를 만드는 방법의 예 입니다. - 만들기 또는 업데이트:

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

{
    "name" : "sql-datasource",
    "type" : "azuresql",
    "credentials" : { 
        "connectionString" : "Database=[SQL database name];ResourceId=/subscriptions/[subscription ID]/resourceGroups/[resource group name]/providers/Microsoft.Sql/servers/[SQL Server name];Connection Timeout=30;"
    },
    "container" : { 
        "name" : "my-table" 
    },
    "identity" : { 
        "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
        "userAssignedIdentity" : "/subscriptions/[subscription ID]/resourcegroups/[resource group name]/providers/Microsoft.ManagedIdentity/userAssignedIdentities/[managed identity name]"
    }
}

4 - 인덱스 만들기

인덱스는 검색 환경을 형성하는 문서, 특성 및 기타 구문의 필드를 지정합니다.

검색 가능한 필드를 사용하여 booktitle REST API 호출은 다음과 같습니다.

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

5 - 인덱서 만들기

인덱서는 데이터 원본을 대상 검색 인덱스에 연결하고 데이터 새로 고침을 자동화하는 일정을 제공합니다. 인덱스 및 데이터 원본이 만들어지면 인덱서 만들 준비가 된 것입니다. 인덱서가 성공하면 연결 구문 및 역할 할당이 유효합니다.

다음은 Azure SQL 인덱서 정의를 사용하여 인덱서 만들기 REST API 호출입니다. 요청을 제출할 때 인덱서가 실행됩니다.

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

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

인덱서가 클라이언트가 서버에 액세스할 수 없다는 데이터 원본에 연결하려고 할 때 오류가 발생하는 경우 일반적인 인덱서 오류를 살펴보세요.

참고 사항

Azure SQL 인덱서

피드백

이 페이지가 도움이 되었나요?

Last updated on 2026-05-12