Microsoft Fabric 미러링에서는 기존 Azure Cosmos DB 데이터를 Fabric의 나머지 데이터와 통합하는 원활한 ETL 없음 환경을 제공합니다. 이 문서의 팁을 사용하여 Fabric에서 Azure Cosmos DB용 미러된 데이터베이스를 만들 때 발생할 수 있는 문제를 해결할 수 있습니다.
Important
Azure Cosmos DB의 미러링은 현재 프리뷰로 제공됩니다. 프로덕션 워크로드는 미리 보기 중에 지원되지 않습니다. 현재는 Azure Cosmos DB for NoSQL 계정만 지원됩니다.
다음은 Azure Cosmos DB 데이터베이스를 Microsoft Fabric에 미러링하는 작업이 정상적으로 작동하지 않는 경우 따라야 할 일반적인 문제 및 관련 문제 해결 단계 목록입니다.
데이터베이스를 로드할 때 "SQLAPIendpoint" 오류와 함께 미러링이 실패합니다. 이 오류를 해결하려면 어떻게 할까요?
일반적으로 이 오류는 선택한 연결에 대해 Azure Cosmos DB 계정 키가 더 이상 유효하지 않음을 나타냅니다. 연결 자격 증명이 유효한 계정 키로 업데이트되면 미러링을 다시 설정하세요.
내 Azure Cosmos DB 계정에 지속적인 백업이 없다는 오류가 발생하면서 Fabric이 미러링을 구성할 수 없습니다. 이 오류를 어떻게 해결할까요?
Azure Cosmos DB 계정에 대해 지속적인 백업을 사용하도록 설정합니다. 자세한 내용은 지속적인 백업을 사용하여 Azure Cosmos DB 계정 만들기 또는 기존 Azure Cosmos DB 계정을 지속적인 백업으로 마이그레이션을 참조하세요.
지속적인 백업 기능을 사용하도록 설정한 후 Fabric 미러링 설정으로 돌아가서 나머지 단계를 계속 진행합니다.
Azure Cosmos DB 계정에 지속적인 백업이 사용하도록 설정되어 있는지 어떻게 알 수 있나요?
Azure Portal을 사용하면 Azure Cosmos DB 계정의 리소스 메뉴에서 특정 시점 복원 옵션을 찾아 지속적인 백업 기능이 사용 설정되어 있는지 확인할 수 있습니다. 이 옵션을 사용할 수 없는 경우 계정에 지속적인 백업을 사용하도록 설정하지 않았거나 계정이 지속적인 백업으로 마이그레이션되고 있는 것입니다.
Azure Cosmos DB 계정에서 지속적인 백업을 사용하도록 설정하면 다양한 오류가 발생합니다. Fabric 미러링을 계속 설정할 수 있나요?
아니요, 미러링 원본이 될 Azure Cosmos DB 계정에 지속적인 백업을 사용하도록 설정해야 합니다.
Azure Cosmos DB 계정에 지속적인 백업을 사용하도록 설정할 때 오류 메시지가 표시되면 계정에 해당 기능이 차단되는 제한 사항이 있을 수 있습니다. 예를 들어 이전에 계정에 대한 분석 저장소를 삭제한 경우 계정은 지속적인 백업을 지원할 수 없습니다. 이 시나리오에서 이제 남은 옵션은 미러링에 새 Azure Cosmos DB 계정을 사용하는 것뿐입니다.
복제가 작동하지 않고, "복제 모니터링"을 선택하면 "내부 서버 오류"가 발생하는 이유는 무엇인가요?
복제가 작동할 수 있으며 Azure Cosmos DB가 Fabric의 요청을 제한할 경우 일시적인 오류가 발생합니다. 또한 Azure Cosmos DB의 미러링 제한으로 인해 이 문제가 발생할 수도 있습니다. 자세한 내용은 Azure Cosmos DB 미러링 제한 사항을 참조하세요.
Fabric 포털을 새로 고치고 문제가 자동으로 해결되는지 확인합니다. 또한 복제를 중지하고 시작할 수도 있습니다. 이러한 옵션이 작동하지 않는 경우 지원 티켓을 엽니다.
Fabric이 Azure Cosmos DB에서 데이터를 복제하고 있는지 어떻게 확인할 수 있나요?
먼저 Fabric 미러된 데이터베이스의 일반적인 문제 해결 단계를 따릅니다. 자세한 내용은 문제 해결을 참조하세요.
대부분의 경우 복제 모니터링 옵션은 데이터가 Fabric에 성공적으로 복제되는지 여부를 나타내는 추가 세부 정보를 제공할 수 있습니다. 일반적인 문제 해결 단계는 마지막으로 새로 고친 시간이 최근인지 확인하는 것입니다. 시간이 최근이 아닌 경우, 다음 단계로 복제를 중지한 다음 다시 시작합니다. "마지막으로 새로 고친 시간"은 복제에 대해 기록된 시간 이후 원본 데이터베이스가 변경된 경우에만 업데이트됩니다. 원본 데이터베이스에 업데이트, 삭제 또는 삽입된 내용이 없으면 "마지막으로 새로 고친 시간"이 업데이트되지 않습니다.
"복제 모니터링" 창에 상당한 시간이 지난 후에도 복제된 행이 없는 테이블이 포함됩니다. 복제가 중단된 것인가요?
복제가 중단되었을 수 있습니다. 첫 단계로, 복제를 중지하고 다시 시작합니다. 이 단계로 해결되지 않으면 지원 티켓을 엽니다.
SQL 분석 엔드포인트에서 테이블을 찾을 수 없는 이유는 무엇인가요?
먼저 스키마 및 dbo 노드를 새로 고쳐 테이블이 준비되었는지 확인합니다. 테이블이 준비되면 자동으로 로드됩니다. 상당한 시간이 지난 후에도 테이블이 준비되지 않은 경우 복제 모니터링 창을 사용하여 복제 오류가 발생했는지 확인합니다.
대상 웨어하우스 테이블에 복제 후 '_rid' 열만 포함되는 이유는 무엇인가요?
먼저 스키마 및 dbo 노드를 새로 고쳐 테이블이 준비되었는지 확인합니다. 테이블이 준비되면 자동으로 로드됩니다. 상당한 시간이 지난 후에도 추가로 준비된 열이 없는 경우 복제 모니터링 창을 사용하여 복제 오류가 발생했는지 확인합니다.
Azure Cosmos DB 데이터베이스의 컨테이너에 새 항목을 추가했습니다. 해당 항목이 SQL 분석 엔드포인트 쿼리의 결과에 포함되지 않습니다. 복제가 작동하는지 어떻게 확인하나요?
복제 모니터링 옵션은 데이터가 Fabric에 성공적으로 복제되는지 여부를 나타내는 추가 세부 정보를 제공할 수 있습니다. 일반적인 문제 해결 단계는 마지막으로 새로 고친 시간이 최근인지 확인하는 것입니다. 시간이 최근이 아닌 경우, 다음 단계로 복제를 중지한 다음 다시 시작합니다. 시간이 최근인 경우 쿼리를 다시 시도합니다. 경우에 따라 Azure Cosmos DB에 삽입되는 데이터와 복제되고 Fabric에서 사용할 수 있는 데이터 사이에 지연이 발생할 수 있습니다.
데이터를 아직 사용할 수 없는 경우 Lakehouse를 사용하여 바로 가기를 만들고 Notebook에서 Spark 쿼리를 실행합니다. Spark는 항상 최신 데이터를 표시합니다. 데이터를 Spark에서 사용할 수 있지만 SQL 분석에서는 사용할 수 없는 경우 지원 티켓을 엽니다.
Spark에서도 데이터를 사용할 수 없는 경우 복제 대기 시간에 의도치 않은 문제가 있을 수 있습니다. 잠시 기다렸다가 복제를 다시 시도합니다. 문제가 지속되면 지원 티켓을 엽니다.
"JSON 텍스트의 형식이 제대로 지정되지 않았습니다. 내 SQL 분석 엔드포인트에 대해 T-SQL 쿼리를 실행할 때 예기치 않은 문자 '"'이(가) 있습니다." 오류 메시지가 표시되는 이유는 무엇인가요?
Data Warehouse는 크기가 8KB보다 큰 JSON 문자열 열을 처리할 수 없습니다. SQL 분석 엔드포인트 또는 웨어하우스 테이블에서 JSON 문자열로 표시되는 중첩된 데이터는 일반적으로 열 크기가 8KB 이상으로 증가할 수 있습니다. 이 오류 메시지가 표시되는 경우 중첩 수준 및 데이터 양을 모니터링합니다. 자세한 내용은 Data Warehouse 제한 사항을 참조하세요.
"모니터 복제" 창에 "잘못된 열 이름" 오류가 표시되는 이유는 무엇인가요?
미러링에서는 공백 또는 와일드카드 문자를 포함하는 속성 이름의 항목이 포함된 컨테이너를 지원하지 않습니다. 이 제한 사항으로 인해 특정 컨테이너에 대한 미러링이 실패합니다. 동일한 데이터베이스 내의 다른 컨테이너는 여전히 성공적으로 미러링할 수 있습니다. 자세한 내용은 복제 제한 사항을 참조하세요.