sp_addlogreader_agent (Transact-sql)

Verilen bir veritabanı için bir günlük Okuyucu Aracısı ekler. Bu saklı yordam, yayını veritabanı üzerinde yayımcı adresindeki yürütülür.

Güvenlik Notu
Bir Publisher ile sağlanan tüm parametreler için değerler uzak bir dağıtımcı yapılandırma dahil job_loginve job_password, dağıtımcı düz metin olarak gönderilir. Bu saklı yordam yürütme önce Publisher ve kendi uzak dağıtımcı arasında bağlantı şifrelemek. Daha fazla bilgi için, bkz. Veritabanı altyapısı (SQL Server Configuration Manager) şifreli bağlantıları etkinleştir.

Transact-SQL Sözdizim Kuralları

Sözdizimi

sp_addlogreader_agent [ @job_login = ] 'job_login'
        , [ @job_password = ] 'job_password'
    [ , [ @job_name = ] 'job_name' ]
    [ , [ @publisher_security_mode = ] publisher_security_mode ]
    [ , [ @publisher_login = ] 'publisher_login' ]
    [ , [ @publisher_password = ] 'publisher_password' ] 
    [ , [ @publisher = ] 'publisher' ]

Bağımsız değişkenler

• @job_login= ] 'job_login'
  Oturum açma için MicrosoftWindows hesap aracı çalıştığı altında. job_login's nvarchar(257), varsayılan değeri NULL. Bu Windows hesabını her zaman Aracısı bağlantıları dağıtımcı için kullanılır.

  [!NOT]

  İçin non- Microsoft SQL Server Publishers, bu belirtilen aynı girişi olmalıdır sp_adddistpublisher (Transact-sql).

• @ job_password=] 'job_password'
  Aracı çalıştığı Windows hesabı için parola değil. job_passwordise sysname, varsayılan değeri NULL.

  Güvenlik Notu
  Kimlik doğrulama bilgileri, komut dosyalarında depolamayın. En iyi güvenlik için giriş adları ve şifreler çalışma zamanında sağlanması.

• @job_name= ] 'job_name'
  Varolan Aracısı iş adıdır. job_nameise sysname, varsayılan değeri NULL. Bu parametre yalnızca aracı varolan bir işi yerine bir yeni oluşturulan iş (varsayılan) başlatıldığında belirtildi.

• @ publisher_security_mode=] publisher_security_mode
  Güvenlik modu için yayımcı bağlanırken Aracısı tarafından kullanılır. publisher_security_modeise smallint, varsayılan 1. 0 belirtir SQL Serverkimlik ve 1 Windows kimlik doğrulamasını belirtir. Değeri 0 için belirtilmelidir olmayan- SQL Server Publishers.

• @ publisher_login=] 'publisher_login'
  Oturum açma için yayımcı bağlanırken kullanılır. publisher_loginise sysname, null varsayılan. publisher_loginne zaman belirtilmelidir publisher_security_modeolan 0. Eğer publisher_loginnull olur ve publisher_security_modeolan 1, sonra belirtilen Windows hesabı job_loginiçin yayımcı bağlanırken kullanılacak.

• publisher_password @=] 'publisher_password'
  Yayımcı için bağlanırken kullanılan parolayı. publisher_passwordise sysname, null varsayılan.

  Güvenlik Notu
  Kimlik doğrulama bilgileri, komut dosyalarında depolamayın. En iyi güvenlik için giriş adları ve şifreler çalışma zamanında sağlanması.

• @ publisher=] 'publisher'
  Sigara adı- SQL Server Yayınevi. publisher's sysname, null varsayılan.

  [!NOT]

  Bu parametre için belirtmemeniz gerekir bir SQL ServerYayınevi.

Dönüş Kodu Değerleri

0 (başarılı) veya 1 (hata)

Açıklamalar

sp_addlogreader_agent işlem çoğaltma kullanılır.

Yürütme gerekir sp_addlogreader_agent bir günlük Okuma Aracısı çoğaltma için bu sürümü etkin veritabanı yükselttiyseniz eklemek için SQL ServerYayını veritabanı kullanılan oluşturulmadan önce.

İzinler

Yalnızca üyeleri sysadmin sabit sunucu rolü veya db_owner sabit veritabanı rolü yürütebilirsiniz sp_addlogreader_agent.

Örnek

-- To avoid storing the login and password in the script file, the values 
-- are passed into SQLCMD as scripting variables. For information about 
-- how to use scripting variables on the command line and in SQL Server
-- Management Studio, see the "Executing Replication Scripts" section in
-- the topic "Programming Replication Using System Stored Procedures".

DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publicationDB = N'AdventureWorks'; 
SET @publication = N'AdvWorksProductTran'; 
-- Windows account used to run the Log Reader and Snapshot Agents.
SET @login = $(Login); 
-- This should be passed at runtime.
SET @password = $(Password); 

-- Enable transactional or snapshot replication on the publication database.
EXEC sp_replicationdboption 
    @dbname=@publicationDB, 
    @optname=N'publish',
    @value = N'true';

-- Execute sp_addlogreader_agent to create the agent job. 
EXEC sp_addlogreader_agent 
    @job_login = @login, 
    @job_password = @password,
    -- Explicitly specify the use of Windows Integrated Authentication (default) 
    -- when connecting to the Publisher.
    @publisher_security_mode = 1;

-- Create a new transactional publication with the required properties. 
EXEC sp_addpublication 
    @publication = @publication, 
    @status = N'active',
    @allow_push = N'true',
    @allow_pull = N'true',
    @independent_agent = N'true';

-- Create a new snapshot job for the publication, using a default schedule.
EXEC sp_addpublication_snapshot 
    @publication = @publication, 
    @job_login = @login, 
    @job_password = @password,
    -- Explicitly specify the use of Windows Integrated Authentication (default) 
    -- when connecting to the Publisher.
    @publisher_security_mode = 1;
GO

Ayrıca bkz.

Başvuru

için yürütme eşdeğerdirsp_addpublication (Transact-sql)

sp_changelogreader_agent (Transact-sql)

Çoğaltma depolanan yordamlar (Transact-sql)

Kavramlar

Yayın oluşturma