Compartilhar via


Origem do Excel

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

A origem do Excel extrai dados de planilhas ou intervalos em pastas de trabalho do Microsoft Excel.

Importante

Para obter informações detalhadas sobre como se conectar a arquivos do Excel, e sobre limitações e problemas conhecidos para carregar dados de ou para arquivos do Excel, consulte Carregar dados do ou para o Excel com o SSIS (SQL Server Integration Services).

Modos de acesso

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

  • Uma tabela ou exibição.

  • 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 armazenados em uma variável.

A origem 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 da planilha de trabalho a ser usado. Para obter mais informações, consulte Excel Connection Manager.

A origem do Excel tem uma saída comum e uma saída de erro.

Configuração da origem do Excel

Você pode definir propriedades pelo Designer do SSIS 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 podem ser definidas na caixa de diálogo Editor Avançado ou programaticamente, clique em um dos seguintes tópicos:

Para obter informações sobre loop através de um grupo de arquivos do Excel, consulte Loop por meio de arquivos do Excel e tabelas usando um contêiner de Loop Foreach.

Editor de Origem do Excel (página Gerenciador de Conexões)

Use o nó Gerenciador de Conexões da caixa de diálogo Editor de Origem do Excel para selecionar a pasta de trabalho do Microsoft Excel para a origem que será usada. A origem do Excel lê os dados de uma planilha ou intervalo nomeado em uma pasta de trabalho existente.

Observação

A propriedade CommandTimeout da origem do Excel não está disponível no Editor de Origem do Excel, mas ela pode ser definida usando o Editor Avançado. Para obter mais informações sobre esta propriedade, consulte a seção Origem do Excel em Excel Custom Properties.

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 Nova.

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 os dados da origem.

Valor Descrição
Tabela ou exibição Recupere dados de uma planilha ou intervalo nomeado no arquivo do Excel.
Nome da tabela ou variável do nome de exibição Especifique a planilha ou o nome do intervalo em uma variável.

Informações relacionadas: Usar variáveis em pacotes
Comando SQL Recupere os dados do arquivo do Excel usando uma consulta SQL.
Comando SQL a partir da variável Especifique o texto da consulta SQL em uma variável.

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

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

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

Nome da planilha do Excel
Selecione o nome da planilha ou o intervalo nomeado na lista disponível na pasta de trabalho do Excel.

Modo de acesso aos dados = Variável do nome da tabela ou do 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 aos dados = Comando SQL

Texto do comando SQL
Insira o texto de uma consulta SQL, crie a consulta clicando em Construir Consultaou procure 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 o parâmetro no texto da consulta, use a caixa de diálogo Definir Parâmetros da Consulta para mapear os parâmetros de entrada da consulta para as variáveis do pacote.

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.

Analisar consulta
Verifique a sintaxe do texto da consulta.

Modo de acesso aos dados = Comando SQL a partir 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 Colunas)

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

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 (fonte) na ordem em que serão lidas pela tarefa. Você pode alterar essa ordem desmarcando as colunas selecionadas na tabela discutida acima e 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 (origem) selecionada; porém, é possível escolher qualquer nome descritivo exclusivo. O nome fornecido será exibido no Designer do SSIS .

Editor de Origem do Excel (página Saída de Erro)

Use a página Saída de Erro da caixa de diálogo Editor de Origem do Excel para selecionar opções de tratamento de erro e definir propriedades em colunas de saída de erros.

Opções

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

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

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.

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