Tarefa Transferir Procedimentos Armazenados Mestres

Aplica-se a:SQL Server SSIS Integration Runtime no Azure Data Factory

A tarefa Transferir Procedimentos Armazenados Mestres transfere um ou mais procedimentos armazenados definidos pelo usuário entre bancos de dados mestre em instâncias do SQL Server. Para transferir um procedimento armazenado do banco de dados mestre , o proprietário do procedimento deve ser dbo.

A tarefa Transferir Procedimentos Armazenados Mestres pode ser configurada para transferir todos os procedimentos armazenados ou apenas procedimentos armazenados específicos. Essa tarefa não copia procedimentos armazenados do sistema.

Os procedimentos armazenados mestres a serem transferidos podem já existir no destino. A tarefa Transferir Procedimentos Armazenados Mestres pode ser configurada para lidar com procedimentos já existentes armazenados das seguintes maneiras:

  • Substituir procedimentos armazenados existentes.

  • Interromper a tarefa quando existirem procedimentos armazenados duplicados.

  • Ignorar procedimentos armazenados duplicados.

Em tempo de execução, a tarefa Transferir Procedimentos Armazenados Mestres conecta-se aos servidores de origem e de destino usando dois gerenciadores de conexões SMO. Os gerenciadores de conexões SMO são configurados separadamente a partir da tarefa Transferir Procedimentos Armazenados Mestres e depois referenciados na tarefa Transferir Procedimentos Armazenados Mestres. Os gerenciadores de conexões SMO especificam o servidor e o modo de autenticação a serem usados ao acessar o servidor. Para obter mais informações, consulte SMO Connection Manager.

Transferindo procedimentos armazenados entre instâncias do SQL Server

A tarefa Transferir Procedimentos Armazenados Mestres dá suporte a uma origem e a um destino do SQL Server .

Eventos

A tarefa gera um evento de informações que informa o número de procedimentos armazenados transferidos e um evento de aviso quando um procedimento armazenado é substituído.

A tarefa Transferir Procedimentos Armazenados Mestres não informa o progresso incremental da transferência de logon; ela apenas informa 0% e 100% de conclusão.

Valor de execução

O valor de execução definido na propriedade ExecutionValue da tarefa retorna o número de procedimentos armazenados transferidos. Atribuindo uma variável definida pelo usuário à propriedade ExecValueVariable da tarefa Transferir Procedimentos Armazenados Mestres, as informações sobre a transferência de procedimentos armazenados podem ser disponibilizadas para outros objetos do pacote. Para obter mais informações, confira Variáveis do Integration Services (SSIS) e Usar variáveis em pacotes.

Entradas de log

A tarefa Transferir Procedimentos Armazenados Mestres inclui as seguintes entradas de log personalizadas:

  • TransferStoredProceduresTaskStartTransferringObjects Essa entrada de log informa que a transferência foi iniciada. A entrada do log contém a hora de início.

  • TransferSStoredProceduresTaskFinishedTransferringObjects Essa entrada de log informa que a transferência foi concluída. A entrada do log contém a hora de término.

Além disso, uma entrada de log para o evento OnInformation informa o número de procedimentos armazenados que foram transferidos e uma entrada de log para o evento OnWarning é gravada para cada procedimento armazenado no destino que é substituído.

Segurança e permissões

O usuário deve ter permissão para exibir a lista do procedimento armazenado no banco de dados mestre na origem e deve ser um membro da função de servidor sysadmin ou ter permissão para procedimentos armazenados criados no banco de dados mestre no servidor de destino.

Configuração da tarefa Transferir Procedimentos Armazenados Mestres

Você pode definir propriedades pelo Designer do SSIS ou programaticamente.

Para obter mais informações sobre as propriedades que podem ser definidas no SSIS Designer, clique no tópico a seguir:

Para obter informações sobre como definir essas propriedades programaticamente, clique no tópico a seguir:

Configurando a tarefa Transferir Procedimentos Armazenados Mestres programaticamente

Para obter mais informações sobre como definir essas propriedades no SSIS Designer, clique no tópico a seguir:

Editor da Tarefa Transferir Procedimentos Armazenados Mestres (Página Geral)

Use a página Geral da caixa de diálogo Editor da Tarefa Transferir Procedimentos Armazenados Mestres para nomear e descrever a tarefa Transferir Procedimentos Armazenados Mestres.

Observação

Essa tarefa transfere apenas procedimentos armazenados definidos pelo usuário pertencentes ao dbo de um banco de dados mestre no servidor de origem para um banco de dados mestre no servidor de destino. Os usuários devem receber a permissão CREATE PROCEDURE no banco de dados mestre no servidor de destino ou devem ser membros da função de servidor fixa sysadmin no servidor de destino para criar procedimentos armazenados ali.

Opções

Nome
Digite um nome exclusivo para a tarefa Transferir Procedimentos Armazenados Mestres. Esse nome é usado como rótulo no ícone de tarefa.

Observação

Os nomes das tarefas devem ser exclusivos em um pacote.

Descrição
Digite uma descrição da tarefa Transferir Procedimentos Armazenados Mestres.

Editor da Tarefa Transferir Procedimentos Armazenados Mestres (páginas Procedimentos Armazenados)

Use a página Procedimentos Armazenados da caixa de diálogo Editor da Tarefa Transferir Procedimentos Armazenados Mestres para especificar propriedades para copiar um ou mais procedimentos armazenados definidos pelo usuário do banco de dados mestre em uma instância do SQL Server para um banco de dados mestre em outra instância do SQL Server.

Observação

Essa tarefa transfere apenas procedimentos armazenados definidos pelo usuário pertencentes ao dbo de um banco de dados mestre no servidor de origem para um banco de dados mestre no servidor de destino. Os usuários devem receber a permissão CREATE PROCEDURE no banco de dados mestre no servidor de destino ou devem ser membros da função de servidor fixa sysadmin no servidor de destino para criar procedimentos armazenados ali.

Opções

SourceConnection
Selecione um gerenciador de conexões SMO na lista ou clique em <Nova conexão...> para criar uma nova conexão com o servidor de origem.

DestinationConnection
Selecione um gerenciador de conexões do SMO na lista ou clique em <Nova conexão...> para criar uma conexão com o servidor de destino.

IfObjectExists
Selecione como a tarefa deve manipular procedimentos armazenados definidos pelo usuário de nome idêntico a outros já existentes no banco de dados mestre no servidor de destino.

As opções desta propriedade estão listadas na seguinte tabela:

Valor DESCRIÇÃO
FailTask Haverá falha na tarefa se já existirem procedimentos armazenados de nome igual no banco de dados mestre no servidor de destino.
Overwrite A tarefa irá substituir os procedimentos armazenados de nome igual no banco de dados mestre no servidor de destino.
Ignorar A tarefa irá ignorar os procedimentos armazenados de nome igual já existentes no banco de dados mestre no servidor de destino.

TransferAllStoredProcedures
Selecione se todos os procedimentos armazenados definidos pelo usuário no banco de dados mestre no servidor de origem devem ser copiados para o servidor de destino.

Valor Descrição
Verdadeiro Copiar todos os procedimentos armazenados definidos pelo usuário no banco de dados mestre .
Falso Copiar só os procedimentos armazenados especificados.

StoredProceduresList
Selecione quais procedimentos armazenados definidos pelo usuário no banco de dados mestre no servidor de origem devem ser copiados para o banco de dados mestre no servidor de destino. Esta opção só fica disponível quando TransferAllStoredProcedures for definido como False.

Consulte Também

Tarefa Transferir Objetos do SQL Server
Tarefas do Integration Services
Fluxo de Controle