sp_changepublication_snapshot (Transact-SQL)
Propriedades de alteração do Snapshot Agent para a publicação especificada. Esse procedimento armazenado é executado no Publicador, no banco de dados de publicação.
Observação sobre segurança |
---|
Quando um Publicador é configurado com um Distribuidor remoto, os valores fornecidos para todos os parâmetros, inclusive job_login e job_password, são enviados ao Distribuidor como texto sem formatação. Você deve criptografar a conexão entre o Publicador e seu Distribuidor remoto antes de executar esse procedimento armazenado. Para obter mais informações, consulte Criptografando conexões com o SQL Server. |
Sintaxe
sp_changepublication_snapshot [ @publication= ] 'publication'
[ , [ @frequency_type= ] frequency_type ]
[ , [ @frequency_interval= ] frequency_interval ]
[ , [ @frequency_subday= ] frequency_subday ]
[ , [ @frequency_subday_interval= ] frequency_subday_interval ]
[ , [ @frequency_relative_interval= ] frequency_relative_interval ]
[ , [ @frequency_recurrence_factor= ] frequency_recurrence_factor ]
[ , [ @active_start_date= ] active_start_date ]
[ , [ @active_end_date= ] active_end_date ]
[ , [ @active_start_time_of_day= ] active_start_time_of_day ]
[ , [ @active_end_time_of_day= ] active_end_time_of_day ]
[ , [ @snapshot_job_name = ] 'snapshot_agent_name' ]
[ , [ @publisher_security_mode = ] publisher_security_mode ]
[ , [ @publisher_login = ] 'publisher_login' ]
[ , [ @publisher_password = ] 'publisher_password' ]
[ , [ @job_login = ] 'job_login' ]
[ , [ @job_password = ] 'job_password' ]
[ , [ @publisher = ] 'publisher' ]
Argumentos
[ @publication =] 'publication'
É o nome da publicação. publication é sysname, sem padrão.[ @frequency_type =] frequency_type
É a freqüência de agendamento do agente. frequency_type é int, e pode ser um dos valores a seguir.Valor
Descrição
1
Uma vez
2
Sob demanda
4
Diariamente
8
Semanalmente
16
Mensalmente
32
Relativo ao mês
64
Autoiniciar
128
Recorrente
NULL (padrão)
[ @frequency_interval =] frequency_interval
Especifica os dias de execução do agente. frequency_interval é int, e pode ser um dos valores a seguir.Valor
Descrição
1
Domingo
2
Segunda-feira
3
Terça-feira
4
Quarta-feira
5
Quinta-feira
6
Sexta-feira
7
Sábado
8
Dia
9
Dias da semana
10
Dias de fim de semana
NULL (padrão)
[ @frequency_subday =] frequency_subday
É a unidade para freq_subday_interval. frequency_subday is int, e pode ser um destes valores.Valor
Descrição
1
Uma vez
2
Segundo
4
Minuto
8
Hora
NULL (padrão)
[ @frequency_subday_interval =] frequency_subday_interval
É o intervalo de frequency_subday. frequency_subday_interval é int, com um padrão NULL.[ @frequency_relative_interval =] frequency_relative_interval
É a data de execução do Snapshot Agent. frequency_relative_interval é int, com um padrão NULL.[ @frequency_recurrence_factor =] frequency_recurrence_factor
É o fator de recorrência usado pelo frequency_type. frequency_recurrence_factor is int, com um padrão NULL.[ @active_start_date =] active_start_date
É a data do primeiro agendamento do Snapshot Agent, formatada como YYYYMMDD. active_start_date é int, com um padrão NULL.[ @active_end_date =] active_end_date
É a data do último agendamento do Snapshot Agent, formatada como YYYYMMDD. active_end_date é int, com um padrão NULL.[ @active_start_time_of_day =] active_start_time_of_day
É a hora do dia do primeiro agendamento do Snapshot Agent, formatada como HHMMSS. active_start_time_of_day é int, com um padrão de NULL.[ @active_end_time_of_day =] active_end_time_of_day
É a hora do dia em que o Snapshot Agent deixa de ser agendado, formatada como HHMMSS. active_end_time_of_day é int, com um padrão NULL.[ @snapshot_job_name = ] 'snapshot_agent_name'
É o nome de um trabalho existente de Snapshot Agent se um trabalho existente estiver sendo usado. snapshot_agent_name é nvarchar(100) com um valor padrão de NULL.[ @publisher_security_mode = ] publisher_security_mode
É o modo de segurança usado pelo agente ao se conectar ao Publicador. publisher_security_mode é smallint, com um padrão NULL. 0 especifica Autenticação do SQL Server e 1 especifica Autenticação do Windows. Um valor de 0 deve ser especificado para Publicadores não-SQL Server.Observação sobre segurança Quando possível, use a Autenticação do Windows.
[ @publisher_login = ] 'publisher_login'
É o logon usado na conexão com o Publicador. publisher_login é sysname, com um padrão NULL. publisher_login deve ser especificado quando publisher_security_mode é 0. Se publisher_login for NULL e publisher_security_mode for 1, então a conta do Windows especificada em job_login será usada na conexão com o Publicador.[ @publisher_password = ] 'publisher_password'
É a senha usada na conexão com o Publicador. publisher_password é sysname, com um padrão de NULL.Observação sobre segurança Não use uma senha em branco. Use uma senha forte. Quando possível, solicite que os usuários insiram as credenciais de segurança em tempo de execução. Se for necessário armazenar credenciais em um arquivo de script, proteja o arquivo para evitar o acesso não autorizado.
[ @job_login = ] 'job_login'
É o logon para a conta do Windows na qual o agente é executado. job_login é nvarchar(257), com um padrão NULL. Esta conta do Windows sempre é usada para conexões de agente com o Distribuidor. Você deve fornecer esse parâmetro ao criar um novo trabalho do Snapshot Agent. Isso não pode ser alterado para um editor não-SQL Server.[ @job_password = ] 'job_password'
É a senha para a conta do Windows na qual o agente é executado. job_password é sysname, com um padrão NULL. Você deve fornecer esse parâmetro ao criar um novo trabalho do Snapshot Agent.Observação sobre segurança Quando possível, solicite que os usuários insiram as credenciais de segurança em tempo de execução. Sendo necessário armazenar credenciais em um arquivo de script, proteja o arquivo para evitar acesso não autorizado.
[ @publisher = ] 'publisher'
Especifica um Publicador não-SQL Server. publisher é sysname, com um padrão de NULL.Observação publisher Não deveria ser usado ao criar um Snapshot Agent em um Publicador SQL Server.
Valores de código de retorno
0 (êxito) ou 1 (falha)
Comentários
sp_changepublication_snapshot é usado em replicação de instantâneo, replicação transacional e replicação de mesclagem.
Permissões
Somente membros da função de servidor fixa sysadmin ou da função de banco de dados fixa db_owner podem executar sp_changepublication_snapshot.