DESCRIBE FUNCTION (Snowpark Container Services)

Descreve a função de serviço especificada, incluindo a assinatura (argumentos), valor de retorno, linguagem e corpo (caminho para o Snowpark Container Services).

Consulte também:

Funções de serviço, CREATE FUNCTION, ALTER FUNCTION, DROP FUNCTION

Sintaxe

{ DESC | DESCRIBE } FUNCTION [ IF EXISTS ] <name> ( [ <arg_data_type> ] [ , ... ] )
Copy

Parâmetros obrigatórios

name

Especifica o identificador para a função de serviço a ser descrita. Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Identificadores entre aspas duplas também diferenciam maiúsculas de minúsculas.

( [ arg_name arg_data_type ] [ , ... ] )

Especifica os argumentos/entradas para a função de serviço. Eles devem corresponder aos argumentos que o serviço espera.

Se não houver argumentos, incluir os parênteses sem nome(s) de argumento(s) e tipo(s) de dados.

Requisitos de controle de acesso

A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:

Privilégio

Objeto

Notas

USAGE

Função de serviço

O privilégio USAGE no banco de dados e no esquema pai é necessário para executar operações em qualquer objeto de um esquema.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Notas de uso

  • 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. Você também pode usar o operador de canal para consultar a saída desse comando.

Exemplos

No Tutorial-1, você cria uma função de serviço (my_echo_udf). O comando DESC FUNCTION a seguir retorna a descrição da função de serviço:

DESC FUNCTION my_echo_udf(VARCHAR);
Copy

Exemplo de saída:

+--------------------+----------------------+
| property           | value                |
|--------------------+----------------------|
| signature          | (INPUTTEXT VARCHAR)  |
| returns            | VARCHAR(16777216)    |
| language           | NULL                 |
| null handling      | CALLED ON NULL INPUT |
| volatility         | VOLATILE             |
| body               | /echo                |
| headers            | null                 |
| context_headers    | null                 |
| max_batch_rows     | not set              |
| service            | ECHO_SERVICE         |
| service_endpoint   | echoendpoint         |
| max_batch_retries  | 3                    |
| on_batch_failure   | ABORT                |
| batch_timeout_secs | not set              |
+--------------------+----------------------+
Linguagem: Português