Azure Cosmos DB 노드 문서
n8n v2.29Azure Cosmos DB 노드를 사용하여 Azure Cosmos DB에서 작업을 자동화하고 Azure Cosmos DB를 다른 애플리케이션과 통합하세요. 이 페이지에서는 Azure Cosmos DB 노드가 지원하는 작업 목록과 추가 리소스 링크를 확인할 수 있습니다.
Azure Cosmos DB 노드를 사용하여 Azure Cosmos DB에서 작업을 자동화하고 Azure Cosmos DB를 다른 애플리케이션과 통합하세요. n8n은 컨테이너 및 항목을 생성, 조회, 업데이트, 삭제하는 기능을 포함하여 다양한 Azure Cosmos DB 기능을 기본으로 지원합니다.
이 페이지에서는 Azure Cosmos DB 노드가 지원하는 작업 목록과 추가 리소스 링크를 확인할 수 있습니다.
작업#
- Container:
- Create
- Delete
- Get
- Get Many
- Item:
- Create
- Delete
- Get
- Get Many
- Execute Query
- Update
Item: Execute Query#
컨테이너에 대해 NoSQL SQL 쿼리를 실행하고 일치하는 항목을 반환합니다.
매개변수#
| Parameter | Required | Description |
|---|---|---|
| Container | Yes | 쿼리를 실행할 컨테이너입니다. 목록에서 선택하거나 컨테이너 ID를 직접 입력하세요. |
| Query | Yes | 실행할 SQL 쿼리입니다. 쿼리 매개변수의 위치 지정자로 $1, $2, $3 등을 사용하세요. n8n은 요청을 Azure Cosmos DB로 보내기 전에 이를 자동으로 @Param1, @Param2, @Param3으로 변환합니다. 예: SELECT * FROM c WHERE c.status = $1 AND c.startDate = $2. |
| Simplify | No | 활성화하면(기본값), 반환된 항목에서 내부 Cosmos DB 메타데이터 필드(_로 시작하는 필드)를 제거합니다. 비활성화하면 전체 원시 API 응답을 받습니다. |
옵션#
Options를 펼쳐 쿼리 매개변수를 구성하세요.
| Option | Description |
|---|---|
| Query Parameters | 쿼리의 $1, $2 등에 위치별로 매핑되는 쉼표로 구분된 문자열 값 목록입니다. 모든 값은 항상 문자열로 전송됩니다. 이름이나 상태 값과 같은 간단한 텍스트 필터에 사용하세요. 예: active,2024. |
| Query Parameters (JSON) | 쿼리의 $1, $2 등에 위치별로 매핑되는 값의 JSON 배열입니다. 숫자, 불리언, null, 앞에 0이 붙은 문자열 등 네이티브 타입을 유지합니다. 타입 정밀도가 중요한 경우 Query Parameters 대신 이 옵션을 사용하세요. 예: [1737062400000, "01234", true, null]. |
Query Parameters와 Query Parameters (JSON) 중 선택하기
Azure Cosmos DB는 타입에 민감한 비교를 수행합니다.
WHERE c.startDate = $1과 같은 필터는 startDate가 데이터베이스에 숫자로 저장되어 있는데 매개변수가 문자열로 전달되면 결과를 반환하지 않습니다.
- 필터 값이 모두 텍스트(이름, 상태, 식별자)인 경우 Query Parameters를 사용하세요.
- 숫자, 불리언,
null, 또는 숫자로 시작하면서 문자열로 유지되어야 하는 문자열(예:"01234"와 같은 우편번호)을 필터링해야 하는 경우 **Query Parameters (JSON)**을 사용하세요.
제한 사항: JavaScript의 JSON 파서는 Number.MAX_SAFE_INTEGER(9007199254740991)보다 큰 정수를 완전한 정밀도로 표현할 수 없습니다. 이 한계를 초과하는 값은 **Query Parameters (JSON)**을 사용할 때 정밀도를 잃을 수 있습니다.
템플릿 및 예제#
Azure Cosmos DB 노드 문서 통합 템플릿 찾아보기 또는 모든 템플릿 검색
관련 자료#
서비스에 대한 자세한 내용은 Azure Cosmos DB 문서를 참고하세요.
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.