/ /

고유 필드 값 검색

개요

이 가이드 에서는 MongoDB PHP 라이브러리를 사용하여 컬렉션 전체에서 지정된 필드 의 고유 값을 조회 하는 방법을 학습 수 있습니다.

컬렉션 내에서 서로 다른 문서에 단일 필드 에 대해 서로 다른 값이 포함될 수 있습니다. 예를 예시 restaurants 컬렉션 의 한 문서 는 borough 값이 'Manhattan' 이고 다른 문서의 borough 값은 'Queens' 입니다. MongoDB PHP 라이브러리를 사용하면 컬렉션 의 여러 문서에서 필드 에 포함된 모든 고유 값을 조회 할 수 있습니다.

샘플 데이터

이 가이드 의 예제에서는 Atlas 샘플 데이터 세트 의 sample_restaurants 데이터베이스 에 있는 restaurants 컬렉션 을 사용합니다. PHP 애플리케이션 에서 이 컬렉션 에 액세스 하려면 Atlas cluster 에 연결하는 MongoDB\Client 를 인스턴스화하고 $collection 변수에 다음 값을 할당합니다.

$collection = $client->sample_restaurants->restaurants;

무료 MongoDB 배포서버 생성하고 샘플 데이터 세트를 로드하는 방법을 학습하려면, MongoDB 시작하기 가이드 참조하세요.

`MongoDB\Collection::distinct()` 메서드

지정된 필드의 고유 값을 검색하려면 MongoDB\Collection::distinct() 메서드를 호출하고 고유 값을 찾으려는 필드의 이름을 전달합니다.

컬렉션 전체에서 고유 값 검색

다음 예에서는 restaurants 컬렉션에 있는 borough 필드의 고유 값을 검색합니다.

$results = $collection->distinct('borough', []);
foreach ($results as $value) {
    echo json_encode($value), PHP_EOL;
}

"Bronx"
"Manhattan"
"Missing"
"Queens"
"Staten Island"

이 작업은 각 고유 borough 필드 값을 저장하는 배열 을 반환합니다. 여러 문서의 borough 필드 에 동일한 값이 있더라도 각 값은 결과에 한 번만 표시됩니다.

지정된 문서에서 고유 값 검색

distinct() 메서드에 쿼리 필터하다 를 제공하여 컬렉션 의 문서 하위 집합에서 고유 필드 값을 찾을 수 있습니다. 쿼리 필터하다 는 작업에서 문서를 일치시키는 데 사용되는 검색 기준을 지정하는 표현식 입니다. 쿼리 필터하다 만들기에 대한 자세한 내용은 쿼리 지정 가이드 를 참조하세요.

다음 예에서는 cuisine 필드 값이 'Italian' 인 모든 문서에 대해 borough 필드의 고유 값을 검색합니다.

$results = $collection->distinct('borough', ['cuisine' => 'Italian']);
foreach ($results as $value) {
    echo json_encode($value), PHP_EOL;
}

"Bronx"
"Manhattan"
"Queens"
"Staten Island"

고유 동작 수정

옵션 값을 지정하는 배열 을 전달하여 distinct() 메서드의 동작을 수정할 수 있습니다. 다음 표에서는 작업을 사용자 지정하기 위해 설정하다 수 있는 몇 가지 옵션에 대해 설명합니다.

옵션	설명
`collation`	작업에 사용할 데이터 정렬입니다. 자세히 학습 이 페이지의 데이터 정렬 섹션을 참조하세요. 유형: `array\|object`
`maxTimeMS`	작업을 실행 수 있는 최대 시간(밀리초)입니다. 유형: `integer`
`comment`	작업에 첨부할 주석입니다. 유형: 유효한 모든 BSON types
`readPreference`	작업에 사용할 읽기 설정 (read preference) . 자세한 학습 은 서버 매뉴얼의 읽기 설정을 참조하세요. 유형: `MongoDB\Driver\ReadPreference`
`hint`	작업에 사용할 인덱스 입니다. 유형: `string\|object`

다음 예시 에서는 borough 필드 값이 'Bronx' 이고 cuisine 필드 값이 'Pizza' 인 모든 문서에 대해 name 필드 의 고유 값을 검색합니다. 또한 옵션 배열 의 comment 필드 를 지정하여 작업에 주석을 추가합니다.

$query = ['borough' => 'Bronx', 'cuisine' => 'Pizza'];
$options = ['comment' => 'Bronx pizza restaurants'];
$results = $collection->distinct('name', $query, $options);
foreach ($results as $value) {
    echo json_encode($value), PHP_EOL;
}

"$1.25 Pizza"
"18 East Gunhill Pizza"
"2 Bros"
"Aenos Pizza"
"Alitalia Pizza Restaurant"
"Amici Pizza And Pasta"
"Angie'S Cafe Pizza"
...

데이터 정렬

작업에 대한 데이터 정렬을 지정하려면 collation 옵션을 설정하는 $options 배열 매개변수를 작업 메서드에 전달합니다. 데이터 정렬 규칙을 구성하는 배열 에 collation 옵션을 할당합니다.

다음 표에서는 데이터 정렬을 구성하기 위해 설정하다 수 있는 필드에 대해 설명합니다.

필드	설명
`locale`	(필수) 국제 구성 요소 유니코드(ICU) 국가 및 언어 설정 및 언어 설정을 지정합니다. 지원되는 국가 및 언어 설정 목록은 MongoDB Server 매뉴얼의 데이터 정렬 국가 및 언어 설정 및 기본 매개변수를 참조하세요. 데이터 유형: `string`
`caseLevel`	(선택 사항) 대소문자 비교를 포함할지 여부를 지정합니다. 로 설정하다 하면 `true` 비교 동작은 `strength` 필드 의 값에 따라 달라집니다. - 가 `strength` `1`인 경우 PHP 라이브러리는 기본 문자와 대소문자를 비교합니다. - 가 `strength` `2`인 경우 PHP 라이브러리는 기본 문자, 발음 부호, 기타 세컨더리 차이점 및 대소문자를 비교합니다. - 이(가) `strength` 다른 값인 경우 이 필드 무시됩니다. 로 설정하다 `false` 하면 PHP 라이브러리에 강도 수준 `1` 또는 에서 대소문자 비교가 포함되지 `2` 않습니다. 데이터 유형: `bool` 기본값: `false`
`caseFirst`	(선택 사항) 3차 수준 비교 시 대소문자 차이의 정렬 순서를 지정합니다. 데이터 유형: `string` 기본값: `"off"`
`strength`	(선택 사항) ICU 문서에 정의된 대로 수행할 비교 수준을 지정합니다. 데이터 유형: `int` 기본값: `3`
`numericOrdering`	(선택 사항) 운전자 숫자 문자열을 숫자로 비교할지 여부를 지정합니다. 로 설정하다 `true` 하면 PHP 라이브러리는 숫자 문자열을 숫자로 비교합니다. 예시 들어, 문자열 '10'와 '2'를 비교할 때 라이브러리는 문자열의 숫자 값을 사용하고 '10'를 ' '보다 큰 것으로 취급합니다.2 로 설정하다 `false` 하면 PHP 라이브러리는 숫자 문자열을10문자열로 비교합니다. 예시 를 들어 ' 문자열과 '2' 문자열을 비교할 때 라이브러리는 한 번에 한 문자씩10비교하여 ' '을 ' '보다 작은 것으로2취급합니다. 자세한 내용은 MongoDB Server 매뉴얼에서 데이터 정렬 제한을 참조하세요. 데이터 유형: `bool` 기본값: `false`
`alternate`	(선택 사항) 라이브러리가 비교 목적으로 공백과 문장 부호를 기본 문자로 간주할지 여부를 지정합니다. 데이터 유형: `string` 기본값: `"non-ignorable"`
`maxVariable`	(선택 사항) 필드 `alternate` 로 설정하다 경우 라이브러리에서 무시할 수 있는 것으로 간주하는 문자를 `"shifted"` 지정합니다. 데이터 유형: `string` 기본값: `"punct"`
`backwards`	(선택 사항) 분음 부호가 포함된 문자열을 문자열 뒤쪽에서 앞쪽으로 정렬할지 여부를 지정합니다. 데이터 유형: `bool` 기본값: `false`

데이터 정렬 및 각 필드에 사용할 수 있는 값에 대해 자세히 학습하려면 MongoDB Server 매뉴얼의 데이터 정렬 항목을 참조하세요.

API 문서

distinct() 메서드에 학습 보려면 API 설명서에서 MongoDB\Collection::distinct() 를 참조하세요.

돌아가기

문서 수 계산

커서에서 데이터 액세스