Criação de um estágio Azure¶

Um estágio especifica onde os arquivos de dados são armazenados (isto é, “preparados”) para que os dados nos arquivos possam ser carregados em uma tabela.

Neste tópico:

Os dados podem ser carregados diretamente dos arquivos em um contêiner Azure especificado ou em uma “pasta” Azure (ou seja, prefixo do valor chave). Se o caminho termina com /, todos os objetos da pasta Azure correspondente são carregados.

Estágios externos¶

Além de carregar diretamente a partir de contêineres Azure, o Snowflake oferece suporte à criação de estágios externos nomeados, que encapsulam todas as informações necessárias para a preparação de arquivos, incluindo:

O contêiner Azure onde os arquivos são preparados.
O objeto de integração de armazenamento nomeado ou as credenciais Azure do contêiner (se for protegido).
Uma chave de criptografia (se os arquivos no contêiner tiverem sido criptografados).

Os estágios externos nomeados são opcionais, mas recomendados quando você planeja carregar dados regularmente a partir do mesmo local. Para instruções para criar um estágio externo, consulte Criação de um estágio externo abaixo.

Criação de um estágio externo¶

Você pode criar um estágio externo nomeado usando SQL ou a interface da Web.

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 externo usando SQL¶

Use o comando CREATE STAGE para criar um estágio externo.

O exemplo seguinte cria um estágio externo chamado my_azure_stage. A instrução CREATE inclui a integração de armazenamento azure_int que foi criada em Configuração de um contêiner Azure para carregamento de dados para acessar o contêiner Azure container1 na conta myaccount.

Os arquivos de dados são armazenados no caminho load/files/. O estágio faz referência a um objeto de formato de arquivo nomeado chamado my_csv_format, que descreve os dados nos arquivos armazenados no caminho:

CREATE STAGE my_azure_stage
  STORAGE_INTEGRATION = azure_int
  URL = 'azure://myaccount.blob.core.windows.net/mycontainer/load/files/'
  FILE_FORMAT = my_csv_format;

Copy

Nota

Use o ponto de extremidade blob.core.windows.net para todos os tipos com suporte de contas de armazenamento de blobs Azure, incluindo Data Lake Storage Gen2.

Nota

Ao especificar um objeto de formato de arquivo nomeado (ou opções individuais de formato de arquivo) para o estágio, não é necessário especificar posteriormente as mesmas opções de formato de arquivo no comando COPY usado para carregar dados do estágio. Para obter mais informações sobre os objetos de formato de arquivo e opções, consulte CREATE FILE FORMAT.

Criação de um estágio externo usando Snowsight¶

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 automatizadas dos 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.

Criação de um estágio externo usando o Console clássico¶

Selecione Databases » <nome_bd> » Stages.

Próximo: Cópia de dados de um estágio Azure