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

Bu öğreticide, Azure Veri Paylaşımı kullanarak 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 öğreneceksiniz.

• 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 davetyourdataprovider@domain.com.
• Microsoft.DataShare kaynak sağlayıcısını, 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 hesabınız yoksa bir Azure Depolama hesabı oluşturabilirsiniz.
• Microsoft.Depolama'da bulunan depolama hesabına yazma izni/storageAccounts/write. Bu izin Depolama Hesap Katkıda Bulunanı rolünde var.
• Microsoft.Authorization/role assignments/write içinde bulunan depolama hesabına rol ataması ekleme izni. Bu izin Sahip rolünde vardır.

SQL tabanlı bir hedefe veri alma

Azure Synapse Analytics Azure SQL Veritabanı veri almayı seçerseniz önkoşulların listesi aşağıdadır.

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

• bir 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 vardır.
• SQL server'ın Microsoft Entra Yönetici
• 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. Kaydet'i seçin.

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

• Azure Synapse Analytics (çalışma alanı) ayrılmış 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 vardır.

• 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 SQL Active Directory yöneticisi'ni 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 '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. Kaydet'i 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ünde vardır.

Azure portalda oturum açma

Azure Portal’ında oturum açın.

Daveti aç

Portal

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

   Daveti e-postadan açmak için gelen kutunuzda veri sağlayıcınızdan gelen daveti denetleyin. Davet Microsoft Azure'dan, azure Veri Paylaşımı daveti başlıklı.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ı Davetler'i arayın. Bu eylem sizi Veri Paylaşımı davet listesine götürür.

   Kiracının konuk kullanıcısıysanız, Veri Paylaşımı daveti ilk kez görüntülemeden önce kiracının 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'de Bash için hızlı başlangıç.

  

• CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin . Windows veya macOS üzerinde çalışıyorsanız Azure CLI’yi bir Docker kapsayıcısında çalıştırmayı değerlendirin. Daha fazla bilgi için bkz . Docker kapsayıcısında Azure CLI'yi çalıştırma.

  • Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Diğer oturum açma seçenekleri için bkz . Azure CLI ile oturum açma.

  • İ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.

  • Yüklü sürümü ve bağımlı kitaplıkları 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 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.
  • Bağlan-AzAccount cmdlet'ini kullanarak Azure hesabınıza Bağlan.
• 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 Bağlan-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ı dağıttığınız Abonelik ve Kaynak Grubu'na tıklayın.

   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ı 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 aldığınız paylaşımı 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 Veri Paylaşımı hesabınızda alınan paylaşıma götürür.

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

Azure CLI

Veri Paylaşımı 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ı oluşturmak için New-AzDataShareSubscription komutunu kullanın. InvitationId, önceki adımda topladığınız kimliktir.

New-AzDataShareSubscription -ResourceGroupName <String> -AccountName <String> -Name <String> -InvitationId <String>

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 deposu seçmek için + Hedefle'yi seçin.

   

2. Verilerin inmesini istediğiniz hedef veri deposu türünü seçin. Hedef veri deposundaki aynı yol ve ada sahip tüm veri dosyalarının veya tabloların üzerine yazılır. Azure SQL Veritabanı veya Azure Synapse Analytics'e (eski adıYla Azure SQL DW) veri alıyorsanız Veri Paylaşımı 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 de anlık görüntü zamanlamasını etkinleştirebilirsiniz. Anlık görüntü zamanlamasının yanındaki kutuyu işaretleyin ve + Etkinleştir'i seçin. zamanlanan ilk anlık görüntü, zamanlama zamanından 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 6789abcd-ef01-2345-6789-abcdef012345 
     --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 kümesi 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 <String> -AccountName <String> -ShareSubscriptionName <String>
   

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-Az Depolama Account komutunu çalıştırın:

      $storageAccount = New-AzStorageAccount -ResourceGroupName <String> -AccountName <String> -Location <String> -SkuName <String>
      
      $ctx = $storageAccount.Context
      

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

      $containerName = <String>
      
      New-AzStorageContainer -Name $containerName -Context $ctx -Permission blob
      

   3. Dosyayı karşıya yüklemek için Set-Az Depolama BlobContent 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-Az Depolama Account komutunu kullanın:

   Get-AzStorageAccount -ResourceGroupName <String> -Name <String>
   

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 <String> -AccountName <String> -ShareSubscriptionName <String> -Name <String> -StorageAccountResourceId <String> -DataSetId <String> -Container <String>
   

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

   Start-AzDataShareSubscriptionSynchronization -ResourceGroupName <String> -AccountName <String> -ShareSubscriptionName <String> -SynchronizationMode <String>
   

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

   Get-AzDataShareSubscriptionSynchronization -ResourceGroupName <String> -AccountName <String> -ShareSubscriptionName <String>
   

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

   Get-AzDataShareSubscriptionSynchronizationDetail -ResourceGroupName <String> -AccountName <String> -ShareSubscriptionName <String> -SynchronizationId <String>
   

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

Anlık görüntü tetikleme için az datashare trigger create komutunu çalıştırın:

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 <String> -AccountName <String> -Name <String> -RecurrenceInterval <String> -SynchronizationTime <DateTime>

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ı temizleme

Kaynağa artık gerek kalmadığında, Veri Paylaşımı Genel Bakış sayfasına gidin ve silmek için Sil'i seçin.

Sonraki adımlar

Bu öğreticide azure Veri Paylaşımı 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ı