SHOW RUNS IN EXPERIMENT
SHOW RUNS IN EXPERIMENT
실험(experiment) 안의 실행(run)들을 나열하는 명령이에요.
출처: 문서
본문
실험 안의 실행들을 나열해요.
구문
SHOW RUNS [ LIKE '<pattern>' ] IN EXPERIMENT <name>
매개변수
LIKE 'pattern'
선택적으로 객체 이름으로 명령 출력을 필터링해요. 필터는 SQL 와일드카드 문자(%와 _)를 지원하며 대소문자를 구분하지 않는 패턴 매칭을 사용해요. 예를 들어 다음 패턴들은 같은 결과를 반환해요:
... LIKE '%testing%' ...
... LIKE '%TESTING%' ...
기본값: 값 없음(출력에 필터링이 적용되지 않음).
name
검사할 실험의 식별자를 지정해요. 식별자에 공백이나 특수 문자가 포함되면 전체 문자열을 큰따옴표로 묶어야 해요. 큰따옴표로 묶은 식별자는 대소문자를 구분해요. 자세한 내용은 식별자 요건(Identifier requirements)을 참고해요.
출력
명령 출력은 객체의 속성과 메타데이터를 설명하는 다음 컬럼을 포함해요:
| 컬럼 | 설명 |
|---|---|
| created_on | 실행이 생성된 날짜와 시각이에요. |
| name | 실행의 식별자예요. |
| database_name | 실행이 저장된 데이터베이스예요. |
| schema_name | 실행이 저장된 스키마예요. |
| experiment_name | 실행이 속한 실험이에요. |
| metadata | 실행 상태와 메트릭을 포함하는 JSON 객체예요. run의 status 필드는 RUNNING인지 FINISHED인지를 나타내요. metrics 필드는 실행의 메트릭을 보고해요. 최신 메트릭 값(가장 높은 스텝의 값)만 포함돼요. |
액세스 제어 요구 사항
이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한을 가져야 해요:
| 권한 | 객체 | 참고 |
|---|---|---|
| USAGE | Experiment |
스키마의 객체를 운영하려면 상위 데이터베이스에 대한 권한이 하나 이상, 상위 스키마에 대한 권한이 하나 이상 필요해요. 지정된 권한 집합으로 사용자 정의 역할을 만드는 방법은 사용자 정의 역할 만들기(Creating custom roles)를 참고해요. 보안 객체에 대한 SQL 작업 수행을 위한 역할·권한 부여에 대한 일반 정보는 액세스 제어 개요(Overview of Access Control)를 참고해요.
사용 메모
- 이 명령은 실행에 웨어하우스가 필요하지 않아요.
- 이 명령은 현재 사용자의 현재 역할에 액세스 권한이 하나 이상 부여된 객체만 반환해요.
MANAGE GRANTS액세스 권한은 보유자에게 계정의 모든 객체를 볼 수 있는 권한을 암묵적으로 부여해요. 기본적으로 계정 관리자(ACCOUNTADMIN 역할)와 보안 관리자(SECURITYADMIN 역할)만MANAGE GRANTS권한을 가져요.- 이 명령의 출력을 후처리하려면 파이프 연산자(
->>)나RESULT_SCAN함수를 사용할 수 있어요. 두 구성 모두 출력을 쿼리할 수 있는 결과 집합으로 취급해요. 예를 들어 SHOW 명령 출력에서 특정 컬럼을 선택하거나 행을 필터링할 수 있어요. - 출력 컬럼을 참조할 때는 큰따옴표로 묶은 식별자를 사용해요. 예를 들어
type출력 컬럼을 선택하려면SELECT "type"이라고 지정해요. SHOW 명령의 출력 컬럼 이름은 소문자이므로 큰따옴표로 묶은 식별자를 사용해야 해요. - 이 명령은 명령을 실행하는 역할의 액세스 권한에 따라 지정한 객체 유형에 대해 최대 1만 개의 레코드를 반환해요. 1만 개를 초과하는 결과를 보려면 Snowflake 정보 스키마의 해당 뷰(존재하는 경우)를 쿼리해요.
- 스키마 수준 객체에 대한 명령을 실행할 때, 현재 역할이 상위 데이터베이스와 스키마에도 권한이 하나 이상 있어야 객체를 반환해요.