DESCRIBE FUNCTION

DESCRIBE FUNCTION (DMF)

DESCRIBE FUNCTION (DMF) 명령은 지정된 데이터 메트릭 함수(DMF)를 설명하는 명령이에요. 시그니처(인자), 반환값, 언어, 본문(정의)을 포함합니다.

출처: DESCRIBE FUNCTION (DMF)

본문

지정된 데이터 메트릭 함수(DMF)를 설명하는 명령입니다. 시그니처(인자), 반환값, 언어, 본문(정의)을 포함해요. Enterprise Edition 기능 — 데이터 품질 모니터링(Data Quality Monitoring)은 Enterprise Edition이 필요합니다. 업그레이드 문의는 Snowflake Support에 연락하세요.

Syntax

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

Parameters

name — 설명할 함수의 식별자를 지정해요. 식별자에 공백이나 특수 문자가 포함되면 전체 문자열을 큰따옴표로 감싸야 합니다. 큰따옴표로 감싼 식별자는 대소문자를 구분해요. 자세한 내용은 Identifier requirements 문서를 참고하세요.
arg_data_type — DMF의 컬럼 인자에 대한 데이터 유형을 지정해요. DMF는 이름 오버로딩(같은 스키마의 두 DMF가 같은 이름을 가질 수 있음)을 지원하므로 인자의 데이터 유형이 설명하려는 DMF를 식별하는 데 필요합니다.

Access control requirements (접근 제어 요구 사항)

DMF 설명에는 관련 권한이 필요합니다.

Usage notes (사용 참고 사항)

이 명령의 출력을 후처리하려면 파이프 연산자(->>)나 RESULT_SCAN 함수를 사용할 수 있어요. 두 구성 모두 출력을 쿼리할 수 있는 결과 집합으로 취급합니다. 예를 들어 파이프 연산자나 RESULT_SCAN 함수를 사용해 SHOW 명령 출력에서 특정 컬럼을 선택하거나 행을 필터링할 수 있어요.

출력 컬럼을 참조할 때는 컬럼 이름에 큰따옴표로 감싼 식별자를 사용하세요. 예를 들어 출력 컬럼 유형을 선택하려면 SELECT "type"을 지정해요. SHOW 명령의 출력 컬럼 이름이 소문자이므로 큰따옴표로 감싼 식별자를 사용해야 합니다. 큰따옴표는 SELECT 목록이나 WHERE 절의 컬럼 이름이 스캔된 SHOW 명령 출력의 컬럼 이름과 일치하도록 보장해요.

Example (예제)

속성을 보기 위해 DMF를 설명해 봅시다.

DESC FUNCTION governance.dmfs.count_positive_numbers(
  TABLE(
    NUMBER, NUMBER, NUMBER
  )
);

+-----------+---------------------------------------------------------------------+
| property  | value                                                               |
+-----------+---------------------------------------------------------------------+
| signature | (ARG_T TABLE(ARG_C1 NUMBER, ARG_C2 NUMBER, ARG_C3 NUMBER))          |
| returns   | NUMBER(38,0)                                                        |
| language  | SQL                                                                 |
| body      | SELECT COUNT(*) FROM arg_t WHERE arg_c1>0 AND arg_c2>0 AND arg_c3>0 |
+-----------+---------------------------------------------------------------------+

DESCRIBE FUNCTION