Preparação de arquivos usando o Snowsight

Com Snowsight, você pode criar e gerenciar estágios nomeados sem escrever SQL. Você também pode carregar arquivos em um estágio interno nomeado para que possa visualizar seus arquivos, fazer referência aos arquivos em uma planilha Python ou carregar dados dos arquivos em uma tabela.

Você não pode carregar arquivos em estágios de usuário ou de tabela usando Snowsight. Consulte Visão geral do carregamento de dados para saber mais sobre os estágios.

Neste tópico:

Criação de um estágio

Você pode usar Snowsight para criar um estágio interno ou externo nomeado.

Nota

Você deve usar uma função que tenha recebido ou herdado o privilégio USAGE no banco de dados e no esquema que armazena o estágio e o privilégio CREATE STAGE no esquema.

Consulte Requisitos de controle de acesso para CREATE STAGE.

Criação de um estágio interno nomeado

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

  1. Entre em Snowsight.

  2. Selecione Data » Databases.

  3. Selecione o banco de dados e o esquema no qual você deseja criar um estágio.

  4. Selecione Create » Stage » Snowflake Managed.

  5. Insira um Stage Name.

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

  7. 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 ativar o acesso aos dados, recomendamos que você selecione 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.

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

  9. 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. Entre em Snowsight.

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

  3. Selecione o banco de dados e o esquema no qual você deseja criar um estágio.

  4. Selecione Create » Stage.

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

  6. Insira um Stage Name.

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

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

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

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

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

  12. Selecione Create.

Carregamento de arquivos em um estágio

Você pode usar a Snowsight para carregar arquivos em um estágio interno nomeado.

Para carregar os arquivos em estágios externos em serviços como Amazon S3, Microsoft Azure ou Google Cloud Storage, use as ferramentas desses serviços de nuvem.

Carregamento de arquivos em um estágio interno nomeado

Nota

O tamanho máximo do arquivo é 250 MB.

Você deve usar 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 para executar essas etapas. Consulte Privilégios de estágio.

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

  1. Entre em Snowsight.

  2. Selecione Data » Databases.

  3. Selecione o esquema do banco de dados no qual você criou o estágio e selecione o estágio.

  4. Selecione + Files para carregar arquivos no estágio.

  5. Na caixa de diálogo Upload Your Files exibida, selecione os arquivos que deseja carregar. Você pode carregar vários arquivos de uma só vez.

  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:

Exibição de arquivos preparados

Você pode visualizar arquivos preparados usando a Snowsight. Você pode visualizar arquivos de estágios internos e externos.

Nota

Você deve usar uma função que tenha recebido ou herdado o privilégio USAGE no banco de dados e no esquema e o privilégio READ no estágio para executar essas etapas.

  1. Entre em Snowsight.

  2. Selecione Data » Databases.

  3. Selecione o banco de dados e o esquema que contém o estágio.

  4. Selecione Stages e selecione o estágio para o qual deseja visualizar os arquivos.

  5. Se solicitado, selecione Enable Directory Table para ativar uma tabela de diretório para o estágio, de modo que você possa ver os arquivos.

  6. Se solicitado, selecione um warehouse para atualizar a tabela de diretório.

Para atualizar a tabela de diretórios em um estágio, selecione o ícone de atualização.

Gerenciamento de arquivos preparados

Você pode usar Snowsight para executar as seguintes ações em arquivos preparados:

Para arquivos em um estágio interno, você também pode realizar as seguintes ações:

  • Selecione Mais opções » Download para baixar o arquivo do estágio.

  • Selecione Mais opções » Remove para remover o arquivo do estágio.

Nota

Para baixar um arquivo de um estágio externo, consulte Como baixar arquivos preparados no Snowsight.

Gerenciamento de estágios

Para gerenciar um estágio na Snowsight, faça o seguinte:

Nota

Você deve usar uma função que tenha recebido ou herdado o privilégio USAGE no banco de dados e no esquema e o privilégio OWNERSHIP no estágio para executar essas etapas.

  1. Entre em Snowsight.

  2. Selecione Data » Databases.

  3. Selecione o banco de dados e o esquema que contém o estágio.

  4. Selecione Stages e selecione o estágio.

  5. Selecione Stage Details.

Você pode gerenciar o estágio das seguintes maneiras:

  • Selecione Mais opções » Edit para editar propriedades ou ativar uma tabela de diretório para o objeto de preparação.

  • Selecione Mais opções » Clone para clonar o estágio.

  • Selecione Mais opções » Drop para descartar ou remover o estágio.

  • Selecione Mais opções » Transfer Ownership para transferir os privilégios OWNERSHIP do estágio para outra função.

Se quiser gerenciar os privilégios do estágio, use a seção Privileges para visualizar, conceder e revogar privilégios.

Solução de problemas

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 novamente se a tabela de diretórios 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.