sp_MSchange_snapshot_agent_properties (Transact-SQL)
Aplica-se a:
SQL Server
Altera as propriedades de um trabalho do Snapshot Agent executado em um Distribuidor do Microsoft SQL Server 2005 (9.x) ou versão posterior. Esse procedimento armazenado é usado para alterar propriedades quando o Publicador é executado em uma instância do Microsoft SQL Server 2000 (8.x). Esse procedimento armazenado é executado no Distribuidor, no banco de dados de distribuição.
Convenções de sintaxe de Transact-SQL
Sintaxe
sp_MSchange_snapshot_agent_properties [ @publisher = ] 'publisher'
, [ @publisher_db = ] 'publisher_db'
, [ @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_type = ] 'publisher_type'
Argumentos
[ @publisher = ] 'publisher' É o nome do Editor. publisher é sysname, sem padrão.
[ @publisher_db = ] 'publisher_db' É o nome do banco de dados de publicação. publisher_db é sysname, sem padrão.
[ @publication = ] 'publication' É o nome da publicação. publication é sysname, sem padrão.
[ @frequency_type = ] frequency_type É a frequência com que o Snapshot Agent é executado. frequency_type é int, e pode ser um desses valores.
| Valor | Description |
|---|---|
| 1 | Uma vez |
| 2 | Sob demanda |
| 4 | Diariamente |
| 8 | Semanalmente |
| 10 | Mensal |
| 20 | Mensalmente, relativo ao intervalo de frequência |
| 40 | Quando o SQL Server Agent é iniciado |
[ @frequency_interval = ] frequency_interval É o valor a ser aplicado à frequência definida por frequency_type. frequency_interval é int, sem 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 |
[ @frequency_subday_interval = ] frequency_subday_interval É o intervalo para frequency_subday. frequency_subday_interval é int, sem padrão.
[ @frequency_relative_interval = ] frequency_relative_interval É a data de execução do Snapshot Agent. frequency_relative_interval é int, sem padrão.
[ @frequency_recurrence_factor = ] frequency_recurrence_factor É o fator de recorrência utilizado por frequency_type. frequency_recurrence_factor é int, sem padrão.
[ @active_start_date = ] active_start_date É a data em que o Snapshot Agent é agendado pela primeira vez, formatado como yyyyMMdd. active_start_date é int, sem padrão.
[ @active_end_date = ] active_end_date É a data em que o Snapshot Agent deixa de ser agendado, formatado como yyyyMMdd. active_end_date é int, sem padrão.
[ @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, sem padrão.
[ @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, sem padrão.
[ @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), sem padrão.
[ @publisher_security_mode = ] publisher_security_mode É o modo de segurança usado pelo agente ao se conectar ao Publicador. publisher_security_mode é int, sem padrão. 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. Quando possível, use a autenticação do Windows.
[ @publisher_login = ] 'publisher_login' É o login usado ao se conectar ao Publicador. publisher_login é sysname, sem padrão. 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 é nvarchar(524), sem padrão.
Importante
Não armazene informações de autenticação em arquivos de script. Para ajudar a melhorar a segurança, recomendamos que você forneça nomes de login e senhas em tempo de execução.
[ @job_login = ] 'job_login' É o logon da conta do Windows sob a qual o agente é executado. job_login é nvarchar(257), sem padrão. 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 Publicador 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, sem padrão. Você deve fornecer esse parâmetro ao criar um novo trabalho do Agente de Instantâneo.
Importante
Não armazene informações de autenticação em arquivos de script. Para ajudar a melhorar a segurança, recomendamos que você forneça nomes de login e senhas em tempo de execução.
[ @publisher_type = ] 'publisher_type' Especifica o tipo de Publicador quando o Publicador não está em execução em uma instância do SQL Server. publisher_type é sysname e pode ser um dos seguintes valores.
| Valor | Descrição |
|---|---|
| MSSQLSERVER | Especifica um Publicador do SQL Server. |
| ORÁCULO | Especifica um Publicador Oracle padrão. |
| ORACLE GATEWAY | Especifica um Editor Oracle Gateway. |
Para obter mais informações sobre as diferenças entre um Oracle Publisher e um Oracle Gateway Publisher, consulte Oracle Publishing Overview.
Valores do código de retorno
0 (sucesso) ou 1 (fracasso)
Comentários
sp_MSchange_snapshot_agent_properties é usado na replicação de snapshot, replicação transacional e replicação de mesclagem.
Você deve especificar todos os parâmetros ao executar sp_MSchange_snapshot_agent_properties. Execute sp_helppublication_snapshot para retornar as propriedades atuais do trabalho do Snapshot Agent.
Quando o Publicador é executado em uma instância do SQL Server 2005 (9.x) ou versão posterior, você deve usar sp_changepublication_snapshot para alterar as propriedades de um trabalho do Snapshot Agent.
Permissões
Somente membros da função de servidor fixa sysadmin no Distribuidor podem executar sp_MSchange_snapshot_agent_properties.
Confira também
Comentários
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, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de