Gerenciador de conexões do Excel

Aplica-se a:Servidor SQL Tempo de execução da integração do SSIS no Azure Data Factory

Um gerenciador de conexões do Excel permite que um pacote se conecte a um arquivo de pasta de trabalho do Microsoft Excel. A origem do Excel e o destino do Excel que o Microsoft SQL Server Integration Services inclui usam o gerenciador de conexões do Excel.

Quando você adiciona um gerenciador de conexões do Excel a um pacote, o Integration Services cria um gerenciador de conexões que é resolvido como uma conexão do Excel em tempo de execução, define as propriedades do gerenciador de conexões e adiciona o gerenciador de conexões à coleção Connections no pacote.

A propriedade ConnectionManagerType do gerenciador de conexões é definida como EXCEL.

Configurar o Gerenciador de Conexões do Excel

Você pode configurar o gerenciador de conexões do Excel das seguintes maneiras:

• Especifique o caminho do arquivo da pasta de trabalho do Excel.

• Especifique a versão do Excel que foi usada para criar o arquivo.

• Indique se a primeira linha nas planilhas ou intervalos selecionados contém nomes de coluna.

Você pode definir propriedades por meio do SSIS Designer ou programaticamente.

Para obter informações sobre como configurar um gerenciador de conexões programaticamente, consulte ConnectionManager e Adicionando conexões programaticamente.

Editor do Gerenciador de Conexões do Excel

Use a caixa de diálogo Editor do Gerenciador de Conexões do Excel para adicionar uma conexão a um arquivo de pasta de trabalho do Microsoft Excel novo ou existente.

Opções

Caminho do arquivo do Excel
Digite o caminho e o nome de arquivo de um arquivo de pasta de trabalho do Excel existente ou novo.

Procurar
Use a caixa de diálogo Abrir para navegar até a pasta na qual o arquivo do Excel existe ou onde você deseja criar o novo arquivo.

Versão Excel
Especifique a versão do Microsoft Excel que foi usada para criar o arquivo.

A primeira linha tem nomes de colunas
Especifique se a primeira linha de dados na planilha selecionada contém nomes de coluna. O valor padrão dessa opção é True.

Solução para importar dados com tipos de dados mistos do Excel

Se você usar dados que contêm tipos de dados mistos, por padrão, o driver do Excel lê as primeiras 8 linhas (configuradas pela chave de registro TypeGuessRows ). Com base nas primeiras 8 linhas de dados, o driver do Excel tenta adivinhar o tipo de dados de cada coluna. Por exemplo, se sua fonte de dados do Excel tiver números e texto em uma coluna, se as primeiras 8 linhas contiverem números, o driver poderá determinar com base nessas primeiras 8 linhas que os dados na coluna são do tipo inteiro. Nesse caso, o SSIS ignora valores de texto e os importa como NULL para o destino.

Para resolver esse problema, você pode tentar uma das seguintes soluções:

• Altere o tipo de coluna do Excel para Texto no arquivo do Excel.

• Adicione a propriedade estendida IMEX à cadeia de conexão para substituir o comportamento padrão do driver. Quando você adiciona o "; IMEX=1" propriedade estendida até o final da cadeia de conexão, o Excel trata todos os dados como texto. Veja o seguinte exemplo:

  Provider=Microsoft.ACE.OLEDB.12.0;Data Source=C:\ExcelFileName.xlsx;Extended Properties="EXCEL 12.0 XML;HDR=YES;IMEX=1";
  

  Para que esta solução funcione de forma fiável, poderá ter de modificar também as definições do registo. O ficheiro main.cmd é o seguinte:

  reg add "HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Office\12.0\Access Connectivity Engine\Engines\Excel" /t REG_DWORD /v TypeGuessRows /d 0 /f
  reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\12.0\Access Connectivity Engine\Engines\Excel" /t REG_DWORD /v TypeGuessRows /d 0 /f
  reg add "HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Office\14.0\Access Connectivity Engine\Engines\Excel" /t REG_DWORD /v TypeGuessRows /d 0 /f
  reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\14.0\Access Connectivity Engine\Engines\Excel" /t REG_DWORD /v TypeGuessRows /d 0 /f
  reg add "HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Office\15.0\Access Connectivity Engine\Engines\Excel" /t REG_DWORD /v TypeGuessRows /d 0 /f
  reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\15.0\Access Connectivity Engine\Engines\Excel" /t REG_DWORD /v TypeGuessRows /d 0 /f
  reg add "HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Office\16.0\Access Connectivity Engine\Engines\Excel" /t REG_DWORD /v TypeGuessRows /d 0 /f
  reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\16.0\Access Connectivity Engine\Engines\Excel" /t REG_DWORD /v TypeGuessRows /d 0 /f
  

• Salve o arquivo no formato CSV e altere o pacote SSIS para oferecer suporte a uma importação CSV.

Tarefas relacionadas

Carregar dados de ou para o Excel com o SQL Server Integration Services (SSIS)
Fonte do Excel
Destino do Excel