Carregamento de dados usando a interface da Web

Você pode usar a Snowsight ou Classic Console para carregar arquivos com dados estruturados (por exemplo, CSV, TSV) ou dados semiestruturados (por exemplo, JSON, Avro, ORC, Parquet ou XML).

Use a interface da Web para carregar dados de arquivos de até 50MB. Para carregar arquivos maiores ou um grande número de arquivos, use o cliente Snowflake, SnowSQL. Consulte Carregamento em massa a partir de um sistema de arquivo local.

Neste tópico:

Carregamento de dados usando o Snowsight

Você pode usar Snowsight para carregar arquivos nos seguintes cenários:

  • Carregar um arquivo ou vários arquivos da sua máquina local em uma tabela existente.

  • Carregar um arquivo de um estágio em uma tabela existente.

  • Criar uma nova tabela ao carregar um arquivo local ou preparado. Snowsight usa a função de tabela INFER_SCHEMA para detectar automaticamente o esquema de metadados do arquivo, recuperar as definições de coluna e gerar uma nova tabela. Observe que este recurso está em versão preliminar e não oferece suporte a arquivos XML.

Você pode carregar dados de arquivos individuais com tamanho de até 50 MB.

Nota

Para usar a Snowsight para carregar dados, você deve usar uma função que tenha o privilégio OWNERSHIP na tabela para a qual deseja carregar dados e o privilégio USAGE no banco de dados e no esquema que contêm a tabela. Consulte Privilégios de tabela.

Se você quiser usar um formato de arquivo nomeado, sua função também terá que receber o privilégio USAGE nesse formato de arquivo específico.

Carregamento de arquivos de sua máquina local para uma tabela existente

  1. Entre em Snowsight.

  2. No menu de navegação, selecione Data » Databases.

  3. Selecione um banco de dados e um esquema específicos.

  4. No explorador de objetos, selecione a tabela na qual você deseja carregar os dados.

  5. Selecione Load Data.

  6. Na caixa de diálogo Load Data into Table, selecione Browse.

  7. Adicione arquivos de dados estruturados ou semiestruturados.

  8. Se não houver um warehouse padrão definido para o usuário, selecione um warehouse.

  9. Selecione Next.

  10. Faça uma das seguintes opções:

    • Selecione um formato de arquivo do banco de dados atual.

    • Selecione um tipo de arquivo para personalizar e, em seguida, selecione as configurações relevantes para seu arquivo de dados.

  11. (Opcional) Selecione o que deve acontecer se ocorrer um erro durante o carregamento. Por padrão, nenhum dado é carregado do arquivo.

  12. Selecione Load.

    O Snowsight carrega seu arquivo e exibe o número de linhas inseridas com êxito na tabela.

  13. Faça uma das seguintes opções:

    • Para abrir uma planilha com sintaxe SQL para consultar sua tabela, selecione Query Data.

    • Para fechar a caixa de diálogo, selecione Done.

    Se seu arquivo não puder ser carregado, por exemplo, se as colunas do arquivo não corresponderem às colunas especificadas na tabela, uma mensagem de erro será exibida. Para ajustar suas configurações, selecione Back.

Carregamento de um arquivo de um estágio em uma tabela existente

Antes de carregar arquivos de um estágio em uma tabela, você precisa criar um estágio e fazer o upload de arquivos para o estágio. Para obter instruções, consulte Preparação de arquivos usando o Snowsight.

  1. Entre em Snowsight.

  2. No explorador de objetos, selecione o estágio do qual deseja carregar os arquivos.

  3. Na lista de arquivos no estágio, selecione o arquivo que deseja carregar na tabela.

  4. No menu suspenso de reticências do arquivo selecionado, selecione Load into table.

  5. Na caixa de diálogo Load Data into Table, selecione um banco de dados, esquema e uma tabela onde deseja carregar o arquivo.

  6. Selecione Next.

  7. Faça uma das seguintes opções:

    • Selecione um formato de arquivo do banco de dados atual.

    • Selecione um tipo de arquivo para personalizar e, em seguida, selecione as configurações relevantes para seu arquivo de dados.

  8. (Opcional) Selecione o que deve acontecer se ocorrer um erro durante o carregamento. Por padrão, nenhum dado é carregado do arquivo.

  9. Selecione Load.

    Snowsight carrega seu arquivo do estágio para a tabela.

Como alternativa, você pode carregar um arquivo preparado em uma tabela copiando o caminho do arquivo preparado.

  1. Siga as etapas 1 a 3 do procedimento anterior.

  2. No menu suspenso de reticências do arquivo selecionado no estágio, selecione Copy path.

  3. No explorador de objetos, selecione a tabela na qual você deseja carregar os dados.

  4. Selecione Load Data.

  5. Na caixa de diálogo Load Data into Table que aparece, selecione Add from Stage.

  6. Cole o caminho que você copiou no campo de caminho e selecione Add.

    O nome do arquivo preparado é exibido.

  7. Selecione Next.

  8. Faça uma das seguintes opções:

    • Selecione um formato de arquivo do banco de dados atual.

    • Selecione um tipo de arquivo para personalizar e, em seguida, selecione as configurações relevantes para seu arquivo de dados.

  9. (Opcional) Selecione o que deve acontecer se ocorrer um erro durante o carregamento. Por padrão, nenhum dado é carregado do arquivo.

  10. Selecione Load.

    Snowsight carrega seu arquivo e exibe o número de linhas inseridas com êxito na tabela.

Criação de uma tabela ao carregar um arquivo

Você pode criar uma nova tabela ao carregar um arquivo seguindo as etapas a seguir. Como alternativa, você pode abrir a caixa de diálogo Load Data into Table em um estágio seguindo as etapas 1-4 da seção anterior Carregamento de um arquivo de um estágio em uma tabela existente e depois executar as etapas a seguir 6-10 para concluir as mesmas tarefas.

Nota

Este recurso suporta arquivos delimitados, arquivos JSON, Parquet, Avro e ORC. Ele não oferece suporte a arquivos XML.

Para executar as tarefas abaixo, você deve ter os privilégios para criação de tabela.

  1. Entre em Snowsight.

  2. No menu de navegação, selecione Data » Databases.

  3. Selecione um banco de dados e um esquema específicos.

  4. Selecione Create.

  5. No menu suspenso, selecione Table » From File.

  6. Na caixa de diálogo Load Data into Table, selecione Browse to add a file ou Drag and drop a file to the dialog ou Add a file from stage. Opcionalmente, escolha o local do seu arquivo.

  7. Selecione um banco de dados e um esquema onde deseja que a tabela seja criada.

  8. Digite um nome para a nova tabela e selecione Next.

    Snowsight detecta o esquema de metadados do arquivo e retorna o formato do arquivo e as definições de coluna identificadas pela função INFER_SCHEMA.

  9. Revise o formato do arquivo inferido, o tipo de dados, o nome da coluna e uma amostra dos dados da coluna. Certifique-se de que todas as informações estejam precisas e faça atualizações, se necessário.

  10. Selecione Load.

    Snowsight carrega o arquivo e cria uma nova tabela para o arquivo.

Carregamento de dados usando o Console Clássico

O Classic Console oferece um assistente conveniente para carregar quantidades limitadas de dados em uma tabela a partir de um pequeno conjunto de arquivos. O assistente executa as mesmas operações PUT e COPY que você faria usando SQL, mas combina as duas fases (preparação de arquivos e carregamento de dados) em uma única operação e exclui todos os arquivos preparados após a conclusão do carregamento.

Você pode carregar dados a partir de arquivos em sua máquina local ou arquivos já preparados em um local de armazenamento em nuvem existente no Snowflake, Amazon S3, Google Cloud Storage ou Microsoft Azure.

Pré-requisitos para o carregamento de dados

Antes de começar a carregar dados usando Classic Console, faça o seguinte:

  • Identifique a localização de seus arquivos de dados. Você pode carregar dados de um dos seguintes itens:

    • Seu computador local.

    • Um estágio interno ou externo.

    • Um local de armazenamento em nuvem no Amazon S3, Google Cloud Storage ou Microsoft Azure que ainda não tenha sido adicionado ao Snowflake como um estágio externo.

  • Determine o tamanho de seus arquivos de dados. Cada arquivo que você carrega pode ter até 50MB. Se você quiser carregar arquivos maiores ou um grande número de arquivos, use o cliente Snowflake, SnowSQL, em vez disso. Consulte Carregamento em massa a partir de um sistema de arquivo local.

A função que você usa para carregar dados deve ter os privilégios adequados:

  • Para carregar dados, sua função deve ter o privilégio USAGE no banco de dados e no esquema que contém a tabela na qual você carrega os dados.

  • Para criar um estágio ao carregar dados, sua função deve ter o privilégio CREATE STAGE no esquema do banco de dados.

  • Para criar um formato de arquivo ao carregar dados, sua função deve ter o privilégio CREATE FILE FORMAT no esquema do banco de dados.

Início do carregamento de dados

Para começar a carregar um arquivo em uma tabela específica, faça o seguinte:

  1. Selecione Databases Databases tab.

  2. Selecione um banco de dados e um esquema específicos.

  3. Selecione a guia Tables.

  4. Localize a tabela na qual você deseja carregar os dados.

  5. Comece a carregar dados em uma tabela específica executando uma das seguintes ações:

    • Selecione uma linha da tabela e, em seguida, selecione Load Data.

    • Clique um nome de tabela para abrir a página de informações da tabela. Depois, selecione Load Table.

    O assistente Load Data é aberto.

  6. Selecione um warehouse a ser usado para carregar dados na tabela. O menu suspenso inclui qualquer warehouse no qual você tenha o privilégio USAGE.

  7. Selecione Next.

Seleção dos dados a serem carregados

Dependendo de onde você escolher para carregar os dados, siga as etapas relevantes. Se você quiser carregar dados de vários locais, use o assistente Load Data várias vezes.

Para carregar dados de seu computador:

  1. Selecione a opção Load files from your computer e Select Files para navegar até os arquivos que deseja carregar.

  2. Selecione um ou mais arquivos de dados locais e selecione Open.

  3. Selecione Next.

Para carregar dados de um estágio existente:

  1. Selecione a opção Load files from external stage.

  2. Selecione um estágio existente a partir da lista suspensa Stage.

  3. (Opcional) Especifique um caminho para os arquivos no estágio.

  4. Selecione Next.

Para criar um estágio, por exemplo, para carregar dados do armazenamento em nuvem externo:

  1. Selecione a opção Load files from external stage.

  2. Selecione + ao lado da lista suspensa Stage.

  3. Selecione o serviço de armazenamento em nuvem compatível onde seus arquivos estão localizados.

  4. Selecione Next.

  5. Preencha os campos para descrever seu estágio. Para obter mais informações, consulte CREATE STAGE.

  6. Selecione Finish.

    Seu novo estágio é selecionado automaticamente na lista suspensa Stage.

  7. (Opcional) Especifique um caminho para os arquivos no estágio.

  8. Selecione Next.

Conclusão do carregamento de dados

Depois de selecionar os arquivos a serem carregados, termine de carregar os dados em sua tabela.

Nota

Se seu warehouse não estiver em execução quando você terminar de carregar os dados, será necessário aguardar a retomada do warehouse (até 5 minutos) para que os dados sejam carregados.

Para concluir o carregamento de dados, faça o seguinte:

  1. Selecione um formato de arquivo nomeado existente a partir da lista suspensa ou crie um.

    Para criar um formato de arquivo:

    1. Selecione + ao lado da lista suspensa.

    2. Preencha os campos na tela para corresponder ao formato de seus arquivos de dados. Para descrições das opções, consulte CREATE FILE FORMAT.

    3. Selecione Finish.

    Seu novo formato de arquivo nomeado é selecionado automaticamente a partir da lista suspensa.

  2. Determine como você deseja tratar os erros que ocorrem quando os dados são carregados:

    • Se você quiser que o carregamento de dados seja interrompido se ocorrer um erro, selecione Load.

    • Se você quiser que os erros sejam tratados de uma maneira diferente:

      1. Selecione Next.

      2. Selecione a opção que descreve como você deseja tratar os erros. Para obter mais detalhes sobre as opções, consulte a seção ON_ERROR de COPY INTO <tabela>.

      3. Selecione Load.

    O Snowflake carrega os dados em sua tabela selecionada, utilizando o warehouse que você selecionou.

  3. Selecione OK para fechar o assistente Load Data.