Compartilhar via


Destino do ADO NET

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

O destino ADO NET carrega dados em uma variedade de bancos de dados compatíveis com o ADO.NETque utilizam uma tabela ou exibição de banco de dados. Você tem a opção de carregar esses dados em uma tabela ou exibição existente ou de criar uma nova tabela e carregar os dados nessa tabela.

Você pode usar o destino do ADO NET para se conectar ao Microsoft Banco de Dados SQL do Azure. Não há suporte para a conexão ao Banco de Dados SQL com o uso do OLE DB. Para obter mais informações sobre Banco de Dados SQL, confira Diretrizes gerais e limitações (Banco de dados SQL do Azure).

Solucionando problemas do destino ADO NET

Você pode registrar as chamadas que o destino ADO NET faz para provedores de dados externos. É possível usar essa capacidade de registro para solucionar o problema de salvar os dados em fontes de dados externas que o destino ADO NET executa. Para registrar as chamadas que o destino ADO NET faz aos provedores de dados externos, habilite o registro de pacotes e selecione o evento Diagnóstico no nível de pacotes. Para obter mais informações, consulte Solucionando problemas de ferramentas para execução de pacotes.

Configurando o destino ADO NET

Esse destino usa um gerenciador de conexões do ADO.NET para conectar-se a uma fonte de dados e o gerenciador de conexões especifica o provedor do ADO.NET a ser usado. Para obter mais informações, consulte Gerenciador de conexões ADO.NET.

Um destino ADO NET inclui mapeamentos entre as colunas de entrada e as colunas da fonte de dados de destino. Você não precisa mapear colunas de entrada para todas as colunas de destino. No entanto, as propriedades de algumas colunas de destino podem precisar do mapeamento de colunas de entrada. Caso contrário, podem ocorrer erros. Por exemplo, se uma coluna de destino não permitir valores nulos, você deve mapear uma coluna de entrada para aquela coluna de destino. Além disso, os tipos de dados de colunas mapeadas devem ser compatíveis. Por exemplo, você não poderá mapear uma coluna de entrada com um tipo de dados String para uma coluna de destino com um tipo de dados numéricos se o provedor do ADO.NET não der suporte a este mapeamento.

Observação

SQL Server não dá suporte à inserção de texto em colunas cujo tipo de dados é definido como imagem. Para obter mais informações sobre tipos de dados do SQL Server, confira Tipos de dados (Transact-SQL).

Observação

O destino ADO NET não dá suporte ao mapeamento de uma coluna de entrada cujo tipo é definido como DT_DBTIME para uma coluna de banco de dados cujo tipo é definido como data e hora. Para obter mais informações sobre tipos de dados Integration Services , consulte Tipos de Dados do Integration Services.

O destino ADO NET tem uma entrada regular e uma saída de erro.

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

A caixa de diálogo Editor Avançado reflete as propriedades que podem ser definidas programaticamente. Para obter mais informações sobre as propriedades que podem ser definidas na caixa de diálogo Editor Avançado ou programaticamente, clique em um dos seguintes tópicos:

Para obter mais informações sobre como definir as propriedades, consulte Definir as propriedades de um componente de fluxo de dados.

Editor de Destino ADO NET (Página Gerenciador de Conexões)

Use a página Gerenciador de Conexões da caixa de diálogo Editor de Destino ADO NET para selecionar a conexão ADO.NET para o destino. Essa página também permite que você selecione uma tabela ou exibição a partir do banco de dados.

Para abrir a página Gerenciador de Conexões

  1. Em SQL Server Data Tools (SSDT), abra o pacote Integration Services que tenha o destino ADO NET.

  2. Na guia Fluxo de Dados , clique duas vezes no destino ADO NET.

  3. No Editor de Destino ADO NET, clique em Gerenciador de Conexões.

Opções estáticas

Connection manager
Selecione um gerenciador de conexões existente na lista ou crie uma nova conexão clicando em Nova.

Novo
Crie um novo gerenciador de conexões usando a caixa de diálogo Configurar Gerenciador de Conexões ADO NET .

Use uma tabela ou exibição
Selecione uma tabela ou exibição existente na lista ou crie uma nova tabela clicando em Nova.

Novo
Crie uma nova tabela ou exibição usando a caixa de diálogo Criar Tabela .

Observação

Ao clicar em Novo, o Integration Services gera uma instrução CREATE TABLE padrão com base na fonte de dados conectada. A instrução CREATE TABLE padrão não incluirá o atributo FILESTREAM mesmo que a tabela de origem inclua uma coluna com o atributo FILESTREAM declarado. Para executar um componente Integration Services com o atributo FILESTREAM, implemente primeiro o armazenamento FILESTREAM no banco de dados de destino. Em seguida, adicione o atributo FILESTREAM à instrução CREATE TABLE na caixa de diálogo Criar Tabela . Para obter mais informações, confira Dados de blob (objeto binário grande) (SQL Server).

Visualização
Visualize os resultados usando a caixa de diálogo Visualizar Resultados da Consulta . A visualização pode exibir até 200 linhas.

Use a inserção em massa quando disponível
Especifique se a interface SqlBulkCopy deve ser usada para melhorar o desempenho de operações de inserção em massa.

Somente os provedores ADO.NET que retornam um objeto SqlConnection dão suporte ao uso da interface SqlBulkCopy . O .NET Data Provider for SQL Server (SqlClient) retorna um objeto SqlConnection e um provedor personalizado pode retornar um objeto SqlConnection .

Você pode usar o Provedor de Dados .NET para o SQL Server (SqlClient) para conectar-se ao Microsoft Banco de Dados SQL do Azure.

Se você selecionar Usar a inserção em massa quando disponívele definir a opção Erro como Redirecionar a linha, o lote de dados que o destino redireciona à saída de erro poderá incluir linhas válidas. Para obter mais informações sobre o tratamento de erro em operações em massa, consulte Tratamento de erros em dados. Para obter mais informações sobre a opção Erro, confira Editor de Destino ADO NET (Página Saída de Erro).

Observação

Se uma tabela de origem do SQL Server ou do Sybase incluir uma coluna de identidade, utilize as tarefas Executar SQL para habilitar IDENTITY_INSERT antes do destino ADO NET e desabilitá-lo novamente depois. (A propriedade de coluna de identidade especifica um valor incremental para a coluna. A instrução SET IDENTITY_INSERT permite inserir valores explícitos da tabela de origem na coluna de identidade na tabela de destino.)

Para executar com êxito as instruções SET IDENTITY_INSERT e o carregamento de dados, você precisa fazer o descrito a seguir.
1. Use o mesmo gerenciador de conexões ADO.NET para as tarefas Executar SQL e para o destino ADO NET.
2. No gerenciador de conexões, defina as propriedades RetainSameConnection e MultipleActiveResultSets como True.
3. No destino ADO.NET, defina a propriedade UseBulkInsertWhenPossible como False.

Para obter mais informações, confira SET IDENTITY_INSERT (Transact-SQL) e IDENTITY (Propriedade) (Transact-SQL).

Recursos externos

Artigo técnico: Carregamento rápido de dados no Banco de Dados SQL do Azure; em sqlcat.com

Editor de Destino ADO NET (Página Mapeamentos)

Use a página Mapeamentos da caixa de diálogo Editor de Destino ADO NET para mapear as colunas de entrada nas colunas de destino.

Para abrir a página Mapeamentos

  1. Em SQL Server Data Tools (SSDT), abra o pacote Integration Services que tenha o destino ADO NET.

  2. Na guia Fluxo de Dados , clique duas vezes no destino ADO NET.

  3. No Editor de Destino ADO NET, clique em Mapeamentos.

Opções

Colunas de Entrada Disponíveis
Exiba a lista das colunas de entrada disponíveis. Use uma operação de arrastar e soltar para mapear colunas de entrada disponíveis na tabela para as colunas de destino.

Colunas de Destino Disponíveis
Exiba a lista de colunas de destino disponíveis. Use uma operação de arrastar e soltar para mapear as colunas de destino disponíveis na tabela para as colunas de entrada.

Coluna de Entrada
Exiba as colunas de entrada que você selecionou. Você pode remover os mapeamentos selecionando < ignorar > para excluir as colunas da saída.

Coluna de Destino
Visualize cada coluna de destino disponível, esteja ela mapeada ou não.

Editor de Destino ADO NET (Página Saída de Erro)

Use a página Saída de Erro da caixa de diálogo Editor de Destino ADO NET para especificar as opções para tratamento de erros.

Para abrir a página Saída de Erro

  1. Em SQL Server Data Tools (SSDT), abra o pacote Integration Services que tenha o destino ADO NET.

  2. Na guia Fluxo de Dados , clique duas vezes no destino ADO NET.

  3. No Editor de Destino ADO NET, clique em Saída de Erro.

Opções

Entrada ou Saída
Visualize o nome da entrada.

Coluna
Não usado.

Erro
Especifique o que deve acontecer quando ocorre um erro: ignorar a falha, redirecionar a linha ou causar falha no componente.

Tópicos Relacionados: Tratamento de erros em dados

Truncation
Não usado.

Descrição
Visualize a descrição da operação.

Definir este valor para células selecionadas
Especifique o que deve acontecer a todas as células selecionadas quando ocorre um erro ou um truncamento: ignorar a falha, redirecionar a linha ou causar a falha no componente.

Aplicar
Aplique a opção de tratamento de erros às células selecionadas.