다음을 통해 공유


Azure Cosmos DB for MongoDB vCore의 일반적인 문제 해결

적용 대상: MongoDB vCore

이 가이드는 Azure Cosmos DB for MongoDB vCore를 사용할 때 발생할 수 있는 문제를 해결하는 데 도움이 되도록 맞춤 제작되었습니다. 이 가이드는 연결 문제, 오류 시나리오 및 최적화 문제에 대한 솔루션을 제공하여 환경을 개선하기 위한 실질적인 인사이트를 제공합니다.

참고 항목

이러한 솔루션은 일반적인 지침이며 개별 상황에 따라 특정 구성이 필요할 수 있습니다. 항상 공식 설명서 및 지원 리소스를 참조하여 가장 정확한 최신 정보를 참조하세요.

일반 오류 및 해결 방법

Azure Cosmos DB for MongoDB vCore에 연결할 수 없음 - 시간 초과 오류

이 문제는 클러스터에 올바른 방화벽 규칙을 사용하도록 설정하지 않은 경우에 발생할 수 있습니다. Azure가 아닌 IP 범위에서 클러스터에 액세스하려는 경우 방화벽 규칙을 더 추가해야 합니다. 자세한 단계는 보안 옵션 및 기능 - Azure Cosmos DB for MongoDB vCore를 참조하세요. 방화벽 규칙은 클러스터에 대한 포털의 네트워킹 설정에서 구성할 수 있습니다. 옵션에는 알려진 IP 주소/범위 추가 또는 공용 IP 액세스를 사용하도록 설정하는 것이 포함됩니다.

Azure Cosmos DB for MongoDB vCore에 대한 시간 초과 오류 솔루션 스크린샷

DNSClient.DnsResponseException 오류로 인해 연결할 수 없음

연결 문제 디버깅:

Windows 사용자:
PsPing이 작동하지 않습니다. nslookup을 사용하면 클러스터 연결성 및 검색 가능성이 확인되어 네트워크 문제가 발생할 가능성이 낮음을 나타냅니다.

Unix 사용자:
소켓/네트워크 관련 예외의 경우 잠재적인 네트워크 연결 문제로 인해 애플리케이션이 Azure Cosmos DB Mongo API 엔드포인트와의 연결을 설정하지 못할 수 있습니다.

연결을 확인하려면 다음 단계를 따릅니다.

nc -v <accountName>.mongocluster.cosmos.azure.com 10260

포트 10260에 대한 TCP 연결이 실패하는 경우, 환경 방화벽이 Azure Cosmos DB 연결을 차단하고 있을 수 있습니다. 페이지 하단까지 아래로 스크롤하여 지원 티켓을 제출하세요.

연결 문자열 확인:

Azure Portal에 제공된 연결 문자열만 사용합니다. 적절한 연결에 필요하므로 mongodb+srv:// 프로토콜이 포함되어 있는지 확인합니다. c와 같은 변형이나 접두사를 사용하지 마십시오. 연결에 문제가 발생하는 경우 지원 티켓을 제출하여 디버깅을 위한 애플리케이션 또는 클라이언트 쪽 드라이버 로그를 공유합니다.

다음 단계