sp_MSchange_snapshot_agent_properties (Transact-SQL)
Aplica-se a: SQL Server
Altera as propriedades de um trabalho do Snapshot Agent que é 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 em que o Snapshot Agent é executado. frequency_relative_interval é int, sem padrão.
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
É o fator de recorrência usado 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 deixa 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 nome de trabalho do Snapshot Agent existente 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 de 0 deve ser especificado para Publicadores não SQL Server. Quando possível, use a autenticação do Windows.
[ @publisher_login = ] 'publisher_login'
É o logon 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 |
---|---|
servidor MSSQL | 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 Publicador Oracle e um Publicador Oracle Gateway, consulte Visão geral da publicação Oracle.
Valores do código de retorno
0 (sucesso) ou 1 (falha)
Comentários
sp_MSchange_snapshot_agent_properties é usado na replicação de instantâneo, 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.