실험 검색 필터
Search Experiments의 where에 type으로 구분한 필터를 전달합니다. 생략하면 해당 모델의 모든 실험이 대상입니다. and와 or는 filters 배열을, not은 필수 value에 하위 필터 하나를 받습니다.
같은 매개변수와 지표에 조건 묶기
parameterFilter는 매개변수 이름과 값 비교를 같은 매개변수에 적용합니다. seriesFilter는 시계열 이름과 지표 조건을 같은 시계열에, summaryMetricFilter는 시계열 이름과 집계 종류 및 비교를 같은 요약 지표에 적용합니다.
이 복합 필터를 사용하면 이름 조건을 만족한 매개변수와 값 조건을 만족한 매개변수가 서로 다른 경우를 피할 수 있습니다.
parameterFilter.operator | 지원하는 값 유형 |
|---|---|
EQ | boolean, double, integer, datetime |
GT, LT | double, integer, datetime |
CONTAINS | 문자열의 부분 문자열 비교 |
문자열 매개변수 값의 지원 연산자는 CONTAINS입니다. 일반 eq 필터의 PARAMETER_NAME은 매개변수 이름을 비교하는 별도의 조건입니다. STATUS 조건에는 RUNNING, SUCCEEDED, FAILED를 사용합니다.
검색과 정렬의 EXPERIMENT_NAME은 질의 필드입니다. 이 필드가 있다는 이유로 Experiment 응답에 name 속성이 반환된다고 전제하지 않습니다.
기본 조건 예시
실행 중인 실험:
{"type":"eq","field":"STATUS","value":"RUNNING"}
master 브랜치의 실험:
{"type":"eq","field":"BRANCH","value":"master"}
learning_rate가 0.01보다 큰 실험:
{"type":"parameterFilter","parameterName":"learning_rate","operator":"GT","value":0.01}
성공했으며 learning_rate가 0.5보다 큰 실험:
{
"type":"and",
"filters":[
{"type":"eq","field":"STATUS","value":"SUCCEEDED"},
{"type":"parameterFilter","parameterName":"learning_rate","operator":"GT","value":0.5}
]
}
매개변수 이름과 값의 자료형은 실제 실험에 기록한 정보에 맞게 지정합니다.
전체 필터 구조
실험 검색 조건입니다. 생략하면 해당 모델의 모든 실험을 대상으로 합니다.
분기 seriesFilter
시계열 이름과 지표 비교 조건을 하나로 묶어 동일한 시계열에서 모든 조건을 평가합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: seriesFilter. | seriesFilter |
seriesName | string | 필수 | 필터할 시계열 이름입니다. | loss |
field | enum | 필수 | 비교할 시계열 지표입니다. 허용값: LENGTH, AGGREGATION_MIN, AGGREGATION_MAX, AGGREGATION_LAST. | LENGTH |
operator | enum | 필수 | 같음, 초과 또는 미만 비교 연산자입니다. 허용값: EQ, GT, LT. | EQ |
value | any | 필수 | 비교할 값입니다. |
분기 contains
부분 문자열을 포함하는 조건입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: contains. | contains |
field | enum | 필수 | 부분 문자열 포함 조건에 사용할 수 있는 필드입니다. 허용값: EXPERIMENT_NAME, PARAMETER_NAME, SERIES_NAME. | EXPERIMENT_NAME |
value | any | 필수 |
분기 not
하위 필터를 만족하지 않는 실험을 반환합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: not. | not |
value | union | 필수 | type으로 연산자를 구분하는 재귀 검색 필터입니다. 동등 비교, 텍스트 조건과 논리 조합을 지원하며 이름과 값 비교를 같은 매개변수 또는 지표에 묶는 복합 필터를 사용할 수 있습니다. |
value의 구조
같은 필터 분기를 재귀적으로 사용합니다.
분기 or
하나 이상의 필터를 만족하는 실험을 반환합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: or. | or |
filters | list<SearchExperimentsFilter> | 선택 |
filters의 구조
배열 항목은 SearchExperimentsFilter이며 자료형은 union입니다.
type으로 연산자를 구분하는 재귀 검색 필터입니다. 동등 비교, 텍스트 조건과 논리 조합을 지원하며 이름과 값 비교를 같은 매개변수 또는 지표에 묶는 복합 필터를 사용할 수 있습니다.
같은 필터 분기를 재귀적으로 사용합니다.
분기 and
모든 필터를 만족하는 실험을 반환합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: and. | and |
filters | list<SearchExperimentsFilter> | 선택 |
filters의 구조
배열 항목은 SearchExperimentsFilter이며 자료형은 union입니다.
type으로 연산자를 구분하는 재귀 검색 필터입니다. 동등 비교, 텍스트 조건과 논리 조합을 지원하며 이름과 값 비교를 같은 매개변수 또는 지표에 묶는 복합 필터를 사용할 수 있습니다.
같은 필터 분기를 재귀적으로 사용합니다.
분기 parameterFilter
매개변수의 정확한 이름과 값 비교를 하나로 묶어 같은 매개변수에서 평가합니다. EQ는 boolean, double, integer, datetime에 사용합니다. GT와 LT는 double, integer, datetime에 사용하며 CONTAINS는 문자열 값의 부분 문자열을 찾습니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: parameterFilter. | parameterFilter |
parameterName | string | 필수 | 필터할 매개변수의 정확한 이름입니다. | learning_rate |
operator | enum | 필수 | 적용할 비교 연산자입니다. 허용값: EQ, GT, LT, CONTAINS. | EQ |
value | any | 필수 | 비교할 값입니다. |
분기 summaryMetricFilter
시계열 이름, 집계 종류와 값 비교를 하나로 묶어 같은 요약 지표에서 평가합니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: summaryMetricFilter. | summaryMetricFilter |
seriesName | string | 필수 | 이 지표가 속한 시계열 이름입니다. | loss |
aggregation | enum | 필수 | 집계 종류입니다. 허용값: MIN, MAX, LAST. | MIN |
operator | enum | 필수 | 같음, 초과 또는 미만 비교 연산자입니다. 허용값: EQ, GT, LT. | EQ |
value | any | 필수 | 비교할 값입니다. |
분기 eq
필드값이 정확히 일치하는 기록을 선택하는 조건입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: eq. | eq |
field | enum | 필수 | 동등 비교를 지원하는 필드입니다. 허용값: STATUS, BRANCH, EXPERIMENT_NAME, EXPERIMENT_RID, JOB_RID, TAG, PARAMETER_NAME, SERIES_NAME. | STATUS |
value | any | 필수 |
분기 startsWith
접두사 일치 조건입니다.
| 이름 | 자료형 | 필수 여부 | 의미와 조건 | 예시 값 |
|---|---|---|---|---|
type | enum | 필수 | 허용값: startsWith. | startsWith |
field | enum | 필수 | 접두사 조건에 사용할 수 있는 필드입니다. 허용값: EXPERIMENT_NAME, PARAMETER_NAME, SERIES_NAME. | EXPERIMENT_NAME |
value | any | 필수 |