SHOW FUNCTIONS¶

Sintaxe¶

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

                      DATABASE                 |
                      DATABASE <database_name> |

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

Parâmetros¶

LIKE 'pattern'

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%' ...

[ IN ... ]

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

ACCOUNT

Retorna registros para toda a conta.

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¶

• 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.

• 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.

• A coluna IS_MEMOIZABLE não é incluída na saída quando o pacote 2022_08 de versão de alteração de comportamento é desativado.

  Para obter mais informações sobre como desabilitar pacotes de versão de alteração de comportamento, consulte Gerenciamento de mudanças de comportamento.

Saída¶

A saída do comando fornece as propriedades das colunas e metadados nas seguintes colunas:

| 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 | is_external_function | language | is_memoizable

Notas de uso¶

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

• A coluna IS_MEMOIZABLE não é incluída na saída quando o pacote 2022_08 de versão de alteração de comportamento é desativado.

  Para obter mais informações sobre como desabilitar pacotes de versão de alteração de comportamento, consulte Gerenciamento de mudanças de comportamento.

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 |
------------+--------+-------------+------------+--------------+---------+-------------------+-------------------+----------------------------------------------------------------------+------------------------------------------------------------+----------+---------------+
            | 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             |
------------+--------+-------------+------------+--------------+---------+-------------------+-------------------+----------------------------------------------------------------------+------------------------------------------------------------+----------+---------------+

Copy