> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/roboflow/roboflow-ko/datasets/manage-datasets/dataset-search.md).

# 데이터셋 검색

Roboflow에서 이미지 파일을 파일 이름, 검색 쿼리로 검색할 수 있으며, 쿼리와 필터를 섞어 사용해 특정 이미지를 찾고 데이터를 더 잘 이해할 수 있습니다.

* **특정 태그가 있는 split의 이미지:**\
  `tag:factory split:train`\
  이것은 태그 필터와 split 필터를 사용합니다
* **시맨틱 검색과 클래스 필터를 사용해 누락된 라벨을 찾기**:\
  `person -class:helmet`\
  이것은 시맨틱 검색과 클래스 필터에 대한 반전 필터를 사용합니다
* **모든 클래스 이미지에 특정 필터가 필요한 경우:**\
  `class:helmet AND NOT (tag:v1 OR tag:v2)`\
  이것은 클래스 필터, 불리언 로직, 태그 필터를 사용합니다
* **어노테이션 수가 적은 넓은 이미지를 찾기:**\
  `min-width:1000 max-annotations:1`\
  이것은 최소 너비 필터와 최대 어노테이션 수 필터를 사용합니다

전체 목록 보기 [검색 필터](#search-filters)와 아래의 예시도 함께 확인하세요

{% hint style="info" %}
이 모든 검색 필터와 쿼리를 함께 조합할 수 있습니다
{% endhint %}

### 시맨틱 검색

이미지를 설명하는 방식으로 이미지를 검색할 수 있습니다. 이 쿼리는 검색어와 가장 밀접하게 관련된 이미지를 검색하며, 객체가 아직 라벨링되지 않은 경우에도 이미지를 찾는 데 도움이 될 수 있습니다.

시맨틱 검색은 어떤 필터 선택자도 없이 텍스트 쿼리를 입력할 때 발생합니다(예: `filename:`)

<figure><img src="/files/543d9892b3d86e0a7bd062f1fef2a446d3062bf8" alt=""><figcaption></figcaption></figure>

### 파일 이름으로 검색

다음을 사용해 파일 이름을 검색할 수 있습니다. `filename:` 필터 또는 파일 이름 입력란을 사용하면 쿼리가 자동으로 생성됩니다.

<figure><img src="/files/4388ee546318da318eb0cb25c5b5097bb21a0ed4" alt="" width="192"><figcaption></figcaption></figure>

### Dataset Split으로 검색

데이터셋 split(train, valid, test)로 이미지를 검색합니다

<figure><img src="/files/9a10f464088db16c62c68b720edc0e3c61b44738" alt="" width="257"><figcaption></figcaption></figure>

이미지를 다른 split으로 다시 할당하려면, 이미지를 선택하고(또는 검색 결과에서 "모두 선택"을 선택하고) 일괄 작업 메뉴에서 "Change Dataset Split"을 클릭하세요. 대량 선택은 백그라운드에서 처리됩니다.

### 업로드 날짜로 검색

다음을 사용하여 Roboflow에 처음 업로드된 날짜를 기준으로 이미지를 필터링합니다. `date:` 필터. 업로드 날짜는 변경할 수 없으며, 이미지를 편집하거나 다시 어노테이션하거나 split 간에 이동해도 바뀌지 않습니다.

사용 `date:YYYY-MM-DD` 를 사용하면 특정 날짜를 지정할 수 있고, 비교 연산자를 조합해 범위를 검색할 수도 있습니다:

`date>=2026-01-01 date<2026-02-01`

## 검색 필터

사용 가능한 필터는 다음과 같습니다:

* `like-image:<IMAGE_ID>`: 이미지 콘텐츠를 기반으로 한 시맨틱 검색
* `tag` : 사용자 제공 태그로 필터링합니다.
* `filename` : 제공된 파일 이름과 일치하는 파일 이름을 검색합니다. 부분 일치를 실행하려면 쿼리의 앞뒤에 \*를 사용하세요.
* `split` : split(train, test, valid)으로 필터링합니다.
* `job:<JOB_ID>` : 제공된 job ID가 있는 이미지를 표시합니다.
* `min-width:X` : 너비가 X보다 큰 이미지를 표시합니다.
* `max-width:X` : 너비가 X보다 작은 이미지를 표시합니다.
* `min-height:X` : 높이가 X보다 큰 이미지를 표시합니다.
* `max-height:X` : 높이가 X보다 작은 이미지를 표시합니다.
* `min-annotations:X` : 지정된 어노테이션 수보다 많은 이미지를 필터링합니다.
* `max-annotations:X` : 지정된 어노테이션 수보다 적은 이미지를 표시합니다.
* `class:CLASS`: 제공된 라벨에 해당하는 어노테이션이 최소 1개 있는 이미지를 표시합니다.
* `date:YYYY-MM-DD` : 이미지를 업로드한 변경 불가능한 날짜로 필터링합니다. 비교 연산자를 지원합니다(예: `date>=2026-01-01 date<2026-02-01`).

### 불리언 로직

AND, OR, NOT과 괄호를 사용해 여러 필터를 조합하여 복잡한 쿼리를 만들 수 있습니다.

`class:helmet AND NOT (tag:v1 OR tag:v2)`

### 반전 필터

필터 앞에 빼기 기호를 추가해 해당 필터와 일치하는 이미지를 제외합니다.

`class:helmet -class:vest`

### 숫자 클래스 필터

이미지 내 라벨이 지정된 항목 수로 필터링합니다.

`class:helmet=3 class:vest>=4`

## API

또한 우리의 [Search API를 통해 Roboflow에서 데이터셋과 이미지를 검색할 수도 있습니다.](https://docs.roboflow.com/api-reference/images/search#rest-api).