입력 바인딩을 사용하여 데이터 읽기
데이터 원본에 연결하려면 ‘입력 바인딩’을 구성해야 합니다. 입력 바인딩을 통해 최소한의 코드를 작성하여 메시지를 만들 수 있습니다. 스토리지 연결 열기와 같은 작업에 대한 코드를 작성할 필요가 없습니다. Azure Functions 런타임 및 바인딩은 이러한 작업을 알아서 처리합니다.
입력 바인딩 형식
Azure 체인 함수에는 여러 가지 형식의 입력이 있을 수 있습니다. 그러나 모든 유형이 입력과 출력 둘 다를 지원하는 것은 아닙니다. 해당 형식의 데이터를 수집하려 할 때마다 입력 함수를 사용합니다. 여기서는 입력 바인딩을 지원하는 입력 함수 형식과 이를 사용하는 경우를 살펴봅니다.
Azure Blob Storage - Blob Storage 바인딩을 사용하면 Blob에서 읽을 수 있습니다.
Azure Cosmos DB - Azure Cosmos DB 입력 바인딩은 SQL API를 사용하여 하나 이상의 Azure Cosmos DB 문서를 검색하고, 함수의 입력 매개 변수에 전달합니다. 문서 ID 또는 쿼리 매개 변수는 함수를 호출하는 트리거를 기반으로 결정할 수 있습니다.
Mobile Apps - Mobile Apps 입력 바인딩은 모바일 테이블 엔드포인트에서 레코드를 로드하여 함수에 전달합니다.
Azure Table Storage - Azure Table Storage에서 데이터를 읽고 작업할 수 있습니다.
지원되는 바인딩의 전체 목록은 여기에서 확인할 수 있습니다.
바인딩을 입력으로 만들려면 direction을 in으로 정의해야 합니다. 바인딩 형식별로 매개 변수가 다를 수 있습니다.
바인딩 식이란?
바인딩 식은 function.json의 특수화된 텍스트, 함수 매개 변수 또는 코드로, 함수가 값을 내기 위해 호출될 때 평가됩니다. 예를 들어 Service Bus 큐 바인딩이 있는 경우 바인딩 식을 사용하여 앱 설정에서 큐의 이름을 가져올 수 있습니다.
바인딩 식의 형식
바인딩 식은 다음을 포함하여 여러 형식이 있습니다.
- 앱 설정
- 트리거 파일 이름
- 트리거 메타데이터
- JSON 페이로드
- 새 GUID
- 현재 날짜 및 시간
대부분의 바인딩 식은 중괄호로 둘러싸서 식별합니다. 그러나 앱 설정 바인딩 식은 중괄호 대신 백분율 기호로 둘러쌉니다. 예를 들어, Blob 출력 바인딩 경로가 %Environment%/newblob.txt이고 Environment 앱 설정 값이 Development인 경우 Blob은 Development 컨테이너에 생성됩니다.
요약
입력 바인딩을 사용하면 함수를 데이터 원본에 연결할 수 있습니다. 여러 유형의 데이터 원본에 연결할 수 있으며 각각에 대한 매개 변수는 다릅니다. 입력 원본의 값을 확인하려면 function.json 파일, 함수 매개 변수 또는 코드에서 바인딩 식을 사용합니다.