Azure Functions에 대한 Azure Data Explorer 바인딩 개요(미리 보기)
이 문서 세트에서는 Azure Functions에서 Azure Data Explorer 바인딩을 사용하는 방법을 설명합니다. Azure Functions는 Azure Data Explorer 클러스터에 대한 입력 바인딩 및 출력 바인딩을 지원합니다.
| 작업 | Type |
|---|---|
| 데이터베이스에서 데이터 읽기 | 입력 바인딩 |
| 데이터베이스에 데이터 수집 | 출력 바인딩 |
확장 설치
설치하는 확장 NuGet 패키지는 함수 앱에서 사용 중인 C# 모드에 따라 다릅니다.
Functions는 격리된 C# 작업자 프로세스에서 실행됩니다. 자세한 내용은 격리된 작업자 프로세스에서 C# Azure Functions 실행 가이드를 참조하세요.
이 NuGet 패키지를 설치하여 프로젝트에 확장을 추가합니다.
dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Kusto --prerelease
번들 설치
Azure Data Explorer 바인딩 확장은 host.json 프로젝트 파일에 지정된 미리 보기 확장 번들의 일부입니다.
host.json 파일에서 다음 코드를 추가하거나 교체하여 미리 보기 확장 번들을 추가할 수 있습니다.
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
"version": "[4.*, 5.0.0)"
}
}
함수 런타임
참고 항목
Azure Data Explorer 바인딩 확장에 대한 Python 언어 지원은 Functions 런타임 v4.6.0 이상부터 사용할 수 있습니다. 로컬 개발을 위해 Azure Functions Core Tools 설치를 업데이트해야 할 수도 있습니다.
번들 설치
Azure Data Explorer 바인딩 확장은 host.json 프로젝트 파일에 지정된 미리 보기 확장 번들의 일부입니다.
host.json 파일에서 다음 코드를 추가하거나 교체하여 미리 보기 확장 번들을 추가할 수 있습니다.
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
"version": "[4.*, 5.0.0)"
}
}
번들 설치
Azure Data Explorer 바인딩 확장은 host.json 프로젝트 파일에 지정된 미리 보기 확장 번들의 일부입니다.
host.json 파일에서 다음 코드를 추가하거나 교체하여 미리 보기 확장 번들을 추가할 수 있습니다.
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
"version": "[4.*, 5.0.0)"
}
}
패키지 업데이트
다음과 같이 Python Azure Functions 프로젝트의 pom.xml 파일을 업데이트하여 Azure Data Explorer 바인딩을 위한 Java 라이브러리를 Functions 프로젝트에 추가합니다.
<dependency>
<groupId>com.microsoft.azure.functions</groupId>
<artifactId>azure-functions-java-library-kusto</artifactId>
<version>1.0.4-Preview</version>
</dependency>
Kusto 연결 문자열
Azure Functions에 대한 Azure Data Explorer 바인딩에는 모든 바인딩의 연결 문자열에 대한 필수 속성이 있습니다. 연결 문자열은 Kusto 연결 문자열에 문서화되어 있습니다.
고려 사항
- Azure Data Explorer 바인딩은 Functions 런타임 버전 4.x 이상을 지원합니다.
- Azure Data Explorer 바인딩의 소스 코드는 이 GitHub 리포지토리에 있습니다.
- 이 바인딩을 사용하려면 Azure Data Explorer에 연결해야 합니다. 입력 바인딩의 경우 사용자에게 뷰어 권한이 필요합니다. 출력 바인딩의 경우 사용자에게 수집기 권한이 필요합니다. 권한에 대한 자세한 내용은 역할 기반 액세스 제어를 참조하세요.