# File Ingest

<figure><img src="/files/AJoMJ3yg8eff7HCrATB9" alt=""><figcaption></figcaption></figure>

A **File Ingest Task** permite ingerir arquivos a partir de sistemas de armazenamento remotos para o **Gaio DataOS**. Ela é comumente utilizada para automatizar a ingestão de dados provenientes de servidores externos, como **SFTP** ou **FTP**, possibilitando pipelines baseados em arquivos de forma repetível e confiável.

Essa task tem foco em conectar-se a uma fonte remota, selecionar arquivos por meio de padrões flexíveis e armazená-los localmente para processamento posterior.

***

### A File Ingest Task foi projetada para:

* Conectar-se a servidores de arquivos externos
* Fazer o download de um ou múltiplos arquivos
* Suportar padrões dinâmicos de seleção de arquivos
* Armazenar arquivos localmente para processamento posterior
* Habilitar fluxos de ingestão automatizados e agendados

***

### Como configurar o File Ingest

1. Defina um nome descritivo para a task.
2. Selecione o protocolo utilizado para acessar o servidor remoto.
3. Selecione o método de autenticação para a conexão:
   * Autenticação por senha (SFTP e FTP)
   * Autenticação por chave (SFTP e FTP)
   * Anônimo (sem senha)
4. Informe o hostname ou endereço IP do servidor remoto.
5. Especifique a porta utilizada pelo protocolo selecionado.
6. Informe o nome de usuário utilizado para autenticação.
7. Defina o padrão de importação:
   * Importar um arquivo específico
   * Importar todos os arquivos com uma determinada extensão
   * Importar todos os arquivos de uma pasta

{% hint style="warning" %}
Ao importar mais de um arquivo, o caminho da pasta remota deve terminar com `/*`.
{% endhint %}

8. Informe o caminho do arquivo ou da pasta no servidor remoto.
9. Defina onde os arquivos serão armazenados localmente.
10. Salve a configuração e execute a task.

***

### Boas práticas (File Ingest)

* Utilize nomes de arquivos explícitos sempre que possível
* Use curingas (*wildcards*) apenas quando necessário
* Sempre valide os caminhos remotos
* Mantenha os caminhos locais organizados por pipeline
* Parametrize nomes de arquivos para ingestões dinâmicas
* Teste a conectividade antes do uso em produção


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gaiodataos.com/gaio-dataos-portuguese/tools/tarefas/etl/file-ingest.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.