sp_changepublication_snapshot (Transact-SQL)
Aplica-se a:SQL ServerInstância Gerenciada de SQL do Azure
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, confira Habilitar conexões criptografadas para o mecanismo de banco de dados (SQL Server Configuration Manager).
Convenções de sintaxe de 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 com que agendar o agente. frequency_type é int e pode ser um dos seguintes valores.
Valor | Description |
---|---|
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 seguintes valores.
Valor | Description |
---|---|
1 | Sunday |
2 | Monday |
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 para freq_subday_interval. frequency_subday é int, e pode ser um desses valores.
Valor | 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 de execução do Snapshot Agent. 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, formatado 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, formatado 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 é 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 o Snapshot Agent para de ser agendado, formatado 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 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 de NULL. 0 especifica a Autenticação do SQL Server e 1 especifica a Autenticação do Windows. Um valor 0 deve ser especificado para Publicadores que não sejam do SQL Server.
Importante
Quando possível, use a autenticação do Windows.
[ @publisher_login = ] 'publisher_login'
É o login usado ao se conectar ao Publicador. publisher_login é sysname, com um padrão de NULL. publisher_login deve ser especificado quando publisher_security_mode for 0. Se publisher_login for NULL e publisher_security_mode for 1, a conta do Windows especificada em job_login será usada ao se conectar ao Publicador.
[ @publisher_password = ] 'publisher_password'
É a senha usada ao se conectar ao Publicador. 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 da conta do 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 editor que não seja do SQL Server.
[ @job_password = ] 'job_password'
É a senha da conta do 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 editor que não seja do SQL Server. publisher é sysname, com um padrão de NULL.
Observação
publisher não deve ser usado ao criar um Snapshot Agent em um SQL Server Publisher.
Valores do código de retorno
0 (sucesso) ou 1 (fracasso)
Comentários
sp_changepublication_snapshot é usado na replicação de snapshot, replicação transacional e replicação de mesclagem.
Permissões
Somente membros da função de servidor fixa sysadmin ou db_owner função de banco de dados fixa podem executar sp_changepublication_snapshot.
Confira 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)
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de