Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a:
SQL Server SSIS Integration Runtime em Azure Data Factory
A fonte ADO NET consome dados de um provedor .NET e disponibiliza os dados para o fluxo de dados.
Você pode usar a fonte ADO NET para se conectar ao Banco de Dados SQL do Microsoft Azure. Não há suporte para a conexão com o Banco de dados SQL usando o OLE DB. Para obter mais informações sobre o Banco de Dados SQL, consulte Diretrizes e limitações gerais (Banco de Dados SQL do Azure).
Suporte a tipos de dados
A origem converte qualquer tipo de dados que não seja mapeado para um tipo de dados específico dos Integration Services no tipo de dados DT_NTEXT. Essa conversão ocorre mesmo se o tipo de dados for System.Object.
Você pode alterar o tipo de dados DT_NTEXT para o tipo de dados DT_WSTR ou alterar o tipo de dados DT_WSTR para DT_NTEXT. Você altera os tipos de dados definindo 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 para o tipo de dados DT_BYTES ou DT_STR usando uma transformação de conversão de dados após a fonte ADO NET. Para obter mais informações, consulte Transformação de Conversão de Dados.
No Integration Services, os tipos de dados de data, DT_DBDATE, DT_DBTIME2, DT_DBTIMESTAMP2 e DT_DBTIMESTAMPOFFSET, correspondem a certos tipos de dados de data no SQL Server. Você pode configurar a fonte ADO NET para converter os tipos de dados de data daqueles que o SQL Server usa para aqueles que o Integration Services usa. Para configurar a fonte ADO NET para converter esses tipos de dados de data, defina a propriedade Type System Version do gerenciador de conexões ADO.NET como Mais recente. (A propriedade Type System Version está na página Todos da caixa de diálogo Gerenciador de Conexões . Para abrir a caixa de diálogo Gestor de ligações , clique com o botão direito do rato no ADO.NET gestor de ligações e, em seguida, clique em Editar.)
Observação
Se a propriedade Type System Version para o gerenciador de conexões ADO.NET estiver definida como SQL Server 2005, o sistema converterá os tipos de dados de data do SQL Server em DT_WSTR.
O sistema converte tipos de dados definidos pelo usuário (UDTs) em BLOBs (objetos binários grandes) do Integration Services quando o gerenciador de conexões ADO.NET especifica o provedor como o Provedor de Dados .NET para SQL Server (SqlClient). O sistema aplica as seguintes regras quando converte o tipo de dados UDT:
Se os dados forem um UDT não grande, o sistema converte os dados em DT_BYTES.
Se os dados forem um UDT não grande e a propriedade Length da coluna no banco de dados estiver definida como -1 ou um valor maior que 8.000 bytes, o sistema converte os dados em DT_IMAGE.
Se os dados forem um UDT grande, o sistema converte os dados em DT_IMAGE.
Observação
Se a fonte ADO NET não estiver configurada para usar a saída de erro, o sistema transmitirá os dados para a coluna DT_IMAGE em blocos de 8.000 bytes. Se a fonte do ADO NET estiver configurada para usar a saída de erro, o sistema passará a matriz de bytes inteira 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, conversões de tipo de dados com suporte e mapeamento de tipos de dados em determinados 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 para tipos de dados gerenciados, consulte Trabalhando com tipos de dados no fluxo de dados.
Solução de problemas de origem do ADO NET
Você pode registrar as chamadas que a fonte ADO NET faz para provedores de dados externos. Você pode usar esse recurso de log para solucionar problemas de carregamento de dados de fontes de dados externas executadas pela fonte ADO NET. Para registrar as chamadas que a fonte do ADO NET faz para provedores de dados externos, habilite o log de pacotes e selecione o evento de diagnóstico no nível do pacote. Para obter mais informações, consulte Ferramentas de solução de problemas para execução de pacotes.
Configuração de origem do ADO NET
Configure a origem do ADO NET fornecendo a instrução SQL que define o conjunto de resultados. Por exemplo, uma fonte ADO NET que se conecta AdventureWorks2025 ao banco de dados e usa a instrução SELECT * FROM Production.Product SQL 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 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 seguinte erro, você poderá resolver o erro adicionando a instrução SET FMTONLY OFF antes da instrução exec.
A coluna <column_name> não pode ser encontrada na fonte de dados.
A fonte ADO NET usa um gerenciador de conexões 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 ADO.NET Connection Manager.
A fonte ADO NET tem uma saída regular e uma saída de erro.
Você pode definir propriedades por meio do SSIS Designer ou programaticamente.
Para obter mais informações sobre as propriedades que você pode definir na caixa de diálogo Advanced Editor ou programaticamente, clique em um dos seguintes tópicos:
Para obter mais informações sobre como definir propriedades, consulte Definir as propriedades de um componente de fluxo de dados.
Editor de código-fonte do ADO NET (página do Gerenciador de Conexões)
Use a página Gerenciador de conexões da caixa de diálogo Editor de código-fonte do ADO NET para selecionar o gerenciador de conexões ADO.NET para a origem. Esta página também permite selecionar uma tabela ou exibição do banco de dados.
Para saber mais sobre a fonte do ADO NET, consulte Fonte do ADO NET.
Para abrir a página do Connection Manager
No SSDT (SQL Server Data Tools), abra o pacote do Integration Services que tem a fonte ADO NET.
Na guia Fluxo de Dados , clique duas vezes na fonte ADO NET.
No Editor de código-fonte do ADO NET, clique em Gerenciador de Conexões.
Opções estáticas
ADO.NET gerenciador de conexões
Selecione um gerenciador de conexões existente na lista ou crie uma nova conexão clicando em Novo.
Novo
Crie um novo gerenciador de conexões usando a caixa de diálogo Configurar ADO.NET Gerenciador de Conexões .
Modo de acesso aos dados
Especifique o método para selecionar dados da fonte.
| Opção | Descrição |
|---|---|
| Tabela ou vista | Recupere dados de uma tabela ou vista na fonte de dados ADO.NET. |
| Comando SQL | Recupere dados da fonte de dados ADO.NET usando uma consulta SQL. |
Previsualizar
Visualize os resultados usando a caixa de diálogo Modo de Exibição de Dados .
A pré-visualização pode apresentar até 200 linhas.
Observação
Quando você visualiza dados, as colunas com um tipo CLR definido pelo usuário não contêm dados. Em vez disso, os valores <são demasiado grandes para serem exibidos> ou são exibidos como System.Byte[]. O primeiro é exibido quando a fonte de dados é acessada usando o provedor ADO.NET, o segundo quando usa o provedor SQL Server Native Client.
Opções dinâmicas do modo de acesso a dados
Modo de acesso a dados = Tabela ou vista
Nome da tabela ou da vista
Selecione o nome da tabela ou exibição em uma lista das disponíveis na fonte de dados.
Modo de acesso a dados = comando SQL
Texto do comando SQL
Insira o texto de uma consulta SQL, crie a consulta clicando em Criar Consulta ou 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.
Navegar
Use a caixa de diálogo Abrir para localizar o arquivo que contém o texto da consulta SQL.
Editor de código-fonte do ADO NET (página Colunas)
Use a página Colunas da caixa de diálogo Editor de código-fonte do ADO NET para mapear uma coluna de saída para cada coluna externa (origem).
Para saber mais sobre a fonte do ADO NET, consulte Fonte do ADO NET.
Para abrir a página Colunas
No SSDT (SQL Server Data Tools), abra o pacote do Integration Services que tem a fonte ADO NET.
Na guia Fluxo de Dados , clique duas vezes na fonte ADO NET.
No Editor de código-fonte do ADO NET, clique em Colunas.
Opções
Colunas externas disponíveis
Exiba a lista de colunas externas disponíveis na fonte de dados. Não é possível usar esta tabela para adicionar ou excluir colunas.
Coluna Externa
Exiba colunas externas (fonte) na ordem em que você as verá ao configurar componentes que consomem dados dessa fonte.
Coluna de saída
Forneça um nome exclusivo para cada coluna de saída. O padrão é o nome da coluna externa (fonte) selecionada; no entanto, você pode escolher qualquer nome exclusivo e descritivo. O nome fornecido será exibido no Designer SSIS.
ADO NET Source Editor (página de saída de erro)
Use a página Saída de erro da caixa de diálogo Editor de código-fonte do ADO NET para selecionar opções de tratamento de erros e definir propriedades em colunas de saída de erro.
Para saber mais sobre a fonte do ADO NET, consulte Fonte do ADO NET.
Para abrir a página de Saída de Erro
No SSDT (SQL Server Data Tools), abra o pacote do Integration Services que tem a fonte ADO NET.
Na guia Fluxo de Dados , clique duas vezes na fonte ADO NET.
No Editor de código-fonte do ADO NET, clique em Saída de erro.
Opções
de entrada/saída
Exiba o nome da fonte de dados.
Coluna
Exiba as colunas externas (origem) selecionadas na página Gerenciador de Conexões da caixa de diálogo Editor de código-fonte do ADO NET .
Erro
Especifique o que deve acontecer quando ocorrer um erro: ignore a falha, redirecione a linha ou falhe o componente.
Tópicos relacionados:Tratamento de erros em dados
Truncamento
Especifique o que deve acontecer quando ocorrer um truncamento: ignorar a falha, redirecionar a linha ou provocar a falha do componente.
Descrição
Veja a descrição do erro.
Defina esse valor para células selecionadas
Especifique o que deve acontecer com todas as células selecionadas quando ocorrer um erro ou truncamento: ignore a falha, redirecione a linha ou falhe o componente.
Candidatar-se
Aplique a opção de tratamento de erros às células selecionadas.