Fonte do Excel

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

A fonte do Excel extrai dados de folhas de cálculo ou intervalos em pastas de trabalho de Microsoft Excel.

Modos de Acesso

A fonte do Excel fornece quatro modos diferentes de acesso a dados para extrair dados:

• Uma tabela ou vista.

• Uma tabela ou exibição especificada em uma variável.

• Os resultados de uma instrução SQL. A consulta pode ser uma consulta parametrizada.

• Os resultados de uma instrução SQL armazenada em uma variável.

A fonte do Excel usa um gerenciador de conexões do Excel para se conectar a uma fonte de dados e o gerenciador de conexões especifica o arquivo de pasta de trabalho a ser usado. Para obter mais informações, consulte Gerenciador de conexões do Excel.

A fonte do Excel tem uma saída regular e uma saída de erro.

Configuração de origem do Excel

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

A caixa de diálogo Editor Avançado reflete todas as propriedades que podem ser definidas 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:

• Propriedades comuns

• Propriedades personalizadas do Excel

Para obter informações sobre como percorrer um grupo de arquivos do Excel, consulte Loop through Excel Files and Tables by Using a Foreach Loop Container.

Editor de código-fonte do Excel (página Gerenciador de conexões)

Utilize o nó Gestor de ligações da caixa de diálogo Editor de Fonte do Excel para selecionar a pasta de trabalho do Microsoft Excel a ser utilizada pela fonte. A fonte do Excel lê dados de uma folha de cálculo ou gama nomeada em um livro de trabalho existente.

Opções estáticas

Gerenciador de conexões OLE DB
Selecione um gerenciador de conexões do Excel 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 Gerenciador de Conexões do Excel .

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

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.

Opções dinâmicas do modo de acesso a dados

Modo de acesso a dados = Tabela ou vista

Nome da folha de Excel
Selecione o nome da planilha ou intervalo nomeado em uma lista dos disponíveis na pasta de trabalho do Excel.

Modo de acesso a dados = Nome da tabela ou variável de nome de exibição

Nome da variável
Selecione a variável que contém o nome da planilha ou do intervalo nomeado.

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 navegue até o arquivo que contém o texto da consulta clicando em Procurar.

Parâmetros
Se você inseriu uma consulta parametrizada usando ? como um espaço reservado para parâmetros no texto da consulta, use a caixa de diálogo Definir parâmetros de consulta para mapear parâmetros de entrada de consulta para variáveis de pacote.

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.

Analisar consulta
Verifique a sintaxe do texto da consulta.

Modo de acesso a dados = comando SQL da variável

Nome da variável
Selecione a variável que contém o texto da consulta SQL.

Editor de Origem do Excel (Página de Colunas)

Use a página Colunas da caixa de diálogo Editor de código-fonte do Excel para mapear uma coluna de saída para cada coluna externa (fonte).

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 a tarefa as lerá. Você pode alterar essa ordem limpando primeiro as colunas selecionadas na tabela discutida acima e, em seguida, selecionando colunas externas da lista em uma ordem diferente.

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 SSIS Designer.

Editor de código-fonte do Excel (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 Excel para selecionar opções de tratamento de erros e definir propriedades em colunas de saída de erro.

Opções

Entrada ou 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 Excel .

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.

Conteúdo relacionado

Carregar dados de ou para o Excel com o SQL Server Integration Services (SSIS)
Destino do Excel
Gerenciador de conexões do Excel