다음을 통해 공유


Azure Cosmos DB의 Microsoft Fabric 미러된 데이터베이스의 제한 사항(미리 보기)

이 문서에서는 Microsoft Fabric에 미러된 Azure Cosmos DB 계정에 대한 현재 제한 사항을 자세히 설명합니다. 이 페이지의 제한 사항 및 할당량 세부 정보는 추후 변경될 수 있습니다.

Important

Azure Cosmos DB의 미러링은 현재 프리뷰로 제공됩니다. 프로덕션 워크로드는 미리 보기 중에 지원되지 않습니다. 현재는 Azure Cosmos DB for NoSQL 계정만 지원됩니다.

가용성

Fabric 및 API for Azure Cosmos DB에 대한 미러링은 특정 지역에서 지원됩니다.

지원되는 API

미러링 여기에 나열된 Azure Cosmos DB 계정 유형에만 사용할 수 있습니다.

사용 가능
API for NoSQL
API for MongoDB(RU 기반) 아니요
API for MongoDB(vCore 기반) 아니요
API for Apache Gremlin 아니요
API for Table 아니요
API for Apache Cassandra(RU 기반) 아니요
Apache Cassandra용 Managed Instance 아니요

지원되는 지역

미러링을 지원하는 패브릭 지역은 다음과 같습니다.

아시아 태평양:

  • 오스트레일리아 동부
  • 오스트레일리아 남동부
  • 인도 중부
  • 동아시아
  • 일본 동부
  • 한국 중부
  • 동남 아시아
  • 인도 남부

유럽

  • 북유럽
  • 서유럽
  • 프랑스 중부
  • 독일 중서부
  • 이탈리아 북부
  • 노르웨이 동부
  • 폴란드 중부
  • 스웨덴 중부
  • 스위스 북부
  • 스위스 서부
  • 영국 남부
  • 영국 서부

아메리카:

  • 브라질 남부
  • 캐나다 중부
  • 캐나다 동부
  • 미국 중부
  • 미국 동부
  • 미국 동부2
  • 미국 중북부
  • 미국 중남부
  • 미국 서부
  • 미국 서부2

중동 및 아프리카

  • 남아프리카 북부
  • 아랍에미리트 북부

계정 및 데이터베이스 제한 사항

  • Azure Cosmos DB 계정이 7일 또는 30일 지속적인 백업으로 구성된 경우에만 미러링을 사용하도록 설정할 수 있습니다.
  • Azure Cosmos DB의 지속적인 백업 기능의 모든 현재 제한 사항은 Fabric 미러링에도 적용됩니다.
    • 이러한 제한 사항에는 다음이 포함되지만 이에 국한되지는 않습니다. 지속적인 백업이 사용하도록 설정되면 지속적인 백업을 사용하지 않도록 설정할 수 없으며 다중 지역 쓰기 계정에 대한 지원이 부족합니다. 자세한 내용은 Azure Cosmos DB의 지속적인 백업 제한 사항을 참조하세요.
    • 동일한 Azure Cosmos DB 계정에서 분석 저장소 및 지속적인 백업 기능을 모두 사용하도록 설정할 수 있습니다.
  • 지속적인 백업을 사용하도록 설정된 Azure Cosmos DB 계정에 분석 저장소 기능을 사용하지 않도록 설정할 수 없습니다.
  • 이전에 컨테이너에 대한 분석 저장소 기능을 사용하지 않도록 설정한 Azure Cosmos DB 계정에서는 지속적인 백업을 사용하도록 설정할 수 없습니다.

보안 제한 사항

  • Azure Cosmos DB 읽기-쓰기 계정 키는 원본 계정에 연결할 수 있는 유일한 메커니즘입니다. 읽기 전용 계정 키, 관리 ID 및 역할 기반 액세스 제어를 통한 암호 없는 인증은 지원되지 않습니다.
  • 계정 키가 회전되는 경우 Fabric 미러링에 대한 연결 자격 증명을 업데이트해야 합니다. 키를 업데이트하지 않으면 미러링이 실패합니다. 이 오류를 해결하려면 복제를 중지하고 새로 회전된 키로 자격 증명을 업데이트한 다음 복제를 다시 시작합니다.
  • 작업 영역에 액세스할 수 있는 Fabric 사용자는 미러 데이터베이스에 대한 액세스를 자동으로 상속합니다. 그러나 작업 영역 및 테넌트 수준 액세스를 세밀하게 제어하여 조직의 사용자에 대한 액세스를 관리할 수 있습니다.
  • Fabric에서 미러된 데이터베이스를 직접 공유할 수 있습니다.

사용 권한

  • Fabric에 뷰어 권한만 있는 경우 SQL 분석 엔드포인트에서 데이터를 미리 보거나 쿼리할 수 없습니다.
  • 데이터 탐색기를 사용하려는 경우 Azure Cosmos DB 데이터 탐색기는 Fabric과 동일한 권한을 사용하지 않습니다. 데이터 탐색기를 사용하여 데이터를 보고 쿼리하는 요청은 Fabric 대신 Azure로 라우팅됩니다.

네트워크 보안

  • 원본 Azure Cosmos DB 계정은 모든 네트워크에 대해 공용 네트워크 액세스를 사용하도록 설정해야 합니다.
  • 프라이빗 엔드포인트는 Azure Cosmos DB 계정에 대해 지원되지 않습니다.
  • Azure Cosmos DB 계정에는 IP 주소 또는 서비스 엔드포인트와 같은 기술 및 기능을 사용한 네트워크 격리가 지원되지 않습니다.
  • OneLake의 데이터는 프라이빗 엔드포인트, 고객 관리형 키 또는 이중 암호화를 지원하지 않습니다.

데이터 탐색기 제한 사항

  • Fabric 데이터 탐색기 쿼리는 읽기 전용입니다. 기존 컨테이너를 보고, 항목을 보고, 항목을 쿼리할 수 있습니다.
  • Fabric에서 데이터 탐색기를 사용하여 컨테이너를 만들거나 삭제할 수 없습니다.
  • Fabric에서 데이터 탐색기를 사용하여 항목을 삽입, 수정 또는 삭제할 수 없습니다.
  • 분석을 위해 다른 사용자와 SQL 분석 엔드포인트만 공유하면 원본 데이터베이스를 공유하지 않도록 할 수 있습니다.
  • 미러된 데이터베이스에서는 데이터 탐색기를 끌 수 없습니다.

복제 제한 사항

  • 미러링은 공백이나 와일드카드 문자가 포함된 속성 이름을 가진 항목이 포함된 컨테이너를 지원하지 않습니다. 이 제한 사항으로 인해 특정 컨테이너에 대한 미러링이 실패합니다. 동일한 데이터베이스 내의 다른 컨테이너는 여전히 성공적으로 미러링할 수 있습니다. 이러한 잘못된 문자를 제거하도록 속성 이름을 업데이트하는 경우 동일한 데이터베이스 및 컨테이너에 새 미러를 구성해야 하며 이전 미러를 사용할 수 없습니다.
  • Fabric OneLake는 Azure Cosmos DB 계정에 여러 읽기 지역이 있는 시나리오에서 지리적으로 가장 가까운 Azure 지역에서 Fabric의 용량 지역으로 미러링됩니다. 재해 복구 시나리오에서 미러링은 읽기 지역이 잠재적으로 장애 조치(failover) 및 변경될 수 있으므로 자동으로 새 읽기 지역을 검색하고 선택합니다.
  • 원본 컨테이너의 삭제 작업은 미러링을 사용하여 Fabric OneLake에 즉시 반영됩니다. TTL(Time to Live) 값을 사용하는 일시 삭제 작업은 지원되지 않습니다.
  • 미러링에서는 사용자 지정 분할을 지원하지 않습니다.
  • Fabric에는 T-SQL에 대한 기존 제한 사항이 있습니다. 자세한 내용은 T-SQL 제한 사항을 참조하세요.

스키마 및 데이터 변경 내용

  • 유사한 컨테이너를 삭제하고 추가하면 웨어하우스 테이블의 데이터가 새 컨테이너의 데이터로만 바뀝니다.
  • 여러 항목에서 속성의 데이터 형식을 변경하면 해당되는 경우 복제자가 데이터를 업캐스트합니다. 이 동작은 기본 델타 환경과 동등합니다. 지원되는 조건에 맞지 않는 모든 데이터는 null 형식이 됩니다. 예를 들어 배열 속성을 문자열로 변경하면 null 형식으로 업캐스트됩니다.
  • 항목에 새 속성을 추가하면 미러링이 새 속성을 원활하게 검색하고 해당 열을 웨어하우스 테이블에 추가합니다. 항목 속성이 제거되거나 누락된 경우 해당 레코드에 대해 null 값이 있습니다.
  • 미러링을 사용한 데이터 복제에는 완전한 충실도나 잘 정의된 스키마가 없습니다. 미러링은 속성 변경 및 데이터 형식(허용되는 경우)을 자동으로 지속적으로 추적합니다.

중첩된 데이터

  • Azure Cosmos DB 항목의 중첩된 JSON 개체는 웨어하우스 테이블에서 JSON 문자열로 표시됩니다.
  • OPENJSON, CROSS APPLYOUTER APPLY와 같은 명령을 사용하여 JSON 문자열 데이터를 선택적으로 확장할 수 있습니다.
  • PowerQuery에는 JSON 문자열 데이터를 선택적으로 확장하는 ToJson이 포함되어 있습니다.
  • 미러링에는 중첩 수준에 대한 스키마 제약 조건이 없습니다. 자세한 내용은 Azure Cosmos DB 분석 저장 스키마 제약 조건을 참조하세요.

Data Warehouse 제한 사항

  • 웨어하우스는 크기가 8KB보다 큰 JSON 문자열 열을 처리할 수 없습니다. 이 시나리오의 오류 메시지는 "JSON 텍스트의 형식이 올바르지 않습니다. 위치에 예기치 않은 문자 '"'가 있습니다"입니다.
  • SQL 분석 엔드포인트 및 웨어하우스 테이블에서 JSON 문자열로 표현되는 중첩된 데이터로 인해 일반적으로 열 크기가 8KB 이상으로 증가할 수 있습니다. 이 오류 메시지가 표시되면 중첩 수준과 데이터 양을 모니터링하세요.

미러된 항목 제한 사항

  • 작업 영역에서 Azure Cosmos DB 계정에 미러링을 사용하도록 설정하려면 작업 영역의 관리자 또는 구성원 역할이 필요합니다.
  • 복제를 중지하면 미러링이 완전히 비활성화됩니다.
  • 복제를 다시 시작하면 모든 대상 웨어하우스 테이블이 다시 시드됩니다. 이 작업은 처음부터 미러링을 효과적으로 시작합니다.

피드백 보내기

현재 제한 사항, 기능 또는 문제에 대한 피드백을 제공하려는 경우 fabriccosmosdbmirror@microsoft.com으로 알려주세요.