Partilhar via


Gestor de Ligações de Ficheiros

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

Um gerenciador de conexões de arquivo permite que um pacote faça referência a um arquivo ou pasta existente ou crie um arquivo ou pasta em tempo de execução. Por exemplo, você pode fazer referência a um arquivo do Excel. Determinados componentes no Microsoft SQL Server Integration Services usam informações em arquivos para executar seu trabalho. Por exemplo, uma tarefa Executar SQL pode fazer referência a um arquivo que contém as instruções SQL que a tarefa executa. Outros componentes executam operações em arquivos. Por exemplo, a tarefa Sistema de arquivos pode fazer referência a um arquivo para copiá-lo para um novo local.

Tipos de uso do Gerenciador de conexões de arquivo

A propriedade FileUsageType do gerenciador de conexões File especifica como a conexão de arquivo é usada. O Gerenciador de conexões de arquivo pode criar um arquivo, criar uma pasta, usar um arquivo existente ou usar uma pasta existente.

A tabela a seguir lista os valores de FileUsageType.

Valor Descrição
0 O gerenciador de conexões de arquivo usa um arquivo existente.
1 O gerenciador de conexões de arquivo cria um arquivo.
2 O gerenciador de conexões de arquivo usa uma pasta existente.
3 O gerenciador de conexões de arquivo cria uma pasta.

Várias conexões de arquivo ou pasta

O Gerenciador de conexões de arquivo pode fazer referência a apenas um arquivo ou pasta. Para fazer referência a vários arquivos ou pastas, use um gerenciador de conexões de vários arquivos em vez de um gerenciador de conexões de arquivos. Para obter mais informações, consulte Gerenciador de conexões de vários arquivos.

Configuração do File Connection Manager

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

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

Você pode configurar um gerenciador de conexões de arquivo das seguintes maneiras:

  • Especifique o tipo de uso.

  • Especifique um arquivo ou pasta.

Você pode definir a propriedade ConnectionString para o gerenciador de conexões File especificando uma expressão na janela Propriedades do SSDT (SQL Server Data Tools). No entanto, para evitar um erro de validação quando você usa uma expressão para especificar o arquivo ou pasta, no Editor do Gerenciador de Conexões de Arquivo, para Arquivo/Pasta, adicione um caminho de arquivo ou pasta.

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

Use a caixa de diálogo Editor do Gerenciador de Conexões de Arquivo para especificar as propriedades usadas para se conectar a um arquivo ou pasta.

Observação

Você pode definir a propriedade ConnectionString para o gerenciador de conexões File especificando uma expressão na janela Propriedades do SSDT (SQL Server Data Tools). No entanto, para evitar um erro de validação quando você usa uma expressão para especificar o arquivo ou pasta, no Editor do Gerenciador de Conexões de Arquivo, para Arquivo/Pasta, adicione um caminho de arquivo ou pasta.

Para saber mais sobre o Gerenciador de conexões de arquivo, consulte Gerenciador de conexões de arquivo.

Opções

Tipo de Utilização
Especifique se o Gerenciador de Conexões de Arquivo se conecta a um arquivo ou pasta existente ou cria um novo arquivo ou pasta.

Valor Descrição
Criar ficheiro Crie um novo arquivo em tempo de execução.
Ficheiro existente Use um arquivo existente.
Criar pasta Crie uma nova pasta em tempo de execução.
Pasta existente Use uma pasta existente.

Arquivo / Pasta
Se Arquivo, especifique o arquivo a ser usado.

Se Pasta, especifique a pasta a ser usada.

Navegar
Selecione o arquivo ou pasta usando a caixa de diálogo Selecionar arquivo ou Procurar pasta .

Adicionar Referência da Interface de Utilizador da Caixa de Diálogo Gestor de Conexões de Arquivo

Use a caixa de diálogo Adicionar Gerenciador de Conexões de Arquivo para definir uma conexão com um grupo de arquivos ou pastas.

Para saber mais sobre o gerenciador de conexões de vários arquivos, consulte Gerenciador de conexões de vários arquivos.

Observação

As tarefas internas e os componentes de fluxo de dados no Integration Services não usam o gerenciador de conexões de vários arquivos. No entanto, você pode usar esse gerenciador de conexões na tarefa Script ou no componente Script.

Opções da caixa de diálogo para Adicionar Gerenciador de Conexões de Arquivo

Tipo de utilização
Especifique o tipo de arquivos a serem usados para o gerenciador de conexões de vários arquivos.

Valor Descrição
Criar ficheiros O gerenciador de conexões criará os arquivos.
Arquivos existentes O gerenciador de conexões usará arquivos existentes.
Criar pastas O gerenciador de conexões criará as pastas.
Pastas existentes O gerenciador de conexões usará pastas existentes.

Ficheiros / Pastas
Exiba os arquivos ou pastas que você adicionou usando os botões descritos a seguir.

Adicionar
Adicione um arquivo usando a caixa de diálogo Selecionar arquivos ou adicione uma pasta usando a caixa de diálogo Procurar pasta .

Editar
Selecione um ficheiro ou pasta e, em seguida, substitua-o por um ficheiro ou pasta diferente utilizando a caixa de diálogo Selecionar Ficheiros ou Procurar Pasta .

Remover
Selecione um arquivo ou pasta e remova-o da lista usando o botão Remover .

Botões de seta
Selecione um arquivo ou pasta e use os botões de seta para movê-lo para cima ou para baixo para especificar a sequência de acesso.

Referência da interface de utilizador da caixa de diálogo Sugerir tipos de coluna

Use a caixa de diálogo Sugerir Tipos de Coluna para identificar o tipo de dados e o comprimento das colunas em um Gerenciador de Conexões de Arquivo Simples com base em uma amostra do conteúdo do arquivo.

Para saber mais sobre os tipos de dados usados pelo Integration Services, consulte Tipos de dados do Integration Services.

Opções da caixa de diálogo para Sugerir Tipos de Coluna

Número de linhas
Digite ou selecione o número de linhas no exemplo que o algoritmo usa.

Sugira o menor tipo de dados inteiros
Desmarque esta caixa de seleção para ignorar a avaliação. Se selecionado, determina o menor tipo de dados inteiro possível para colunas que contêm dados numéricos integrais.

Sugira o menor tipo de dados reais
Desmarque esta caixa de seleção para ignorar a avaliação. Se selecionada, determina se as colunas que contêm dados numéricos reais podem usar o tipo de dados real menor, DT_R4.

Identifique colunas booleanas usando os seguintes valores
Digite os dois valores que você deseja usar como os valores booleanos true e false. Os valores devem ser separados por uma vírgula e o primeiro valor representa True.

Preencher colunas de texto
Marque essa caixa de seleção para habilitar o preenchimento de cadeia de caracteres.

Percentagem de preenchimento
Digite ou selecione a porcentagem dos comprimentos de coluna para aumentar o comprimento das colunas para tipos de dados de caracteres. A percentagem deve ser um número inteiro.

Referência de Erro e Mensagem dos Serviços de Integração