Compartilhar via

Destino do Excel

  • Artigo

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 de trabalho 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

A Gerenciador de Conexões do Excel usa o provedor Microsoft OLE DB para Jet 4.0 e seu driver ISAM (Método de Acesso Sequencial Indexado) do Excel para se conectar e ler e gravar dados em fontes de dados do Excel.

Muitos artigos existentes 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 antecessores, talvez você queira saber sobre determinados comportamentos que podem levar a resultados inesperados. Para obter informações gerais sobre o uso e comportamento do driver do Excel, consulte Como usar ADO com dados do Excel do Visual Basic ou do 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 aspas simples, consulte esta postagem no blog, Aspas simples são acrescentadas a todas as cadeias de caracteres quando os dados são transformados para Excel ao usar o componente de fluxo de dados de destino do Excel no pacote SSIS, no 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 design do pacote ou em tempo de execução, a instrução CREATE TABLE deverá usar LONGTEXT (ou um de seus sinônimos) como o tipo de dados da 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:

    • Float de precisão dupla numérica (DT_R8)

    • Moeda (DT_CY)

    • Booliano booliano (DT_BOOL)

    • Data/hora datetime (DT_DATE)

    • Cadeia de caracteres Unicode, comprimento 255 (DT_WSTR)

    • Fluxo de texto Unicode de Memorando (DT_NTEXT)

  • Conversões de tipo de dados e comprimento. O Integration Services não converte implicitamente tipos de dados. 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 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.

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

Consulte Também

Origem do Excel
Variáveis do SSIS (Integration Services)
Fluxo de Dados
Trabalhar com arquivos do Excel com a tarefa Script