> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar arquivos para o Cloud

> Saiba como enviar arquivos para o Cloud

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

ClickHouse Cloud oferece uma maneira fácil de importar seus arquivos e oferece suporte aos
seguintes formatos:

| Formato                         |
| ------------------------------- |
| `CSV`                           |
| `CSVWithNamesAndTypes`          |
| `CSVWithNames`                  |
| `JSONEachRow`                   |
| `TabSeparated`                  |
| `TabSeparatedWithNames`         |
| `TabSeparatedWithNamesAndTypes` |

<Steps>
  <Step title="Fazer upload de um arquivo" id="upload-file">
    Na página inicial do Cloud, selecione seu serviço, conforme mostrado abaixo:

    <Image img="https://mintcdn.com/private-7c7dfe99/REHSqgCLT_igIuJP/images/cloud/migrate/csv_01.webp?fit=max&auto=format&n=REHSqgCLT_igIuJP&q=85&s=c7ca14909861ea3bac9fd34c6e611842" alt="upload_file_02" width="3024" height="1483" data-path="images/cloud/migrate/csv_01.webp" />

    Se o seu serviço estiver inativo, você precisará ativá-lo.

    Selecione `Data sources` na aba à esquerda, conforme mostrado abaixo:

    <Image img="https://mintcdn.com/private-7c7dfe99/REHSqgCLT_igIuJP/images/cloud/migrate/csv_02.webp?fit=max&auto=format&n=REHSqgCLT_igIuJP&q=85&s=28fd0b1beb6c1f23c68eec997439b641" alt="upload_file_03" width="3024" height="1483" data-path="images/cloud/migrate/csv_02.webp" />

    Em seguida, selecione `Upload a file` no lado direito da página de fontes de dados:

    <Image img="https://mintcdn.com/private-7c7dfe99/REHSqgCLT_igIuJP/images/cloud/migrate/csv_03.webp?fit=max&auto=format&n=REHSqgCLT_igIuJP&q=85&s=3cbc85e9e6bd2fb2668c9337f1644b70" alt="upload_file_04" width="3024" height="1483" data-path="images/cloud/migrate/csv_03.webp" />

    Uma janela de seleção de arquivo será exibida, permitindo que você selecione o arquivo que deseja
    usar para inserir dados em uma tabela no seu serviço Cloud.

    <Image img="https://mintcdn.com/private-7c7dfe99/REHSqgCLT_igIuJP/images/cloud/migrate/csv_04.webp?fit=max&auto=format&n=REHSqgCLT_igIuJP&q=85&s=dc27310c9c632c0a9fce57edd74aa2e6" alt="upload_file_05" width="1267" height="736" data-path="images/cloud/migrate/csv_04.webp" />
  </Step>

  <Step title="Configurar tabela" id="configure-table">
    Depois que o arquivo for enviado, você poderá configurar a tabela na qual deseja
    inserir os dados. Uma prévia da tabela com as três primeiras linhas será exibida.

    <Image img="https://mintcdn.com/private-7c7dfe99/REHSqgCLT_igIuJP/images/cloud/migrate/csv_08.webp?fit=max&auto=format&n=REHSqgCLT_igIuJP&q=85&s=6389c7c8b16efcd392b21c388d5c7a23" alt="upload_file_08" width="3018" height="1476" data-path="images/cloud/migrate/csv_08.webp" />

    Agora você pode selecionar uma tabela de destino. As opções são:

    * uma nova tabela
    * uma tabela existente

    <br />

    Você pode especificar em qual banco de dados deseja carregar os dados e, no caso de
    uma nova tabela, o nome da tabela que será criada. Você também poderá selecionar a chave de ordenação:

    <Image img="https://mintcdn.com/private-7c7dfe99/REHSqgCLT_igIuJP/images/cloud/migrate/csv_05.webp?fit=max&auto=format&n=REHSqgCLT_igIuJP&q=85&s=dbefedaa90cdfef7f9e8e59680c86945" alt="upload_file_05" width="3016" height="1474" data-path="images/cloud/migrate/csv_05.webp" />

    As colunas lidas do arquivo são mostradas como `Source field` e, para cada campo, você
    pode alterar:

    * o tipo inferido
    * o valor padrão
    * se a coluna deve ser [Nullable](/docs/pt-BR/reference/data-types/nullable) ou não

    <Image img="https://mintcdn.com/private-7c7dfe99/REHSqgCLT_igIuJP/images/cloud/migrate/csv_06.webp?fit=max&auto=format&n=REHSqgCLT_igIuJP&q=85&s=1f65b44d27f08ee84c012d6f4965a16f" alt="upload_file_06" width="3012" height="1476" data-path="images/cloud/migrate/csv_06.webp" />

    <Info>
      **Excluindo campos**

      Você também pode remover um campo se não quiser incluí-lo na importação
    </Info>

    Você pode especificar o tipo de mecanismo de tabela que deseja usar:

    * `MergeTree`
    * `ReplacingMergeTree`
    * `SummingMergeTree`
    * `Null`

    <br />

    Você pode especificar uma expressão de chave de particionamento e uma
    expressão de chave primária.

    <Image img="https://mintcdn.com/private-7c7dfe99/REHSqgCLT_igIuJP/images/cloud/migrate/csv_07.webp?fit=max&auto=format&n=REHSqgCLT_igIuJP&q=85&s=32e78db4d20f738542e4e1a300150756" alt="upload_file_07" width="3004" height="1476" data-path="images/cloud/migrate/csv_07.webp" />

    Clique em `Import to ClickHouse` (mostrado acima) para importar os dados. A importação de dados será colocada em
    fila, como indicado pelo indicador de status `queued` na coluna `Status`, conforme mostrado abaixo. Você também pode clicar em
    `Open as query` (mostrado acima) para abrir a consulta de inserção no SQL Console. A consulta inserirá
    o arquivo que foi enviado para um bucket do S3 usando a função de tabela `URL`.

    <Image img="https://mintcdn.com/private-7c7dfe99/REHSqgCLT_igIuJP/images/cloud/migrate/csv_09.webp?fit=max&auto=format&n=REHSqgCLT_igIuJP&q=85&s=4e8a6fdf4349f051c1e127040758f4d9" alt="upload_file_09" width="1271" height="487" data-path="images/cloud/migrate/csv_09.webp" />

    Se a operação falhar, você verá um indicador de status `failed` na coluna `Status` da
    aba `Data upload history`. Você pode clicar em `View Details` para obter mais informações
    sobre o motivo da falha do upload. Talvez seja necessário modificar a configuração da tabela ou limpar
    os dados com base na mensagem de erro da inserção com falha.

    <Image img="https://mintcdn.com/private-7c7dfe99/REHSqgCLT_igIuJP/images/cloud/migrate/csv_10.webp?fit=max&auto=format&n=REHSqgCLT_igIuJP&q=85&s=74f15da39ec723a05c0b475100070f87" alt="upload_file_11" width="1260" height="262" data-path="images/cloud/migrate/csv_10.webp" />
  </Step>
</Steps>
