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é 250 MB. Para carregar arquivos maiores ou um grande número de arquivos, use o cliente Snowflake, SnowSQL. Para obter mais informações, 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 ou de um estágio para 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. Este recurso não oferece suporte a arquivos XML.

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

Privilégios de controle de acesso

O Snowsight não oferece suporte ao uso de funções de banco de dados para conceder privilégios em um banco de dados, esquema ou tabela. Use uma função de conta para interagir com o Snowsight. Para obter mais informações, consulte os tipos de funções.

Carregamento de dados usando o Snowsight

O carregamento de dados usando o Snowsight requer uma função com no mínimo os seguintes privilégios:

Objeto

Privilégio

Notas

Banco de dados

USAGE

Esquema

USAGE

Estágio

USAGE

Necessário para carregar um arquivo de um estágio.

Formato do arquivo

USAGE

Necessário para usar um formato de arquivo nomeado.

Tabela

OWNERSHIP

Crianção de uma nova tabela ao carregar dados usando o Snowsight

Criar uma nova tabela ao carregar dados usando o Snowsight requer uma função com no mínimo os seguintes privilégios:

Objeto

Privilégio

Notas

Banco de dados

USAGE

Esquema

CREATE TABLE

Estágio

USAGE

Tabela

OWNERSHIP

Carregamento de um arquivo em uma tabela existente

  1. Faça login no Snowsight.

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

  3. Na página Add Data, selecione Load data into a Table.

    A caixa de diálogo Load Data into Table aparece.

  4. Na caixa de diálogo Load Data into Table, selecione ou crie um banco de dados e esquema onde deseja que a tabela seja criada.

  5. Selecione Browse para adicionar um arquivo da sua máquina local, Drag and drop to upload files ou Add from stage.

    Se você selecionar Add from stage, o explorador de estágio será exibido. No explorador de estágio, você pode navegar pelos estágios e subpastas e selecionar pastas e arquivos específicos do estágio. Se você selecionar Add sem selecionar nenhum arquivo específico no estágio, o estágio raiz, que inclui todos os arquivos e pastas no estágio, será adicionado.

    O número máximo de arquivos que podem ser exibidos em uma pasta de estágio é 250.

  6. Após adicionar os arquivos, selecione Next. A caixa de diálogo do esquema da tabela é exibida.

  7. Na caixa de diálogo do esquema da tabela, faça o seguinte:

    • 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.

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

    • Selecione uma das opções Match by column names para associar automaticamente o arquivo de origem com a tabela de destino. A opção padrão é case insensitive.

      Observe que a detecção de esquema e o mapeamento de colunas visuais não oferecem suporte a XML.

    • Selecione a guia Edit Schema no lado direito da caixa de diálogo do esquema da tabela. Você pode ver qualquer discrepância entre o arquivo de origem e a tabela de destino. Faça ajustes conforme necessário.

    • Se você selecionar a guia Table Preview, poderá visualizar como os dados do arquivo de origem recebido ficarão na tabela de destino.

  8. Selecione Load.

    O 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.

Nota

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

  1. Faça login no Snowsight.

  2. No menu de navegação, selecione Create » Table » From File.

    A caixa de diálogo Load Data into Table aparece.

  3. Na caixa de diálogo Load Data into Table, selecione ou crie um banco de dados e esquema onde deseja que a tabela seja criada.

  4. Selecione Browse para adicionar um arquivo da sua máquina local, Drag and drop to upload files ou Add from stage.

    Se você selecionar Add from stage, o explorador de estágio será exibido. No explorador de estágio, você pode navegar pelos estágios e subpastas e selecionar pastas e arquivos específicos do estágio. Se você selecionar Add sem selecionar nenhum arquivo específico no estágio, o estágio raiz, que inclui todos os arquivos e pastas no estágio, será adicionado.

    Observe que o número máximo de arquivos que podem ser exibidos em uma pasta de estágio é 250.

  5. 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.

  6. 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.

  7. 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é 250 MB. 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 Guia Bancos de dados.

  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.