SHOW DATA METRIC FUNCTIONS

SHOW DATA METRIC FUNCTIONS

SHOW DATA METRIC FUNCTIONS 명령은 접근 권한(privilege)이 있는 데이터 메트릭 함수(DMF, Data Metric Function) 목록을 보여주는 명령이에요. 데이터 품질 모니터링에서 사용하는 DMF들을 확인할 때 사용해요.

출처: 문서

본문

이 명령은 접근 권한이 있는 DMF를 나열해요. 세션의 현재 데이터베이스·스키마, 지정한 데이터베이스·스키마, 또는 전체 계정의 DMF를 나열할 수 있어요.

기능 상태: Enterprise Edition 기능. 데이터 품질 모니터링(Data Quality Monitoring)에는 Enterprise Edition이 필요해요. 업그레이드 문의는 Snowflake 지원에 연락해요.

관련 명령: CREATE DATA METRIC FUNCTION, ALTER FUNCTION (DMF), DESCRIBE FUNCTION (DMF), DROP FUNCTION (DMF).

구문 (Syntax)

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

        DATABASE                 |
        DATABASE <database_name> |

        SCHEMA                   |
        SCHEMA <schema_name>     |
        <schema_name>
      }
  ]
  [ STARTS WITH '<name_string>' ]

파라미터 (Parameters)

  • LIKE <pattern> — 명령 출력을 객체 이름으로 필터링해요. 대소문자를 구분하지 않는 패턴 매칭이며 SQL 와일드카드 문자(%와 _)를 지원해요. 기본값: 없음.

  • [ IN ... ] — 명령의 범위를 선택적으로 지정해요:

    • ACCOUNT — 전체 계정의 레코드 반환.
    • DATABASE 또는 DATABASE db_name — 현재 또는 지정한 데이터베이스의 레코드 반환. 데이터베이스가 사용 중이 아닌데 db_name 없이 지정하면 키워드가 출력에 영향을 주지 않아요. 참고: 데이터베이스 컨텍스트에서 IN 절 없이 SHOW 명령을 사용하면 예상보다 적은 결과가 나올 수 있어요. IN 절 없이 같은 이름의 객체는 한 번만 표시돼요.
    • SCHEMA 또는 SCHEMA schema_name — 현재 또는 지정한 스키마의 레코드 반환. SCHEMA 다음의 schema_name은 데이터베이스가 사용 중이거나 완전 정규화된 이름(예: db.schema)을 지정하면 선택 사항이에요.
    • IN ...을 생략하면 범위는 세션의 현재 데이터베이스 유무에 따라 달라져요: 있으면 IN DATABASE와 같은 효과, 없으면 IN ACCOUNT와 같은 효과.

  • STARTS WITH <name_string> — 객체 이름의 시작 문자를 기준으로 출력을 필터링해요. 문자열은 작은따옴표로 묶어야 하며 대소문자를 구분해요.

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

권한 (Privilege) 객체 (Object) 비고
USAGE 데이터 메트릭 함수

출력 (Output)

명령 출력은 DMF 속성과 메타데이터를 다음 컬럼으로 제공해요:

  • created_on — 함수가 생성된 타임스탬프.
  • name — 함수 이름.
  • schema_name — 함수가 존재하는 스키마 이름. 기본 제공 함수는 NULL.
  • is_builtin — 함수가 기본 제공 함수이면 Y, 아니면 N.
  • is_aggregate — 함수가 집계 함수이면 Y, 아니면 N.
  • is_ansi — 함수가 ANSI SQL 표준의 일부이면 Y, 아니면 N.
  • min_num_arguments — 최소 인자 수.
  • max_num_arguments — 최대 인자 수.
  • arguments — 인자 및 반환 값의 데이터 타입을 표시.
  • description — 함수 설명.
  • catalog_name — 함수가 존재하는 데이터베이스 이름. 기본 제공 함수는 NULL.
  • is_table_function — 함수가 테이블 함수이면 Y, 아니면 N.
  • valid_for_clustering — 함수를 CLUSTER BY 표현식에 사용할 수 있으면 Y, 아니면 N.
  • is_secure — 함수가 보안(secure) 함수이면 Y, 아니면 N.
  • is_external_function — 함수가 외부(external) 함수이면 Y, 아니면 N.
  • language — 기본 제공 함수는 SQL을 표시. 사용자 정의 함수는 작성 언어(SQL, JAVASCRIPT 등)를 표시. 외부 함수는 EXTERNAL을 표시.
  • is_memoizable — 함수가 메모이제이션 가능하면 Y, 아니면 N.
  • is_data_metric — 함수가 DMF이면 Y, 아니면 N.

사용 참고 사항 (Usage notes)

  • 실행에 실행 중인 웨어하우스를 요구하지 않아요.
  • 현재 역할에 하나 이상의 접근 권한이 부여된 객체만 반환해요.
  • MANAGE GRANTS 권한은 보유자가 계정의 모든 객체를 볼 수 있게 해줘요. 기본적으로 ACCOUNTADMIN과 SECURITYADMIN 역할만 이 권한을 가져요.
  • 출력을 후처리하려면 파이프 연산자(|>) 또는 RESULT_SCAN 함수를 사용할 수 있어요. 출력 컬럼을 참조할 때는 컬럼 이름을 큰따옴표로 감싸서 사용해요.
  • 명령은 역할의 접근 권한에 따라 최대 1만 개의 레코드를 반환해요. 1만 개가 넘는 결과는 필터를 적용해도 반환되지 않아요.

예제 (Examples)

governance 데이터베이스의 dmfs 스키마에서 볼 권한이 있는 DMF를 나열해요:

USE SCHEMA governance.dmfs;

SHOW DATA METRIC FUNCTIONS;

더 알아보기 (Learn more)