SHOW FUNCTIONS¶

Lista todas as funções escalares nativas (isto é, definidas pelo sistema/internas) fornecidas pelo Snowflake, bem como quaisquer funções definidas pelo usuário (UDFs) ou funções externas que tenham sido criadas para sua conta.

Para obter mais informações, consulte Referência de funções e procedimentos armazenados, Visão geral das funções definidas pelo usuário e Como escrever funções externas.

Consulte também:: SHOW USER FUNCTIONS , SHOW EXTERNAL FUNCTIONS , CREATE FUNCTION , DROP FUNCTION , ALTER FUNCTION , DESCRIBE FUNCTION

Sintaxe¶

SHOW FUNCTIONS [ 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).

Saída¶

A saída do comando fornece propriedades de função e metadados nas seguintes colunas:

Coluna	Descrição
`created_on`	O carimbo de data/hora em que a função foi criada.
`name`	O nome da função.
`schema_name`	O nome do esquema em que a função existe. (NULL para funções internas).
`is_builtin`	`Y` se a função for uma função interna; caso contrário, `N`.
`is_aggregate`	`Y` se a função for uma função de agregação; caso contrário, `N`.
`is_ansi`	`Y` se a função for definida como parte da norma ANSI SQL; caso contrário, `N`.
`min_num_arguments`	Número mínimo de argumentos.
`max_num_arguments`	Número máximo de argumentos.
`arguments`	Os tipos de dados dos argumentos e do valor de retorno. Argumentos opcionais são exibidos com a palavra-chave `DEFAULT`.
`description`	Descrição da função.
`catalog_name`	O nome do banco de dados no qual a função existe. (NULL para funções internas).
`is_table_function`	`Y` se a função for uma função de tabela; caso contrário, `N`.
`valid_for_clustering`	`Y` se a função puder ser usada em uma expressão CLUSTER BY; caso contrário, `N`.
`is_secure`	`Y` se a função for uma função segura; caso contrário, `N`.
`is_external_function`	`Y` se a função for uma função externa; caso contrário, `N`.
`language`	Para funções internas, essa coluna mostra «SQL». Para funções definidas pelo usuário, essa coluna mostra a linguagem na qual a função foi escrita, por exemplo, «JAVASCRIPT» ou «SQL». Para funções externas, essa coluna mostra «EXTERNAL».
`is_memoizable`	`Y` se a função for memoizável; caso contrário, `N`.
`is_data_metric`	Esta coluna é um espaço reservado para futuras funcionalidades.

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 |

A saída deste comando pode incluir objetos com nomes como SN_TEMP_OBJECT_<n> (onde <n> é um número). Estes são objetos temporários criados pela biblioteca Snowpark em nome do usuário.

Exemplos¶

Mostrar todas as funções:

SHOW FUNCTIONS;

Copy

Mostrar apenas funções que correspondam à expressão regular especificada:

SHOW FUNCTIONS LIKE 'SQUARE';

------------+--------+-------------+------------+--------------+---------+-------------------+-------------------+----------------------------------------------------------------------+------------------------------------------------------------+----------+---------------+----------------+
 created_on | name   | schema_name | is_builtin | is_aggregate | is_ansi | min_num_arguments | max_num_arguments |                               arguments                              |                      description                           | language | is_memoizable | is_data_metric |
------------+--------+-------------+------------+--------------+---------+-------------------+-------------------+----------------------------------------------------------------------+------------------------------------------------------------+----------+---------------+----------------+
            | SQUARE |             | Y          | N            | Y       | 1                 | 1                 | SQUARE(NUMBER(38,0)) RETURN NUMBER(38,0), SQUARE(FLOAT) RETURN FLOAT | Compute the square of the input expression.                | SQL      | N             | N              |
------------+--------+-------------+------------+--------------+---------+-------------------+-------------------+----------------------------------------------------------------------+------------------------------------------------------------+----------+---------------+----------------+

Copy