sp_addlogreader_agent (języka Transact-SQL)

Dodaje agenta czytnik dziennika dla danej bazy danych.Ta procedura składowana jest wykonywany na Wydawca na bazie publikacja.

Uwaga dotycząca zabezpieczeńUwaga dotycząca zabezpieczeń

Podczas konfigurowania Publisher z dystrybutor zdalny, wartości dostarczone dla wszystkich parametrów, łącznie z job_login i job_password, są wysyłane do dystrybutora jako zwykły tekst.Należy zaszyfrować połączenie między wydawcy i jego dystrybutor zdalny przed wykonywania tej procedura składowana.Aby uzyskać więcej informacji, zobacz Szyfrowania połączeńSQL Server.

Ikona łącza do tematuKonwencje składni Transact-SQL

Składnia

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' ]

Argumenty

  • [ @ job_login=] 'job_login"
    Jest logowania dla Microsoft konta systemu Windows, na którym działa agent. job_login jest nvarchar(257), o wartości domyślnej NULL.To konto systemu Windows jest zawsze używana dla połączeń agenta do dystrybutora.

    Ostrzeżenie

    For non-Microsoft SQL Server Publishers, this must be the same login specified in sp_adddistpublisher (języka Transact-SQL).

  • [ @ job_password=] 'job_password"
    Is the password for the Windows account under which the agent runs.job_password is sysname, with a default value of NULL.

    Uwaga dotycząca zabezpieczeńUwaga dotycząca zabezpieczeń

    Nie przechowuj uwierzytelnianie informacji w plikach skryptów.Najlepiej nazwy logowania i hasła powinien być dostarczony w czasie wykonywania.

  • [ @ job_name=] 'job_name"
    Is the name of an existing agent job.job_name is sysname, with a default value of NULL.Ten parametr jest określony tylko rozpoczęcie agent przy użyciu istniejącego zadania zamiast nowo utworzone zadanie (domyślnie).

  • [ @ publisher_security_mode=] publisher_security_mode
    Is the security mode used by the agent when connecting to the Publisher.publisher_security_mode is smallint, with a default of 1.0 Określa SQL Server uwierzytelniania, i 1 Określa uwierzytelnianie systemu Windows.Wartość 0 musi być określona dla nie-SQL Server wydawcy.

  • [ @ publisher_login=] 'publisher_login"
    Is the login used when connecting to the Publisher.publisher_login is sysname, with a default of NULL.publisher_login must be specified when publisher_security_mode is 0.Jeśli publisher_login ma wartość NULL i publisher_security_mode jest 1, a następnie konto systemu Windows, określone w job_login będą używane podczas łączenia się z Wydawca.

  • [ @ publisher_password=] 'publisher_password"
    Is the password used when connecting to the Publisher.publisher_password is sysname, with a default of NULL.

    Uwaga dotycząca zabezpieczeńUwaga dotycząca zabezpieczeń

    Nie przechowuj uwierzytelnianie informacji w plikach skryptów.Najlepiej nazwy logowania i hasła powinien być dostarczony w czasie wykonywania.

  • [ program publisher @ =] 'publisher"
    Jest to nazwa bez-SQL Server Wydawca. publisher jest sysname, domyślna wartość NULL.

    Ostrzeżenie

    Nie należy określać ten parametr dla SQL Server Wydawca.

Wartości kodów powrotnych

0 (sukces) lub 1 (błąd)

Uwagi

sp_addlogreader_agent w replikacja transakcyjna.

Należy wykonać sp_addlogreader_agent Aby dodać agenta czytnik dziennika po uaktualnieniu bazy danych, która została włączona replikacja do tej wersja SQL Server przed utworzeniem publikacja, który używany bazy danych.

Uprawnienia

Tylko członkowie sysadmin stała rola serwera lub db_owner ustaloną rola bazy danych można wykonać sp_addlogreader_agent.

Przykład

-- 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'AdventureWorks2008R2'; 
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