다음을 통해 공유

저장 프로시저, 트리거 및 사용자 정의 함수

  • 아티클

적용 대상: NoSQL

Azure Cosmos DB는 JavaScript의 언어 통합형, 트랜잭션 실행을 제공합니다. Azure Cosmos DB에서 API for NoSQL을 사용하는 경우 JavaScript 언어로 저장 프로시저, 트리거 및 UDF(사용자 정의 함수)를 작성할 수 있습니다. 데이터베이스 엔진 내에서 실행되는 JavaScript로 논리를 작성할 수 있습니다. Azure Portal, Azure Cosmos DB의 JavaScript Language-Integrated Query 또는 Azure Cosmos DB for NoSQL 클라이언트 SDK를 사용하여 트리거, 저장 프로시저 및 UDF를 만들고 실행할 수 있습니다.

서버 쪽 프로그래밍 사용의 이점

JavaScript에서 저장 프로시저, 트리거 및 UDF(사용자 정의 함수)를 작성하면 서식 있는 애플리케이션을 빌드하고 다음과 같은 이점을 얻을 수 있습니다.

  • 절차적 논리: 비즈니스 논리를 노출하는 풍부하고 익숙한 인터페이스를 제공하는 고급 프로그래밍 언어인 JavaScript입니다. 데이터에 대해 복잡한 작업 시퀀스를 수행할 수 있습니다.

  • 원자성 트랜잭션: 단일 저장 프로시저 또는 트리거 내에서 수행되는 Azure Cosmos DB 데이터베이스 작업입니다. 이 원자성 기능을 사용하면 애플리케이션이 관련 작업을 단일 배치로 결합하여 모든 작업이 성공하거나 모두 실패하도록 할 수 있습니다.

  • 성능: JSON 데이터는 JavaScript 언어 유형 시스템에 본질적으로 매핑되어 있습니다. 이 매핑을 사용하면 버퍼 풀에 있는 JSON 문서의 지연 구체화, 실행 중인 코드에서 요청 시 사용 가능과 같은 다양한 최적화가 허용됩니다. 데이터베이스에 비즈니스 논리를 이동할 경우 다음과 같은 기타 성능상의 이점이 있습니다.

    • ‘일괄 처리’: 개발자가 삽입 등의 작업을 그룹화하여 대량 제출할 수 있습니다. 개별 트랜잭션을 만들기 위한 네트워크 트래픽 지연 비용 및 저장소 오버헤드가 크게 줄어듭니다.

    • 사전 컴파일: 저장 프로시저, 트리거 및 UDF는 각 스크립트 호출 시 컴파일 비용을 피하기 위해 암시적으로 바이트 코드 형식으로 사전 컴파일됩니다. 사전 컴파일로 인해 저장 프로시저 호출이 빨라지고 사용 공간이 줄어듭니다.

    • ‘시퀀싱’: 경우에 따라 데이터에 대해 여러 업데이트를 수행할 수 있는 트리거 메커니즘이 필요한 작업이 있습니다. 서버 쪽에서 실행할 경우 원자성 이외의 성능상 이점도 얻을 수 있습니다.

  • 캡슐화: 저장 프로시저를 사용하여 논리를 단일 장소에 그룹화할 수 있습니다. 캡슐화는 데이터 위에 추상 계층을 추가하므로 데이터와 독립적으로 애플리케이션을 개발할 수 있습니다. 이 추상화 계층은 데이터에 스키마가 없으며 애플리케이션에 직접 논리를 추가할 필요가 없는 경우에 유용합니다. 추상화를 사용하면 스크립트에서 액세스를 간소화하여 데이터를 안전하게 유지할 수 있습니다.

팁

저장 프로시저는 쓰기 작업이 많고 파티션 키 값 간에 트랜잭션이 필요한 작업에 가장 적합합니다. 저장 프로시저 사용 여부를 결정할 때는 가능한 최대량의 쓰기를 캡슐화하는 것에 초점을 맞추어 최적화합니다. 일반적으로 저장 프로시저가 대량의 읽기 또는 쿼리 작업을 수행하는 가장 효율적인 방법은 아니므로 저장 프로시저를 사용하여 대량의 읽기를 클라이언트에 일괄로 반환할 경우 원하는 이점을 얻지 못합니다. 최상의 성능을 위해 Azure Cosmos DB SDK를 사용하여 클라이언트 쪽에서 읽기가 많은 작업을 수행해야 합니다.

참고 항목

저장 프로시저, 트리거, 사용자 정의 함수를 포함한 서버 쪽 JavaScript 기능은 모듈 가져오기를 지원하지 않습니다.

트랜잭션

일반적인 데이터베이스의 트랜잭션은 하나의 논리적 작업 단위로 수행되는 작업 시퀀스로 정의할 수 있습니다. 각 트랜잭션에서는 ACID 속성 보장을 제공합니다. ACID는 원자성, 일관성, 격리, 내구성을 나타내는 잘 알려진 머리글자어입니다.

  • 원자성은 트랜잭션 내부에서 수행된 모든 작업이 하나의 단위로 처리되어 모두 커밋되거나 커밋되지 않도록 합니다.

  • 일관성은 데이터가 트랜잭션 간에 항상 올바른 상태로 유지되도록 합니다.

  • 격리는 두 트랜잭션이 서로를 방해하지 않도록 합니다. 많은 상용 시스템은 애플리케이션 요구에 따라 사용할 수 있는 여러 격리 수준을 제공합니다.

  • 내구성은 데이터베이스에서 커밋된 변경 내용이 항상 유지되도록 합니다.

Azure Cosmos DB에서 JavaScript 런타임의 호스트는 데이터베이스 엔진입니다. 따라서 저장 프로시저 및 트리거 내에서 수행된 요청이 동일한 데이터베이스 세션 범위에서 실행됩니다. 이 기능을 통해 Azure Cosmos DB에서 저장 프로시저 또는 트리거에 속하는 모든 작업에 대해 ACID 속성을 보장할 수 있습니다. 예제를 보려면 트랜잭션 구현 방법 문서를 참조하세요.

팁

Azure Cosmos DB for NoSQL의 트랜잭션 지원을 위해 기본 설정 클라이언트 SDK를 사용하여 트랜잭션 일괄 처리를 구현할 수도 있습니다. 자세한 내용은 Azure Cosmos DB for NoSQL의 트랜잭션 일괄 처리 작업을 참조하세요.

트랜잭션의 범위

저장 프로시저는 Azure Cosmos DB 컨테이너와 연결되고 저장 프로시저 실행 범위는 논리 파티션 키로 지정됩니다. 저장 프로시저는 실행 중에 트랜잭션 범위에 대한 논리 파티션을 정의하는 논리 파티션 키 값을 포함해야 합니다. 자세한 내용은 Azure Cosmos DB 분할 문서를 참조하세요.

커밋 및 롤백

트랜잭션은 기본적으로 Azure Cosmos DB의 JavaScript 프로그래밍 모델에 통합됩니다. JavaScript 함수 내부에서 모든 작업은 자동으로 단일 트랜잭션 아래에 래핑됩니다. 저장 프로시저의 JavaScript 논리가 예외 없이 완료되면 트랜잭션 내의 모든 작업이 데이터베이스로 커밋됩니다. BEGIN TRANSACTION 및 COMMIT TRANSACTION(관계형 데이터베이스에 잘 알려짐)과 같은 문은 Azure Cosmos DB에서 암시적입니다. 스크립트에서 발생한 예외가 있을 경우 Azure Cosmos DB의 JavaScript 런타임이 전체 트랜잭션을 롤백합니다. 따라서 예외를 발생시키는 것은 결과적으로 Azure Cosmos DB의 ROLLBACK TRANSACTION과 동일합니다.

데이터 일관성

저장 프로시저와 트리거는 항상 Azure Cosmos DB 컨테이너의 주 복제본에서 실행됩니다. 이 기능은 저장 프로시저의 읽기에서 강력한 일관성을 제공합니다. 사용자 정의 함수를 사용하는 쿼리는 주 또는 보조 복제본에서 실행할 수 있습니다. 저장 프로시저와 트리거는 트랜잭션 쓰기를 지원하기 위한 것입니다. 한편, 읽기 전용 논리는 데이터베이스 처리량을 포화시키는 데 도움이 되는 Azure Cosmos DB for NoSQL SDK를 사용하여 애플리케이션 쪽 논리 및 쿼리로 가장 잘 구현됩니다.

팁

저장 프로시저 또는 트리거 내에서 실행되는 쿼리로는 동일한 스크립트 트랜잭션에서 변경된 항목을 볼 수 없습니다. 이 문은 getContent().getCollection().queryDocuments()와 같은 SQL 쿼리뿐만 아니라 getContext().getCollection().filter()와 같은 통합 언어 쿼리에도 적용됩니다.

제한된 예외

모든 Azure Cosmos DB 작업은 지정된 제한 시간 내에 완료되어야 합니다. 저장 프로시저의 시간 제한은 5초입니다. 이 제약 조건은 JavaScript 함수인 저장 프로시저, 트리거 및 사용자 정의 함수에도 적용됩니다. 해당 시간 제한 내에 작업이 완료되지 않으면 트랜잭션이 롤백됩니다.

따라서 JavaScript 함수가 시간 제한 내에 완료되거나 실행을 일괄 처리/다시 시작하는 연속 기반 모델을 구현될 것으로 보장할 수 있습니다. 시간 제한을 처리하는 저장 프로시저 및 트리거 개발을 간소화하기 위해 Azure Cosmos DB 컨테이너 아래의 모든 함수(예: 항목 만들기, 읽기, 업데이트 및 삭제)는 해당 작업이 완료되는지 여부를 나타내는 부울 값을 반환합니다. 이 값이 false이면 스크립트가 구성된 값보다 더 많은 시간 및 프로비전된 처리량을 사용하므로 프로시저가 실행을 래핑해야 한다는 것을 나타냅니다. 수락되지 않은 첫 번째 저장소 작업 전에 대기된 작업은 저장 프로시저가 제시간에 완료되고 더 이상 요청을 대기열에 추가하지 않을 경우 완료됩니다. 따라서 JavaScript의 콜백 규칙을 사용하여 한 번에 하나의 작업을 큐에 대기함으로써 스크립트의 제어 흐름을 관리해야 합니다. 스크립트는 서버 쪽 환경에서 실행되므로 엄격하게 관리됩니다. 실행 경계를 반복적으로 위반하는 스크립트는 비활성 상태로 표시되어 실행할 수 없으며, 실행 경계를 준수하도록 다시 만들어야 합니다.

JavaScript 함수는 프로비저된 처리 용량에도 적용됩니다. JavaScript 함수는 짧은 시간 내에 많은 요청 단위를 사용할 수 있으며, 프로비전된 처리 용량 한계에 도달하면 속도가 제한될 수 있습니다. 이러한 데이터베이스 작업은 클라이언트에서 동일한 작업을 실행하는 것보다는 약간 더 저렴하지만, 데이터베이스 작업 실행에 소요되는 처리량 외에 스크립트에도 추가 처리량이 사용된다는 점에 유의해야 합니다.

트리거

Azure Cosmos DB는 두 가지 유형의 트리거를 지원합니다.

사전 트리거

Azure Cosmos DB는 Azure Cosmos DB 항목에 대해 작업을 수행하여 호출할 수 있는 트리거를 제공합니다. 예를 들어, 항목을 작성할 때 사전 트리거를 지정할 수 있습니다. 이 경우 항목을 만들기 전에 사전 트리거가 실행됩니다. 사전 트리거는 입력 매개 변수를 사용할 수 없습니다. 필요한 경우 요청 개체를 사용하여 원래 요청에서 문서 본문을 업데이트할 수 있습니다. 사용자는 트리거를 등록할 때 트리거 실행에 사용되는 작업을 지정할 수 있습니다. 트리거를 TriggerOperation.Create로 만든 경우에는 바꾸기 작업에서 해당 트리거를 사용하는 것이 허용되지 않습니다. 예제를 보려면 트리거 작성 방법 문서를 참조하세요.

사후 트리거

사전 트리거와 마찬가지로 사후 트리거도 Azure Cosmos DB 항목에 대한 작업과 관련되며 입력 매개 변수가 필요하지 않습니다. 이 트리거는 작업이 완료된 후에 실행되며 클라이언트에 전송된 응답 메시지에 액세스할 수 있습니다. 예제를 보려면 트리거 작성 방법 문서를 참조하세요.

참고 항목

등록된 트리거는 해당 작업(만들기/삭제/바꾸기/업데이트)이 발생할 때 자동으로 실행되지 않습니다. 이러한 작업을 실행할 때 등록된 트리거를 명시적으로 호출해야 합니다. 자세히 알아보려면 트리거를 실행하는 방법 문서를 참조하세요.

사용자 정의 함수

UDF(사용자 정의 함수)는 API for NoSQL 쿼리 언어 구문을 확장하고 사용자 지정 비즈니스 논리를 쉽게 구현하는 데 사용됩니다. 이 함수는 쿼리 내에서만 호출할 수 있습니다. UDF는 컨텍스트 개체에 액세스할 수 없으며 컴퓨팅 전용 JavaScript로 사용되어야 합니다. 따라서 UDF는 보조 복제본에서 실행할 수 있습니다.

JavaScript 언어 통합 쿼리 API

API for NoSQL 쿼리 구문을 사용하여 쿼리를 실행하는 것외에, 서버 쪽 SDK를 사용하면 SQL에 대한 지식 없이도 JavaScript 인터페이스를 사용하여 쿼리를 수행할 수 있습니다. JavaScript 쿼리 API를 사용하면 조건자 함수를 함수 호출 시퀀스로 전달하여 프로그래밍 방식으로 쿼리를 빌드할 수 있습니다. 쿼리는 JavaScript 런타임에서 구문 분석되며 Azure Cosmos DB 내에서 효율적으로 실행됩니다. JavaScript 쿼리 API 지원에 대해 자세히 알아보려면 API 작업 문서를 참조하세요. 예제를 보려면 JavaScript 쿼리 API를 사용하여 저장 프로시저 및 트리거를 작성하는 방법 문서를 참조하세요.

다음 단계

다음 문서를 사용하여 Azure Cosmos DB에서 저장 프로시저, 트리거 및 사용자 정의 함수를 작성하고 사용하는 방법을 알아봅니다.

Azure Cosmos DB로 마이그레이션하기 위한 용량 계획을 수행하려고 하시나요? 용량 계획을 위해 기존 데이터베이스 클러스터에 대한 정보를 사용할 수 있습니다.