sys.sp_changepublication_snapshot (Transact-SQL)

Aplica-se a: SQL ServerAzure SQL Managed Instance

Altera as propriedades do Snapshot Agent para a publicação especificada. Este procedimento armazenado é executado no Publisher no banco de dados de publicação.

Important

Quando configura um Publisher com um Distribuidor remoto, os valores fornecidos para todos os parâmetros, incluindo @job_login e @job_password, são enviados ao Distribuidor em texto simples. Deve encriptar a ligação entre o Publisher e o seu Distribuidor remoto antes de executar este procedimento armazenado. Para obter mais informações, consulte Configurar o Mecanismo de Banco de Dados do SQL Server para criptografar conexões.

Transact-SQL convenções de sintaxe

Syntax

sys.sp_changepublication_snapshot
    [ @publication = ] N'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 = ] N'snapshot_job_name' ]
    [ , [ @publisher_security_mode = ] publisher_security_mode ]
    [ , [ @publisher_login = ] N'publisher_login' ]
    [ , [ @publisher_password = ] N'publisher_password' ]
    [ , [ @job_login = ] N'job_login' ]
    [ , [ @job_password = ] N'job_password' ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @job_security_mode = ] job_security_mode ]
[ ; ]

Arguments

[ @publication = ] N'publicação'

O nome da publicação. @publication é sysname, sem padrão.

[ @frequency_type = ] frequency_type

Especifica a frequência com que agendar o agente. @frequency_type é int, e pode ser um dos seguintes valores.

Value Description
1 Uma vez
2 A pedido
4 Diariamente
8 Semanalmente
16 Monthly
32 Parente mensal
64 Arranque automático
128 Recorrente
NULL (padrão)

[ @frequency_interval = ] frequency_interval

Especifica os dias em que o agente opera. @frequency_interval é int, e pode ser um dos seguintes valores.

Value Description
1 Domingo
2 Segunda-feira
3 Tuesday
4 Quarta-feira
5 Quinta-feira
6 Sexta-feira
7 Sábado
8 Dia
9 Dias úteis
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.

Value Description
1 Uma vez
2 Second
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 Snapshot Agent é executado. @frequency_relative_interval é int, com um padrão de NULL.

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

O fator de recorrência utilizado por @frequency_type. @frequency_recurrence_factor é int, com um padrão de NULL.

[ @active_start_date = ] active_start_date

A data em que o Snapshot Agent é agendado pela primeira vez, formatada como yyyyMMdd. @active_start_date é int, com um padrão de NULL.

[ @active_end_date = ] active_end_date

A data em que o Snapshot Agent deixa de ser agendado, formatada como yyyyMMdd. @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 Snapshot Agent é inicialmente agendado, 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 o Snapshot Agent deixa de ser agendado, formatada como HHmmss. @active_end_time_of_day é int, com um padrão de NULL.

[ @snapshot_job_name = ] N'snapshot_job_name'

O nome de um emprego Snapshot Agent existente, caso um trabalho já existente esteja a ser utilizado. @snapshot_job_name é nvarchar(100), com um padrão de NULL.

[ @publisher_security_mode = ] publisher_security_mode

O modo de segurança usado pelo agente ao ligar-se ao Publisher. @publisher_security_mode é int, com um padrão de NULL. Um valor de 0 deve ser especificado para editores que não sejam SQL Server.

  • 0 especifica autenticação SQL Server
  • 1 especifica autenticação no Windows

Important

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

[ @publisher_login = ] N'publisher_login'

O login usado ao ligar-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 NULL e @publisher_security_mode for 1, então a conta Windows especificada em @job_login é usada ao ligar à Publisher.

[ @publisher_password = ] N'publisher_password'

A palavra-passe usada ao ligar-se ao Publisher. @publisher_password é sysname, com um padrão de NULL.

Important

Não utilize uma palavra-passe em branco. Use uma senha forte. Quando possível, solicite que os usuários insiram credenciais de segurança em tempo de execução. Se você precisar armazenar credenciais em um arquivo de script, deverá proteger o arquivo para impedir o acesso não autorizado.

[ @job_login = ] N'job_login'

O login da conta Windows com a qual o agente corre. @job_login é nvarchar(257), com um padrão de NULL. Esta conta do Windows é sempre usada para ligações de agentes ao Distribuidor. Deve fornecer este parâmetro ao criar um novo trabalho do Snapshot Agent. Isto não pode ser alterado para um editor que não seja SQL Server.

[ @job_password = ] N'job_password'

A palavra-passe da conta Windows com a qual o agente corre. @job_password é sysname, com um padrão de NULL. Deve fornecer este parâmetro ao criar um novo trabalho do Snapshot Agent.

Important

Quando possível, solicite que os usuários insiram credenciais de segurança em tempo de execução. Se você precisar armazenar credenciais em um arquivo de script, deverá proteger o arquivo para impedir o acesso não autorizado.

@publisher [ = ] N'editor'

Especifica um editor que não seja SQL Server. @publisher é sysname, com um padrão de NULL.

Note

@publisher não deve ser usado ao criar um Snapshot Agent num SQL Server Publisher.

[ @job_security_mode = ] job_security_mode

Identificado apenas para fins informativos. Não suportado. A compatibilidade futura não é garantida.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

sp_changepublication_snapshot é usado na replicação de snapshot, replicação transacional e replicação de mesclagem.

Permissions

Apenas os membros do papel fixo de servidor administrador do sistema ou db_owner papel fixo de base de dados podem executar sp_changepublication_snapshot.