Gerenciamento do Snowpipe no Snowsight¶
Você pode usar o Snowsight para visualizar os detalhes do Snowpipe e executar algumas tarefas de gerenciamento de canal.
Visualize os estágios, canais e tabelas em um gráfico e entenda os relacionamentos e a linhagem de dados entre esses objetos.
Veja as informações completas de qualquer um de seus canais sobre o que foi carregado (ou parcialmente carregado).
Verifique se algum de seus canais está falhando, travado ou parou de carregar novos dados de arquivos.
Execute algumas tarefas de gerenciamento de canais, como pausar ou retomar um canal, descartar um canal, transferir a propriedade de um canal e adicionar comentários a um canal.
Visualize o status detalhado e o histórico de cópias.
Requisitos¶
Para visualizar os detalhes do canal, você deve usar uma função com o privilégio MONITOR ou OWNERSHIP no canal e o privilégio USAGE tanto no banco de dados quanto no esquema com o canal. Para obter mais informações, consulte Privilégios de canal.
Detalhes do canal¶
Para visualizar os detalhes do canal no Snowsight, siga as etapas abaixo:
Faça login no Snowsight.
No menu de navegação, selecione Data » Databases.
Localize o banco de dados e o esquema com o canal.
Selecione o canal para abrir os detalhes.

A página Pipe Details inclui informações sobre o seguinte:
Status. Exemplos: Running; Paused.
O número de arquivos pendentes no canal, se houver.
A data da última ingestão realizada, se aplicável.
O warehouse. (O Snowpipe sempre é executado usando os recursos de computação Serverless)
O canal Notificações de entrada para informar ao canal quando houver novos arquivos.
Relações entre os estágios, canais e tabelas em um gráfico.
As últimas cópias realizadas.
O comando SQL usado para criar o canal (Pipe Definition).
Os privilégios concedidos no canal.
Gerenciamento de canais¶
Você pode executar as seguintes tarefas na página Pipe Details:
Para adicionar um comentário ao canal, selecione
» Edit. Para editar outras propriedades de um canal, você deve usar o CREATE PIPE comando SQL para substituir o canal.
Para pausar ou retomar o canal, selecione
» Pause ou Resume.
Para transferir a propriedade do canal para outra função, selecione
» Transfer Ownership.
Para obter mais informações sobre o gerenciamento de canais, consulte Gerenciamento do Snowpipe.
Histórico de cópias¶
Para visualizar o histórico de cópias de qualquer um de seus canais, acesse a página Pipe Details e selecione a guia Copy History.
A guia Histórico de cópias exibe detalhes, incluindo STATUS, DURATION, ROWS, SIZE e FILE NAME.
O histograma exibe até 14 dias de histórico de carregamento e permite que você selecione entre as seguintes dimensões:
Copies (padrão): o número de arquivos carregados. Exibe a contagem de arquivos agrupados por status diariamente ou por hora, ajudando a identificar cargas com falha e a monitorar as tendências de ingestão ao longo do tempo.
Rows: o número de linhas inseridas. Agrega as contagens de linhas por dia ou hora, fornecendo insights sobre as tendências de rendimento de dados.
Duration: duração da ingestão do canal. Mostra o tempo gasto para a ingestão do canal (agregado por dia ou hora), que representa o tempo de computação sem servidor do seu canal e serve como um proxy para o custo de computação.
A seção de métricas do canal ajuda a analisar a integridade e o rendimento do seu canal com as seguintes métricas principais:
Success rate: porcentagem de arquivos carregados com sucesso dentro do intervalo de tempo selecionado.
Max ingestion gap: destaca grandes intervalos entre os ciclos de ingestão, facilitando a identificação de interrupções na ingestão contínua.
Time since last ingestion: indica o tempo decorrido desde que o arquivo mais recente foi carregado.
Min row count: identifica arquivos com menos linhas do que o esperado ou arquivos vazios.
Pending files: mostra o número de arquivos detectados que ainda não foram carregados na tabela.
Você também pode optar por carregar manualmente os arquivos que não foram carregados, selecionando a opção Manual Refresh no menu suspenso de reticências no canto superior direito da página.
Para pesquisar arquivos individuais, use a barra de pesquisa no canto superior direito da página. Você pode pesquisar por nome de arquivo, status ou data.