Öğretici: Azure Veri Paylaşımı kullanarak verileri kabul etme ve alma

Bu öğreticide, Azure Veri Paylaşımı kullanarak bir veri paylaşımı daveti kabul etmeyi öğreneceksiniz. Sizinle paylaşılan verileri almayı ve her zaman sizinle paylaşılan verilerin en son anlık görüntüsüne sahip olduğunuzdan emin olmak için düzenli yenileme aralığını etkinleştirmeyi öğrenirsiniz.

• Azure Veri Paylaşımı daveti kabul etme
• Azure Veri Paylaşımı hesabı oluşturma
• Verileriniz için bir hedef belirtin
• Zamanlanmış yenileme için veri paylaşımınıza abonelik oluşturma

Önkoşullar

Veri paylaşımı daveti kabul etmeden önce aşağıda listelenen bazı Azure kaynaklarını oluşturmanız gerekir.

Veri paylaşımı daveti kabul etmeden önce tüm önkoşulların tamamlandığından emin olun.

• Azure Aboneliği: Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
• Veri Paylaşımı daveti: Microsoft Azure'dan "Azure Veri Paylaşımı daveti" başlıklı bir davet yourdataprovider@domain.com.
• Microsoft.DataShare kaynak sağlayıcısını, bir Veri Paylaşımı kaynağı oluşturacağınız Azure aboneliğine ve hedef Azure veri depolarınızın bulunduğu Azure aboneliğine kaydedin.

Depolama hesabına veri alma

• Azure Depolama hesabı: Henüz bir hesabınız yoksa bir Azure Depolama hesabı oluşturabilirsiniz.
• Microsoft.Storage/storageAccounts/write içinde bulunan depolama hesabına yazma izni. Bu izin, Depolama Hesabı Katılımcısı rolünde bulunur.
• Microsoft.Authorization/role assignments/write içinde bulunan depolama hesabına rol ataması ekleme izni. Bu izin Sahip rolünde var.

SQL tabanlı bir hedefe veri alımı

Azure SQL Veritabanı, Azure Synapse Analytics'e veri almayı seçerseniz aşağıdaki önkoşulların listesi.

Azure SQL Veritabanı veya Azure Synapse Analytics'e (eski adıyla Azure SQL DW) veri almak için önkoşullar

• Azure SQL Veritabanı veya Azure Synapse Analytics (eski adıyla Azure SQL DW).
• Microsoft.Sql/servers/databases/write içinde bulunan SQL sunucusundaki veritabanlarına yazma izni. Bu izin Katkıda Bulunan rolünde var.
• SQL sunucusunun Microsoft Entra Yöneticisi
• SQL Server Güvenlik Duvarı erişimi. Bu, aşağıdaki adımlarla yapılabilir:
  1. Azure portalında SQL server'da Güvenlik duvarları ve sanal ağlar'a gidin
  2. Azure hizmetlerinin ve kaynaklarının bu sunucuya erişmesine izin ver için Evet'i seçin.
  3. +İstemci IP'sini ekle'yi seçin. İstemci IP adresi değiştirilebilir. Azure portaldan SQL verilerini bir sonraki paylaşışınızda bu işlemin tekrarlanması gerekebilir. Ayrıca bir IP aralığı da ekleyebilirsiniz.
  4. Kaydetseçeneğini seçin.

Azure Synapse Analytics (çalışma alanı) SQL havuzuna veri almak için önkoşullar

• Azure Synapse Analytics çalışma alanı için ayrılmış bir SQL havuzu. Sunucusuz SQL havuzuna veri alma şu anda desteklenmiyor.

• Microsoft.Synapse/workspaces/sqlPools/write içinde bulunan Synapse çalışma alanında SQL havuzuna yazma izni. Bu izin Katkıda Bulunan rolünde var.

• Veri Paylaşımı kaynağının yönetilen kimliğinin Synapse çalışma alanı SQL havuzuna erişme izni. Bu, aşağıdaki adımlarla yapılabilir:

  1. Azure portalında Synapse çalışma alanına gidin. Sol gezinti bölmesinden Microsoft Entra admin'i seçin ve kendinizi Microsoft Entra yöneticisi olarak ayarlayın.

  2. Synapse Studio'yu açın, sol gezinti bölmesinde Yönet'i seçin. Güvenlik altında Erişim denetimi'ni seçin. Kendinize SQL yöneticisi veya Çalışma Alanı yöneticisi rolü atayın .

  3. Synapse Studio'da sol gezinti bölmesinden Geliştir'i seçin. Veri Paylaşımı kaynağı Yönetilen Kimliği'ni 'db_datareader, db_datawriter, db_ddladmin' olarak eklemek için SQL havuzunda aşağıdaki betiği yürütebilirsiniz.

     create user "<share_acc_name>" from external provider; 
     exec sp_addrolemember db_datareader, "<share_acc_name>"; 
     exec sp_addrolemember db_datawriter, "<share_acc_name>"; 
     exec sp_addrolemember db_ddladmin, "<share_acc_name>";
     

     <share_acc_name>, Veri Paylaşımı kaynağınızın adıdır. Henüz bir Veri Paylaşımı kaynağı oluşturmadıysanız, daha sonra bu önkoşula geri dönebilirsiniz.

• Synapse çalışma alanı Güvenlik duvarı erişimi. Bu, aşağıdaki adımlarla yapılabilir:

  1. Azure portalında Synapse çalışma alanına gidin. Sol gezinti bölmesinden Güvenlik duvarları'nı seçin.
  2. Azure hizmetlerinin ve kaynaklarının bu çalışma alanına erişmesine izin ver için ON'ı seçin.
  3. +İstemci IP'sini ekle'yi seçin. İstemci IP adresi değiştirilebilir. Azure portaldan SQL verilerini bir sonraki paylaşışınızda bu işlemin tekrarlanması gerekebilir. Ayrıca bir IP aralığı da ekleyebilirsiniz.
  4. Kaydetseçeneğini seçin.

Azure Veri Gezgini kümesine veri alma:

• Veri sağlayıcısının Veri Gezgini kümesiyle aynı Azure veri merkezinde bir Azure Veri Gezgini kümesi: Henüz bir kümeniz yoksa bir Azure Veri Gezgini kümesi oluşturabilirsiniz. Veri sağlayıcısının kümesinin Azure veri merkezini bilmiyorsanız, işlemin ilerleyen bölümlerinde kümeyi oluşturabilirsiniz.
• Microsoft.Kusto/clusters/write içinde bulunan Azure Veri Gezgini kümesine yazma izni. Bu izin Katkıda Bulunan rolü içinde mevcuttur.

Azure portalda oturum açma

Azure portalınaoturum açın.

Daveti aç

Portal

1. Daveti e-postadan veya doğrudan Azure portalından açabilirsiniz.

   E-postadaki daveti açmak için gelen kutunuzda veri sağlayıcınızdan gelen daveti kontrol edin. Davet, Microsoft Azure'dan, adlı Azure Veri Paylaşımı daveti şeklindedir yourdataprovider@domain.com. Davetinizi Azure'da görmek için Daveti görüntüle'yi seçin.

   Daveti doğrudan Azure portalından açmak için Azure portalında Veri Paylaşımı Davetleri için arama yapın. Bu eylem sizi Veri Paylaşımı davetleri listesine götürür.

   Kiracının konuk kullanıcısıysanız, Veri Paylaşımı davetini ilk kez görüntülemeden önce kiracı için e-posta adresinizi doğrulamanız istenir. Doğrulandıktan sonra 12 ay geçerlidir.

   

2. Görüntülemek istediğiniz daveti seçin.

Azure CLI

Azure CLI ortamınızı hazırlayın ve davetlerinizi görüntüleyin.

Başlangıç olarak ortamınızı Azure CLI için hazırlayın:

• Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz. Azure Cloud Shell'i kullanmaya başlama.

  

• CLI referans komutlarını yerel olarak çalıştırmayı tercih ediyorsanız, Azure CLI'yi yükleyin. Windows veya macOS üzerinde çalışıyorsanız, Azure CLI'yi bir Docker konteynerinde çalıştırmayı düşünün. Daha fazla bilgi için Azure CLI'nin bir Docker konteynerında nasıl çalıştırılacağını inceleyin.

  • Yerel bir kurulum kullanıyorsanız, az login komutunu kullanarak Azure CLI'ye giriş yapın. Kimlik doğrulama işlemini tamamlamak için, terminalinizde görüntülenen adımları takip edin. Diğer oturum açma seçenekleri için bkz. Azure CLI kullanarak Azure'da kimlik doğrulaması.

  • İstendiğinde, ilk kullanımda Azure CLI uzantısını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma ve yönetme.

  • Yüklü olan sürümü ve bağımlı kütüphaneleri bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

Geçerli davetlerinizi görmek için az datashare consumer-invitation list-invitation komutunu çalıştırın.

az datashare consumer-invitation list-invitation

Sonraki bölümde kullanmak üzere davet kimliğinizi kopyalayın.

PowerShell

PowerShell için ortamınızı hazırlayarak başlayın. PowerShell komutlarını yerel olarak çalıştırabilir veya Azure Cloud Shell'deki Bash ortamını kullanabilirsiniz.

• Azure PowerShell'i yerel olarak kullanmayı seçerseniz:
  • Az PowerShell modülünün en son sürümünü yükleyin.
  • Connect-AzAccount cmdlet'ini kullanarak Azure hesabınıza bağlanın.
• Azure Cloud Shell'i kullanmayı seçerseniz:
  • Daha fazla bilgi için bkz. Azure Cloud Shell'e genel bakış .

1. Azure hesabınıza bağlanmak için Connect-AzAccount komutunu kullanın.

   Connect-AzAccount
   

2. Birden çok aboneliğiniz varsa doğru aboneliği ayarlamak için Set-AzContext komutunu çalıştırın.

   Set-AzContext [SubscriptionID/SubscriptionName]
   

3. Geçerli davetlerinizi görmek için Get-AzDataShareReceivedInvitation komutunu çalıştırın:

   Get-AzDataShareReceivedInvitation
   

Sonraki bölümde kullanmak üzere davet kimliğinizi kopyalayın.

Daveti kabul et

Portal

1. Kullanım Koşulları da dahil olmak üzere tüm alanların gözden geçirildiğinden emin olun. Kullanım koşullarını kabul ediyorsanız, kabul ettiğinizi belirtmek için kutuyu işaretlemeniz gerekir.

   

2. Hedef Veri Paylaşımı Hesabı'nın altında, Veri Paylaşımınızı dağıttığınız Abonelik ve Kaynak Grubunu seçin.

   Veri Paylaşımı Hesabı alanı için Mevcut bir Veri Paylaşımı hesabınız yoksa Yeni oluştur'u seçin. Aksi takdirde, veri paylaşımınızı kabul etmek istediğiniz mevcut bir Veri Paylaşımı hesabını seçin.

   Alınan Paylaşım Adı alanı için, veri tarafından belirtilen varsayılan değeri bırakabilir veya alınan paylaşım için yeni bir ad belirtebilirsiniz.

   Kullanım koşullarını kabul ettikten ve alınan paylaşımınızı yönetmek için bir Veri Paylaşımı hesabı belirttikten sonra Kabul Et ve yapılandır'ı seçin. Paylaşım aboneliği oluşturulur.

   

   Bu eylem sizi Data Share hesabınızdaki alınan paylaşımınıza götürür.

   Daveti kabul etmek istemiyorsanız Reddet'i seçin.

Azure CLI

Veri Paylaşımını oluşturmak için az datashare share-subscription create komutunu kullanın.

az datashare share-subscription create --resource-group share-rg \
  --name "fabrikamsolutions" --account-name FabrikamDataShareAccount \
  --invitation-id 89abcdef-0123-4567-89ab-cdef01234567 \
  --source-share-location "East US 2"

PowerShell

Veri Paylaşımını oluşturmak için New-AzDataShareSubscription komutunu kullanın. InvitationId, önceki adımda topladığınız kimliktir.

New-AzDataShareSubscription -ResourceGroupName share-rg -AccountName FabrikamDataShareAccount -Name "Fabrikam Solutions" -InvitationId "89abcdef-0123-4567-89ab-cdef01234567"

Alınan paylaşımı yapılandırma

Portal

Veri almak istediğiniz yeri yapılandırmak için aşağıdaki adımları izleyin.

1. Veri kümeleri sekmesini seçin. Hedef atamak istediğiniz veri kümesinin yanındaki kutuyu işaretleyin. Hedef veri deposunu seçmek için + Harita ile hedefle seçeneğini seçin.

   

2. Verilerin inmesini istediğiniz hedef veri deposu türünü seçin. Hedef veri deposundaki aynı yol ve ada sahip olan tüm veri dosyaları veya tablolar üzerine yazılır. Azure SQL Veritabanı'na veya Azure Synapse Analytics'e (eski adıYla Azure SQL DW) veri alıyorsanız , Veri Paylaşımı'nın yukarıdaki 'kullanıcı oluştur' betiğini benim adıma çalıştırmasına izin ver onay kutusunu işaretleyin.

   Yerinde paylaşım için, belirtilen Konum'da bir veri deposu seçin. Konum, veri sağlayıcısının kaynak veri deposunun bulunduğu Azure veri merkezidir. Veri kümesi eşlendikten sonra, verilere erişmek için Hedef Yol'daki bağlantıyı izleyebilirsiniz.

   

3. Anlık görüntü tabanlı paylaşım için, veri sağlayıcısı verilere düzenli güncelleştirme sağlamak için bir anlık görüntü zamanlaması oluşturduysa , Anlık Görüntü Zamanlaması sekmesini seçerek anlık görüntü zamanlamasını da etkinleştirebilirsiniz. Anlık görüntü zamanlamasının yanındaki kutuyu işaretleyin ve + Etkinleştir'i seçin. İlk zamanlanmış anlık görüntü, zamanlama saatinden sonraki bir dakika içinde başlar ve izleyen anlık görüntüler zamanlanan saatten sonraki saniyeler içinde başlar.

   

   Kopyalanan dosyaların meta verileri her çalıştırmadan sonra kalıcı olmaz. Bu tasarım gereğidir.

Azure CLI

Veri almak istediğiniz yeri yapılandırmak için bu komutları kullanın.

1. Veri kümesi kimliğini almak için az datashare consumer-source-data-set list komutunu çalıştırın:

   az datashare consumer-source-data-set list --resource-group "share-rg" \
    --account-name "FabrikamDataShareAccount" \
      --share-subscription-name "fabrikamsolutions" \
   

2. Depolama hesabına ihtiyacınız varsa az storage account create komutunu çalıştırarak bu Veri Paylaşımı için bir depolama hesabı oluşturun:

   az storage account create --resource-group "share-rg" --name "FabrikamDataShareStorageAccount" \
   

3. Depolama hesabı kimliğini almak için az storage account show komutunu kullanın:

   az storage account show --resource-group "share-rg" --name "FabrikamDataShareStorageAccount" \
    --query "id"
   

4. Hesap sorumlusu kimliğini almak için aşağıdaki komutu kullanın:

   az datashare account show --resource-group "share-rg" --name "FabrikamDataShareAccount" \
     --query "identity.principalId"
   

5. Hesap sorumlusu kimliğini ve depolama hesabı kimliğinizi kullanarak hesap sorumlusu için rol ataması oluşturmak için az role assignment create komutunu kullanın:

   az role assignment create --role "Contributor" \
     --assignee-object-id aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb 
     --assignee-principal-type ServicePrincipal --scope "your\storage\account\id\path"
   

6. 1. adımdaki veri kümesi kimliğini temel alarak eşleme için bir değişken oluşturun:

   $mapping='{\"data_set_id\":\"' + $dataset_id + '\",\"container_name\":\"newcontainer\",
     \"storage_account_name\":\"datashareconsumersa\",\"kind\":\"BlobFolder\",\"prefix\":\"consumer\"}'
   

7. Veri seti eşlemesini oluşturmak için az datashare data-set-mapping create komutunu kullanın:

   az datashare data-set-mapping create --account-name "FabrikamDataShareAccount" \
    --data-set-mapping-name "datasetmapping" --resource-group "share-rg" \
    --share-subscription-name "fabrikamsolutions" --blob-folder-data-set-mapping $mapping
   

8. Veri kümesi eşitlemesini başlatmak için az datashare share-subscription synchronize komutunu çalıştırın.

   az datashare share-subscription synchronize \
     --resource-group "share-rg" --account-name "FabrikamDataShareAccount"  \
     --name "Fabrikam Solutions" --synchronization-mode "Incremental" \
   

   Eşitlemelerinizin listesini görmek için az datashare share-subscription list-synchronization komutunu çalıştırın:

   az datashare share-subscription list-synchronization \
     --resource-group "share-rg" --account-name "FabrikamDataShareAccount" \
     --share-subscription-name "Fabrikam Solutions" \
   

   Paylaşımınızda ayarlanan eşitleme ayarlarını görmek için az datashare share-subscription list-source-share-synchronization-setting komutunu kullanın.

   az datashare share-subscription list-source-share-synchronization-setting \
     --resource-group "share-rg" --account-name "FabrikamDataShareAccount" \
     --share-subscription-name "Fabrikam Solutions"
   

PowerShell

Veri almak istediğiniz yeri yapılandırmak için bu komutları kullanın.

1. Veri kümesi kimliğini almak için Get-AzDataShareSourceDataSet komutunu çalıştırın:

   Get-AzDataShareSourceDataSet -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions"
   

2. Paylaşılan verileri depolamak istediğiniz bir konumunuz yoksa, depolama hesabı oluşturmak için bu adımları izleyebilirsiniz. Zaten depolama alanınız varsa, sonraki adımlara atlayabilirsiniz.

   1. Bir Azure Depolama hesabı oluşturmak için New-AzStorageAccount komutunu çalıştırın:

      $storageAccount = New-AzStorageAccount -ResourceGroupName "share-rg" -AccountName FabrikamStorageAccount -Location "East US 2" -SkuName Standard_GRS
      
      $ctx = $storageAccount.Context
      

   2. Yeni Azure Depolama hesabınızda verilerinizi barındıracak bir kapsayıcı oluşturmak için New-AzStorageContainer komutunu çalıştırın:

      $containerName = "StorageContainer"
      
      New-AzStorageContainer -Name $containerName -Context $ctx -Permission blob
      

   3. Dosyayı karşıya yüklemek için Set-AzStorageBlobContent komutunu çalıştırın. Aşağıdaki örnek ,textfile.csv yerel bellek üzerindeki D:\testFiles klasöründen oluşturduğunuz kapsayıcıya yükler.

      Set-AzStorageBlobContent -File "D:\testFiles\textfile.csv" -Container $containerName -Blob "textfile.csv" -Context $ctx
      

   PowerShell'de Azure Depolama ile çalışma hakkında daha fazla bilgi için bu Azure Depolama PowerShell kılavuzunu izleyin.

3. Depolama hesabı kimliğini almak için Get-AzStorageAccount komutunu kullanın:

   Get-AzStorageAccount -ResourceGroupName "share-rg" -Name FabrikamStorageAccount
   

4. İlk adımdaki veri kümesi kimliğini kullanın ve ardından New-AzDataShareDataSetMapping komutunu çalıştırarak veri kümesi eşlemesini oluşturun:

   New-AzDataShareDataSetMapping -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions" -Name "Fabrikam Solutions" -StorageAccountResourceId "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"  -DataSetId "0123abcd-ef01-2345-6789-abcdef012345"  -Container "StorageContainer"
   

5. Veri kümesi eşitlemesini başlatmak için Start-AzDataShareSubscriptionSynchronization komutunu çalıştırın.

   Start-AzDataShareSubscriptionSynchronization -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions" -SynchronizationMode "Incremental"
   

   Eşitlemelerinizin listesini görmek için Get-AzDataShareSubscriptionSynchronization komutunu çalıştırın:

   Get-AzDataShareSubscriptionSynchronization -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions"
   

   Paylaşımınızda ayarlanan eşitleme ayarlarını görmek için Get-AzDataShareSubscriptionSynchronizationDetail komutunu kullanın.

   Get-AzDataShareSubscriptionSynchronizationDetail -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions" -SynchronizationId "a6ee5c8d-0ce0-485e-b2f2-966b187dc6c7"
   

Anlık görüntü tetikleme

Portal

Bu adımlar yalnızca anlık görüntü tabanlı paylaşım için geçerlidir.

1. Ayrıntılar sekmesini ve ardından Anlık görüntüyü tetikle'yi seçerek anlık görüntüyü tetikleyebilirsiniz. Burada verilerinizin tam veya artımlı anlık görüntüsünü tetikleyebilirsiniz. Veri sağlayıcınızdan ilk kez veri alıyorsanız tam kopya'yı seçin.

   

2. Son çalıştırma durumu başarılı olduğunda, alınan verileri görüntülemek için hedef veri deposuna gidin. Veri kümeleri'ni seçin ve Hedef Yol'daki bağlantıyı seçin.

   

Azure CLI

az datashare trigger create komutunu çalıştırarak bir anlık görüntüyü tetikleyin:

az datashare trigger create --account-name "FabrikamDataShareAccount" --resource-group "share-rg" --share-subscription-name "Fabrikam Solutions" --scheduled-trigger recurrence-interval="Day" synchronization-mode="Incremental" synchronization-time="2018-11-14T04:47:52.9614956Z" --name "Trigger1"

PowerShell

Bu adımlar yalnızca anlık görüntü tabanlı paylaşım için geçerlidir.

Anlık görüntü tetikleme için New-AzDataShareTrigger komutunu çalıştırın:

New-AzDataShareTrigger -ResourceGroupName "share-rg" -AccountName "FabrikamDataShareAccount" -Name "Fabrikam Solutions" -RecurrenceInterval "Day" -SynchronizationTime "2018-11-14T04:47:52.9614956Z"

Geçmişi görüntüle

Bu adım yalnızca anlık görüntü tabanlı paylaşım için geçerlidir. Anlık görüntülerinizin geçmişini görüntülemek için Geçmiş sekmesini seçin. Burada son 30 gün için oluşturulan tüm anlık görüntülerin geçmişini bulabilirsiniz.

Kaynakları temizle

Kaynak artık gerekli olmadığında, Veri Paylaşımına Genel Bakış sayfasına gidin ve silmek için Sil'i seçin.

Sonraki Adımlar

Bu öğreticide azure veri paylaşımını kabul edip almayı öğrendiniz. Azure Veri Paylaşımı kavramları hakkında daha fazla bilgi edinmek için Azure Veri Paylaşımı Terminolojisi'ne geçin.

Azure Veri Paylaşımı Kavramları