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:

  1. Faça login no Snowsight.

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

  3. Localize o banco de dados e o esquema com o canal.

    Captura de tela de onde encontrar a página Detalhes do canal no Snowsight
  4. Selecione o canal para abrir os detalhes.

Captura de tela da página Detalhes do canal no Snowsight

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 Mais opções » 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 Mais opções » Pause ou Resume.

  • Para descartar o canal, selecione Mais opções » Drop.

  • Para transferir a propriedade do canal para outra função, selecione Mais opções » 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.

Captura de tela da guia Histórico de cópias no Snowsight

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.