Replication Snapshot Agent

O Replication Snapshot Agent é um arquivo executável que prepara arquivos de instantâneo contendo esquema e dados de tabelas publicadas e objetos do banco de dados, armazena os arquivos na pasta de instantâneo e registra trabalhos de sincronização no banco de dados de distribuição.

Observação
Os parâmetros podem ser especificados em qualquer ordem.

Sintaxe

snapshot [ -?] 
-Publisher server_name[\instance_name] 
-Publication publication_name 
[-70Subscribers] 
[-BcpBatchSize bcp_batch_size]
[-DefinitionFile def_path_and_file_name]
[-Distributor server_name[\instance_name]]
[-DistributorDeadlockPriority [-1|0|1] ]
[-DistributorLogin distributor_login]
[-DistributorPassword distributor_password]
[-DistributorSecurityMode [0|1] ]
[-DynamicFilterHostName dynamic_filter_host_name]
[-DynamicFilterLogin dynamic_filter_login]
[-DynamicSnapshotLocation dynamic_snapshot_location] 
[-EncryptionLevel [0|1|2]]
[-FieldDelimiter field_delimiter]
[-HistoryVerboseLevel [0|1|2|3] ]
[-HRBcpBlocks number_of_blocks ]
[-HRBcpBlockSize block_size ]
[-HRBcpDynamicBlocks ]
[-KeepAliveMessageInterval keep_alive_interval]
[-LoginTimeOut login_time_out_seconds]
[-MaxBcpThreads number_of_threads ]
[-MaxNetworkOptimization [0|1]]
[-Output output_path_and_file_name]
[-OutputVerboseLevel [0|1|2] ]
[-PacketSize packet_size]
[-ProfileName profile_name]
[-PublisherDB publisher_database]
[-PublisherDeadlockPriority [-1|0|1] ]
[-PublisherFailoverPartner server_name[\instance_name] ]
[-PublisherLogin publisher_login]
[-PublisherPassword publisher_password] 
[-PublisherSecurityMode [0|1] ]
[-QueryTimeOut query_time_out_seconds]
[-ReplicationType [1|2] ]
[-RowDelimiter row_delimiter]
[-StartQueueTimeout start_queue_timeout_seconds]
[-UsePerArticleContentsView use_per_article_contents_view]

Argumentos

• -?
  Imprime todos os parâmetros disponíveis.

• -Publisher server_name[**\instance_name]
  É o nome do Publicador. Especifica server_name para a ocorrência padrão do Microsoft SQL Server naquele servidor. Especifique server_name\**instance_name para uma instância nomeada do SQL Server naquele servidor.

• -Publicationpublication
  É o nome da publicação. Esse parâmetro só é válido se a publicação estiver definida para ter sempre um instantâneo disponível para assinaturas novas ou reiniciadas.

• -70Subscribers
  Deve ser usado se qualquer Assinante estiver executando SQL Server versão 7.0.

• -BcpBatchSizebcp_ batch_ size
  É o número de linhas a ser enviado em uma operação de cópia em massa. Ao executar uma operação bcp in, o tamanho do lote é o número de linhas a ser enviado ao servidor como uma transação, e também o número de linhas que deve ser enviado antes que o Distribution Agent registre uma mensagem de progresso bcp. Ao executar uma operação bcp out , um tamanho fixo de lote de 1000 é usado. Um valor de 0 indica que não houve registro de mensagem.

• -DefinitionFiledef_path_and_file_name
  É o caminho do arquivo de definição do agente. Um arquivo de definição de agente contém argumentos de linha de comando para o agente. O conteúdo do arquivo é analisado como um arquivo executável. Use aspas duplas (") para especificar valores de argumentos que contêm caracteres arbitrários.

• -Distributorserver_name[**\instance_name]
  É o nome do Distribuidor. Especifique server_name para a instância padrão do SQL Server naquele servidor. Especifique server_name\**instance_name para uma instância nomeada do SQL Server naquele servidor.

• -DistributorDeadlockPriority [-1|0|1]
  É a prioridade da conexão do Snapshot Agent com o Distribuidor quando um deadlock ocorre. Esse parâmetro é especificado para resolver deadlocks que possam ocorrer entre o Snapshot Agent e aplicativos de usuário durante a geração de instantâneo.

  Valor DistributorDeadlockPriority	Descrição
  -1	Aplicativos diferentes do Snapshot Agent têm prioridade quando ocorre um deadlock no Distribuidor.
  0 (padrão)	A prioridade não é atribuída.
  1	O Snapshot Agent tem prioridade quando um deadlock ocorre no Distribuidor.

• -DistributorLogindistributor_login
  É o logon usado ao se conectar ao Distribuidor usando a Autenticação do SQL Server.

• -DistributorPassworddistributor_password
  É a senha usada ao se conectar ao Distribuidor usando a Autenticação do SQL Server. .

• -DistributorSecurityMode [ 0| 1]
  Especifica o modo de segurança do Distribuidor. Um valor de 0 indica Modo (padrão) de Autenticação do SQL Server e um valor de 1 indica Modo de Autenticação do Windows.

• -DynamicFilterHostNamedynamic_filter_host_name
  É usado para definir um valor para HOST_NAME (Transact-SQL) na filtragem quando um instantâneo dinâmico é criado. Por exemplo, se a cláusula de filtro de subconjunto rep_id = HOST_NAME() for especificada para um artigo e você definir a propriedade DynamicFilterHostName como "FBJones" antes de chamar o Merge Agent, somente linhas com "FBJones" na coluna rep_id serão replicadas.

• -DynamicFilterLogindynamic_filter_login
  Usado para definir um valor para SUSER_SNAME (Transact-SQL)na filtragem quando um instantâneo dinâmico é criado. Por exemplo, se a cláusula de filtro de subconjunto user_id = SUSER_SNAME() for especificada para um artigo e você definir a propriedade DynamicFilterLogin como "rsmith" antes de chamar o método Run do objeto SQLSnapshot, somente linhas com "rsmith" na coluna user_id serão incluídas no instantâneo.

• -DynamicSnapshotLocationdynamic_snapshot_location
  É o local onde o instantâneo dinâmico deve ser gerado.

• -EncryptionLevel [ 0 | 1 | 2 ]
  É o nível da criptografia SSL (Secure Sockets Layer) usada pelo Snapshot Agent ao fazer conexões.

  Valor EncryptionLevel	Descrição
  0	Especifica que o SSL não é usado.
  1	Especifica que o SSL é usado, mas o agente não verifica se o certificado de servidor SSL é assinado por um emissor confiável.
  2	Especifica que o SSL é usado e que o certificado é verificado.

  Para obter mais informações, consulte Visão geral de segurança (Replicação).

• -FieldDelimiterfield_delimiter
  É o caractere ou cadeia de caracteres que marca o fim de um campo no arquivo de dados de cópia em massa no SQL Server. O padrão é \n<x$3>\n.

• -HistoryVerboseLevel [ 1| 2| 3]
  Especifica a quantidade de histórico registrada durante uma operação de instantâneo. Você pode minimizar o efeito de registro de histórico no desempenho selecionando 1.

  Valor HistoryVerboseLevel	Descrição
  0	Mensagens de progresso são gravadas no console ou em um arquivo de saída. Registros de histórico não são registrados no banco de dados de distribuição.
  1	Sempre atualize uma mensagem de histórico anterior do mesmo status (inicialização, progresso, sucesso, e assim por diante). Se nenhum registro anterior com o mesmo status existir, insira um registro novo.
  2 (padrão)	Insira novos registros de histórico, a menos que o registro seja para coisas como mensagens ociosas ou mensagens de trabalho de execução longa; em tal caso, atualize os registros anteriores.
  3	Sempre insira novos registros, a menos que seja para mensagens ociosas.

• -HRBcpBlocksnumber_of_blocks
  É o número de blocos de dados bcp enfileirados entre os threads de leitura e gravação. O valor padrão é 50. HRBcpBlocks só é usado com publicações Oracle.

  Observação
  Esse parâmetro é usado para ajuste de desempenho do desempenho de bcp de um Publicador Oracle.

• --HRBcpBlockSizeblock_size
  É o tamanho, em kilobyte (KB), de cada bloco de dados bcp. O valor padrão é 64 KB. HRBcpBlocks só é usado com publicações Oracle.

  Observação
  Esse parâmetro é usado para ajuste de desempenho do desempenho de bcp de um Publicador Oracle.

• -HRBcpDynamicBlocks
  Se o tamanho de cada bloco de dados bcp pode ou não crescer dinamicamente. HRBcpBlocks só é usado com publicações Oracle.

  Observação
  Esse parâmetro é usado para ajuste de desempenho do desempenho de bcp de um Publicador Oracle.

• -KeepAliveMessageIntervalkeep_alive_interval
  É a quantidade de tempo, em segundos, que o Snapshot Agent aguarda antes de registrar "aguardando por mensagem de back-end" na tabela MSsnapshot_history. O valor padrão é 300 segundos.

• -LoginTimeOutlogin_time_out_seconds
  É o número de segundos antes que o logon expire. O padrão é 15 segundos.

• -MaxBcpThreadsnumber_of_threads
  Especifica o número de operações de cópia em massa que podem ser executadas em paralelo. O número máximo de threads e conexões ODBC que existe simultaneamente no menor dos MaxBcpThreads ou o número de solicitações de cópia em massa que aparece na transação sincronizada no banco de dados de distribuição. MaxBcpThreads deve ter um valor maior que 0 e não tem um limite superior embutido em código. O padrão é 1.

• - - MaxNetworkOptimization [ 0| 1]
  Se exclusões irrelevantes forem enviadas ao Assinante. Exclusões irrelevantes são comandos DELETE enviados aos Assinantes por linhas que não pertencem à partição do Assinante. Exclusões irrelevantes não afetam a integridade ou convergência dos dados, mas podem resultar em tráfego de rede desnecessário. O valor padrão de MaxNetworkOptimization é 0. Definindo MaxNetworkOptimization como 1 minimiza as chances de exclusões irrelevantes, reduzindo o tráfego de rede e maximizando a otimização da rede. A definição desse parâmetro como 1 também aumenta o armazenamento de metadados e causa degradação de desempenho no Publicador se vários níveis de filtro de junção e filtros de subconjuntos complexos estiverem presentes. Você deve avaliar com cuidado a topologia da replicação e definir MaxNetworkOptimization como 1 somente se o tráfego de rede de exclusões irrelevantes estiver inaceitavelmente alto.

  Observação
  A definição desse parâmetro como 1 é útil somente quando a opção de otimização de sincronização da publicação de mesclagem é definida como true (o parâmetro @keep_partition_changes de sp_addmergepublication (Transact-SQL)).

• -Outputoutput_path_and_file_name
  É o caminho do arquivo de saída do agente. Se o nome de arquivo não for fornecido, a saída será enviada ao console. Se o nome do arquivo especificado existir, a saída será anexada ao arquivo.

• -OutputVerboseLevel [ 0| 1| 2]
  Especifica se a saída deve ser detalhada.

  Valor OutputVerboseLevel	Descrição
  0	Somente mensagens de erro são impressas.
  1 (padrão)	Todas as mensagens de relatório de progresso são impressas (padrão).
  2	Todas as mensagens de erro e mensagens de relatório de progresso são impressas, o que é útil na depuração.

• -PacketSizepacket_size
  É o tamanho de pacote (em bytes) usado pelo Snapshot Agent na conexão com o SQL Server. O valor padrão é 8192 bytes.

  Observação
  Não altere o tamanho de pacote a menos que você tenha certeza de que melhorará o desempenho. Para a maioria dos aplicativos, o tamanho do pacote padrão é o melhor.

• -ProfileNameprofile_name
  Especifica um perfil de agente a ser usado para parâmetros de agente. Se ProfileName for NULL, o perfil de agente será desabilitado. Se ProfileName não for especificado, o perfil padrão de tipo de agente será usado. Para obter informações, consulte Perfis do Replication Agent.

• -PublisherDBpublisher_database
  É o nome do banco de dados de publicação. Esse parâmetro não tem suporte para Editores Oracle .

• -PublisherDeadlockPriority [-1|0|1]
  É a prioridade da conexão do Snapshot Agent com o Publicador quando um deadlock ocorre. Esse parâmetro é especificado para resolver deadlocks que possam ocorrer entre o Snapshot Agent e aplicativos de usuário durante a geração de instantâneo.

  Valor PublisherDeadlockPriority	Descrição
  -1	Aplicativos diferentes do Snapshot Agent têm prioridade quando ocorre um deadlock no Publicador.
  0 (padrão)	A prioridade não é atribuída.
  1	O Snapshot Agent tem prioridade quando um deadlock ocorre no Publicador.

• -PublisherFailoverPartnerserver_name[**\**instance_name]
  Especifica a instância de parceiro de failover do SQL Server que participa de uma sessão de espelhamento de banco de dados com o banco de dados de publicação. Para obter mais informações, consulte Replicação e espelhamento do banco de dados.

• -PublisherLoginpublisher_login
  É o logon usado ao se conectar ao Publicador usando a Autenticação do SQL Server.

• -PublisherPassword publisher_password
  É a senha usada ao se conectar ao Publicador usando a Autenticação do SQL Server. .

• -PublisherSecurityMode [ 0| 1]
  Especifica o modo de segurança do Publicador. Um valor de 0 indica Autenticação do SQL Server (padrão), e um valor de 1 indica Modo de Autenticação do Windows.

• -QueryTimeOutquery_time_out_seconds
  É o número de segundos antes que a consulta expire. O padrão é 1800 segundos.

• -ReplicationType [ 1| 2]
  Especifica o tipo de replicação. Um valor de 1 indica replicação transacional e um valor de 2 indica replicação de mesclagem.

• -RowDelimiterrow_delimiter
  É o caractere ou cadeia de caracteres que marca o fim de uma linha no arquivo de dados de cópia em massa no SQL Server. O padrão é \n<,@g\>\n.

• -StartQueueTimeoutstart_queue_timeout_seconds
  É o número máximo de segundos que o Snapshot Agent aguarda quando o número de processos de instantâneo dinâmico simultâneos em execução está no limite definido pela propriedade @max_concurrent_dynamic_snapshots de sp_addmergepublication (Transact-SQL). Se o número máximo de segundos for alcançado e o Snapshot Agent ainda estiver esperando, será fechado. Um valor de 0 significa que o agente espera indefinidamente, embora possa ser cancelado.

• - - UsePerArticleContentsView use_per_article_contents_view
  Esse parâmetro foi preterido e só tem suporte para compatibilidade com versões anteriores.

Comentários

Importante

Se você instalou o SQL Server Agent para ser executado em uma conta de Sistema Local em vez de em uma conta de Usuário de Domínio (o padrão), o serviço só poderá acessar o computador local. Se o Snapshot Agent executado no SQL Server Agent for configurado para usar o Modo de Autenticação do Windows ao fazer logon noSQL Server, o Snapshot Agent falhará. A configuração padrão é Autenticação do SQL Server.

Para iniciar o Snapshot Agent, execute snapshot.exe no prompt do comando. Para obter informações, consulte Executáveis do agente de replicação.

Consulte também

Conceitos

Administrando agentes de replicação