Partilhar via

Destino do Excel

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

O destino do Excel carrega dados em folhas de cálculo ou intervalos nas 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 de ou para o Excel com o SQL Server Integration Services (SSIS).

Modos de Acesso

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

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

O destino do Excel tem uma entrada regular e uma saída de erro.

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:

Para obter mais informações sobre como definir propriedades, consulte Definir as propriedades de um componente de fluxo de dados.

Editor de destino do Excel (página Gerenciador de conexões)

Use a página Gerenciador de Conexões da caixa de diálogo Editor de Destino 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 Destino do Excel, mas pode ser definida usando o Editor Avançado. Além disso, certas opções de Carregamento Rápido estão disponíveis apenas no Editor Avançado. Para obter mais informações sobre essas propriedades, consulte a seção Destino do Excel de Propriedades personalizadas do Excel.

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

Opção Descrição
Tabela ou vista Carrega dados em uma planilha ou intervalo nomeado na fonte de dados do Excel.
Nome da tabela ou variável de nome de exibição Especifique o nome da planilha ou 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 folha de Excel
Selecione o destino do Excel na lista suspensa. Se a lista estiver vazia, clique em Novo.

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

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

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

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 Editor de Destino do Excel para mapear colunas de entrada para colunas de destino.

Opções

Colunas de entrada disponíveis
Veja a lista de colunas de entrada disponíveis. Use uma operação de arrastar e soltar para mapear as colunas de entrada disponíveis na tabela para as colunas de destino.

Colunas de destino disponíveis
Veja a lista de colunas de destino disponíveis. Use uma operação de arrastar e soltar para mapear colunas de destino disponíveis na tabela para colunas de entrada.

Coluna de Entrada
Veja as colunas de entrada selecionadas na tabela acima. Você pode alterar os mapeamentos usando a lista de Colunas de Entrada Disponíveis.

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

Editor de destino do Excel (página de saída de erro)

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

Opções

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

Coluna
Exiba as colunas externas (origem) selecionadas no nó Gestor de Conexões da caixa de diálogo Editor de Origem 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.

Ver também

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

  • Last updated on