관리 ID를 사용하여 연속 내보내기 작업 실행

적용 대상: Azure Data Explorer

연속 내보내기 작업 주기적으로 실행되는 쿼리를 사용하여 외부 테이블 데이터를 내보냅니다.

연속 내보내기 작업은 다음 시나리오에서 관리 ID 구성해야 합니다.

• 외부 테이블이 가장 인증을 사용하는 경우
• 쿼리가 다른 데이터베이스의 테이블을 참조하는 경우
• 쿼리가 사용하도록 설정된 행 수준 보안 정책이 있는 테이블을 참조하는 경우

관리 ID로 구성된 연속 내보내기 작업은 관리 ID를 대신하여 수행됩니다.

이 문서에서는 시스템 할당 또는 사용자 할당 관리 ID를 구성하고 해당 ID를 사용하여 연속 내보내기 작업을 만드는 방법을 알아봅니다.

필수 구성 요소

• 클러스터 및 데이터베이스입니다. 클러스터 및 데이터베이스만듭니다.
• 데이터베이스에 대한 모든 데이터베이스 관리자 권한을 .

관리 ID 구성

관리 ID에는 두 가지 유형이 있습니다.

• 시스템 할당: 시스템 할당 ID가 클러스터에 연결되고 클러스터가 제거되면 제거됩니다. 클러스터당 하나의 시스템 할당 ID만 허용됩니다.

• 사용자 할당: 사용자가 할당한 관리 ID는 독립 실행형 Azure 리소스입니다. 여러 사용자 할당 ID를 클러스터에 할당할 수 있습니다.

다음 탭 중 하나를 선택하여 기본 관리 ID 유형을 설정합니다.

사용자 할당

1. 단계에 따라 사용자 할당 ID추가합니다.

2. Azure Portal의 관리 ID 리소스 왼쪽 메뉴에서 속성선택합니다. 다음 단계에서 사용할 테넌트 ID 및 보안 주체 ID 복사하고 저장합니다.

   

3. 다음 .alter-merge 정책 managed_identity 명령을 실행하여 <objectId> 이전 단계의 관리 ID 개체 ID로 바꿉니다. 이 명령은 관리 ID를 연속 내보내기에서 사용할 수 있도록 클러스터에서 관리 ID 정책 설정합니다.

   .alter-merge cluster policy managed_identity ```[
       {
         "ObjectId": "<objectId>",
         "AllowedUsages": "AutomatedFlows"
       }
   ]```
   

   메모

   특정 데이터베이스에서 정책을 설정하려면 cluster대신 database <DatabaseName> 사용합니다.

4. 다음 명령을 실행하여 외부 테이블이 포함된 데이터베이스와 같이 연속 내보내기에 사용되는 모든 데이터베이스에 대해 관리 ID 데이터베이스 뷰어 권한을 부여합니다.

   .add database <DatabaseName> viewers ('aadapp=<objectId>;<tenantId>')
   

   <DatabaseName> 관련 데이터베이스로 바꾸고, 2단계의 관리 ID 보안 주체 ID<objectId>, 2단계의 Microsoft Entra ID 테넌트 ID<tenantId>.

시스템 할당

1. 단계에 따라 시스템 할당 ID추가 .

2. 이후 단계에서 사용할 개체(보안 주체) ID 복사하고 저장합니다.

3. 다음 .alter-merge 정책 managed_identity 명령을 실행합니다. 이 명령은 관리 ID를 연속 내보내기에서 사용할 수 있도록 클러스터에서 관리 ID 정책 설정합니다.

   .alter-merge cluster policy managed_identity ```[
       {
         "ObjectId": "system",
         "AllowedUsages": "AutomatedFlows"
       }
   ]```
   

   메모

   특정 데이터베이스에서 정책을 설정하려면 cluster대신 database <DatabaseName> 사용합니다.

4. 다음 명령을 실행하여 외부 테이블이 포함된 데이터베이스와 같이 연속 내보내기에 사용되는 모든 데이터베이스에 대해 관리 ID 데이터베이스 뷰어 권한을 부여합니다.

   .add database <DatabaseName> viewers ('aadapp=<objectId>')
   

   관련 데이터베이스로 바꾸고 2단계에서 관리 ID 개체(보안 주체) ID로 바꿉니다.

외부 테이블 설정

외부 테이블은 Azure Blob Storage, Azure Data Lake Storage Gen1, Azure Data Lake Storage Gen2 또는 SQL Server와 같은 Azure Storage에 있는 데이터를 참조합니다.

다음 탭 중 하나를 선택하여 Azure Storage 또는 SQL Server 외부 테이블을 설정합니다.

1. 스토리지 연결 문자열 템플릿을 기반으로 연결 문자열을 만듭니다. 이 문자열은 액세스할 리소스와 해당 인증 정보를 나타냅니다. 연속 내보내기 흐름의 경우 가장 인증것이 좋습니다.

2. .create 또는 .alter 외부 테이블 명령을 실행하여 테이블을 만듭니다. 이전 단계의 연결 문자열을 storageConnectionString 인수로 사용합니다.

   예를 들어 다음 명령은 Azure Blob Storage의 mystorageaccountmycontainer CSV 형식 데이터를 참조하는 MyExternalTable 만듭니다. 테이블에는 정수 x 열과 문자열 s열이 하나씩 있습니다. 연결 문자열은 가장 인증을 사용하여 데이터 저장소에 액세스하도록 나타내는 ;impersonate끝납니다.

   .create external table MyExternalTable (x:int, s:string) kind=storage dataformat=csv 
   ( 
       h@'https://mystorageaccount.blob.core.windows.net/mycontainer;impersonate' 
   )
   

3. 관련 외부 데이터 저장소에 대한 관리 ID 쓰기 권한을 부여합니다. 연속 내보내기 작업이 관리 ID를 대신하여 데이터 저장소로 데이터를 내보내기 때문에 관리 ID에 쓰기 권한이 필요합니다.

   외부 데이터 저장소	필요한 권한	사용 권한 부여
   Azure Blob Storage	Storage Blob 데이터 기여자	Azure 역할 할당
   Data Lake Storage Gen2	Storage Blob 데이터 기여자	Azure 역할 할당
   Data Lake Storage Gen1	공헌자	Azure 역할 할당

1. SQL Server 연결 문자열을 만듭니다. 이 문자열은 액세스할 리소스와 해당 인증 정보를 나타냅니다. 연속 내보내기 흐름의 경우 가장 인증인 Microsoft Entra 통합 인증것이 좋습니다.

2. .create 또는 .alter 외부 테이블 명령을 실행하여 테이블을 만듭니다. 이전 단계의 연결 문자열을 sqlServerConnectionString 인수로 사용합니다.

   예를 들어 다음 명령은 SQL Server의 MyDatabaseMySqlTable 테이블을 참조하는 MySqlExternalTable 만듭니다. 테이블에는 정수 x 열과 문자열 s열이 하나씩 있습니다. 연결 문자열에는 가장 인증을 사용하여 테이블에 액세스하도록 나타내는 ;Authentication=Active Directory Integrated포함되어 있습니다.

   .create external table MySqlExternalTable (x:int, s:string) kind=sql table=MySqlTable
   ( 
      h@'Server=tcp:myserver.database.windows.net,1433;Authentication=Active Directory Integrated;Initial Catalog=MyDatabase;'
   )
   

3. SQL Server 데이터베이스에 대한 관리 ID CREATE, UPDATE 및 INSERT 권한을 부여합니다. 연속 내보내기 작업이 관리 ID를 대신하여 데이터베이스로 데이터를 내보내기 때문에 관리 ID에 쓰기 권한이 필요합니다. 자세한 내용은 사용 권한참조하세요.

연속 내보내기 작업 만들기

다음 탭 중 하나를 선택하여 사용자 할당 또는 시스템 할당 관리 ID를 대신하여 실행되는 연속 내보내기 작업을 만듭니다.

사용자 할당

managedIdentity 속성이 관리 ID 개체 ID로 설정된 .create-or-alter 연속 내보내기 명령을 실행합니다.

예를 들어 다음 명령은 사용자가 할당한 관리 ID를 대신하여 MyTable 데이터를 MyExternalTable 내보내는 MyExport 연속 내보내기 작업을 만듭니다. <objectId> 관리 ID 개체 ID여야 합니다.

.create-or-alter continuous-export MyExport over (MyTable) to table MyExternalTable with (managedIdentity=<objectId>, intervalBetweenRuns=5m) <| MyTable

시스템 할당

managedIdentity 속성을 system설정하여 .create-or-alter 연속 내보내기 명령을 실행합니다.

예를 들어 다음 명령은 시스템 할당 관리 ID를 대신하여 MyTable 데이터를 MyExternalTable 내보내는 MyExport 연속 내보내기 작업을 만듭니다.

.create-or-alter continuous-export MyExport over (MyTable) to table MyExternalTable with (managedIdentity="system", intervalBetweenRuns=5m) <| MyTable

관련 콘텐츠

• 연속 내보내기 개요
• 연속 내보내기 표시
• 관리 ID