다음을 통해 공유


방법: 복제 에이전트 프로필 작업(RMO 프로그래밍)

복제 에이전트 프로필은 에이전트 작업이 만들어질 때 기본값을 정의하는 데 사용됩니다. 각 에이전트에는 기본 프로필이 있으며 미리 정의된 프로필이 추가된 에이전트도 있습니다. RMO(복제 관리 개체)를 사용하여 사용자 정의 프로필을 만들 수 있습니다. 프로필에 대한 자세한 내용은 복제 에이전트 프로필을 참조하십시오.

새 에이전트 프로필을 만들려면

  1. ServerConnection 클래스의 인스턴스를 사용하여 배포자에 대한 연결을 만듭니다.

  2. AgentProfile 클래스의 인스턴스를 만듭니다.

  3. 개체의 다음 속성을 설정합니다.

    • Name - 프로필의 이름입니다.

    • AgentType - 프로필을 만들 복제 에이전트의 유형을 지정하는 AgentType 값입니다.

    • ConnectionContext - 1단계에서 만든 ServerConnection입니다.

    • Description(옵션) - 프로필에 대한 설명입니다.

    • Default(옵션) - 이 AgentType의 모든 새 에이전트 작업에서 기본적으로 이 프로필이 사용되는 경우 이 속성을 true로 설정합니다.

  4. Create 메서드를 호출하여 서버에 프로필을 만듭니다.

  5. 서버에 프로필이 있으면 복제 에이전트 매개 변수의 값을 추가, 제거 또는 변경하여 프로필을 사용자 지정할 수 있습니다.

  6. 기존 복제 에이전트 작업에 프로필을 할당하려면 AssignToAgent 메서드를 호출합니다. distributionDBName에 대한 배포 데이터베이스 이름 및 agentID에 대한 작업 ID를 전달합니다.

기존 에이전트 프로필을 수정하려면

  1. ServerConnection 클래스의 인스턴스를 사용하여 배포자에 대한 연결을 만듭니다.

  2. ReplicationServer 클래스의 인스턴스를 만듭니다. 1단계에서 만든 ServerConnection 개체를 전달합니다.

  3. LoadProperties 메서드를 호출합니다. 이 메서드가 false를 반환하는 경우 배포자가 있는지 확인합니다.

  4. EnumAgentProfiles 메서드를 호출합니다. AgentType 값을 전달하여 반환되는 프로필의 범위를 특정 유형의 복제 에이전트로 좁힙니다.

  5. 반환된 ArrayList에서 원하는 AgentProfile 개체를 가져옵니다. 이때 개체의 Name 속성은 프로필 이름과 일치합니다.

  6. AgentProfile의 다음 메서드 중 하나를 호출하여 프로필을 변경합니다.

    • AddParameter - 프로필에 지원되는 매개 변수를 추가합니다. 여기서 name은 복제 에이전트 매개 변수의 이름이고 value는 지정된 값입니다. 지정된 에이전트 유형에 대해 지원되는 모든 에이전트 매개 변수를 열거하려면 EnumParameterInfo 메서드를 호출합니다. 이 메서드는 지원되는 모든 매개 변수를 나타내는 AgentProfileParameterInfo 개체의 ArrayList를 반환합니다.

    • RemoveParameter - 프로필에서 기존 매개 변수를 제거합니다. 여기서 name은 복제 에이전트 매개 변수의 이름입니다. 프로필에 대해 정의된 현재의 모든 에이전트 매개 변수를 열거하려면 EnumParameters 메서드를 호출합니다. 이 메서드는 이 프로필의 기존 매개 변수를 나타내는 AgentProfileParameter 개체의 ArrayList를 반환합니다.

    • ChangeParameter - 프로필의 기존 매개 변수 설정을 변경합니다. 여기서 name은 에이전트 매개 변수의 이름이고 newValue는 매개 변수를 변경할 값입니다. 프로필에 대해 정의된 현재의 모든 에이전트 매개 변수를 열거하려면 EnumParameters 메서드를 호출합니다. 이 메서드는 이 프로필의 기존 매개 변수를 나타내는 AgentProfileParameter 개체의 ArrayList를 반환합니다. 지원되는 모든 에이전트 매개 변수 설정을 열거하려면 EnumParameterInfo 메서드를 호출합니다. 이 메서드는 모든 매개 변수에 대해 지원되는 값을 나타내는 AgentProfileParameterInfo 개체의 ArrayList를 반환합니다.

에이전트 프로필을 삭제하려면

  1. ServerConnection 클래스의 인스턴스를 사용하여 배포자에 대한 연결을 만듭니다.

  2. AgentProfile 클래스의 인스턴스를 만듭니다. Name에 프로필 이름을 설정하고 ConnectionContext에 1단계에서 만든 ServerConnection을 설정합니다.

  3. LoadProperties 메서드를 호출합니다. 이 메서드가 false를 반환하는 경우 지정한 이름이 올바르지 않거나 해당 프로필이 서버에 없는 것입니다.

  4. Type 속성이 고객 프로필을 나타내는 User로 설정되어 있는지 확인합니다. Type의 값이 System인 프로필은 제거하면 안 됩니다.

  5. Remove 메서드를 호출하여 이 개체가 나타내는 사용자 정의 프로필을 서버에서 제거합니다.