Çoğaltma aracısı profilleri ile çalışmak

Makale
10/29/2012

Bu konuda çoğaltma aracısı profilleri ile nasıl çalışılacağını açıklar SQL Server 2012kullanarak SQL Server Management Studio, Transact-SQL, ya da Çoğaltma Yönetimi Nesneleri'ni (rmo). Her çoğaltma aracısı davranışını Aracısı profilleri ayarlanabilir parametreler kümesi tarafından denetlenir. Her Aracısı bir varsayılan profil vardır ve bazı ek önceden tanımlanmış profiller; belirli bir anda yalnızca bir profil bir aracı için etkindir.

Bu Konuda

Kullanarak çoğaltma aracısı profilleri ile çalışmak için:

SQL Server Management Studio
- Aracısı profilleri iletişim kutusuna erişin
- Bir aracı için bir profil belirleme
- Profil oluşturma
- Profil değiştirme
- Profil silme
Transact-SQL
- Profil oluşturma
- Profil değiştirme
- Profil silme
- Eşitleme sırasında Aracısı profilleri kullan
- Transact-sql örnek
Çoğaltma Yönetimi Nesneleri'ni
- Profil oluşturma
- Profil değiştirme
- Profil silme
Takip: aracısı parametrelerini değiştirme sonra

SQL Server Management Studio Kullanarak

SQL Server Management Studio'yu Aracısı profilleri iletişim kutusuna erişmek için

Tarih Genel sayfası Dağıtımcı özellikleri - <Dağıtıcı > iletişim kutusu'yı Profil Varsayılanları.

Çoğaltma izleyicisi'nden Aracısı profilleri iletişim kutusuna erişmek için

Tüm aracılar için iletişim kutusunu açmak için Publisher sağ tıklatın ve ardından Aracısı profilleri.
Bir tek Aracısı için iletişim kutusunu açmak için:
1. Çoğaltma izleyicisi'nin sol bölmede bir yayımcı grubu genişletin, bir Publisher genişletin ve sonra bir yayın'ı tıklatın.
2. Dağıtım Aracısı ve Birleştirme Aracısı profilleri için abonelik sağ Tüm abonelikleri sekmesini tıklatıp ardından Aracısı profili. Diğer maddeler için aracı sağ ajanlar sekmesini tıklatıp ardından Aracısı profili.
[Top]

Bir aracı için bir profil belirtmek için

Eğer Aracısı profilleri birden fazla Aracısı profilleri iletişim kutusunu görüntüler, bir aracı seçin.
Bir profil seçin için yeni varsayılan sütununda Aracısı profilleri ızgara. Varsayılan olarak, yeni yayınlar ve abonelikleri için yalnızca profil uygulanır.
Seçilen türdeki tüm aracılar için varolan yayınlar veya abonelikler bu profili kullanmak tıklayın belirtmek için Varolan aracıları Değiştir.

[Top]

Görüntülemek ve bir profille ilişkili parametrelerini düzenlemek için

Eğer Aracısı profilleri birden fazla Aracısı profilleri iletişim kutusunu görüntüler, bir aracı seçin.
Özellikler düğmesini tıklatın (...) bir profilin yanındaki.
Parametreleri ve değerleri görüntülemek <ProfilAdı > Profil özelliklerinin iletişim kutusu.
- Kullanıcı tanımlı profilleri parametrelerinde düzenlenebilir; önceden tanımlanmış sistem profilleri parametrelerinde olamaz.
- Bir aracı için tüm parametreleri görmek için temizleyin sadece bu profilde kullanılan parametrelerini göster onay kutusu. Aracısı parametreleri hakkında daha fazla bilgi için bu konunun sonundaki bağlantılara bakın.
Tıklayın yakın.

[Top]

Kullanıcı tanımlı bir profil oluşturmak için

Eğer Aracısı profilleri birden fazla Aracısı profilleri iletişim kutusunu görüntüler, bir aracı seçin.
Tıklayın Yeni.
İçinde Yeni Aracısı profil başlatma iletişim kutusunda, yeni profil esas alacağı varolan bir profili seçin.
İçinde Yeni Aracısı profil iletişim kutusunda, değerler girin ad ve Açıklama metin kutuları.
Profil terzi parametrelerini değiştirin. Bir aracı için tüm parametreleri görmek için temizleyin sadece bu profilde kullanılan parametrelerini göster onay kutusu. Aracısı parametreleri hakkında daha fazla bilgi için bu konunun sonundaki bağlantılara bakın.
Tamam’ı tıklatın.

[Top]

Bir kullanıcı tanımlı profilini silmek için

Eğer Aracısı profilleri birden fazla Aracısı profilleri iletişim kutusunu görüntüler, bir aracı seçin.
Profili bir veya daha fazla aracıları ile ilişkili ise, bu aracılar için profili değiştirin:
1. Farklı bir profil seçmek Aracısı profilleri ızgara.
2. Tıklayın Varolan aracıları Değiştir.
  
  [!NOT]
  
  Bu profil için varolan yayınlar veya abonelik, yalnızca silmek istediğiniz profili kullanarak olanlar için seçilen türdeki tüm aracılar değişecektir.
Silin ve ardından istediğiniz profili seçin silmek.
Tamam’ı tıklatın.

Başa Dön bağlantısıyla kullanılan ok simgesi [Top]

Transact-SQL'i Kullanma

Yeni Aracısı profil oluşturmak için

Dağıtıcı idam sp_add_agent_profile (Transact-sql). Belirtmek @ adı, değeri 1 için @ profile_type, ve değer aşağıdakilerden biri için @ agent_type:
Bu profili çoğaltma aracısı türü için yeni varsayılan profil olacaktır, değeri belirtmeniz 1 için @ varsayılan. Yeni profil için tanımlayıcı kullanarak döndürülen @ profile_id parametresi çıktı. Bu, verilen Aracısı türü için varsayılan profili temel profili parametreler kümesi ile yeni bir profil oluşturur.
Yeni Profil oluşturulduktan sonra ekleme, kaldırma veya değiştirme profili özelleştirmek için varsayılan parametreleri.

[Top]

Varolan Aracısı profilini değiştirmek için

Dağıtıcı idam sp_help_agent_profile (Transact-sql). İçin aşağıdaki değerlerden birini belirtin @ agent_type:
Bu tüm profiller için belirtilen Aracısı türünü döndürür. Değerini not alın profile_id sonuç kümesinde profilini değiştirmek.
Dağıtıcı idam sp_help_agent_parameter (Transact-sql). Profili tanımlayıcı için adım 1 belirtmeniz @ profile_id. Bu profil için tüm parametreleri döndürür. Değiştirmek veya profilden kaldırmak için herhangi bir parametre adını not alın.
Profilindeki bir parametre değeri değiştirmek için idam sp_change_agent_profile (Transact-sql). Profili tanımlayıcı için adım 1 belirtmeniz @ profile_id, değiştirmek için parametre adı @ özellikve yeni bir değer parametresi için @ değeri.

[!NOT]

Bir aracı için varsayılan profil olmak için varolan Aracısı profili değiştiremezsiniz. Bunun yerine, önceki yordamda gösterildiği gibi varsayılan profil olarak yeni bir profil oluşturmanız gerekir.
Parametre bir profilden kaldırmak için idam sp_drop_agent_parameter (Transact-sql). Profili tanımlayıcı için adım 1 belirtmeniz @ profile_id ve kaldırmak için parametre adı @ parameter_name.
Profil için yeni bir parametre eklemek için aşağıdakileri yapmanız gerekir:
- Sorgu MSagentparameterlist (Transact-sql)hangi profili parametreler her Aracısı türü için ayarlanabilir belirlemek için dağıtımcı masada.
- Dağıtıcı idam sp_add_agent_parameter (Transact-sql). Profili tanımlayıcı için adım 1 belirtmeniz @ profile_id, eklemek için geçerli bir parametre adı @ parameter_name, parametre değeri @ parameter_value.
[Top]

Aracısı profili silmek için

Dağıtıcı idam sp_help_agent_profile (Transact-sql). İçin aşağıdaki değerlerden birini belirtin @ agent_type:
Bu tüm profiller için belirtilen Aracısı türünü döndürür. Değerini not alın profile_id sonuç kümesinde kaldırmak için profil.
Dağıtıcı idam sp_drop_agent_profile (Transact-sql). Profili tanımlayıcı için adım 1 belirtmeniz @ profile_id.

[Top]

Eşitleme sırasında Aracısı profillerini kullanmak için

Dağıtıcı idam sp_help_agent_profile (Transact-sql). İçin aşağıdaki değerlerden birini belirtin @ agent_type:
Bu tüm profiller için belirtilen Aracısı türünü döndürür. Değerini not alın profile_name sonuç kümesi kullanmak için profil.
Bir ajan işten Aracısı başlatılmışsa, aracısının değerini belirtmek için başlatılan iş adım düzenleme profile_nameAdım 1 sonra elde - ProfileName komut satırı parametresi. Daha fazla bilgi için, bkz. Görüntülemek ve çoğaltma aracısı komut istemi Parametreler (SQL Server Management Studio'yu) Değiştir.
Aracı komut isteminden başlatırken, değerini belirtmek profile_name adım 1 sonra elde - ProfileName komut satırı parametresi.

[Top]

Örnek (Transact-sql)

Bu örnek, adlandırılmış birleştirme Aracısı için özel bir profil oluşturur custom_merge, değerini değiştirir - UploadReadChangesPerBatch parametresi, yeni bir ekler - ExchangeType parametre ve oluşturulan profil bilgisini döndürür.

DECLARE @profilename AS sysname;
DECLARE @profileid AS int;
SET @profilename = N'custom_merge';

-- Create a temporary table to hold the returned 
-- Merge Agent profiles.
CREATE TABLE #profiles (
    profile_id int, 
    profile_name sysname,
    agent_type int,
    [type] int,
    description varchar(3000),
    def_profile bit)

INSERT INTO #profiles (profile_id, profile_name, 
    agent_type, [type],description, def_profile)
    EXEC sp_help_agent_profile @agent_type = 4;

SET @profileid = (SELECT profile_id FROM #profiles 
    WHERE profile_name = @profilename);

IF (@profileid IS NOT NULL)
BEGIN
    EXEC sp_drop_agent_profile @profileid;
END
DROP TABLE #profiles

-- Add a new merge agent profile. 
EXEC sp_add_agent_profile @profile_id = @profileid OUTPUT, 
@profile_name = @profilename, @agent_type = 4, 
@description = N'custom merge profile';

-- Change the value of uploadreadchangesperbatch in the profile.
EXEC sp_change_agent_parameter @profile_id = @profileid, 
    @parameter_name = N'-UploadReadChangesPerBatch', @parameter_value = 50;

-- Add a new parameter ExchangeType the profile. 
EXEC sp_add_agent_parameter @profile_id = @profileid, 
    @parameter_name = N'-ExchangeType', @parameter_value = 1;

-- Verify the new profile. 
EXEC sp_help_agent_parameter @profileid;
GO

Başa Dön bağlantısıyla kullanılan ok simgesi [Top]

Using :

Yeni Aracısı profil oluşturmak için

Dağıtımcı bir bağlantı örneğini kullanarak oluşturmak ServerConnectionsınıf
Örneğini AgentProfilesınıf
Nesneyi aşağıdaki özelliklerini ayarlayın:
- Name-Profil adı.
- AgentType-bir AgentTypeiçin profili oluşturulur çoğaltma aracısı türünü belirten değer.
- ConnectionContext- ServerConnection1. adımda oluşturulan.
- (İsteğe bağlı) Description-Profil açıklaması.
- (İsteğe bağlı) Default- Bu özelliğini true, tüm yeni Aracısı işleri bu AgentTypevarsayılan olarak bu profili kullanacak.
Arama CreateProfil sunucuda oluşturma yöntemi.
Profil sunucuda bulunduğu sonra ekleme, kaldırma veya çoğaltma aracısı parametre değerlerini değiştirerek özelleştirebilirsiniz.
Varolan çoğaltma aracısı iş için profili atamak için çağrı AssignToAgentyöntemi. Dağıtım veritabanı adı geçmesi distributionDBNameve iş Kımlığı agentID.

[Top]

Varolan Aracısı profilini değiştirmek için

Dağıtımcı bir bağlantı örneğini kullanarak oluşturmak ServerConnectionsınıf
Örneğini ReplicationServersınıf Geçmek ServerConnection1. adımda oluşturulan nesne.
Arama LoadPropertiesyöntemi. Bu yöntem ise false, dağıtımcı varolduğundan emin olun.
Arama EnumAgentProfilesyöntemi. Geçmek bir AgentTypedeğeri belirli bir çoğaltma aracısı türü için döndürülen profilleri daraltmak için.
İstenen olsun AgentProfiledöndürülen nesne ArrayList, burada NameProfil ad nesnesinin özelliği ile eşleşen için.
Aşağıdaki yöntemlerden birini arayın AgentProfiletercihi değiştirmek için:
- AddParameter-profile, desteklenen bir parametre ekler nerede nameçoğaltma aracısı parametre adı ve valuebelirtilen değer. Verilen Aracısı türü için tüm desteklenen Aracısı parametreleri listelemek için EnumParameterInfoyöntemi. Bu yöntem döndürür bir ArrayList, AgentProfileParameterInfodesteklenen tüm parametreleri temsil eden nesneler.
- RemoveParameter-Varolan bir parametre profilinden kaldırır nerede nameçoğaltma aracısı parametre adı. Profil için tanımlanmış tüm geçerli aracısı parametrelerini numaralandırmak için çağrı EnumParametersyöntemi. Bu yöntem döndürür bir ArrayList, AgentProfileParameterBu profil için varolan parametre temsil eden nesneler.
- ChangeParameter-değiştirir profile, varolan bir parametre ayarı nerede nameAracısı parametre adı ve newValuedeğeri için parametre değiştirilir. Profil için tanımlanmış tüm geçerli aracısı parametrelerini numaralandırmak için çağrı EnumParametersyöntemi. Bu yöntem döndürür bir ArrayList, AgentProfileParameterBu profil için varolan parametre temsil eden nesneler. Desteklenen tüm numaralandırmak için Aracısı parametre ayarları, arama EnumParameterInfoyöntemi. Bu yöntem döndürür bir ArrayList, AgentProfileParameterInfotüm parametreler için desteklenen değerler temsil eden nesneler.
[Top]

Aracısı profili silmek için

Dağıtımcı bir bağlantı örneğini kullanarak oluşturmak ServerConnectionsınıf
Örneğini AgentProfilesınıf Profil adını Nameve ServerConnectioniçin adım 1'de belirtilen ConnectionContext.
Arama LoadPropertiesyöntemi. Bu yöntem ise false, belirtilen ad hatalı veya profil sunucuda yok.
Emin olun Typeözelliği ayarlanır User, hangi gösterir bir müşteri profili. Bir değeri olan bir profil kaldırmamanız Systemiçin Type.
Arama RemoveBu nesne tarafından temsil edilen sunucudan kullanıcı tanımlı profili kaldırma yöntemi.