Preparação de arquivos usando o Snowsight¶

Criação de um estágio interno nomeado¶

Para usar Snowsight para criar um estágio interno nomeado, faça o seguinte:

1. Faça login no Snowsight.

2. No menu de navegação, selecione Create » Stage » Snowflake Managed.

3. Na caixa de diálogo Create Stage, insira um Stage Name.

4. Selecione o banco de dados e o esquema onde você deseja criar o estágio.

5. Opcionalmente, desmarque Directory table. As tabelas de diretório permitem que você veja os arquivos no estágio, mas exigem um warehouse e, portanto, têm um custo. Você pode optar por desmarcar essa opção por enquanto e ativar uma tabela de diretórios posteriormente.

6. Selecione o tipo de Encryption compatível com todos os arquivos do seu estágio. Para obter detalhes, consulte criptografia para estágios internos. Você não pode alterar o tipo de criptografia depois de criar o estágio.

   Nota

   Para habilitar o acesso aos dados, use a criptografia no lado do servidor. Caso contrário, os arquivos preparados serão criptografados no lado do cliente por padrão e ilegíveis quando baixados. Para obter mais informações, consulte Criptografia do lado do servidor para acesso a dados não estruturados.

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

8. Selecione Create.

Criação de um estágio externo nomeado¶

Para usar Snowsight para criar um estágio externo nomeado, faça o seguinte:

1. Faça login no Snowsight.

2. No menu de navegação, selecione Create » Stage » External Stage.

3. Selecione seu provedor de armazenamento em nuvem externo: Amazon S3, Microsoft Azure ou Google Cloud Platform.

4. Na caixa de diálogo Create Stage, insira um Stage Name.

5. Selecione o banco de dados e o esquema onde você deseja criar o estágio.

6. Digite o URL de seu local de armazenamento externo em nuvem.

7. Se o armazenamento externo não for público, ative Authentication e insira seus detalhes. Para obter mais informações, consulte CREATE STAGE.

8. Opcionalmente, desmarque Directory table. As tabelas de diretório permitem que você veja os arquivos no estágio, mas exigem um warehouse e, portanto, têm um custo. Você pode optar por desmarcar essa opção por enquanto e ativar uma tabela de diretórios posteriormente.

   Se você ativar Directory table, selecione opcionalmente Enable auto-refresh e selecione sua notificação de evento ou integração de notificação para atualizar automaticamente a tabela de diretórios quando arquivos forem adicionados ou removidos. Para saber mais, consulte Atualizações automatizadas dos metadados da tabela de diretório.

9. Se seus arquivos estiverem criptografados, ative Encryption e digite seus detalhes.

10. Opcionalmente, expanda o SQL Preview para visualizar uma instrução SQL gerada. Para especificar opções adicionais para seu estágio, como AUTO_REFRESH, você pode abrir essa versão preliminar de SQL em uma planilha.

11. Selecione Create.

Carregamento de arquivos em um estágio interno nomeado¶

Para carregar arquivos em seu estágio, faça o seguinte:

1. Faça login no Snowsight.

2. Selecione Data » Add Data.

3. Na página Add Data, selecione Load files into a Stage.

4. Na caixa de diálogo Upload Your Files exibida, selecione os arquivos que deseja carregar. Você pode carregar vários arquivos ao mesmo tempo.

5. Selecione o esquema do banco de dados no qual você criou o estágio e, em seguida, selecione o estágio.

6. Opcionalmente, selecione ou crie um caminho onde deseja salvar seus arquivos no estágio.

7. Selecione Upload.

Depois de carregar arquivos no estágio, você pode executar uma das seguintes ações, dependendo do arquivo:

• Use os arquivos em uma planilha Python. Para obter mais informações, consulte Como adicionar um arquivo Python de um estágio a uma planilha.

• Copie os dados dos arquivos preparados em uma tabela. Para obter mais informações, consulte Carregamento de um arquivo em uma tabela existente ou Cópia de dados de um estágio interno.

• Consulte os dados no estágio. Para obter mais informações, consulte Consulta de dados em arquivos preparados.

Os arquivos não estão visíveis em um estágio externo¶

Esse problema pode ocorrer quando um estágio externo não possui uma tabela de diretórios habilitada ou quando as informações sobre o local de armazenamento externo estão incorretas.

Para corrigir esse problema, tente o seguinte:

• Verifique se o proprietário do estágio ativou uma tabela de diretórios no estágio.

• Verifique se a tabela de diretório foi atualizada. Para atualizar a tabela de diretórios, selecione seu estágio em Snowsight e selecione o ícone de atualização.

• Verifique se o URL do provedor de nuvem está correto. Se o seu URL contiver um subcaminho, certifique-se de que haja uma barra final.

O botão Carregar arquivos não está disponível (inativo)¶

Esse problema pode ocorrer quando você não tem os privilégios necessários para fazer upload de arquivos para um estágio interno ou se outro upload estiver em andamento.

Para corrigir esse problema, tente o seguinte:

• Certifique-se de ter selecionado um estágio interno.

• Use uma função que tenha recebido ou herdado o privilégio USAGE no banco de dados e no esquema e o privilégio WRITE no estágio.

• Verifique se outro upload está em andamento. Passar o mouse sobre o botão inativo exibe informações sobre quaisquer uploads em andamento. Snowsight também exibe uma notificação para uploads em andamento. Se outro upload estiver em andamento, ele deverá ser concluído antes que você possa carregar arquivos adicionais no estágio.