Compartilhar via


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çãoObservaçã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 MicrosoftSQL 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çãoObservaçã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çãoObservaçã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çãoObservaçã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çãoObservaçã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çãoObservaçã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

Observação importanteImportante

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