기본 제공 구성

아티클
03/02/2011

이 항목은 Windows Workflow Foundation 4에 적용됩니다.

이 샘플에서는 SQL 워크플로 인스턴스 저장소를 사용하고 구성하는 방법을 보여 줍니다. SQL 워크플로 인스턴스 저장소는 인스턴스 저장소의 SQL 기반 구현이며, 이 저장소를 사용하면 인스턴스가 SQL Server 또는 SQL Server Express 데이터베이스 간에 인스턴스 상태를 저장하고 로드할 수 있습니다.

참고:
컴퓨터에 이 샘플이 이미 설치되어 있을 수도 있습니다. 계속하기 전에 다음(기본) 디렉터리를 확인하십시오. `<InstallDrive>:\WF_WCF_Samples` 이 디렉터리가 없으면 다운로드 페이지로 이동하여 WCF(Windows Communication Foundation) 및 WF 샘플을 모두 다운로드하십시오. 이 샘플은 다음 디렉터리에 있습니다. `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Persistence\BuiltInConfiguration`

참고:

컴퓨터에 이 샘플이 이미 설치되어 있을 수도 있습니다. 계속하기 전에 다음(기본) 디렉터리를 확인하십시오.

<InstallDrive>:\WF_WCF_Samples

이 디렉터리가 없으면 다운로드 페이지로 이동하여 WCF(Windows Communication Foundation) 및 WF 샘플을 모두 다운로드하십시오. 이 샘플은 다음 디렉터리에 있습니다.

<InstallDrive>:\WF_WCF_Samples\WF\Basic\Persistence\BuiltInConfiguration

샘플 세부 정보

이 샘플은 계산 서비스를 구현하는 워크플로로 구성되어 있습니다. 서비스의 시작 메서드를 호출하면 서비스는 0부터 59까지 계산합니다. 카운터는 2초 간격으로 증가하고, 각 계산 후에 워크플로가 지속됩니다.

계산 워크플로는 워크플로 서비스 호스트에서 자체 호스팅합니다. 프로그램의 Main 메서드는 계산 워크플로를 호스팅하는 워크플로 서비스 호스트의 인스턴스를 만들고, 계산 워크플로가 도달할 수 있는 끝점을 정의합니다. 그런 다음 SQL 워크플로 인스턴스 저장소를 구성하는 데 사용되는 SQL 워크플로 인스턴스 저장소 동작을 정의합니다. 그런 다음 프로그램은 계산 워크플로의 시작 메서드를 호출하는 클라이언트를 만듭니다.

프로그램을 시작하면 카운터가 자동으로 계산을 시작합니다. 인스턴스를 로드하고 SQL 워크플로 인스턴스 저장소를 구성하는 데는 몇 초 정도 걸릴 수 있습니다. 워크플로 인스턴스 저장소에 대한 자세한 내용은 SQL 워크플로 인스턴스 저장소를 참조하십시오.

이 샘플은 두 부분으로 구성되어 있습니다.

InstanceStore1에서는 C# 코드를 사용하여 SqlWorkflowInstanceStore를 구성하는 방법을 보여 줍니다(Program.cs 참조).
InstanceStore2에서는 XML을 사용하여 SqlWorkflowInstanceStore를 구성하는 방법을 보여 줍니다(App.config 참조).

다음 설정은 SQL 워크플로 인스턴스 저장소 동작을 구성하는 데 사용할 수 있습니다.

HostLockRenewalPeriod를 설정합니다. 이 시간에 따라 호스트가 실행하는 인스턴스의 소유권 잠금을 갱신하는 간격이 정의됩니다. 잠금 정보는 인스턴스 저장소에 저장됩니다. HostLockRenewalPeriod에 정의된 간격이 두 번 경과할 때까지 소유권을 갱신하지 않으면 인스턴스는 중단된 것으로 간주됩니다. 다른 WorkflowServiceHost가 같은 컴퓨터나 다른 컴퓨터의 동일한 인스턴스 저장소에 연결되어 있는 상태에서 같은 워크플로를 실행 중이면 해당 인스턴스가 복구됩니다. 인스턴스 복구에 대해서는 이 샘플에서 다루지 않습니다.
RunnableInstancesDetectionPeriod를 설정합니다. 이 기간에 따라 호스트가 실행 가능하게 된 인스턴스를 폴링하는 간격이 정의됩니다. 인스턴스는 다음 이벤트 중 하나가 발생하는 경우 실행 가능하게 될 수 있습니다.
- 지속적인 타이머(Delay)가 만료되는 경우
- 컴퓨터 고장 등의 이유로 다른 호스트에 HostLockRenewal 하트비트가 누락되고 인스턴스가 복구되는 경우
InstanceCompletionAction을 설정합니다. 이 속성을 DeleteNothing으로 설정하면 완료된 인스턴스가 인스턴스 저장소에서 유지되고, DeleteAll로 설정하면 인스턴스가 완료될 때 저장소에서 삭제됩니다.

참고:

계산이 완료되기 전에 Enter 키를 눌러 호스트를 종료하면 워크플로 인스턴스가 완료되지 않습니다.
InstanceLockedExceptionAction을 설정합니다. 이 설정에 따라 호스트가 다른 호스트에서 잠근 인스턴스를 로드하려는 경우 수행해야 하는 작업이 정의됩니다. 다음과 같은 옵션이 있습니다.
- NoRetry로 설정하는 경우: 로드하려고 다시 시도하지 않고 호스트에 InstanceLockedException을 반환합니다.
- BasicRetry로 설정하는 경우: 계속해서 인스턴스를 로드하려고 시도합니다. 단순한 선형 알고리즘에 따라 다시 시도가 예약됩니다. 예를 들면 5초 간격으로 다시 시도합니다.
- AggressiveRetry로 설정하는 경우: 계속해서 인스턴스를 로드하려고 시도합니다. 적극적인 지수 백오프 알고리즘에 따라 다시 시도가 예약됩니다.
인코딩 옵션을 설정합니다. 이 설정에 따라 인스턴스 상태가 SQL 워크플로 인스턴스 저장소에 저장되는 방식이 정의됩니다. 다음과 같은 옵션이 있습니다.
- 인스턴스 상태가 GZip 압축 알고리즘을 사용하여 압축됩니다.
- 인스턴스 상태가 압축되지 않습니다.

참고:
계산이 완료되기 전에 Enter 키를 눌러 호스트를 종료하면 워크플로 인스턴스가 완료되지 않습니다.

이 샘플을 사용하려면

관리자 권한(있는 경우)으로 Visual Studio 2010 명령 프롬프트를 엽니다.
샘플 디렉터리(\WF\Basic\Persistence\BuiltInConfiguration\CS)로 이동하고 CreateInstanceStore.cmd를 실행합니다.
관리자 권한이 없는 경우 SQL Server 로그인을 만듭니다. Security, 로그인으로 이동합니다. 로그인을 마우스 오른쪽 단추로 클릭하고 새 로그인을 만듭니다.
SQL 역할에 ACL 사용자를 추가합니다. 데이터베이스, InstanceStore, 보안을 엽니다. 사용자를 마우스 오른쪽 단추로 클릭하고 새 사용자를 선택합니다. 로그인 이름을 이전 단계에서 만든 사용자로 설정합니다. 데이터베이스 역할 멤버 자격(예: System.Activities.DurableInstancing.InstanceStoreUsers)에 사용자를 추가합니다. 사용자가 이미 있을 수도 있습니다(예: 사용자 dbo).
Visual Studio 2010에서 InstanceStore.sln 파일을 열고 F6 키를 눌러 솔루션을 빌드합니다.
Windows 탐색기에서 샘플의 적절한 bin\debug 디렉터리(\WF\Basic\Persistence\BuiltInConfiguration\cs\InstanceStore(1 또는 2)\bin\debug)로 이동하고 InstanceStore.exe를 마우스 오른쪽 단추로 클릭한 다음 관리자 권한으로 실행을 선택합니다. 이 샘플은 채널 수신기를 열기 때문에 관리자 권한으로 실행해야 합니다.
SQL Server Express 로컬 설치 이외의 데이터베이스에 인스턴스 저장소를 만든 경우에는 샘플에서 데이터베이스 연결 문자열(InstanceStore1 프로젝트의 Program.cs에 있는 const string ConnectionString 및 InstanceStore2 프로젝트의 App.config에 있는 connectionString 특성)을 업데이트한 다음 샘플을 다시 컴파일해야 합니다.

샘플이 올바르게 실행되고 있는지 확인하려면

샘플이 실행되고 있는 동안 SQL Server Management Studio를 시작합니다.
개체 탐색기에서 데이터베이스, InstanceStore, 테이블 및 System.Activities.DurableInstancing.InstanceTable을 차례로 선택합니다.
인스턴스 테이블을 마우스 오른쪽 단추로 클릭하고 상위 1000개의 행 선택을 선택합니다.
새 항목이 있는지와 잠금 만료가 5초 간격으로 변경되는지 확인합니다. 쿼리를 새로 고치려면 작업 표시줄의 실행 단추를 클릭합니다. 이것은 호스트 잠금 갱신 기간을 5로 설정할 경우에 나타나는 결과입니다.
계산이 완료된 후 인스턴스 테이블의 항목이 제거되었는지 확인합니다. 이것은 인스턴스 완료 동작을 DeleteAll로 설정할 경우에 나타나는 결과입니다.
Enter 키를 눌러 워크플로 호스트 응용 프로그램을 종료한 다음 LockOwnersTable이 삭제되었는지 확인합니다.

샘플을 제거하려면

샘플 디렉터리(\WF\Basic\Persistence\BuiltInConfiguration)에서 RemoveInstanceStore.cmd를 실행합니다.

참고:
컴퓨터에 이 샘플이 이미 설치되어 있을 수도 있습니다. 계속하기 전에 다음(기본) 디렉터리를 확인하십시오. `<InstallDrive>:\WF_WCF_Samples` 이 디렉터리가 없으면 Windows Communication Foundation (WCF) and Windows Workflow Foundation (WF) Samples for .NET Framework 4로 이동하여 WCF(Windows Communication Foundation) 및 WF 샘플을 모두 다운로드하십시오. 이 샘플은 다음 디렉터리에 있습니다. `<InstallDrive>:\WF_WCF_Samples\WF\Basic\Persistence\BuiltInConfiguration`

참고: