Compartilhar via


Destino do Excel

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

O destino do Excel carrega dados em 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

O destino do Excel fornece três modos de acesso diferentes para carregar 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.

Configurar o destino do Excel

O destino 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 Excel Connection Manager.

O destino do Excel 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 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 mais informações sobre como definir as propriedades, consulte Definir as propriedades de um componente de fluxo de dados.

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

Use a página Gerenciador de Conexões da caixa de diálogo Editor de Destinos do Excel para especificar informações da fonte de dados e visualizar os resultados. O destino do Excel carrega dados em uma planilha ou um intervalo nomeado em uma pasta de trabalho do Microsoft Excel .

Observação

A propriedade CommandTimeout do destino do Excel não está disponível no Editor de Destinos do Excel, mas pode ser definida com o Editor Avançado. Além disso, determinadas opções de carregamento rápido só estarão disponíveis no Editor Avançado. Para obter mais informações sobre essas propriedades, consulte a seção Destino do Excel em Excel Custom Properties.

Opções estáticas

Gerenciador de conexões do Excel
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.

Opção Descrição
Tabela ou exibição Carregue dados em uma planilha ou intervalo nomeado na fonte de dados 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 Carregue dados no destino do Excel usando uma consulta SQL.

Nome da planilha do Excel
Selecione o destino do Excel da listagem suspensa. Se a lista estiver vazia, clique em Novo.

Novo
Clique em Novo para iniciar a caixa de diálogo Criar Tabela . Quando você clicar em OK, a caixa de diálogo cria o arquivo Excel para o qual o Gerenciador de Conexões do Excel aponta.

Exibir dados existentes
Visualize os resultados usando a caixa de diálogo Visualizar Resultados da Consulta . 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 fonte de dados.

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

Analisar Consulta
Verifique a sintaxe do texto da consulta.

Editor de Destino do Excel (página Mapeamentos)

Use a página Mapeamentos da caixa de diálogo do Editor de Destinos do Excel para mapear colunas de entrada para colunas de destino.

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
Exibir colunas de entrada selecionadas na tabela acima. É possível alterar os mapeamentos usando a lista Colunas de Entrada Disponíveis.

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

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

Use a página Avançado da caixa de diálogo Editor de Destinos do Excel para especificar opções de tratamento de erro.

Opções

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

Coluna
Veja as colunas externas (origem) que você selecionou no nó 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.

Consulte Também

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