Azure Synapse Link kullanmak için Cosmos DB hesabını etkinleştirme

  • 5 dakika

Azure Cosmos DB için Azure Synapse Link, Azure Cosmos DB ile Azure Synapse Analytics arasında tümleştirme sağlayan bulutta yerel bir HTAP özelliğidir.

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

Yukarıdaki diyagramda Cosmos DB için Azure Synapse Link mimarisinin aşağıdaki temel özellikleri gösterilmiştir:

  1. Azure Cosmos DB kapsayıcısı, okuma/yazma işlemleri için iyileştirilmiş satır tabanlı işlem deposu sağlar.
  2. Kapsayıcı ayrıca analiz iş yükleri için iyileştirilmiş sütun tabanlı bir analiz deposu sağlar. Tam olarak yönetilen otomatik eşitleme işlemi, veri depolarını eşitlenmiş durumda tutar.
  3. Azure Synapse Link, Azure Cosmos DB'de analiz deposu etkinleştirilmiş kapsayıcıyı bir Azure Synapse Analytics çalışma alanına bağlayan bağlı bir hizmet sağlar.
  4. Azure Synapse Analytics, Azure Cosmos DB'deki işlemsel veri deposunu etkilemeden Azure Cosmos DB analiz deposundan veri almak, işlemek ve analiz etmek için kod çalıştırabileceğiniz Synapse SQL ve Apache Spark çalışma zamanları sağlar.

Cosmos DB için Azure Synapse Link'i kullanmanın ilk adımı, bunu bir Azure Cosmos DB hesabında etkinleştirmektir. Azure Synapse Link aşağıdaki Azure Cosmos DB hesabı türlerinde desteklenir:

  • NoSQL için Azure Cosmos DB
  • MongoDB için Azure Cosmos DB
  • Apache Gremlin için Azure Cosmos DB (önizleme)

Azure Synapse Link'i Cosmos DB hesabınızın Azure portalı sayfasından ya da bir komut satırından veya betikten Azure CLI veya Azure PowerShell kullanarak etkinleştirebilirsiniz.

Azure portalını kullanma

Azure portalında, aşağıda gösterildiği gibi Tümleştirmeler bölümündeki Azure Synapse Link sayfasında Cosmos DB hesabı için Azure Synapse Link'i etkinleştirebilirsiniz.

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

Bahşiş

NoSQL için Azure Cosmos DB hesapları için Veri Gezgini sayfasında da bir bağlantı vardır.

Azure CLI'yı kullanma

Azure CLI kullanarak Azure Synapse Link'i etkinleştirmek için parametresiyle --enable-analytical-storage true komutunu (yeni bir Cosmos DB hesabı oluşturmak için) veya az cosmosdb update komutunu (mevcut bir Cosmos DB hesabını yapılandırmak için) çalıştırınaz cosmosdb create. Örneğin aşağıdaki komut, Azure Synapse Link'i etkinleştirmek için my-cosmos-db adlı mevcut bir Cosmos DB hesabını güncelleştirir.

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

Apache Gremlin için Azure Cosmos DB hesabı için Azure Synapse Link'i etkinleştirmek için parametresini --capabilities EnableGremlin ekleyin.

Azure PowerShell’i kullanma

Azure PowerShell kullanarak Azure Synapse Link'i etkinleştirmek için cmdlet'ini New-AzCosmosDBAccount (yeni bir Cosmos DB hesabı oluşturmak için) veya Update-AzCosmosDBAccount cmdlet'ini (mevcut bir Cosmos DB hesabını yapılandırmak için) parametresiyle -EnableAnalyticalStorage 1 çalıştırın. Örneğin aşağıdaki komut, Azure Synapse Link'i etkinleştirmek için my-cosmos-db adlı mevcut bir Cosmos DB hesabını güncelleştirir.

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

Cosmos DB hesabı için Azure Synapse Link'i etkinleştirmeyi planlarken aşağıdaki olguları göz önünde bulundurun:

  • Bir hesap için Azure Synapse Link'i etkinleştirdikten sonra devre dışı bırakamazsınız.

  • Azure Synapse Link'in etkinleştirilmesi işlemsel verilerin analiz deposuyla eşitlenmesine başlamaz. Ayrıca analiz deposu desteğiyle bir kapsayıcı oluşturmanız veya güncelleştirmeniz gerekir.

  • Azure CLI veya PowerShell kullanarak NoSQL için Cosmos DB için Azure Synapse Link'i etkinleştirirken, şema türünü (varsayılan) veya olarak WellDefined belirtmek için (Azure CLI) veya FullFidelity-AnalyticalStorageSchemaType (PowerShell) parametresini kullanabilirsiniz --analytical-storage-schema-type . MongoDB hesabı için Cosmos DB için varsayılan (ve yalnızca desteklenen) şema türü olur FullFidelity.

  • Bir şema türü atandıktan sonra değiştiremezsiniz.

    Dekont

    Sonraki ünitede analiz deposu ve şema türleri hakkında daha fazla bilgi edineceksiniz.