Destino do Excel

Artigo
09/10/2014

O destino do Excel carrega dados em planilhas ou intervalos em pastas de trabalho do Microsoft Excel.

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.

Importante
No Excel, uma planilha ou intervalo é equivalente a uma tabela ou exibição. As listas de tabelas disponíveis nos Editores de Origem e Destino do Excel exibem somente planilhas existentes (identificadas pelo sinal $ anexado ao nome da planilha, por exemplo, Planilha1$) e os intervalos nomeados (identificados pela ausência desse sinal $, como MyRange).

Considerações de uso

O gerenciador de conexões do Excel usa o provedor Microsoft OLE DB para Jet 4.0 e driver de método de acesso sequencial indexado (ISAM) do Excel para se conectar; e lê e grava dados nas fontes de dados do Excel.

Muitos artigos da Base de Dados de Conhecimento da Microsoft documentam o comportamento desse provedor e driver e, embora esses artigos não sejam específicos do Integration Services ou de seus serviços de transformação de dados anteriores, talvez você queira obter mais informações sobre determinados comportamentos que podem levar a resultados inesperados. Para obter informações gerais sobre o uso e o comportamento do driver do Excel, consulte COMO: usar o ADO com dados do Excel no Visual Basic ou VBA.

Os seguintes comportamentos do provedor Jet que está incluído no driver do Excel podem levar a resultados inesperados ao salvar dados em um destino do Excel.

Salvando dados de texto. Quando o driver do Excel salva valores de dados de texto em um destino do Excel, o driver coloca aspas simples (') antes do texto de cada célula para garantir que os valores salvos serão interpretados como texto. Se você tem ou desenvolve outros aplicativos que leem ou processam os dados salvos, será necessário incluir um tratamento especial para as aspas simples que precedem cada texto.

Para obter informações sobre como evitar incluir as aspas simples, consulte este post do blog, Single quote is appended to all strings when data is transformed to excel when using Excel destination data flow component in SSIS package (Aspas simples são acrescentadas a todas as cadeias de caracteres quando os dados são transformados em Excel ao usar o componente de fluxo de dados de destino do Excel no pacote SSIS), em msdn.com.
Salvando dados de memorando (ntext). Antes de salvar com sucesso cadeias de caracteres com mais de 255 caracteres em uma coluna do Excel, o driver deve reconhecer o tipo de dados da coluna de destino como memorando e não como cadeia de caracteres. Se a tabela de destino já contém linhas de dados, então as primeiras linhas que serão amostradas pelo driver devem conter pelo menos uma instância com um valor maior que 255 caracteres na coluna de memorando. Se a tabela de destino for criada durante o desenvolvimento do pacote ou em tempo de execução, a instrução CREATE TABLE deve usar o tipo de dados LONGTEXT (ou um de seus sinônimos) para a coluna de memorando.
Tipos de dados. O driver do Excel reconhece apenas um conjunto limitado de tipos de dados. Por exemplo, todas as colunas numéricas são interpretadas como duplas (DT_R8) e todas as colunas de cadeia de caracteres (que não sejam colunas de memorando) são interpretadas como cadeias Unicode de 255 caracteres (DT_WSTR). O Integration Services mapeia os tipos de dados do Excel da seguinte maneira:
- Numérico flutuante de precisão dupla (DT_R8)
- Moeda moeda (DT_CY)
- Booliano Booliano (DT_BOOL)
- Data/hora datetime (DT_DATE)
- Cadeia de caracteres cadeia de caracteres Unicode, 255 de comprimento (DT_WSTR)
- Memorando fluxo de texto Unicode (DT_NTEXT)
Conversões de comprimento e tipo de dados. O Integration Services não converte tipos de dados implicitamente. Como resultado, talvez seja necessário usar as transformações Coluna Derivada ou Conversão de Dados para converter explicitamente os dados do Excel antes de carregá-los em um destino que não seja Excel ou para converter dados que não sejam do Excel antes de carregá-los em um destino do Excel. Nesse caso, pode ser útil criar o pacote inicial usando o Assistente de Importação e Exportação, que configura as conversões necessárias. Alguns exemplos de conversões que podem ser necessárias incluem:
- Conversão entre colunas de cadeia de caracteres Unicode e não Unicode do Excel com páginas de código específicas.
- Conversão entre colunas de cadeia de 255 caracteres e de comprimentos diferentes do Excel.
- Conversão entre colunas numéricas de precisão dupla e outros tipos de colunas numéricas do Excel.

Configuração do 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 pelo Designer do SSIS ou programaticamente.

Para obter mais informações sobre as propriedades que podem ser definidas na caixa de diálogo Editor de Destinos do Excel, clique em um dos seguintes tópicos:

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 propriedades, consulte Definir as propriedades de um componente de fluxo de dados.

Tarefas relacionadas

Conteúdo relacionado

Entrada no blog, Excel in Integration Services, Part 1 of 3: Connections and Components (Excel no Integration Services, Parte 1 de 3: conexões e componentes), em dougbert.com
Entrada no blog, Excel in Integration Services, Part 2 of 3: Tables and Data Types (Excel no Integration Services, Parte 2 de 3: tabelas e tipos de dados), em dougbert.com.
Entrada no blog, Excel in Integration Services, Part 3 of 3: Issues and Alternatives (Excel no Integration Services, Parte 3 de 3: problemas e alternativas), em dougbert.com.

Mantenha-se atualizado com o Integration Services

Para obter os downloads, artigos, exemplos e vídeos mais recentes da Microsoft, assim como soluções selecionadas pela comunidade, visite a página do Integration Services no MSDN: