다음을 통해 공유


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에 연결해야 합니다. 입력 바인딩의 경우 사용자에게 뷰어 권한이 필요합니다. 출력 바인딩의 경우 사용자에게 수집기 권한이 필요합니다. 권한에 대한 자세한 내용은 역할 기반 액세스 제어를 참조하세요.

다음 단계