Partilhar via

Tarefa Transferir objetos do SQL Server

Aplica-se a:Servidor SQL Tempo de execução da integração do SSIS no Azure Data Factory

A tarefa Transferir Objetos do SQL Server transfere um ou mais tipos de objetos em um banco de dados do SQL Server entre instâncias do SQL Server. Por exemplo, a tarefa pode copiar tabelas e procedimentos armazenados. Dependendo da versão do SQL Server usada como origem, diferentes tipos de objetos estão disponíveis para cópia. Por exemplo, apenas um banco de dados do SQL Server inclui esquemas e agregações definidas pelo usuário.

Objetos a transferir

Funções de servidor, funções e usuários do banco de dados especificado podem ser copiados, bem como as permissões para os objetos transferidos. Ao copiar os usuários, funções e permissões associados juntamente com os objetos, você pode tornar os objetos transferidos imediatamente operáveis no servidor de destino.

A tabela a seguir lista o tipo de objetos que podem ser copiados.

Objeto
Tables
Views
Procedimentos armazenados
Funções Definidas pelo Usuário
Defaults
User-Defined tipos de dados
Funções de partição
Esquemas de partição
Schemas
Montagens
User-Defined Agregados
Tipos Definidos pelo Usuário
Coleção de esquema XML

Tipos definidos pelo usuário (UDTs) que foram criados em uma instância do SQL Server têm dependências em assemblies CLR (Common Language Runtime). Se você usar a tarefa Transferir Objetos do SQL Server para transferir UDTs, também deverá configurar a tarefa para transferir objetos dependentes. Para transferir objetos dependentes, defina a propriedade IncludeDependentObjects como True.

Opções de tabela

Ao copiar tabelas, você pode indicar os tipos de itens relacionados à tabela a serem incluídos no processo de cópia. Os seguintes tipos de itens podem ser copiados juntamente com a tabela relacionada:

  • Indexes

  • Acionadores

  • Índices de texto completo

  • Chaves primárias

  • Chaves estrangeiras

Você também pode indicar se o script que a tarefa gera está no formato Unicode.

Opções de destino

Você pode configurar a tarefa Transferir Objetos do SQL Server para incluir nomes de esquema, dados, propriedades estendidas de objetos transferidos e objetos dependentes na transferência. Se os dados forem copiados, eles poderão substituir ou acrescentar dados existentes.

Algumas opções aplicam-se apenas ao SQL Server. Por exemplo, apenas o SQL Server dá suporte a esquemas.

Opções de Segurança

A tarefa Transferir Objetos do SQL Server pode incluir usuários e funções no nível de banco de dados do SQL Server da origem, logons do SQL Server e as permissões para objetos transferidos. Por exemplo, a transferência pode incluir as permissões nas tabelas transferidas.

Transferir objetos entre instâncias do SQL Server

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

Events

A tarefa gera um evento de informação que relata o objeto transferido e um evento de aviso quando um objeto é substituído. Um evento de informação também é gerado para ações como o truncamento de tabelas de banco de dados.

A tarefa Transferir Objetos do SQL Server não relata o progresso incremental da transferência de objetos; ele relata apenas 0% e 100 % conclusão.

Valor de Execução

O valor de execução, armazenado na propriedade ExecutionValue da tarefa, retorna o número de objetos transferidos. Ao atribuir uma variável definida pelo usuário à propriedade ExecValueVariable da tarefa Transferir Objetos do SQL Server, as informações sobre a transferência de objetos podem ser disponibilizadas para outros objetos no pacote. Para obter mais informações, consulte Variáveis do Integration Services (SSIS) e Usar variáveis em pacotes.

Entradas de log

A tarefa Transferir Objetos do SQL Server inclui as seguintes entradas de log personalizadas:

  • TransferSqlServerObjectsTaskStartTransferringObjects Esta entrada de log informa que a transferência foi iniciada. A entrada de log inclui a hora de início.

  • TransferSqlServerObjectsTaskFinishedTransferringObjects Esta entrada de log informa que a transferência foi concluída. A entrada de log inclui a hora de término.

Além disso, uma entrada de log para um evento OnInformation relata o número de objetos dos tipos de objeto que foram selecionados para transferência, o número de objetos que foram transferidos e ações como o truncamento de tabelas quando os dados são transferidos com tabelas. Uma entrada de log para o evento OnWarning é gravada para cada objeto no destino que é substituído.

Segurança e permissões

O usuário deve ter permissão para procurar objetos no servidor de origem e deve ter permissão para soltar e criar objetos no servidor de destino; Além disso, o usuário deve ter acesso ao banco de dados especificado e objetos de banco de dados.

Configuração da tarefa Transferir objetos do SQL Server

A tarefa Transferir Objetos do SQL Server pode ser configurada para transferir todos os objetos, todos os objetos de um tipo ou apenas objetos especificados de um tipo. Por exemplo, você pode optar por copiar apenas tabelas selecionadas no banco de dados AdventureWorks.

Se a tarefa Transferir Objetos do SQL Server transferir tabelas, você poderá especificar os tipos de objetos relacionados à tabela a serem copiados com as tabelas. Por exemplo, você pode especificar que as chaves primárias sejam copiadas com tabelas.

Para aprimorar ainda mais a funcionalidade de objetos transferidos, você pode configurar a tarefa Transferir Objetos do SQL Server para incluir nomes de esquema, dados, propriedades estendidas de objetos transferidos e objetos dependentes na transferência. Ao copiar dados, você pode especificar se deseja substituir ou acrescentar dados existentes.

Em tempo de execução, a tarefa Transferir Objetos do SQL Server se conecta aos servidores de origem e de destino usando dois gerenciadores de conexões SMO. Os gerenciadores de conexões SMO são configurados separadamente da tarefa Transferir Objetos do SQL Server e, em seguida, referenciados na tarefa Transferir Objetos do SQL Server. Os gerenciadores de conexões SMO especificam o servidor e o modo de autenticação a ser usado ao acessar o servidor. Para obter mais informações, consulte SMO Connection Manager.

Você pode definir propriedades por meio do SSIS Designer ou programaticamente.

Para obter mais informações sobre as propriedades que você pode definir no Designer SSIS, clique no seguinte tópico:

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

Configuração programática da tarefa Transferir objetos do SQL Server

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

Editor de tarefas Transferir objetos do SQL Server (página Geral)

Use a página Geral da caixa de diálogo Transferir Editor de Tarefas de Objetos do SQL Server para nomear e descrever a tarefa Transferir Objetos do SQL Server.

Observação

O usuário que cria a tarefa Transferir Objetos do SQL Server deve ter permissões adequadas nos objetos do servidor de origem para selecioná-los para cópia e permissão para acessar o banco de dados do servidor de destino para o qual os objetos serão transferidos.

Opções

Nome
Digite um nome exclusivo para a tarefa Transferir Objetos do SQL Server. Esse nome é usado como o rótulo no ícone da tarefa.

Observação

Os nomes das tarefas devem ser exclusivos dentro de um pacote.

Descrição
Digite uma descrição da tarefa Transferir Objetos do SQL Server.

Editor de tarefas Transferir objetos do SQL Server (página Objetos)

Use a página Objetos da caixa de diálogo Transferir Editor de Tarefas de Objetos do SQL Server para especificar propriedades para copiar um ou mais objetos do SQL Server de uma instância do SQL Server para outra. Tabelas, exibições, procedimentos armazenados e funções definidas pelo usuário são alguns exemplos de objetos do SQL Server que você pode copiar.

Observação

O usuário que cria a tarefa Transferir Objetos do SQL Server deve ter permissões suficientes nos objetos do servidor de origem para selecioná-los para cópia e permissão para acessar o banco de dados do servidor de destino para o qual os objetos serão transferidos.

Opções estáticas

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.

SourceDatabase
Selecione um banco de dados no servidor de origem do qual os objetos serão copiados.

DestinationConnection
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 destino.

Base de Dados de Destino
Selecione um banco de dados no servidor de destino para o qual os objetos serão copiados.

DropObjectsFirst
Selecione se os objetos selecionados serão descartados primeiro no servidor de destino antes de copiar.

IncludeExtendedProperties
Selecione se as propriedades estendidas serão incluídas quando os objetos forem copiados da origem para o servidor de destino.

CopiarDados
Selecione se os dados serão incluídos quando os objetos forem copiados da origem para o servidor de destino.

Dados existentes
Especifique como os dados serão copiados para o servidor de destino. Esta propriedade tem as opções listadas na tabela a seguir:

Valor Description
Substituir Os dados no servidor de destino serão substituídos.
Anexar Os dados copiados do servidor de origem serão anexados aos dados existentes no servidor de destino.

Observação

A opção ExistingData só está disponível quando CopyData está definido como True.

CopySchema
Selecione se o esquema é copiado durante a tarefa Transferir Objetos do SQL Server.

Observação

CopySchema só está disponível para SQL Server.

UseCollation
Selecione se a transferência de objetos deve incluir o agrupamento especificado no servidor de origem.

IncludeDependentObjects
Selecione se a cópia dos objetos selecionados será feita em cascata para incluir outros objetos que dependem dos objetos selecionados para cópia.

CopyAllObjects
Selecione se a tarefa copiará todos os objetos no banco de dados de origem especificado ou apenas os objetos selecionados. Definir essa opção como False oferece a opção de selecionar os objetos a serem transferidos e exibe as opções dinâmicas na seção CopyAllObjects.

ObjetosToCopy
Expanda ObjectsToCopy para especificar quais objetos devem ser copiados do banco de dados de origem para o banco de dados de destino.

Observação

ObjectsToCopy só está disponível quando CopyAllObjects está definido como False.

As opções para copiar os seguintes tipos de objetos são suportadas apenas no SQL Server:

Montagens

Funções de partição

Esquemas de partição

Schemas

Agregações definidas pelo utilizador

Tipos definidos pelo usuário

Coleções de esquema XML

CopyDatabaseUsers
Especifique se os usuários do banco de dados devem ser incluídos na transferência.

CopyDatabaseRoles
Especifique se as funções de banco de dados devem ser incluídas na transferência.

CopySqlServerLogins
Especifique se os logons do SQL Server devem ser incluídos na transferência.

CopyObjectLevelPermissions
Especifique se as permissões no nível do objeto devem ser incluídas na transferência.

CopyIndexes
Especificar se os índices devem ser incluídos na transferência.

CopyTriggers
Especifique se os fatores de desencadeamento devem ser incluídos na transferência.

CopyFullTextIndexes
Especifique se os índices de texto completo devem ser incluídos na transferência.

CopyPrimaryKeys
Especifique se as chaves primárias devem ser incluídas na transferência.

CopyForeignKeys
Especifique se as chaves estrangeiras devem ser incluídas na transferência.

GenerateScriptsInUnicode
Especifique se os scripts de transferência gerados estão no formato Unicode.

Opções dinâmicas

CopyAllObjects = Falso

CopyAllTables
Selecione se a tarefa copiará todas as tabelas no banco de dados de origem especificado ou apenas as tabelas selecionadas.

Lista de Tabelas
Clique para abrir a caixa de diálogo Selecionar tabelas .

CopyAllViews
Selecione se a tarefa copiará todos os modos de exibição no banco de dados de origem especificado ou apenas os modos de exibição selecionados.

Lista de visualizações
Clique para abrir a caixa de diálogo Selecionar modos de exibição.

CopyAllStoredProcedures
Selecione se a tarefa copiará todos os procedimentos armazenados definidos pelo usuário no banco de dados de origem especificado ou apenas os procedimentos selecionados.

StoredProceduresList
Clique para abrir a caixa de diálogo Selecionar Procedimentos Armazenados .

CopyAllUserDefinedFunctions
Selecione se a tarefa copiará todas as funções definidas pelo usuário no banco de dados de origem especificado ou apenas as UDFs selecionadas.

UserDefinedFunctionsList
Clique para abrir a caixa de diálogo Selecionar funções definidas pelo usuário .

CopyAllDefaults
Selecione se a tarefa copiará todos os padrões no banco de dados de origem especificado ou apenas os padrões selecionados.

DefaultsList
Clique para abrir a caixa de diálogo Selecionar padrões .

CopyAllUserDefinedDataTypes
Selecione se a tarefa copiará todos os tipos de dados definidos pelo usuário no banco de dados de origem especificado ou apenas os tipos de dados definidos pelo usuário selecionados.

UserDefinedDataTypesList
Clique para abrir a caixa de diálogo Selecionar User-Defined tipos de dados .

CopyAllPartitionFunctions
Selecione se a tarefa copiará todas as funções de partição definidas pelo usuário no banco de dados de origem especificado ou apenas as funções de partição selecionadas. Com suporte somente no SQL Server.

PartitionFunctionsList
Clique para abrir a caixa de diálogo Selecionar funções de partição .

CopyAllPartitionSchemes
Selecione se a tarefa copiará todos os esquemas de partição no banco de dados de origem especificado ou apenas os esquemas de partição selecionados. Com suporte somente no SQL Server.

PartitionSchemesList
Clique para abrir a caixa de diálogo Selecionar esquemas de partição .

CopyAllSchemas
Selecione se a tarefa copiará todos os esquemas no banco de dados de origem especificado ou apenas os esquemas selecionados. Com suporte somente no SQL Server.

Lista de esquemas
Clique para abrir a caixa de diálogo Selecionar esquemas .

CopyAllSqlAssemblies
Selecione se a tarefa copiará todos os assemblies SQL no banco de dados de origem especificado ou apenas os assemblies SQL selecionados. Com suporte somente no SQL Server.

SqlAssembliesList
Clique para abrir a caixa de diálogo Selecionar assemblies SQL .

CopyAllUserDefinedAggregates
Selecione se a tarefa copiará todas as agregações definidas pelo usuário no banco de dados de origem especificado ou apenas as agregações definidas pelo usuário selecionadas. Com suporte somente no SQL Server.

UserDefinedAggregatesList
Clique para abrir a caixa de diálogo Selecionar User-Defined agregações .

CopyAllUserDefinedTypes
Selecione se a tarefa copiará todos os tipos definidos pelo usuário no banco de dados de origem especificado ou apenas as UDTs selecionadas. Com suporte somente no SQL Server.

UserDefinedTypes
Clique para abrir a caixa de diálogo Selecionar User-Defined tipos .

CopyAllXmlSchemaCollections
Selecione se a tarefa copiará todas as coleções de esquema XML no banco de dados de origem especificado ou apenas as coleções de esquema XML selecionadas. Com suporte somente no SQL Server.

XmlSchemaCollectionsList
Clique para abrir a caixa de diálogo Selecionar coleções de esquema XML .

Ver também

Referência de mensagem e erro do Integration Services
Tarefas do Integration Services
Página de expressões
Formatos de dados para importação ou exportação em massa (SQL Server)
Considerações de segurança para uma instalação do SQL Server

  • Last updated on