sp_changepublication_snapshot (Transact-SQL)

Artigo
05/07/2013

Propriedades de alteração do Agente de Instantâneo para a publicação especificada. Esse procedimento armazenado é executado no Publicador, no banco de dados publicador.

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 Habilitar conexões criptografadas no Mecanismo de Banco de Dados (SQL Server Configuration Manager).

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 Habilitar conexões criptografadas no Mecanismo de Banco de Dados (SQL Server Configuration Manager).

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

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 frequê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

Iniciar automaticamente

128

Recorrente

NULL (padrão)

Valor	Descrição
1	Uma vez
2	Sob demanda
4	Diariamente
8	Semanalmente
16	Mensalmente
32	Relativo ao mês
64	Iniciar automaticamente
128	Recorrente
NULL (padrão)

[ @frequency_interval =] frequency_interval
Especifica os dias em que o agente é executado. 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
São as unidades de freq_subday_interval. frequency_subday é int, e pode ter 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 para frequency_subday. frequency_subday_interval é int, com um padrão de NULL.
[ @frequency_relative_interval =] frequency_relative_interval
É a data de execução do Agente de Instantâneo. frequency_relative_interval é int, com um padrão de NULL.
[ @frequency_recurrence_factor =] frequency_recurrence_factor
É o fator de recorrência usado por frequency_type. frequency_recurrence_factor é int, com um padrão de NULL.
[ @active_start_date =] active_start_date
É a data do primeiro agendamento do Agente de Instantâneo, formatada como AAAAMMDD. active_start_date é int, com um padrão de NULL.
[ @active_end_date =] active_end_date
É a data em que o Agente de Instantâneo para de ser agendado, formatada como AAAAMMDD. active_end_date é int, com um padrão de NULL.
[ @active_start_time_of_day =] active_start_time_of_day
É a hora do dia do primeiro agendamento do Agente de Instantâneo, 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 do último agendamento do Agente de Instantâneo, formatada como HHMMSS. active_end_time_of_day é int, com um padrão de NULL.
[ @snapshot_job_name = ] 'snapshot_agent_name'
É o nome de um trabalho existente do Agente de Instantâneo se um trabalho existente estiver sendo usado. snapshot_agent_name é nvarchar(100) com o valor padrão de NULL.
[ @publisher_security_mode = ] publisher_security_mode
É o modo de segurança usado pelo agente ao conectar-se ao Publicador. publisher_security_mode é smallint, com um padrão de 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 de 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.

Valor	Descrição
1	Uma vez
2	Segundo
4	Minuto
8	Hora
NULL (padrão)

Observação sobre segurança
Quando possível, use a Autenticação do Windows.

[ @publisher_password = ] 'publisher_password'
É a senha usada ao conectar-se ao 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, você deverá proteger o arquivo para impedir acesso não autorizado.

[ @job_login = ] 'job_login'
É o logon da conta do Windows na qual o agente é executado. job_login é nvarchar(257), com um padrão de NULL. Essa 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 Agente de Instantâneo. Isso não pode ser alterado para um editor não SQL Server.

[ @job_password = ] 'job_password'
É a senha da conta do Windows na qual o agente é executado. job_password é sysname, com um padrão de NULL. Você deve fornecer esse parâmetro ao criar um novo trabalho do Agente de Instantâneo.

Observação sobre segurança
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, você deverá proteger o arquivo para impedir acesso não autorizado.

[ @publisher = ] 'publisher'
Especifica um publicador que não é do SQL Server. publisher é sysname, com um padrão de NULL.

Observação

publisher Não deveria ser usado ao criar um Agente de Instantâneo em um Publicador SQL Server.

Observação
publisher Não deveria ser usado ao criar um Agente de Instantâneo 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.