Carregamento de dados usando a interface da Web¶

Criação de uma nova tabela usando o Snowsight¶

Ao carregar dados, muitas vezes é possível criar e configurar automaticamente uma nova tabela para os dados ao mesmo tempo.

1. Faça login na Snowsight.

2. Abra o menu do usuário e selecione uma função de conta que inclua pelo menos os seguintes privilégios:

   Objeto	Privilégio	Notas
   Banco de dados	USAGE
   Esquema	CREATE TABLE
   Estágio	USAGE
   Tabela	OWNERSHIP

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

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

   

4. Selecione ou crie um banco de dados e um esquema onde você deseja que a tabela seja criada.

5. Selecione os arquivos que contêm os dados usando um destes métodos:

   • Drag and drop to upload files diretamente de seu sistema local.

   • Browse para arquivos em seu sistema local.

   • Add from stage.

     Se você selecionar Add from stage, o explorador de estágio será exibido.

     

     No explorador de estágios, é possível 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. Digite um nome para a nova tabela e selecione Next. A caixa de diálogo do esquema da tabela é exibida.

   

   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.

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

8. Selecione Load.

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

Carregar dados em uma tabela existente usando o Snowsight¶

1. Faça login na Snowsight.

2. Abra o menu do usuário e selecione uma função de conta que inclua pelo menos 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	INSERT

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

4. Selecione Load data into a Table. A caixa de diálogo Carregar dados na tabela é exibida.

   

5. Selecione os arquivos que contêm os dados usando um destes métodos:

   • Drag and drop to upload files diretamente de seu sistema local.

   • Browse para arquivos em seu sistema local.

   • Add from stage.

     Se você selecionar Add from stage, o explorador de estágio será exibido.

     

     No explorador de estágios, é possível 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. Selecione o banco de dados, o esquema e a tabela em que você deseja carregar os dados.

7. Selecione Next. A página Editar esquema aparece na caixa de diálogo Carregar dados na tabela.

   

8. Faça as personalizações finais conforme necessário:

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

     Nota

     Para carregar dados do Parquet em uma tabela Iceberg gerenciada pelo Snowflake, desmarque Load as a single variant column?. O Snowflake carrega os dados do Parquet diretamente nas colunas da tabela do Iceberg. Somente o padrão LOAD_MODE = FULL_INGEST é compatível quando você usa o Snowsight para carregar arquivos Parquet. Para obter mais informações, consulte COPY INTO <tabela>.

   • (Opcional) Selecione View options para opções de tipo de formato (exemplos: especificar formatos de data e hora ou substituir caracteres inválidos).

     

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

   • Selecione uma das seguintes opções para Table loading methods. A opção padrão é Append.

     • Append: os novos dados serão anexados à tabela existente durante o carregamento de dados.

     • Replace: os novos dados substituirão os dados existentes na tabela.

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

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

9. Selecione Load.

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

Selecione uma função¶

Selecione uma função que tenha os privilégios adequados. (Selecione o menu suspenso no canto superior esquerdo (ao lado de seu nome de login) » Switch Role » ACCOUNTADMIN.)

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

Selecione a tabela na qual você carregará os dados¶

1. Selecione Databases .

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.

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.