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:
Entre em Snowsight.
Selecione Data » Databases.
Selecione o banco de dados e o esquema no qual você deseja criar um estágio.
Selecione Create » Stage » Snowflake Managed.
Insira um Stage Name.
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.
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.
Preencha os campos para descrever seu estágio. Para obter mais informações, consulte CREATE STAGE.
Selecione Create.
Criação de um estágio externo nomeado¶
Para usar Snowsight para criar um estágio externo nomeado, faça o seguinte:
Entre em Snowsight.
No menu de navegação, selecione Data » Databases.
Selecione o banco de dados e o esquema no qual você deseja criar um estágio.
Selecione Create » Stage.
Selecione o serviço de armazenamento em nuvem compatível onde seus arquivos estão localizados.
Insira um Stage Name.
Digite o URL de seu local de armazenamento externo em nuvem.
Se o armazenamento externo não for público, ative Authentication e insira seus detalhes. Para obter mais informações, consulte CREATE STAGE.
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 automáticas de metadados da tabela de diretório.
Se seus arquivos estiverem criptografados, ative Encryption e digite seus detalhes.
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.
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 é 50MB.
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:
Entre em Snowsight.
Selecione Data » Databases.
Selecione o esquema do banco de dados no qual você criou o estágio e selecione o estágio.
Selecione + Files para carregar arquivos no estágio.
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.
Opcionalmente, selecione ou crie um caminho onde deseja salvar seus arquivos no estágio.
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. Consulte Como adicionar um arquivo Python de um estágio a uma planilha.
Copie os dados dos arquivos preparados em uma tabela. Consulte Carregamento de um arquivo de um estágio em uma tabela existente ou Cópia de dados de um estágio interno.
Consulte os dados no estágio. Consulte Consulta de dados em arquivos preparados.
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.
Entre em Snowsight.
Selecione Data » Databases.
Selecione o banco de dados e o esquema que contém o estágio.
Selecione Stages e selecione o estágio para o qual deseja visualizar os arquivos.
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.
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:
Selecione
» Load into table para carregar o arquivo do estágio em uma tabela.Selecione
» Copy path para copiar o caminho do arquivo para uso em outro lugar, como em uma planilha.
Para arquivos em um estágio interno, você também pode realizar as seguintes ações:
Selecione
» Download para baixar o arquivo do estágio.Selecione
» 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.
Entre em Snowsight.
Selecione Data » Databases.
Selecione o banco de dados e o esquema que contém o estágio.
Selecione Stages e selecione o estágio.
Selecione Stage Details.
Você pode gerenciar o estágio das seguintes maneiras:
Selecione
» Edit para editar propriedades ou ativar uma tabela de diretório para o objeto de preparação.Selecione
» Clone para clonar o estágio.Selecione
» Drop para descartar ou remover o estágio.Selecione
» 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.