sp_changepublication_snapshot (Transact-SQL)

Aplica-se a: simSQL Server (todas as versões compatíveis) SimInstância Gerenciada do Azure SQL

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.

Importante

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

Ícone de link do 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. a publicação é sysname, sem padrão.

[ @frequency_type = ] frequency_type É a frequência com a qual agendar o 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 Mensal
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 Sunday
2 Monday
3 Terça-feira
4 Quarta-feira
5 Quinta-feira
6 Friday
7 Sábado
8 Dia
9 Dias da semana
10 Dias de fim de semana
NULL (padrão)

[ @frequency_subday = ] frequency_subday É as unidades para freq_subday_interval. frequency_subday é int e pode ser um desses 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 em que o Agente de Instantâneo é executado. frequency_relative_interval é int, com um padrão de NULL.

[ @frequency_recurrence_factor = ] frequency_recurrence_factor É o fator de recorrência usado pelo frequency_type. frequency_recurrence_factor é int, com um padrão de NULL.

[ @active_start_date = ] active_start_date É a data em que o Agente de Instantâneo é agendado pela primeira vez, formatado como AAAAMMDD. active_start_date é int, com um padrão de NULL.

[ @active_end_date = ] active_end_date É a data em que a Agente de Instantâneo para de ser agendada, 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 em que o Agente de Instantâneo é agendado pela primeira vez, formatado 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 a Agente de Instantâneo para de ser agendada, 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 nome de trabalho de Agente de Instantâneo existente 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 Publisher. publisher_security_mode é smallint, com um padrão de NULL. 0 especifica a SQL Server autenticação e 1 especifica Windows autenticação. Um valor de 0 deve ser especificado para não SQL Server Publicadores.

Importante

Quando possível, use a autenticação do Windows.

[ @publisher_login = ] 'publisher_login'É o logon usado ao conectar-se ao Publisher. publisher_login é sysname, com um padrão de NULL. publisher_login deve ser especificado quando publisher_security_mode é 0. se publisher_login for nulo e publisher_security_mode for 1, a conta de Windows especificada em job_login será usada ao conectar-se à Publisher.

[ @publisher_password = ] 'publisher_password'É a senha usada ao conectar-se ao Publisher. publisher_password é sysname, com um padrão de NULL.

Importante

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 para a conta de Windows sob a 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 não SQL Server Publicador.

[ @job_password = ] 'job_password'é a senha para a conta de Windows sob a 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.

Importante

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 não SQL Server Publicador. o Publicador é sysname, com um padrão de NULL.

Observação

o Publicador não deve ser usado ao criar um agente de instantâneo em um SQL Server Publisher.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_changepublication_snapshot é usado na replicação de instantâneos, na replicação transacional e na replicação de mesclagem.

Permissões

Somente os membros da função de servidor fixa sysadmin ou db_owner função de banco de dados fixa podem ser executados sp_changepublication_snapshot.

Consulte Também

Exibir e modificar as propriedades da publicação
Alterar propriedades da publicação e do artigo
sp_addpublication_snapshot (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)