Oktatóanyag: Adatok elfogadása és fogadása az Azure Data Share használatával

Ebben az oktatóanyagban megtudhatja, hogyan fogadhat el adatmegosztási meghívást az Azure Data Share használatával. Megtudhatja, hogyan fogadhatja az Önnel megosztott adatokat, és hogyan engedélyezheti a rendszeres frissítési időközt annak biztosítása érdekében, hogy mindig a legfrissebb pillanatképe legyen az Önnel megosztott adatokról.

• Azure Data Share-meghívás elfogadása
• Azure Data Share-fiók létrehozása
• Adja meg az adatok célhelyét
• Előfizetés létrehozása az adatmegosztáshoz ütemezett frissítéshez

Előfeltételek

Mielőtt elfogadná az adatmegosztási meghívást, létre kell hoznia néhány Azure-erőforrást, amelyek az alábbiakban láthatók.

Az adatmegosztási meghívás elfogadása előtt győződjön meg arról, hogy az összes előfeltétel teljesül.

• Azure-előfizetés: Ha nem rendelkezik Azure-előfizetéssel, a kezdés előtt hozzon létre egy ingyenes fiókot .
• Adatmegosztási meghívó: A Microsoft Azure meghívása az "Azure Data Share-meghívás innen yourdataprovider@domain.com" című témakörrel.
• Regisztrálja a Microsoft.DataShare erőforrás-szolgáltatót az Azure-előfizetésben, ahol létre fog hozni egy adatmegosztási erőforrást, valamint azt az Azure-előfizetést, amelyben a cél Azure-adattárak találhatók.

Adatok fogadása tárfiókba

• Azure Storage-fiók: Ha még nem rendelkezik ilyen fiókkal, létrehozhat egy Azure Storage-fiókot.
• A Microsoft.Storage/storageAccounts/write fájlban található tárfiókba való írásra vonatkozó engedély. Ez az engedély a tárfiók közreműködői szerepkörében létezik.
• Engedély szerepkör-hozzárendelés hozzáadásához a Microsoft.Authorization/role assignments/write fájlban található tárfiókhoz. Ez az engedély a Tulajdonos szerepkör részét képezi.

Adatok fogadása SQL-alapú célba

Ha úgy dönt, hogy adatokat fogad az Azure SQL Database-be, az Azure Synapse Analyticsbe, az alábbiakban megtalálja az előfeltételek listáját.

Az Azure SQL Database-be vagy az Azure Synapse Analyticsbe (korábban Azure SQL DW-be) történő adatfogadás előfeltételei

• Azure SQL Database vagy Azure Synapse Analytics (korábbi nevén Azure SQL DW).
• A Microsoft.Sql/servers/databases/write fájlban található SQL Serveren található adatbázisokba való írásra vonatkozó engedély. Ez az engedély a Közreműködő szerepkör részét képezi.
• Az SQL Server Microsoft Entra Rendszergazda
• SQL Server tűzfalhozzáférés. Ez a következő lépésekkel végezhető el:
  1. Az Azure Portal SQL-kiszolgálóján keresse meg a tűzfalakat és a virtuális hálózatokat
  2. Válassza az Igen lehetőséget, ha engedélyezi az Azure-szolgáltatások és -erőforrások számára a kiszolgáló elérését.
  3. Válassza az +Ügyfél IP-címének hozzáadása lehetőséget. Az ügyfél IP-címe változhat. Előfordulhat, hogy ezt a folyamatot meg kell ismételni, amikor legközelebb sql-adatokat oszt meg az Azure Portalról. IP-tartományt is hozzáadhat.
  4. Válassza a Mentés lehetőséget.

Az Azure Synapse Analytics (munkaterület) SQL-készletébe való adatfogadás előfeltételei

• Dedikált Azure Synapse Analytics -készlet (munkaterület). Az adatok kiszolgáló nélküli SQL-készletbe való fogadása jelenleg nem támogatott.

• Engedély az SQL-készletbe való íráshoz a Synapse-munkaterületen, amely a Microsoft.Synapse/workspaces/sqlPools/write fájlban található. Ez az engedély a Közreműködő szerepkör részét képezi.

• Az adatmegosztási erőforrás felügyelt identitásának engedélye a Synapse-munkaterület SQL-készletének elérésére. Ez a következő lépésekkel végezhető el:

  1. Az Azure Portalon lépjen a Synapse-munkaterületre. Válassza ki az SQL Active Directory-rendszergazdát a bal oldali navigációs sávon, és állítsa be magát Microsoft Entra-rendszergazdaként.

  2. Nyissa meg a Synapse Studiót, és válassza a Kezelés lehetőséget a bal oldali navigációs sávon. Válassza a Hozzáférés-vezérlés lehetőséget a Biztonság területen. Rendelje hozzá magát SQL-rendszergazdai vagy munkaterület-rendszergazdai szerepkörhöz.

  3. A Synapse Studióban válassza a Fejlesztés lehetőséget a bal oldali navigációs sávon. Hajtsa végre a következő szkriptet az SQL-készletben az adatmegosztási erőforrás felügyelt identitásának "db_datareader, db_datawriter, db_ddladmin" néven való hozzáadásához.

     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>";
     

     A <share_acc_name> az adatmegosztási erőforrás neve. Ha még nem hozott létre adatmegosztási erőforrást, később visszatérhet erre az előfeltételre.

• Synapse-munkaterület tűzfalhozzáférése. Ez a következő lépésekkel végezhető el:

  1. Az Azure Portalon lépjen a Synapse-munkaterületre. Válassza a Tűzfalak lehetőséget a bal oldali navigációs sávon.
  2. Válassza a BE lehetőséget, ha engedélyezni szeretné, hogy az Azure-szolgáltatások és -erőforrások hozzáférjenek ehhez a munkaterülethez.
  3. Válassza az +Ügyfél IP-címének hozzáadása lehetőséget. Az ügyfél IP-címe változhat. Előfordulhat, hogy ezt a folyamatot meg kell ismételni, amikor legközelebb sql-adatokat oszt meg az Azure Portalról. IP-tartományt is hozzáadhat.
  4. Válassza a Mentés lehetőséget.

Adatok fogadása egy Azure Data Explorer-fürtbe:

• Egy Azure Data Explorer-fürt ugyanabban az Azure-adatközpontban, mint az adatszolgáltató Data Explorer-fürtje: Ha még nincs ilyenje, létrehozhat egy Azure Data Explorer-fürtöt. Ha nem ismeri az adatszolgáltató fürtjének Azure-adatközpontját, a folyamat későbbi szakaszában létrehozhatja a fürtöt.
• A Microsoft.Kusto/clusters/write fájlban található Azure Data Explorer-fürtre való írás engedélyezése. Ez az engedély a Közreműködő szerepkör részét képezi.

Jelentkezzen be az Azure Portalra

Jelentkezzen be az Azure Portalra.

Meghívó megnyitása

Portál

1. A meghívót megnyithatja e-mailben vagy közvetlenül az Azure Portalon.

   Ha e-mailben szeretne meghívót megnyitni, ellenőrizze a Beérkezett üzenetek mappában az adatszolgáltatótól kapott meghívót. A meghívó a Microsoft Azure-ból származik, amely az Azure Data Share meghívása innen származik yourdataprovider@domain.com. Válassza a Meghívás megtekintése lehetőséget, ha meg szeretné tekinteni a meghívást az Azure-ban.

   Ha közvetlenül az Azure Portalról szeretne meghívót megnyitni, keressen adatmegosztási meghívókat az Azure Portalon. Ez a művelet az adatmegosztási meghívások listájára viszi.

   Ha Ön egy bérlő vendégfelhasználója, a rendszer kérni fogja, hogy ellenőrizze a bérlő e-mail-címét az adatmegosztási meghívás első megtekintése előtt. Az ellenőrzés után 12 hónapig érvényes.

   

2. Válassza ki a megtekinteni kívánt meghívót.

Azure CLI

Készítse elő az Azure CLI-környezetet, majd tekintse meg a meghívókat.

Először készítse elő a környezetet az Azure CLI-hez:

• Használja a Bash-környezetet az Azure Cloud Shellben. További információ: A Bash rövid útmutatója az Azure Cloud Shellben.

  

• Ha inkább helyi cli-referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszert használ, fontolja meg az Azure CLI Docker-tárolóban való futtatását. További információ: Az Azure CLI futtatása Docker-tárolóban.

  • Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd : Bejelentkezés az Azure CLI-vel.

  • Amikor a rendszer kéri, először telepítse az Azure CLI-bővítményt. További információ a bővítményekről: Bővítmények használata az Azure CLI-vel.

  • Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.

Futtassa az az datashare consumer-invitation list-invitation parancsot az aktuális meghívók megtekintéséhez:

az datashare consumer consumer-invitation list-invitation

Másolja ki a meghívóazonosítót a következő szakaszban való használatra.

PowerShell

Először készítse elő a környezetet a PowerShell-hez. Futtathat helyben PowerShell-parancsokat, vagy használhatja a Bash-környezetet az Azure Cloud Shellben.

• Ha az Azure PowerShell helyi használatát választja:
  • Telepítse az Az PowerShell-modul legújabb verzióját.
  • Csatlakozás az Azure-fiókjába az Csatlakozás-AzAccount parancsmag használatával.
• Ha az Azure Cloud Shell használata mellett dönt:
  • További információkért tekintse meg az Azure Cloud Shell áttekintését.

1. Az Csatlakozás-AzAccount paranccsal csatlakozzon az Azure-fiókjához.

   Connect-AzAccount
   

2. Futtassa a Set-AzContext parancsot a megfelelő előfizetés beállításához, ha több előfizetéssel rendelkezik.

   Set-AzContext [SubscriptionID/SubscriptionName]
   

3. Futtassa a Get-AzDataShareReceivedInvitation parancsot az aktuális meghívók megtekintéséhez:

   Get-AzDataShareReceivedInvitation
   

Másolja ki a meghívóazonosítót a következő szakaszban való használatra.

Meghívás elfogadása

Portál

1. Győződjön meg arról, hogy az összes mező áttekintve van, beleértve a használati feltételeket is. Ha elfogadja a használati feltételeket, a jelölőnégyzet bejelölésével jelezheti, hogy egyetért.

   

2. A Céladat-megosztási fiók csoportban válassza ki azt az előfizetést és erőforráscsoportot, amelybe az adatmegosztást üzembe helyezi.

   Az Adatmegosztási fiók mezőnél válassza az Új létrehozása lehetőséget, ha nincs meglévő adatmegosztási fiókja. Ellenkező esetben válasszon ki egy meglévő adatmegosztási fiókot, amelybe el szeretné fogadni az adatmegosztást.

   A Fogadott megosztás neve mezőnél meghagyhatja az adatok által megadott alapértelmezett értéket, vagy megadhat egy új nevet a fogadott megosztásnak.

   Miután elfogadta a használati feltételeket, és megadott egy adatmegosztási fiókot a fogadott megosztás kezeléséhez, válassza az Elfogadás és konfigurálás lehetőséget. Létrejön egy megosztási előfizetés.

   

   Ez a művelet az adatmegosztási fiókban kapott megosztásra viszi.

   Ha nem szeretné elfogadni a meghívást, válassza az Elutasítás lehetőséget.

Azure CLI

Az adatmegosztás létrehozásához használja az az datashare share-subscription create parancsot.

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

Az adatmegosztás létrehozásához használja a New-AzDataShareSubscription parancsot. A InvitationId lesz az előző lépésből összegyűjtött azonosító.

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

Fogadott megosztás konfigurálása

Portál

Az alábbi lépéseket követve konfigurálhatja, hogy hol szeretné fogadni az adatokat.

1. Válassza az Adathalmazok lapot. Jelölje be a célként hozzárendelni kívánt adathalmaz melletti jelölőnégyzetet. Válassza a + Céltérkép lehetőséget a céladattár kiválasztásához.

   

2. Válasszon ki egy céladattár-típust, amelybe az adatok be szeretnének szállni. A céladattárban az azonos elérési úttal és névvel rendelkező adatfájlok vagy táblák felülíródnak. Ha adatokat fogad az Azure SQL Database-be vagy az Azure Synapse Analyticsbe (korábbi nevén Azure SQL DW), jelölje be az "Adatmegosztás engedélyezése a fenti felhasználó létrehozása" szkript futtatásához a nevemben jelölőnégyzetet.

   A helyszíni megosztáshoz válasszon egy adattárat a megadott helyen. A Hely az azure-adatközpont, ahol az adatszolgáltató forrásadattára található. Az adathalmaz megfeleltetése után a célútvonalon található hivatkozást követve érheti el az adatokat.

   

3. Pillanatképalapú megosztás esetén, ha az adatszolgáltató létrehozott egy pillanatkép-ütemezést az adatok rendszeres frissítéséhez, a Pillanatkép ütemezése lap kiválasztásával engedélyezheti a pillanatkép-ütemezést is. Jelölje be a pillanatkép-ütemezés melletti jelölőnégyzetet, és válassza az + Engedélyezés lehetőséget. Az első ütemezett pillanatkép az ütemezési időtől számított egy percen belül indul el, a későbbi pillanatképek pedig az ütemezett időponttól számított másodperceken belül indulnak el.

   

   A másolt fájlok metaadatai nem maradnak meg minden futtatás után. Ez az elvárt működés.

Azure CLI

Ezekkel a parancsokkal konfigurálhatja, hogy hol szeretné fogadni az adatokat.

1. Futtassa az az datashare consumer-source-data-set list parancsot az adatkészlet azonosítójának lekéréséhez:

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

2. Ha tárfiókra van szüksége, futtassa az az storage account create parancsot az adatmegosztáshoz tartozó tárfiók létrehozásához:

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

3. A tárfiók azonosítójának lekéréséhez használja az az storage account show parancsot:

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

4. A fióknév azonosítójának lekéréséhez használja a következő parancsot:

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

5. Az az role assignment create paranccsal hozzon létre egy szerepkör-hozzárendelést a fióknévhez a fióknév azonosítójával és a tárfiók azonosítójával:

   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. Hozzon létre egy változót a leképezéshez az 1. lépés adatkészlet-azonosítója alapján:

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

7. Az adatkészlet-leképezés létrehozásához használja az az datashare data-set-mapping create parancsot:

   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. Futtassa az az datashare share-subscription szinkronizálási parancsot az adathalmaz-szinkronizálás elindításához.

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

   Futtassa az az datashare share-subscription list-synchronization parancsot a szinkronizálások listájának megtekintéséhez:

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

   Az az datashare share-subscription list-source-share-synchronization-setting paranccsal megtekintheti a megosztáson beállított szinkronizálási beállításokat.

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

PowerShell

Ezekkel a parancsokkal konfigurálhatja, hogy hol szeretné fogadni az adatokat.

1. Futtassa a Get-AzDataShareSourceDataSet parancsot az adatkészlet azonosítójának lekéréséhez:

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

2. Ha még nincs olyan helye, ahol tárolni szeretné a megosztott adatokat, az alábbi lépéseket követve létrehozhat egy tárfiókot. Ha már rendelkezik tárhellyel, ugorjon a következő lépésekre.

   1. Futtassa a New-AzStorageAccount parancsot egy Azure Storage-fiók létrehozásához:

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

   2. Futtassa a New-AzStorageContainer parancsot az adatok tárolására szolgáló tároló létrehozásához az új Azure Storage-fiókban:

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

   3. Futtassa a Set-AzStorageBlobContent parancsot egy fájl feltöltéséhez. Az alábbi példa textfile.csv tölt fel a helyi memória D:\testFiles mappájából a létrehozott tárolóba.

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

   Az Azure Storage PowerShellben való használatával kapcsolatos további információkért kövesse az Azure Storage PowerShell-útmutatót.

3. A Tárfiók azonosítójának lekéréséhez használja a Get-AzStorageAccount parancsot:

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

4. Használja az első lépés adatkészlet-azonosítóját, majd futtassa a New-AzDataShareDataSetMapping parancsot az adathalmaz-megfeleltetés létrehozásához:

   New-AzDataShareDataSetMapping -ResourceGroupName <String> -AccountName <String> -ShareSubscriptionName <String> -Name <String> -StorageAccountResourceId <String> -DataSetId <String> -Container <String>
   

5. Futtassa a Start-AzDataShareSubscriptionSynchronization parancsot az adathalmaz-szinkronizálás elindításához.

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

   Futtassa a Get-AzDataShareSubscriptionSynchronization parancsot a szinkronizálások listájának megtekintéséhez:

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

   A Get-AzDataShareSubscriptionSynchronizationDetail paranccsal megtekintheti a megosztáson beállított szinkronizálási beállításokat.

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

Pillanatkép aktiválása

Portál

Ezek a lépések csak a pillanatkép-alapú megosztásra vonatkoznak.

1. A pillanatképek aktiválásához válassza a Részletek fület, majd az Eseményindító pillanatképet. Itt aktiválhatja az adatok teljes vagy növekményes pillanatképét. Ha első alkalommal kap adatokat az adatszolgáltatótól, válassza a teljes másolatot.

   

2. Ha az utolsó futtatási állapot sikeres, lépjen a céladattárba a fogadott adatok megtekintéséhez. Válassza ki az Adathalmazok lehetőséget, és válassza ki a hivatkozást a célútvonalon.

   

Azure CLI

A pillanatkép aktiválásához futtassa az az datashare trigger create parancsot:

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

Ezek a lépések csak a pillanatkép-alapú megosztásra vonatkoznak.

Pillanatkép aktiválásához futtassa a New-AzDataShareTrigger parancsot:

New-AzDataShareTrigger -ResourceGroupName <String> -AccountName <String> -Name <String> -RecurrenceInterval <String> -SynchronizationTime <DateTime>

Előzmények megtekintése

Ez a lépés csak a pillanatképalapú megosztásra vonatkozik. A pillanatképek előzményeinek megtekintéséhez válassza az Előzmények lapot. Itt megtalálja az elmúlt 30 napban létrehozott összes pillanatkép előzményeit.

Az erőforrások eltávolítása

Ha az erőforrásra már nincs szükség, lépjen az Adatmegosztás áttekintése lapra, és a Törlés gombra kattintva távolítsa el.

Következő lépések

Ebben az oktatóanyagban megtanulta, hogyan fogadhatja el és fogadhatja el az Azure Data Share-et. Az Azure Data Share fogalmaival kapcsolatos további információkért folytassa az Azure Data Share terminológiával.

Az Azure Data Share fogalmai