Azure Functions 2.x 이상의 Azure Cosmos DB 트리거 및 바인딩 개요

이 문서 세트에서는 Azure Functions 2.x 이상에서 Azure Cosmos DB 바인딩을 사용하는 방법을 설명합니다. Azure Functions는 Azure Cosmos DB에 대한 트리거, 입력 및 출력 바인딩을 지원합니다.

작업 형식
Azure Cosmos DB 문서를 만들거나 수정할 때 함수 실행 트리거
Azure Cosmos DB 문서 읽기 입력 바인딩
Azure Cosmos DB 문서에 변경 내용 저장 출력 바인딩

참고

이 참조는 Azure Functions 버전 2.x 이상에 대한 것입니다. Functions 1.x에서 이러한 바인딩을 사용하는 방법에 대한 내용은 Azure Functions 1.x에 대한 Azure Cosmos DB 바인딩을 참조하세요.

이 바인딩의 원래 이름은 DocumentDB입니다. Functions 버전 2.x 이상에서는 트리거, 바인딩 및 패키지의 이름이 모두 Cosmos DB로 지정됩니다.

지원되는 API

Azure Cosmos DB 바인딩은 SQL API에서만 사용할 수 있습니다. 다른 모든 Azure Cosmos DB API의 경우 Azure Cosmos DB의 MongoDB용 API, Cassandra API, Gremlin APITable API를 비롯한 API에 정적 클라이언트를 사용하여 함수에서 데이터베이스에 액세스해야 합니다.

Functions 앱에 추가

Functions 2.x 이상

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

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

Cosmos DB 확장 4.x 이상

새 버전의 Cosmos DB 바인딩 확장은 미리 보기로 제공됩니다. 비밀 대신 ID를 사용하여 연결하는기능을 소개합니다. 관리 ID를 사용한 함수 앱 구성에 대한 자습서는 ID 기반 연결을 사용한 함수 앱 만들기 자습서를 참조하세요. .NET 애플리케이션의 경우 새 확장 버전도 바인딩할 수 있는 형식을 변경하여 v2 SDK의 형식을 Microsoft.Azure.DocumentDB v3 SDK Microsoft.Azure.Cosmos최신 형식으로 바꿉니다. 이러한 새 형식이 어떻게 다른지와 SDK 마이그레이션 가이드, 트리거, 입력 바인딩및 출력 바인딩 예제에서 이러한 형식으로 마이그레이션하는 방법에 대해 자세히 알아봅니다.

이 확장 버전은 [미리 보기 NuGet 패키지로]사용할 수 있습니다. 자세한 내용은 [확장 업데이트를 참조하세요.]

참고

현재 4.x 미리 보기 확장을 사용하는 비밀 대신 ID를 사용한 인증은 탄력적 Premium 계획에서만 사용할 수 있습니다.

Functions 1.x

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

예외 및 반환 코드

바인딩 참고
CosmosDB CosmosDB 오류 코드

host.json 설정

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

{
    "version": "2.0",
    "extensions": {
        "cosmosDB": {
            "connectionMode": "Gateway",
            "protocol": "Https",
            "leaseOptions": {
                "leasePrefix": "prefix1"
            }
        }
    }
}
속성 기본값 Description
GatewayMode 게이트웨이 Azure Cosmos DB 서비스에 연결할 때 해당 함수에 의해 사용되는 연결 모드입니다. 옵션은 DirectGateway입니다.
프로토콜 Https Azure Cosmos DB 서비스에 연결할 때 해당 함수에 의해 사용되는 연결 프로토콜입니다. 두 모드에 대한 설명은 여기를 읽어보세요.

이 설정은 확장의 버전 4.x에서사용할 수 없습니다.
leasePrefix 해당 없음 앱의 모든 함수에서 사용할 접두사를 임대합니다.

이 설정은 확장의 버전 4.x에서사용할 수 없습니다.

다음 단계