DESCRIBE FUNCTION(Snowpark Container Services)¶
서명(인자), 반환 값, 언어, 본문(Snowpark Container Services 서비스 경로)을 포함하여 지정된 서비스 함수 를 설명합니다.
- 참고 항목:
구문¶
{ DESC | DESCRIBE } FUNCTION [ IF EXISTS ] <name> ( [ <arg_data_type> ] [ , ... ] )
필수 매개 변수¶
name설명할 서비스 함수의 식별자를 지정합니다. 식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.
( [ arg_name arg_data_type ] [ , ... ] )서비스 함수에 대한 인자/입력값을 지정합니다. 이는 서비스가 예상하는 인자와 일치해야 합니다.
인자가 없으면 인자 이름과 데이터 타입 없이 괄호를 포함하십시오.
액세스 제어 요구 사항¶
이 작업을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.
권한 |
오브젝트 |
참고 |
|---|---|---|
USAGE |
서비스 함수 |
스키마의 오브젝트에 대한 작업을 수행하려면 상위 데이터베이스에 대한 하나 이상의 권한과 상위 스키마에 대한 하나 이상의 권한이 필요합니다.
지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.
보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.
사용법 노트¶
이 명령의 출력을 후처리하기 위해 파이프 연산자 (
->>) 또는 RESULT_SCAN 함수를 사용할 수 있습니다. 두 구문 모두 출력을 쿼리할 수 있는 결과 세트로 간주합니다.예를 들어, 파이프 연산자 또는 RESULT_SCAN 함수를 사용하여 SHOW 명령 출력에서 특정 열을 선택하거나 행을 필터링할 수 있습니다.
출력 열을 참조하는 경우 열 이름에 :ref:`큰따옴표로 묶인 식별자<label-delimited_identifier>`를 사용합니다. 예를 들어, 출력 열 ``type``을 선택하려면 ``SELECT “type”``을 지정합니다.
SHOW 명령의 출력 열 이름은 소문자이므로 큰따옴표로 묶인 식별자를 사용해야 합니다. 큰따옴표는 SELECT 목록 또는 WHERE 절의 열 이름이 스캔된 SHOW 명령 출력과 일치하도록 보장합니다.
예¶
자습서-1 에서는 서비스 함수(my_echo_udf)를 생성합니다. 다음 DESC FUNCTION 명령은 서비스 함수 설명을 반환합니다.
DESC FUNCTION my_echo_udf(VARCHAR);
출력 예:
+--------------------+----------------------+
| property | value |
|--------------------+----------------------|
| signature | (INPUTTEXT VARCHAR) |
| returns | VARCHAR |
| 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 |
+--------------------+----------------------+