MongoDB
쿼리 추가
페이지 목록에서 워크플로우를 추가하여 쿼리 스텝을 추가할 수 있습니다.
워크플로우 스텝 사이드바에서 MongoDB 데이터 소스를 선택하면 쿼리 입력 창이 나타납니다.
데이터 소스 추가 방법은 MongoDB 데이터 소스 가이드를 참고해주세요.
액션
find (조회)
컬렉션에서 문서를 조회합니다.
파라미터
이름 | 타입 | 설명 |
---|---|---|
컬렉션 (collection) | string | 컬렉션 이름 |
Filter (filter) | object | 조회 조건 |
Limit (limit) | number | 반환할 문서 수 제한 |
Skip (skip) | number | 건너뛸 문서 수 |
Sort (sort) | object | 정렬 조건 |
쿼리 결과 값
조회된 문서 배열을 반환합니다.
[
{ "_id": "507f1f77bcf86cd799439011", "name": "John", "age": 30 },
{ "_id": "507f1f77bcf86cd799439012", "name": "Jane", "age": 25 }
]
insertOne (단일 문서 삽입)
단일 문서를 컬렉션에 삽입합니다.
파라미터
이름 | 타입 | 설명 |
---|---|---|
컬렉션 (collection) | string | 컬렉션 이름 |
Document (document) | object | 삽입할 문서 데이터 |
Options (options) | object | 삽입 옵션 |
쿼리 결과값
insertOne 액션을 실행하면 삽입된 문서의 ID 결과값이 아래와 같은 구조로 반환됩니다. 자세한 내용은 MongoDB 공식 문서를 참고해주세요.
{
"acknowledged": true,
"insertedId": "507f1f77bcf86cd799439011"
}
insertMany (다중 문서 삽입)
여러 문서를 한 번에 컬렉션에 삽입합니다.
파라미터
이름 | 타입 | 설명 |
---|---|---|
컬렉션 (collection) | string | 컬렉션 이름 |
Documents (documents) | array | 삽입할 문서 배열 |
Options (options) | object | 삽입 옵션 |
쿼리 결과값
insertMany 액션을 실행하면 삽입된 문서들의 ID 배열 결과값이 아래와 같은 구조로 반환됩니다. 자세한 내용은 MongoDB 공식 문서를 참고해주세요.
{
"acknowledged": true,
"insertedIds": ["507f1f77bcf86cd799439011", "507f1f77bcf86cd799439012"]
}
replaceOne (문서 교체)
필터 조건에 맞는 단일 문서를 새로운 문서로 교체합니다.
파라미터
이름 | 타입 | 설명 |
---|---|---|
컬렉션 (collection) | string | 컬렉션 이름 |
Filter (filter) | object | 교체할 문서 조건 |
Replacement (replacement) | object | 교체할 새로운 문서 |
Options (options) | object | 교체 옵션 |
쿼리 결과값
replaceOne 액션을 실행하면 교체된 문서 수 결과값이 아래와 같은 구조로 반환됩니다. 자세한 내용은 MongoDB 공식 문서를 참고해주세요.
{
"acknowledged": true,
"matchedCount": 1,
"modifiedCount": 1
}
updateOne (단일 문서 수정)
필터 조건에 맞는 단일 문서를 수정합니다.
파라미터
이름 | 타입 | 설명 |
---|---|---|
컬렉션 (collection) | string | 컬렉션 이름 |
Filter (filter) | object | 수정할 문서 조건 |
Update (update) | object | 수정할 내용 |
Options (options) | object | 수정 옵션 |
쿼리 결과값
updateOne 액션을 실행하면 수정된 문서 수 결과값이 아래와 같은 구조로 반환됩니다. 자세한 내용은 MongoDB 공식 문서를 참고해주세요.
{
"acknowledged": true,
"matchedCount": 1,
"modifiedCount": 1
}
updateMany (다중 문서 수정)
필터 조건에 맞는 모든 문서를 수정합니다.
파라미터
이름 | 타입 | 설명 |
---|---|---|
컬렉션 (collection) | string | 컬렉션 이름 |
Filter (filter) | object | 수정할 문서 조건 |
Updates (updates) | array | 수정할 내용 배열 |
Options (options) | object | 수정 옵션 |
쿼리 결과값
updateMany 액션을 실행하면 수정된 문서 수 결과값이 아래와 같은 구조로 반환됩니다. 자세한 내용은 MongoDB 공식 문서를 참고해주세요.
{
"acknowledged": true,
"matchedCount": 5,
"modifiedCount": 5
}
deleteOne (단일 문서 삭제)
필터 조건에 맞는 단일 문서를 삭제합니다.
파라미터
이름 | 타입 | 설명 |
---|---|---|
컬렉션 (collection) | string | 컬렉션 이름 |
Filter (filter) | object | 삭제할 문서 조건 |
Options (options) | object | 삭제 옵션 |
쿼리 결과값
deleteOne 액션을 실행하면 삭제된 문서 수 결과값이 아래와 같은 구조로 반환됩니다. 자세한 내용은 MongoDB 공식 문서를 참고해주세요.
{
"acknowledged": true,
"deletedCount": 1
}
deleteMany (다중 문서 삭제)
필터 조건에 맞는 모든 문서를 삭제합니다.
파라미터
이름 | 타입 | 설명 |
---|---|---|
컬렉션 (collection) | string | 컬렉션 이름 |
Filter (filter) | object | 삭제할 문서 조건 |
Options (options) | object | 삭제 옵션 |
쿼리 결과값
deleteMany 액션을 실행하면 삭제된 문서 수 결과값이 아래와 같은 구조로 반환됩니다. 자세한 내용은 MongoDB 공식 문서를 참고해주세요.
{
"acknowledged": true,
"deletedCount": 10
}
distinct (고유값 조회)
지정된 필드의 고유한 값들을 조회합니다.
파라미터
이름 | 타입 | 설명 |
---|---|---|
컬렉션 (collection) | string | 컬렉션 이름 |
Field Name (fieldName) | string | 조회할 필드 이름 |
Filter (filter) | object | 필터 조건 |
쿼리 결과 값
distinct 액션을 실행하면 고유한 값들의 배열 결과값이 아래와 같은 구조로 반환됩니다. 자세한 내용은 MongoDB 공식 문서를 참고해주세요.
["Seoul", "New York", "London", "Tokyo"]
count (문서 수 계산)
필터 조건에 맞는 문서의 수를 계산합니다.
파라미터
이름 | 타입 | 설명 |
---|---|---|
컬렉션 (collection) | string | 컬렉션 이름 |
Filter (filter) | object | 계산할 문서 조건 |
Options (options) | object | 계산 옵션 |
쿼리 결과 값
count 액션을 실행하면 조회한 문서 수 결과값이 아래와 같은 구조로 반환됩니다. 자세한 내용은 MongoDB 공식 문서를 참고해주세요.
{ "n": 42 }
aggregate (집계)
데이터를 집계하여 분석합니다.
파라미터
이름 | 타입 | 설명 |
---|---|---|
컬렉션 (collection) | string | 컬렉션 이름 |
Pipeline (pipeline) | array | 집계 파이프라인 |
쿼리 결과값
aggregate 액션을 실행하면 집계 결과 배열 결과값이 아래와 같은 구조로 반환됩니다. 자세한 내용은 MongoDB 공식 문서를 참고해주세요.
[
{
"_id": "Seoul",
"totalPopulation": 9700000,
"avgAge": 35.6
},
{
"_id": "Tokyo",
"totalPopulation": 13960000,
"avgAge": 38.2
}
]
bulkWrite (일괄 작업)
여러 작업을 한 번에 실행합니다.
파라미터
이름 | 타입 | 설명 |
---|---|---|
컬렉션 (collection) | string | 컬렉션 이름 |
Requests (requests) | object | 실행할 작업 목록 |
쿼리 결과값
bulkWrite 액션을 실행하면 실행된 작업 결과 결과값이 아래와 같은 구조로 반환됩니다. 자세한 내용은 MongoDB 공식 문서를 참고해주세요.
{
"acknowledged": true,
"insertedCount": 2,
"matchedCount": 3,
"modifiedCount": 3,
"deletedCount": 1,
"upsertedCount": 0
}
runCommand (명령어 실행)
데이터베이스 명령어를 직접 실행합니다.
파라미터
이름 | 타입 | 설명 |
---|---|---|
컬렉션 (collection) | string | 컬렉션 이름 |
Command (command) | object | 실행할 명령어 |
쿼리 결과값
runCommand 액션을 실행하면 명령어 실행 결과 결과값이 아래와 같은 구조로 반환됩니다. 자세한 내용은 MongoDB 공식 문서를 참고해주세요.
{
"ok": 1,
"n": 100,
"avgObjSize": 157,
"size": 15700
}