SHOW PROCEDURES

Lista os procedimentos armazenados para os quais você tem privilégios de acesso.

Para obter mais informações sobre os procedimentos armazenados, consulte Como trabalhar com procedimentos armazenados.

Consulte também:

ALTER PROCEDURE , CREATE PROCEDURE , DROP PROCEDURE , DESCRIBE PROCEDURE

Sintaxe

SHOW PROCEDURES [ LIKE '<pattern>' ]
                [ IN
                     {
                       ACCOUNT                  |

                       CLASS <class_name>       |

                       DATABASE                 |
                       DATABASE <database_name> |

                       SCHEMA                   |
                       SCHEMA <schema_name>     |
                       <schema_name>
                     }
                ]
Copy

Parâmetros

LIKE 'pattern'

Opcionalmente, filtra a saída do comando pelo nome do objeto. O filtro utiliza correspondência de padrão que não diferencia maiúsculas e minúsculas, com suporte para caracteres curinga SQL (% e _).

Por exemplo, os seguintes padrões retornam os mesmos resultados:

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. padrão: sem valor (nenhuma filtragem é aplicada à saída).

[ IN ... ]

Opcionalmente, especifica o escopo do comando. Especifique um dos seguintes:

ACCOUNT

Retorna registros para toda a conta.

CLASS class_name

Retorna registros para a classe especificada (class_name).

DATABASE, . DATABASE db_name

Retorna registros do banco de dados atual em uso ou de um banco de dados especificado (db_name).

Se você especificar DATABASE sem db_name e nenhum banco de dados estiver em uso, a palavra-chave não terá efeito sobre a saída.

SCHEMA, . SCHEMA schema_name, . schema_name

Retorna registros do esquema atual em uso ou de um esquema especificado (schema_name).

SCHEMA é opcional se um banco de dados estiver em uso ou se você especificar o schema_name totalmente qualificado (por exemplo, db.schema).

Se nenhum banco de dados estiver em uso, a especificação SCHEMA não terá efeito sobre a saída.

Padrão: depende se a sessão tem ou não um banco de dados em uso no momento:

  • Banco de dados: DATABASE é o padrão (ou seja, o comando retorna os objetos nos quais você tem privilégios para visualizar no banco de dados).

  • Sem banco de dados: ACCOUNT é o padrão (ou seja, o comando retorna os objetos que você tem privilégios de visualização em sua conta).

Notas de uso

  • As colunas que começam com o prefixo is_ retornam Y (sim) ou N (não).

  • O comando não precisa de um warehouse em funcionamento para ser executado.

  • O comando retorna um máximo de 10 mil registros para o tipo de objeto especificado, como ditado pelos privilégios de acesso para a função usada para executar o comando; quaisquer registros acima do limite 10 mil não são retornados, mesmo com um filtro aplicado.

    Para visualizar resultados para os quais existem mais de 10.000 registros, consulte a visualização correspondente (se houver) em Snowflake Information Schema.

  • Para pós-processar a saída deste comando, você pode usar a função RESULT_SCAN, que trata a saída como uma tabela que pode ser consultada.

  • Se você especificar CLASS, o comando retornará apenas as seguintes colunas:

    | name | min_num_arguments | max_num_arguments | arguments | descriptions | language |
    

Saída

A saída do comando fornece propriedades de procedimento e metadados nas seguintes colunas:

Coluna

Descrição

created_on

O carimbo de data/hora em que o procedimento armazenado foi criado.

name

O nome do procedimento armazenado.

schema_name

O nome do esquema no qual o procedimento armazenado existe.

is_builtin

Y se o procedimento armazenado for embutido (em vez de definido pelo usuário); caso contrário, N.

is_aggregate

Não aplicável atualmente.

is_ansi

Y se o procedimento armazenado estiver definido na norma ANSI; caso contrário, N.

min_num_arguments

O número mínimo de argumentos.

max_num_arguments

O número máximo de argumentos.

arguments

Os tipos de dados dos argumentos e dos tipos de retorno. Argumentos opcionais são exibidos com a palavra-chave DEFAULT.

description

Uma descrição do procedimento armazenado.

catalog_name

O nome do banco de dados no qual o procedimento armazenado existe.

is_table_function

Y se o procedimento armazenado retornar dados tabulares; caso contrário, N.

valid_for_clustering

Não aplicável atualmente.

is_secure

Y se o procedimento armazenado for um procedimento armazenado seguro; caso contrário, N.

Exemplos

Mostrar todos os procedimentos:

SHOW PROCEDURES;
Copy

Este exemplo mostra como usar SHOW PROCEDURE em um procedimento armazenado que tem um parâmetro. Isto também mostra como limitar a lista de procedimentos àqueles que correspondem à expressão regular especificada.

SHOW PROCEDURES LIKE 'area_of_%';
+-------------------------------+----------------+--------------------+------------+--------------+---------+-------------------+-------------------+------------------------------------+------------------------+-----------------------+-------------------+----------------------+-----------+
| created_on                    | name           | schema_name        | is_builtin | is_aggregate | is_ansi | min_num_arguments | max_num_arguments | arguments                          | description            | catalog_name          | is_table_function | valid_for_clustering | is_secure |
|-------------------------------+----------------+--------------------+------------+--------------+---------+-------------------+-------------------+------------------------------------+------------------------+-----------------------+-------------------+----------------------+-----------|
| 1967-06-23 00:00:00.123 -0700 | AREA_OF_CIRCLE | TEMPORARY_DOC_TEST | N          | N            | N       |                 1 |                 1 | AREA_OF_CIRCLE(FLOAT) RETURN FLOAT | user-defined procedure | TEMPORARY_DOC_TEST_DB | N                 | N                    | N         |
+-------------------------------+----------------+--------------------+------------+--------------+---------+-------------------+-------------------+------------------------------------+------------------------+-----------------------+-------------------+----------------------+-----------+
Copy

As colunas de saída são similares às colunas de saída para SHOW FUNCTIONS e SHOW USER FUNCTIONS. Para procedimentos armazenados, algumas destas colunas não são atualmente significativas (por exemplo, is_aggregate, valid_for_clustering), mas estão reservadas para uso futuro.