Esquema:: ACCOUNT_USAGE

Exibição PIPES¶

Esta visualização de Account Usage exibe uma linha para cada canal definido na conta.

Colunas¶

Nome da coluna	Tipo de dados	Descrição
PIPE_ID	NUMBER	Internal or system-generated identifier for the pipe.
PIPE_NAME	VARCHAR	The name of the pipe object. Para canais criados manualmente, este é o nome definido na instrução CREATE PIPE. Para o canal padrão de alto desempenho do Snowpipe Streaming, este nome é derivado do nome da tabela de destino; por exemplo, `MY_TABLE-STREAMING`.
PIPE_SCHEMA_ID	NUMBER	Internal or system-generated identifier for the schema that the pipe belongs to. Para o canal padrão, isso corresponde ao ID do esquema da tabela de destino.
PIPE_SCHEMA	VARCHAR	Esquema ao qual pertence o canal. Para o canal padrão, isso corresponde ao esquema da tabela de destino.
PIPE_CATALOG_ID	NUMBER	Internal or system-generated identifier for the database that the pipe belongs to. Para o canal padrão, isso corresponde ao ID do banco de dados da tabela de destino.
PIPE_CATALOG	VARCHAR	Name of the database that the pipe belongs to. Para o canal padrão, isso corresponde ao banco de dados da tabela de destino.
IS_AUTOINGEST_ENABLED	VARCHAR	Se AUTO-INGEST está habilitado para o canal. Representa a funcionalidade futura.
NOTIFICATION_CHANNEL_NAME	VARCHAR	Fila do Amazon Resource Name of the Amazon SQS para o estágio nomeado na coluna DEFINITION. Representa a funcionalidade futura.
PIPE_OWNER	VARCHAR	Nome da função proprietária do canal. Retorna NULL para o canal padrão.
DEFINITION	VARCHAR	Instrução COPY usada para carregar dados de arquivos em fila em uma tabela do Snowflake.
CREATED	TIMESTAMP_LTZ	Hora de criação do canal.
LAST_ALTERED	TIMESTAMP_LTZ	Data e hora em que o objeto foi alterado pela última vez por uma operação de metadados de DML, DDL ou em segundo plano. Consulte as Notas de uso.
COMMENT	VARCHAR	Comentário para este canal. Retorna a seguinte mensagem para o canal padrão: «Default pipe for Snowpipe Streaming High Performance ingestion to a table. Created and managed by Snowflake.»
PATTERN	VARCHAR	Valor da opção de cópia PATTERN na instrução COPY INTO <tabela> da definição do canal, se a opção de cópia tiver sido especificada
DELETED	TIMESTAMP_LTZ	Data e hora em que o canal foi excluído.
OWNER_ROLE_TYPE	VARCHAR	O tipo de função que tem propriedade sobre o objeto; por exemplo, ROLE. Se um Snowflake Native App for o proprietário do objeto, o valor será APPLICATION. O Snowflake retornará NULL se você excluir o objeto, pois um objeto excluído não tem uma função de proprietário. Retorna NULL para o canal padrão.

Notas de uso¶

A latência da visualização pode ser de até 180 minutos (3 horas).

A visualização exibe apenas objetos para os quais a função atual da sessão tem privilégios de acesso.
A exibição não reconhece o privilégio MANAGE GRANTS e consequentemente pode mostrar menos informações em comparação com um comando SHOW executado por um usuário com o privilégio MANAGE GRANTS.
A coluna LAST_ALTERED é atualizada quando as seguintes operações são executadas em um objeto:
- operações DDL.
- operações DML (somente para tabelas). Esta coluna é atualizada mesmo quando nenhuma linha é afetada pela instrução DML.
- Operações de manutenção em segundo plano em metadados realizadas pelo Snowflake.

Exemplos¶

O exemplo a seguir une esta visualização com Exibição PIPE_USAGE_HISTORY na coluna PIPE_ID para acompanhar o uso de crédito associado a cada objeto PIPE único:

select a.PIPE_CATALOG as PIPE_CATALOG,
       a.PIPE_SCHEMA as PIPE_SCHEMA,
       a.PIPE_NAME as PIPE_NAME,
       b.CREDITS_USED as CREDITS_USED
from SNOWFLAKE.ACCOUNT_USAGE.PIPES a join SNOWFLAKE.ACCOUNT_USAGE.PIPE_USAGE_HISTORY b
on a.pipe_id = b.pipe_id
where b.START_TIME > date_trunc(month, current_date);

Copy