Azure Synapse Link를 사용하도록 Cosmos DB 계정 설정

  • 5분

Azure Cosmos DB용 Azure Synapse Link는 Azure Cosmos DB와 Azure Synapse Analytics 간 통합을 가능하게 하는 클라우드 네이티브 HTAP 기능입니다.

A diagram showing Azure Synapse Link integration with Azure Cosmos DB and Azure Synapse Analytics.

위의 다이어그램에는 Cosmos DB 아키텍처용 Azure Synapse Link의 다음과 같은 주요 기능이 설명되어 있습니다.

  1. Azure Cosmos DB 컨테이너는 읽기/쓰기 작업에 최적화된 행 기반 트랜잭션 저장소를 제공합니다.
  2. 또한 컨테이너는 분석 워크로드에 최적화된 열 기반 분석 저장소를 제공합니다. 완전 관리형 자동 동기화 프로세스는 데이터 저장소를 동기화 상태로 유지합니다.
  3. Azure Synapse Link는 Azure Cosmos DB의 분석 저장소 지원 컨테이너를 Azure Synapse Analytics 작업 영역에 연결하는 연결된 서비스를 제공합니다.
  4. Azure Synapse Analytics는 코드를 실행하여 Azure Cosmos DB의 트랜잭션 데이터 저장소에 영향을 주지 않고 Azure Cosmos DB 분석 저장소에서 데이터를 검색, 처리 및 분석할 수 있는 Synapse SQL 및 Apache Spark 런타임을 제공합니다.

Azure Cosmos DB용 Azure Synapse Link를 사용하는 첫 번째 단계는 Cosmos DB 계정에서 사용하도록 설정하는 것입니다. Azure Synapse Link는 다음과 같은 유형의 Azure Cosmos DB 계정에서 지원됩니다.

  • Azure Cosmos DB for NoSQL
  • Azure Cosmos DB for MongoDB
  • Azure Cosmos DB for Apache Gremlin(미리 보기)

Cosmos DB 계정의 Azure Portal 페이지에서 Azure CLI 또는 Azure PowerShell에서 명령줄 또는 스크립트를 사용하여 Azure Synapse Link를 사용하도록 설정할 수 있습니다.

Azure Portal 사용

Azure Portal에서 아래와 같이 통합 섹션의 Azure Synapse Link 페이지에서 Cosmos DB 계정에 Azure Synapse Link를 사용하도록 설정할 수 있습니다.

A screenshot showing the option to enable Azure Synapse Link for a Cosmos DB for NoSQL account.

팁

Azure Cosmos DB for NoSQL 계정의 경우 Data Explorer 페이지에도 링크가 있습니다.

Azure CLI 사용

Azure CLI를 사용하여 Azure Synapse Link를 사용하도록 설정하려면 --enable-analytical-storage true 매개 변수를 사용하여 az cosmosdb create 명령(새 Cosmos DB 계정을 만드는 경우) 또는 az cosmosdb update 명령(기존 Cosmos DB 계정을 구성하는 경우)을 실행합니다. 예를 들어 다음 명령은 Azure Synapse Link를 사용하도록 my-cosmos-db라는 기존 Cosmos DB 계정을 업데이트합니다.

az cosmosdb update --name my-cosmos-db --resource-group my-rg --enable-analytical-storage true

Azure Cosmos DB for Apache Gremlin 계정에 Azure Synapse Link를 사용하도록 설정하려면 --capabilities EnableGremlin 매개 변수를 포함합니다.

Azure PowerShell 사용

Azure PowerShell을 사용하여 Azure Synapse Link를 사용하도록 설정하려면 -EnableAnalyticalStorage 1 매개 변수를 사용하여 New-AzCosmosDBAccount cmdlet(새 Cosmos DB 계정을 만드는 경우) 또는 Update-AzCosmosDBAccount cmdlet(기존 Cosmos DB 계정을 구성하는 경우)을 실행합니다. 예를 들어 다음 명령은 Azure Synapse Link를 사용하도록 my-cosmos-db라는 기존 Cosmos DB 계정을 업데이트합니다.

Update-AzCosmosDBAccount -Name "my-cosmos-db" -ResourceGroupName "my-rg" -EnableAnalyticalStorage 1

Cosmos DB 계정에 Azure Synapse Link를 사용하도록 설정할 계획인 경우 다음 사실을 고려합니다.

  • 계정에 Azure Synapse Link를 사용하도록 설정한 후에는 사용하지 않도록 설정할 수 없습니다.

  • Azure Synapse Link를 사용하도록 설정해도 운영 데이터를 분석 저장소에 동기화할 수 없습니다. 또한 분석 저장소를 지원하는 컨테이너를 만들거나 업데이트해야 합니다.

  • Azure CLI 또는 PowerShell을 사용하여 Cosmos DB for NoSQL 계정에 Azure Synapse Link를 사용하도록 설정하는 경우 --analytical-storage-schema-type(Azure CLI) 또는 -AnalyticalStorageSchemaType(PowerShell) 매개 변수를 사용하여 스키마 유형을 WellDefined(기본값) 또는 FullFidelity로 지정할 수 있습니다. Cosmos DB for MongoDB 계정의 경우 기본(및 지원되는) 스키마 유형은 FullFidelity입니다.

  • 스키마 유형이 할당된 후에는 스키마 유형을 변경할 수 없습니다.

    참고

    다음 단원에서 분석 저장소 및 해당 스키마 유형에 대해 자세히 알아봅니다.