Origem do ADO NET

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

A origem do ADO NET recebe dados de um provedor de .NET e os disponibiliza para o fluxo de dados.

Você pode usar a fonte 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).

Suporte do tipo de dados

A fonte converte qualquer tipo de dados que não é mapeado para um tipo de dados específico do Integration Services em um tipo de dados DT_NTEXT do Integration Services . Essa conversão ocorre mesmo que o tipo de dados seja System.Object.

É possível alterar o tipo de dados DT_NTEXT para o tipo de dados DT_WSTR ou alterar DT_WSTR para DT_NTEXT. Para alterar tipos de dados, defina a propriedade DataType na caixa de diálogo Editor Avançado da fonte ADO.NET. Para obter mais informações, consulte Propriedades comuns.

O tipo de dados DT_NTEXT também pode ser convertido no tipo de dados DT_BYTES ou DT_STR usando uma transformação Conversão de Dados depois da origem do ADO NET. Para obter mais informações, consulte Data Conversion Transformation.

No Integration Services, os tipos de dados de data, DT_DBDATE, DT_DBTIME2, DT_DBTIMESTAMP2 e DT_DBTIMESTAMPOFFSET, são mapeados para certos tipos de dados de data no SQL Server. Você pode configurar a fonte ADO.NET para converter os tipos de dados de data usados pelo SQL Server naqueles usados pelo Integration Services . Para configurar a fonte ADO.NET para converter esses tipos de dados de data, defina a propriedade Versão do Sistema de Tipos do gerenciador de conexões do ADO.NET como Mais Recente. (A propriedade Versão do Sistema de Tipos está na página Todos da caixa de diálogo Gerenciador de Conexões. Para abrir a caixa de diálogo Gerenciador de Conexões, clique com o botão direito do mouse no gerenciador de conexões ADO.NET e clique em Editar.)

Observação

Se a propriedade Versão do Sistema de Tipos do gerenciador de conexões do ADO.NET for definida como SQL Server 2005, o sistema converterá os tipos de dados de data do SQL Server em DT_WSTR.

O sistema converte UDTs (tipos de dados definidos pelo usuário) em BLOBs (objetos grandes binários) do Integration Services quando o gerenciador de conexões do ADO.NET especifica o provedor como o Provedor de Dados .NET para SQL Server (SqlClient). O sistema aplica as regras a seguir ao converter o tipo de dados UDT:

  • Se os dados forem UDTs pequenos, o sistema converterá os dados em DT_BYTES.

  • Se os dados forem UDTs que não são grandes e a propriedade Length da coluna do banco de dados for definida como -1 ou um valor superior a 8.000 bytes, o sistema converterá os dados em DT_IMAGE.

  • Se os dados forem UDTs grandes, o sistema converterá os dados em DT_IMAGE.

    Observação

    Se a origem do ADO NET não estiver configurada para usar a saída de erro, o sistema enviará os dados para a coluna DT_IMAGE em blocos de 8.000 bytes. Se a origem do ADO NET for configurada para usar a saída de erro, o sistema passará a matriz inteira de bytes para a coluna DT_IMAGE. Para obter mais informações sobre como configurar componentes para usar a saída de erro, consulte Tratamento de erros em dados.

Para obter mais informações sobre os tipos de dados do Integration Services , as conversões de tipos de dados com suporte e o mapeamento de tipos de dados em alguns bancos de dados, incluindo o SQL Server, consulte Tipos de dados do Integration Services.

Para obter informações sobre como mapear tipos de dados do Integration Services em tipos de dados gerenciados, consulte Trabalhando com tipos de dados no fluxo de dados.

Solução de problemas da origem do ADO NET

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

Configuração da origem do ADO NET

Para configurar a origem do ADO NET, forneça a instrução SQL que define o conjunto de resultados. Por exemplo, a fonte ADO.NET que se conecta ao banco de dados AdventureWorks2022 e que usa a instrução SQL SELECT * FROM Production.Product extrai todas as linhas da tabela Production.Product e fornece o conjunto de dados para um componente downstream.

Observação

Quando você usa uma instrução SQL para invocar um procedimento armazenado que retorna resultados de uma tabela temporária, use a opção de WITH RESULT SETS para definir metadados para o conjunto de resultados.

Observação

Se você usar uma instrução SQL para executar um procedimento armazenado e o pacote falhar com o erro a seguir, você poderá resolver o erro adicionando a instrução SET FMTONLY OFF antes da instrução exec.

Não é possível encontrar a coluna <nome_da_coluna> na fonte de dados.

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

A origem do ADO NET tem uma saída regular e uma saída de erro.

Você pode definir propriedades pelo Designer do SSIS ou 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 origem ADO NET (Página Gerenciador de Conexões)

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

Para obter mais informações sobre a origem ADO NET, consulte ADO NET Source.

Para abrir a página Gerenciador de Conexões

  1. No SQL Server Data Tools (SSDT), abra o pacote Integration Services que tenha a origem ADO NET.

  2. Na guia Fluxo de Dados , clique duas vezes na origem ADO NET.

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

Opções estáticas

Gerenciador de conexões ADO.NET
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 .

Modo de acesso aos dados
Especifique o método para selecionar os dados da origem.

Opção Descrição
Tabela ou exibição Recupere os dados de uma tabela ou visualize na fonte de dados ADO.NET .
Comando SQL Recupere os dados da fonte de dados ADO.NET usando uma consulta SQL.

Visualização
Visualize os resultados usando a caixa de diálogo Exibição de Dados . Avisualização pode exibir até 200 linhas.

Observação

Quando você visualiza os dados, as colunas com um tipo de dado CLR definido pelo usuário não contêm dados. Em vez disso, os valores <muito grandes para serem exibidos> ou System.Byte[] é exibido. O primeiro é exibido quando a fonte de dados é acessada usando o provedor ADO.NET , o último ao usar o provedor Native Client do SQL Server .

Opções dinâmicas de modo de acesso aos dados

Modo de acesso aos dados = Tabela ou exibição

Nome da tabela ou da exibição
Selecione o nome da tabela ou da exibição na lista de tabelas ou exibições disponíveis na fonte de dados.

Modo de acesso aos dados = Comando SQL

Texto do comando SQL
Digite o texto de uma consulta SQL, crie a consulta clicando em Construir Consultaou localize o arquivo que contém o texto da consulta clicando em Procurar.

Construir consulta
Use a caixa de diálogo Construtor de Consultas para construir a consulta SQL visualmente.

Procurar
Use a caixa de diálogo Abrir para localizar o arquivo com contém o texto da consulta SQL.

Editor de Origem ADO NET (Página Colunas)

Use a página Colunas da caixa de diálogo do Editor de Origem ADO NET para mapear uma coluna de saída em cada coluna externa (origem).

Para obter mais informações sobre a origem ADO NET, consulte ADO NET Source.

Para abrir a página Colunas

  1. No SQL Server Data Tools (SSDT), abra o pacote Integration Services que tenha a origem ADO NET.

  2. Na guia Fluxo de Dados , clique duas vezes na origem ADO NET.

  3. No Editor de Origem ADO NET, clique em Colunas.

Opções

Colunas Externas Disponíveis
Exiba a lista de colunas externas disponíveis na fonte de dados. Você não pode usar esta tabela para adicionar ou excluir colunas.

Coluna Externa
Exiba as colunas externas (origem) na ordem em que serão exibidas ao configurar os componentes que consomem os dados dessa origem.

Coluna de Saída
Forneça um nome exclusivo para cada coluna de saída. O padrão é o nome da coluna externa (origem) selecionada; porém, é possível escolher qualquer nome descritivo exclusivo. O nome fornecido será exibido no Designer SSIS .

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

Use a página Saída de Erro da caixa de diálogo Editor de Origem ADO NET para selecionar as opções de manipulação de erros e definir as propriedades nas colunas de saída de erros.

Para obter mais informações sobre a origem ADO NET, consulte ADO NET Source.

Para abrir a página Saída de Erro

  1. No SQL Server Data Tools (SSDT), abra o pacote Integration Services que tenha a origem ADO NET.

  2. Na guia Fluxo de Dados , clique duas vezes na origem ADO NET.

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

Opções

Entrada/Saída
Exibe o nome da fonte de dados.

Coluna
Exiba as colunas externas (origem) que você selecionou na página Gerenciador de Conexões da caixa de diálogo Editor de Origem ADO NET .

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
Especifique o que deve acontecer quando ocorre um truncamento: ignorar a falha, redirecionar a linha ou causar falha do componente.

Descrição
Exiba a descrição do erro.

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.

Consulte Também

Destino do DataReader
Destino do ADO NET
Fluxo de Dados