# Uma importação falha

> Por que um arquivo de mídia é recusado ou falha ao importar, e o que mudar.

Source: https://alexgalhardo.github.io/vukem-video/pt-br/docs/troubleshooting/import-fails/

## O que você vai aprender

- como ver por que uma importação falhou;
- as recusas que vêm do caminho, do arquivo e dos limites;
- o que fazer em cada uma.

## A ideia

Uma importação tem duas etapas. Primeiro o servidor confere o **caminho** e coloca o arquivo na fila: um caminho ruim é recusado na hora. Depois a tarefa de **ingestão** lê o arquivo com o ffprobe, gera o proxy, as miniaturas e os picos de áudio, e termina no estado `ready`, ou `failed` com um motivo. A biblioteca mostra o estado de cada mídia (**Aguardando**, **Importando**, **Pronta** ou **Falhou**) e uma que falhou tem **Tentar de novo**.

## Início rápido

1. Leia o motivo: o cartão com falha na biblioteca, ou a CLI.
2. Associe-o à tabela.
3. Corrija e importe de novo. O mesmo arquivo importado duas vezes não acrescenta nada, porque os originais são guardados por conteúdo.

```bash
vukem-video media:list --project prj_7k2m9x4q1b
vukem-video media:inspect ast_4h6j8k2m3n --project prj_7k2m9x4q1b --sections probe
vukem-video doctor --full
```

| O que você vê | Causa | Correção |
| --- | --- | --- |
| `E_FILE_NOT_FOUND` (modo local) | o caminho não existe | confira o caminho; cole o caminho absoluto, um navegador não consegue lê-lo de um arquivo solto |
| `E_PATH_NOT_ALLOWED` | uma URL, um caminho UNC ou de dispositivo, um caminho relativo, um `..`, um diretório ou um arquivo que não é comum | informe o caminho absoluto de um arquivo comum nesta máquina |
| `E_PATH_NOT_ALLOWED` no modo de rede | o arquivo não está dentro de `VUKEM_VIDEO_IMPORT_ROOTS`, ou não existe: a resposta é a mesma de propósito | peça ao operador que adicione o diretório às raízes de importação |
| um arquivo maior que 8 GiB | `VUKEM_VIDEO_MAX_IMPORT_BYTES` | aumente o limite, ou corte o arquivo antes |
| mais longo que 4 horas | `VUKEM_VIDEO_MAX_IMPORT_SECONDS` | aumente-o, ou corte o arquivo |
| um quadro maior que 7680 x 4320, ou um lado acima de 8192 | `VUKEM_VIDEO_MAX_IMPORT_PIXELS` | reduza a escala da origem |
| `E_FFMPEG_MISSING` | nenhum FFmpeg utilizável | veja [FFmpeg, codecs e licenças](/docs/self-hosting/ffmpeg-and-licences) |
| `E_ASSET_NOT_READY` em uma edição | a mídia ainda está em ingestão | espere por `ready`, depois repita; pode ser repetido |
| `E_RATE_LIMITED` | mais de 10 importações por minuto | espere o `Retry-After` |
| `E_QUEUE_FULL` | ingestões demais ao mesmo tempo (`VUKEM_VIDEO_MAX_INGESTS`) | repita em breve |
| o arquivo termina `failed` com um motivo de codec | o arquivo está danificado ou em um formato que o FFmpeg não consegue ler | exporte o arquivo de novo a partir da origem, ou converta-o para MP4 |

Se o servidor está abaixo de `VUKEM_VIDEO_MIN_FREE_BYTES` (2 GiB) de espaço livre no volume do espaço de trabalho, as gravações são recusadas até você liberar espaço.

## Erros comuns

- Importar de um compartilhamento de rede ou de uma unidade removível que desaparece: o original é copiado para o espaço de trabalho uma vez, mas uma unidade que se desconecta durante a cópia faz a importação falhar.
- Ler `E_PATH_NOT_ALLOWED` como um problema de permissões no modo de rede. Ele também esconde se o arquivo existe.

## Próximos passos

- [Biblioteca de mídia](/docs/guide/media-library)
- [O pacote de diagnóstico](/docs/troubleshooting/diagnostic-bundle)
