Azure Functions의 Azure Blob Storage 바인딩 개요

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

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

확장 설치

설치하는 확장 NuGet 패키지는 함수 앱에서 사용 중인 C# 모드에 따라 다릅니다.

Functions는 Functions 호스트와 동일한 프로세스에서 실행됩니다. 자세한 내용은 Azure Functions를 사용하여 C# 클래스 라이브러리 함수 개발을 참조하세요.

확장 기능의 기능은 확장 버전에 따라 다릅니다.

이 버전에는 비밀 대신 ID를 사용하여 연결하는 기능이 도입되었습니다. 관리 ID로 함수 앱을 구성하는 방법에 대한 자습서는 ID 기반 연결로 함수 앱 만들기 자습서를 참조하세요.

이 버전을 사용하면 Azure.Storage.Blobs의 형식에 바인딩할 수 있습니다. 이러한 새로운 형식이 WindowsAzure.StorageMicrosoft.Azure.Storage와 어떻게 다른지 그리고 Azure.Storage.Blobs 마이그레이션 가이드에서 이러한 형식으로 마이그레이션하는 방법에 대해 자세히 알아봅니다.

이 확장은 Microsoft.Azure.WebJobs.Extensions.Storage.Blobs NuGet 패키지, 버전 5.x를 설치하여 사용할 수 있습니다.

.NET CLI 사용:

dotnet add package Microsoft.Azure.WebJobs.Extensions.Storage.Blobs --version 5.0.0

참고

이제 Azure Blob, Azure Queues 및 Azure Tables는 별도의 확장을 사용하며 개별적으로 참조됩니다. 예를 들어 .NET in-process 앱의 세 가지 서비스 모두에 대해 트리거와 바인딩을 사용하려면 프로젝트에 다음 패키지를 추가해야 합니다.

이전에는 확장이 Microsoft.Azure.WebJobs.Extensions.Storage, 버전 4.x로 함께 제공되었습니다. 이 동일한 패키지에는 Blob 및 큐에 대해서만 분할 패키지를 참조하는 5.x 버전도 있습니다. 따라서 이전 버전에서 패키지 참조를 업그레이드할 때 새로운 Microsoft.Azure.WebJobs.Extensions.Tables NuGet 패키지를 추가로 참조해야 할 수 있습니다. 또한 이러한 새로운 분할 패키지를 참조할 때 결합된 스토리지 패키지의 이전 버전을 참조하고 있지 않은지 확인합니다. 이렇게 하면 동일한 바인딩의 두 정의에서 충돌이 발생하기 때문입니다.

번들 설치

Blob Storage 바인딩은 host.json 프로젝트 파일에 지정된 확장 번들의 일부입니다. 바인딩 버전을 변경하거나 번들이 아직 설치되지 않은 경우 이 번들을 수정해야 할 수 있습니다. 자세한 내용은 확장 번들을 참조하세요.

이 버전에는 비밀 대신 ID를 사용하여 연결하는 기능이 도입되었습니다. 관리 ID로 함수 앱을 구성하는 방법에 대한 자습서는 ID 기반 연결로 함수 앱 만들기 자습서를 참조하세요.

host.json 파일에서 다음 코드를 추가하거나 교체하여 확장 번들 v3에서 이 버전의 확장을 추가할 수 있습니다.

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

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

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입니다.

다음 단계