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örben létezik.

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örben létezik.
• Az SQL Server Microsoft Entra-rendszergazdája
• 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 az Mentésgombot.

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

• Dedikált SQL-készlet az Azure Synapse Analytics (munkaterület) számára. 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örben létezik.

• 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 a Microsoft Entra 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 az Mentésgombot.

Adatok fogadása az 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éhez tartozó Azure-adatközpontot, 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örben létezik.

Bejelentkezés az Azure Portalra

Jelentkezzen be a Azure portalra.

Nyílt meghívás

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-tól, amelynek címe: Azure Data Share meghívója 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 arra kéri, hogy az adatmegosztási meghívás első megtekintése előtt ellenőrizze a bérlő e-mail-címét. 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ó: Az Azure Cloud Shell használatának első lépései.

  

• Ha a CLI referencia parancsokat helyben szeretnéd futtatni, telepítsd az Azure CLI-t. Ha Windows vagy macOS rendszeren fut, fontolja meg az Azure CLI-t egy Docker-konténerben futtatni. További információkért lásd: Az Azure CLI használata Docker-konténerben.

  • Ha egy helyileg telepített verziót használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. Az azonosítási folyamat befejezéséhez kövesse a terminálján megjelenő lépéseket. További bejelentkezési lehetőségekért lásd: Hitelesítés az Azure-ba az Azure CLI használatával.

  • Amikor megjelenik a felszólítás, az első használatkor 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 és kezelése az Azure CLI-vel.

  • Futtasd a az version parancsot, hogy megtudd a telepített verziót és függő könyvtárakat. A legújabb verzióra való frissítéshez futtassa a az upgrade parancsot.

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

az datashare 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.
  • Csatlakozzon az Azure-fiókjához a Connect-AzAccount parancsmag használatával.
• Ha az Azure Cloud Shell használata mellett dönt:
  • További információkért tekintse meg a Azure Cloud Shell áttekintését.

1. A Connect-AzAccount paranccsal csatlakozhat 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 a Data Share-fiókjában található 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 az előző lépésből összegyűjtött azonosító.

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

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 annak az adathalmaznak a melletti jelölőnégyzetet, amelyhez célhelyet szeretne rendelni. 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 adatforrás tárhelye található. Az adathalmaz megfeleltetése után a célútvonalon található hivatkozást követve érheti el az adatokat.

   

3. A pillanatképalapú megosztáshoz, 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 is engedélyezheti a pillanatkép-ütemezést. 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 kezdődnek.

   

   A másolt fájlok metaadatai nem maradnak meg minden futtatás után. Ez szándékosan van így.

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ók alap-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ókfőhöz, a számla fő azonosítójával és a tárfiók azonosítójával.

   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. 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 az datashare data-set-mapping create parancsot használja az adatkészlet-leképezés létrehozására.

   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 "share-rg" -AccountName "FabrikamDataShareAccount" -ShareSubscriptionName "fabrikamsolutions"
   

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 "share-rg" -AccountName FabrikamStorageAccount -Location "East US 2" -SkuName Standard_GRS
      
      $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 = "StorageContainer"
      
      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 "share-rg" -Name FabrikamStorageAccount
   

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

   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. Futtassa a Start-AzDataShareSubscriptionSynchronization parancsot az adathalmaz-szinkronizálás elindításához.

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

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

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

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

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

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 "share-rg" -AccountName "FabrikamDataShareAccount" -Name "Fabrikam Solutions" -RecurrenceInterval "Day" -SynchronizationTime "2018-11-14T04:47:52.9614956Z"

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 az elmúlt 30 napban létrehozott összes pillanatkép előzményeit találja.

Erőforrások tisztí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 fogadhat el és kaphat Azure Data Share adatmegosztást. 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