Azure Functions의 Azure Blob Storage 바인딩 개요

Azure Functions는 트리거 및 바인딩을 통해 Azure Storage와 통합됩니다. Blob Storage와 통합하면 Blob 데이터의 변경 내용 및 읽기/쓰기 값에 응답하는 함수를 작성할 수 있습니다.

작업 Type
Blob Storage 데이터 변경 시 함수 실행 트리거
함수에서 Blob Storage 데이터 읽기 입력 바인딩
함수가 Blob Storage 데이터를 쓰도록 허용 출력 바인딩

Functions 앱 추가

Functions 2.x 이상

트리거 및 바인딩을 사용하려면 적절한 패키지를 참조해야 합니다. NuGet 패키지는 .NET 클래스 라이브러리에 사용되는 반면, 확장 번들은 다른 모든 애플리케이션 형식에 사용됩니다.

언어 추가 방법... 설명
C# NuGet 패키지 버전 3.x 설치
C# Script, Java, JavaScript, Python, PowerShell 확장 번들 등록 Azure Tools 확장은 Visual Studio Code와 함께 사용하는 것이 좋습니다.
C# 스크립트(Azure Portal에서 온라인으로만) 바인딩 추가 함수 앱을 다시 게시하지 않고 기존 바인딩 확장을 업데이트하려면 확장 업데이트를 참조하세요.

스토리지 확장 5.x 이상

이제 새 버전의 Storage 바인딩 확장을 사용할 수 있습니다. 비밀 대신 ID를 사용하여 연결하는기능을 소개합니다. 관리 ID를 통해 함수 앱을 구성하는 방법에 대한 자습서는 ID 기반 연결을 통해 함수 앱 만들기 자습서를 참조하세요. .NET 애플리케이션의 경우 새 확장 버전도 바인딩할 수 있는 형식을 변경하여 및 의 형식을 WindowsAzure.Storage Microsoft.Azure.Storage Azure.Storage 최신 형식으로 바꿉니다. Blob . Azure.Storage.Blobs 마이그레이션 가이드에서 이러한 새로운 유형의 차이점과 마이그레이션 방법에 대해 자세히 알아봅니다.

이 확장 버전은 NuGet 패키지, 버전 5.x를 설치하여 사용할 수 있으며, 파일에 다음을 추가하여 확장 번들 v3에서 추가할 수 있습니다. host.json

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[3.3.0, 4.0.0)"
  }
}

자세한 내용은 [확장 업데이트를 참조하세요.]

Functions 1.x

Functions 1.x 앱은 Microsoft.Azure.WebJobs NuGet 패키지 버전 2.x에 대한 참조를 자동으로 포함합니다.

Functions 1.x의 Azure Storage SDK 버전

Functions 1.x에서 Storage 트리거 및 바인딩은 버전 7.2.1의 Azure Storage SDK(WindowsAzure.Storage NuGet 패키지)를 사용합니다. 다른 버전의 Storage SDK를 참조하며, 함수 서명에서 Storage SDK 형식에 바인딩하는 경우 Functions 런타임은 해당 형식에 바인딩할 수 없음을 보고할 수 있습니다. 해결 방법은 프로젝트가 WindowsAzure.Storage 7.2.1를 참조하도록 하는 것입니다.

host.json 설정

이 섹션에서는 이 바인딩하는 함수에 사용할 수 있는 함수 앱 구성 설정을 설명합니다. 이러한 설정은 확장 버전 5.0.0 이상 을사용하는 경우에만 적용됩니다. 아래 예제 host.json 파일에는 이 바인딩에 대한 버전 2.x+ 설정만 포함되어 있습니다. 버전 2.x 이상 버전의 함수 앱 구성 설정에 대한 자세한 내용은 Azure Functions 대한 host.json 참조를 참조하세요.

참고

이 섹션은 5.0.0 이전의 확장 버전에는 적용되지 않습니다. 이전 버전의 경우 Blob에 대한 함수 앱 전체 구성 설정이 없습니다.

{
    "version": "2.0",
    "extensions": {
        "blobs": {
            "maxDegreeOfParallelism": "4"
        }
    }
}
속성 기본값 Description
maxDegreeOfParallelism 8*(사용 가능한 코어 수) 각 Blob 트리거 함수에 대해 허용되는 동시 호출 수(정수)입니다. 허용되는 최솟값은 1입니다.

다음 단계