Udostępnij za pośrednictwem

  • Artykuł

How to: Work with Replication Agent Profiles (Replication Transact-SQL Programming)

Agent profile są używane do definiowania wartości domyślnych, gdy tworzony jest zadanie agenta.Każdy agent ma profilu domyślnego, a niektóre z nich zawierają również dodatkowe profile wstępnie zdefiniowanych.Można tworzyć profile użytkownika za pomocą procedur przechowywanych replikacja.Aby uzyskać więcej informacji na temat agentów profili zobacz Replication Agent Profiles.

Uwaga

Nie należy modyfikować ani usuwać wstępnie zdefiniowanych profile.Agent parametr zmiany zostaną wprowadzone przy następnym agent jest uruchomiony.Jeśli stale jest uruchomiony agent, należy zatrzymać i ponownie uruchomić agenta.

Aby utworzyć nowy profil agenta

  1. Na dystrybutor wykonać sp_add_agent_profile (Transact-SQL). Określ Nazwa: @, wartość 1 for @ profile_typei jeden z następujących wartości @ agent_type:

    Jeśli ten profil staną się nowy profil domyślny dla swojego typu agent replikacja, należy określić wartość 1 for @ domyślne.Zwraca identyfikator dla nowego profilu za pomocą @ profile_id parametr wyjściowy.Spowoduje to utworzenie nowego profilu z zestaw parametrów profilu na podstawie profilu domyślnego dla agenta określonego typu.

  2. Po utworzeniu nowego profilu dodać, usunąć lub zmodyfikować parametry domyślne, aby dostosować profil.

Aby zmodyfikować istniejący profil agenta

  1. Na dystrybutor wykonać sp_help_agent_profile (Transact-SQL). Określ jedną z następujących wartości @ agent_type:

    Powoduje to zwrócenie wszystkich profilów dla określonego typu agenta.Należy zwrócić uwagę, wartość profile_id w zestaw wyników dla profilu zmienić.

  2. Na dystrybutor wykonać sp_help_agent_parameter (języka Transact-SQL). Identyfikator profilu z kroku 1 do @ profile_id.Powoduje to zwrócenie wszystkich parametrów dla tego profilu.Zanotuj nazwę żadnych parametrów, aby zmodyfikować lub usunąć z profilu.

  3. Aby zmienić wartość parametru w profilu, wykonać sp_change_agent_profile (Transact-SQL). Identyfikator profilu z kroku 1 do @ profile_id, nazwę parametru, aby zmienić @ Właściwośći nową wartość dla parametru dla wartość @.

    Uwaga

    Nie można zmienić istniejący profil agenta do domyślnego profilu dla agenta.Zamiast tego należy utworzyć nowy profil jako profil domyślny, jak pokazano w powyższej procedury.

  4. Aby usunąć parametr z profilu, wykonać sp_drop_agent_parameter (języka Transact-SQL). Identyfikator profilu z kroku 1 do @ profile_id i nazwę parametru, aby usunąć @ parameter_name.

  5. Aby dodać nowego parametru do profilu, wykonaj następujące czynności:

    • Kwerendy MSagentparameterlist (Transact-SQL) Tabela na Dystrybutor, aby określić, które parametry profilu zestaw dla każdego typu agenta.

    • Na dystrybutor wykonać sp_add_agent_parameter (Transact-SQL). Identyfikator profilu z kroku 1 do @ profile_id, nazwę prawidłowego parametru dodać dla @ parameter_name, a wartość parametru dla @ parameter_value.

Aby usunąć profil programu agent

  1. Na dystrybutor wykonać sp_help_agent_profile (Transact-SQL). Określ jedną z następujących wartości @ agent_type:

    Powoduje to zwrócenie wszystkich profilów dla określonego typu agenta.Należy zwrócić uwagę, wartość profile_id w zestaw wyników profilu do usunięcia.

  2. Na dystrybutor wykonać sp_drop_agent_profile (języka Transact-SQL). Identyfikator profilu z kroku 1 do @ profile_id.

Aby korzystać z agenta profilów podczas synchronizacji

  1. Na dystrybutor wykonać sp_help_agent_profile (Transact-SQL). Określ jedną z następujących wartości @ agent_type:

    Powoduje to zwrócenie wszystkich profilów dla określonego typu agenta.Należy zwrócić uwagę, wartość nazwa_profilu w wyniku dla profilu, który będzie używany.

  2. Jeśli agent jest uruchomiony z zadanie agenta, edytowanie kroku zadanie, który uruchamia proces agenta, aby określić wartość profile_name uzyskane w kroku 1 po -ProfileName parametr wiersza polecenia.Aby uzyskać więcej informacji zobacz How to: View and Modify Replication Agent Command Prompt Parameters (SQL Server Management Studio).

  3. Podczas uruchamiania agenta wiersz polecenia, należy określić wartość nazwa_profilu uzyskane w kroku 1 po -ProfileName parametr wiersz polecenia.

Example

W tym przykładzie tworzony profilu niestandardowego o nazwie Agent korespondencji seryjnej custom_mergezmienia się wartość ,-UploadReadChangesPerBatch parametr, dodaje nowy -ExchangeType parametr i zwraca informacje o profil, który jest tworzony.