- Esquema:
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. For manually created pipes, this is the name defined in the CREATE PIPE statement. For the Snowpipe Streaming high-performance default pipe, this is derived from the target table name; for example, |
PIPE_SCHEMA_ID |
NUMBER |
Internal or system-generated identifier for the schema that the pipe belongs to. For the default pipe, this corresponds to the target table’s schema ID. |
PIPE_SCHEMA |
VARCHAR |
Esquema ao qual pertence o canal. For the default pipe, this corresponds to the target table’s schema. |
PIPE_CATALOG_ID |
NUMBER |
Internal or system-generated identifier for the database that the pipe belongs to. For the default pipe, this corresponds to the target table’s database ID. |
PIPE_CATALOG |
VARCHAR |
Name of the database that the pipe belongs to. For the default pipe, this corresponds to the target table’s database. |
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. Returns NULL for the default pipe. |
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. Returns the following message for the default pipe: «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 |
The type of role that owns the object; for example, ROLE. If a Snowflake Native App owns the object, the value is APPLICATION. Snowflake returns NULL if you delete the object because a deleted object doesn’t have an owner role. Returns NULL for the default pipe. |
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);