Esercitazione: Condividere dati con Azure Condivisione dati

In questa esercitazione si apprenderà come configurare una nuova Condivisione dati di Azure e iniziare a condividere i dati con clienti e partner esterni all'organizzazione di Azure.

Questa esercitazione illustra come:

• Creare una condivisione dati.
• Aggiungere set di dati alla condivisione dati.
• Abilitare una pianificazione degli snapshot per la condivisione dati.
• Aggiungere i destinatari alla condivisione dati.

Prerequisiti

• Sottoscrizione di Azure: se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.
• L'indirizzo di posta elettronica di Azure del destinatario (usando l'alias di posta elettronica non funzionerà).
• Se l'archivio dati di Azure di origine si trova in una sottoscrizione di Azure diversa da quella che si userà per creare Condivisione dati risorsa, registrare il provider di risorse Microsoft.DataShare nella sottoscrizione in cui si trova l'archivio dati di Azure.

Condividere da un account di archiviazione

• Un account Archiviazione di Azure: se non ne è già disponibile uno, è possibile creare un account Archiviazione di Azure
• Autorizzazione per la scrittura nell'account di archiviazione, disponibile in Microsoft.Storage/storageAccounts/write. Questa autorizzazione esiste nel ruolo Collaboratore account Archiviazione.
• Autorizzazione per aggiungere l'assegnazione di ruolo all'account di archiviazione, disponibile in Microsoft.Authorization/role assignments/write. Questa autorizzazione è presente nel ruolo Proprietario.

Condividere da un'origine basata su SQL

Di seguito è riportato l'elenco di prerequisiti per la condivisione da un'origine SQL.

Prerequisiti per la condivisione da Database SQL di Azure o Azure Synapse Analytics (in precedenza Azure SQL Data Warehouse)

• Un'istanza di Database SQL di Azure o di Azure Synapse Analytics (in precedenza Azure SQL Data Warehouse) con tabelle e viste da condividere.
• Autorizzazione per la scrittura nei database del server SQL, disponibile in Microsoft.Sql/servers/databases/write. Questa autorizzazione è presente nel ruolo di collaboratore.
• Microsoft Entra Amministrazione del server SQL
• Accesso al firewall di SQL Server. Questa operazione può essere eseguita tramite la procedura seguente:
  1. Nel portale di Azure passare al server SQL. Selezionare Firewall e reti virtuali nel riquadro di spostamento sinistro.
  2. Selezionare Sì per Consenti ai servizi e alle risorse di Azure di accedere a questo server.
  3. Selezionare +Aggiungi IP client. L'indirizzo IP client è soggetto a modifiche. Questo processo potrebbe essere necessario ripetere la prossima volta che si condividono i dati SQL da portale di Azure. È anche possibile aggiungere un intervallo di indirizzi IP.
  4. Seleziona Salva.

Prerequisiti per la condivisione dal pool SQL di Azure Synapse Analytics (area di lavoro)

• • Un pool SQL dedicato di Azure Synapse Analytics (area di lavoro) con le tabelle da condividere. La condivisione della visualizzazione non è attualmente supportata. La condivisione dal pool SQL serverless non è attualmente supportata.

• Autorizzazione per scrivere nel pool SQL nell'area di lavoro di Synapse, presente in Microsoft.Synapse/workspaces/sqlPools/write. Questa autorizzazione è presente nel ruolo di collaboratore.

• Autorizzazione per l'identità gestita della risorsa Condivisione dati per l'accesso al pool SQL dell'area di lavoro di Synapse. A tale scopo, seguire questa procedura:

  1. Nel portale di Azure passare all'area di lavoro di Synapse. Selezionare Amministratore di SQL Active Directory nel riquadro di spostamento sinistro e impostare se stessi come amministratore di Microsoft Entra.

  2. Aprire Synapse Studio e selezionare Gestisci nel riquadro di spostamento sinistro. Selezionare Controllo di accesso in Sicurezza. Assegnare a se stessi il ruolo di amministratore SQL o amministratore dell'area di lavoro.

  3. In Synapse Studio selezionare Sviluppo nel riquadro di spostamento sinistro. Eseguire lo script seguente nel pool SQL per aggiungere l'identità gestita della risorsa Condivisione dati come db_datareader.

     create user "<share_acct_name>" from external provider;     
     exec sp_addrolemember db_datareader, "<share_acct_name>"; 
     

     Il <share_acc_name> è il nome della risorsa Condivisione dati. Se non è ancora stata creata una risorsa Condivisione dati, è possibile tornare a questo prerequisito in un secondo momento.

• Accesso al firewall dell'area di lavoro di Synapse. A tale scopo, seguire questa procedura:

  1. Nel portale di Azure passare all'area di lavoro di Synapse. Selezionare Firewall nel riquadro di spostamento sinistro.
  2. Selezionare SÌ per Consenti ai servizi e alle risorse di Azure di accedere a questa area di lavoro.
  3. Selezionare +Aggiungi IP client. L'indirizzo IP client è soggetto a modifiche. Questo processo potrebbe essere necessario ripetere la prossima volta che si condividono i dati SQL da portale di Azure. È anche possibile aggiungere un intervallo di indirizzi IP.
  4. Seleziona Salva.

Condividere da Esplora dati di Azure

• Cluster di Esplora dati di Azure con i database da condividere.
• Autorizzazione per la scrittura nel cluster di Esplora dati di Azure, disponibile in Microsoft.Kusto/clusters/write. Questa autorizzazione è presente nel ruolo di collaboratore.

Accedere al portale di Azure

Accedere al portale di Azure.

Creare un account di condivisione dati

Portale

Creare una risorsa di condivisione dati di Azure in un gruppo di risorse di Azure.

1. Selezionare il pulsante del menu nell'angolo superiore sinistro del portale e quindi selezionare + Crea una risorsa.

2. Cercare Condivisione dati.

3. Selezionare Condivisione dati e quindi Crea.

4. Compilare i dettagli di base della risorsa di condivisione dati di Azure con le informazioni seguenti.

   Impostazione	Valore consigliato	Descrizione campo
   Subscription	Sottoscrizione in uso	Selezionare la sottoscrizione di Azure da usare per l'account di condivisione dati.
   Gruppo di risorse	testresourcegroup	Usare un gruppo di risorse esistente oppure crearne uno nuovo.
   Ufficio	Stati Uniti orientali 2	Selezionare un'area per l'account di condivisione dati.
   Nome	datashareaccount	Specificare un nome per l'account di condivisione dati.

5. Selezionare Rivedi e crea e quindi Crea per creare l'account di condivisione dati. La creazione di un nuovo account di condivisione dati richiede in genere circa 2 minuti.

6. Al termine della distribuzione, seleziona Vai alla risorsa.

Interfaccia della riga di comando di Azure

Creare una risorsa di condivisione dati di Azure in un gruppo di risorse di Azure.

Per iniziare, preparare l'ambiente per l'interfaccia della riga di comando di Azure:

• Usare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido per Bash in Azure Cloud Shell.

  

• Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.

  • Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Accedere tramite l'interfaccia della riga di comando di Azure.

  • Quando richiesto, installare l'estensione dell'interfaccia della riga di comando di Azure al primo utilizzo. Per altre informazioni sulle estensioni, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure.

  • Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.

Usare questi comandi per creare la risorsa:

1. Usare il comando az account set per impostare la sottoscrizione come sottoscrizione predefinita corrente:

   az account set --subscription 00000000-0000-0000-0000-000000000000
   

2. Eseguire il comando az provider register per registrare il provider di risorse:

   az provider register --name "Microsoft.DataShare"
   

3. Eseguire il comando az group create per creare un gruppo di risorse o usarne uno esistente:

   az group create --name testresourcegroup --location "East US 2"
   

4. Eseguire il comando az datashare account create per creare un account di Condivisione dati:

   az datashare account create --resource-group testresourcegroup --name datashareaccount --location "East US 2" 
   

   Eseguire il comando az datashare account list per visualizzare gli account di Condivisione dati:

   az datashare account list --resource-group testresourcegroup
   

PowerShell

Creare una risorsa di condivisione dati di Azure in un gruppo di risorse di Azure.

Per iniziare, preparare l'ambiente per PowerShell. È possibile eseguire comandi di PowerShell in locale o usare l'ambiente Bash in Azure Cloud Shell.

• Se si sceglie di usare Azure PowerShell in locale:
  • Installare la versione più recente del modulo Az PowerShell.
  • Connettersi all'account Azure con il cmdlet Connect-AzAccount.
• Se si sceglie di usare Azure Cloud Shell:
  • Vedere Panoramica di Azure Cloud Shell per altre informazioni.

Usare questi comandi per creare la risorsa:

1. Usare il comando Connessione-AzAccount per connettersi all'account Azure.

   Connect-AzAccount
   

2. Eseguire il comando Set-AzContext per impostare la sottoscrizione corretta, se sono presenti più sottoscrizioni.

   Set-AzContext [SubscriptionID/SubscriptionName]
   

3. Eseguire il comando New-AzResourceGroup per creare un gruppo di risorse o usare un gruppo di risorse esistente:

   New-AzResourceGroup -Name <String> -Location <String>
   

4. Eseguire il comando New-AzDataShare per creare un account Condivisione dati:

    New-AzDataShareAccount -ResourceGroupName <String> -Name <String> -Location <String>
   

   Eseguire il comando Get-AzDataShareAccount per visualizzare gli account Condivisione dati:

   Get-AzDataShareAccount
   

Creare una condivisione

Portale

1. Passare alla pagina di panoramica della condivisione dati.

   

2. Selezionare Start sharing your data (Inizia a condividere i dati).

3. Seleziona Crea.

4. Immettere i dettagli della condivisione. Specificare un nome, un tipo di condivisione, una descrizione del contenuto della condivisione e le condizioni per l'utilizzo (facoltativo).

   

5. Selezionare Continua.

6. Per aggiungere set di dati alla condivisione, selezionare Aggiungi set di dati.

   

7. Selezionare il tipo di set di dati da aggiungere. Verrà visualizzato un elenco diverso di tipi di set di dati a seconda del tipo di condivisione (snapshot o sul posto) selezionato nel passaggio precedente. Se la condivisione da un database SQL di Azure o Da Azure Synapse Analytics (in precedenza Azure SQL Data Warehouse), verrà richiesto il metodo di autenticazione per elencare le tabelle. Selezionare Autenticazione Di Microsoft Entra e selezionare la casella di controllo Consenti Condivisione dati di eseguire lo script "crea utente" precedente per conto dell'utente.

   

8. Passare all'oggetto che si vuole condividere e selezionare "Add Datasets" (Aggiungi set di dati).

   

9. Nella scheda Destinatari immettere l'indirizzo di posta elettronica del consumer di dati selezionando "+ Aggiungi il destinatario".

   

10. Selezionare Continua.

11. Se è stato selezionato tipo di condivisione snapshot, è possibile configurare la pianificazione degli snapshot per fornire aggiornamenti dei dati al consumer di dati.

    

12. Selezionare un'ora di inizio e un intervallo di ricorrenza.

13. Selezionare Continua.

14. Nella scheda Rivedi e crea verificare il contenuto del pacchetto, le impostazioni, i destinatari e le impostazioni di sincronizzazione. Seleziona Crea.

Interfaccia della riga di comando di Azure

1. Eseguire il comando az storage account create per creare un account Archiviazione per questo Condivisione dati:

   az storage account create --resource-group testresourcegroup --name ContosoMarketplaceAccount
   

2. Usare il comando az storage container create per creare un contenitore all'interno dell'account di archiviazione creato nel comando precedente:

   az storage container create --name ContosoMarketplaceContainer --account-name ContosoMarketplaceAccount
   

3. Eseguire il comando az datashare create per creare la condivisione dati:

   az datashare create --resource-group testresourcegroup \
     --name ContosoMarketplaceDataShare --account-name ContosoMarketplaceAccount \
     --description "Data Share" --share-kind "CopyBased" --terms "Confidential"
   

4. Usare il comando az datashare invitation create per creare l'invito per l'indirizzo specificato:

   az datashare invitation create --resource-group testresourcegroup \
     --name DataShareInvite --share-name ContosoMarketplaceDataShare \
     --account-name ContosoMarketplaceAccount --target-email "jacob@fabrikam.com"
   

PowerShell

1. Se non si hanno già dati da condividere, è possibile seguire questa procedura per creare un account di archiviazione. Se si dispone già di spazio di archiviazione, è possibile passare al passaggio 2.

   1. Eseguire il comando New-Az Archiviazione Account per creare un account Archiviazione di Azure:

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

   2. Eseguire il comando New-Az Archiviazione Container per creare un contenitore nel nuovo account Archiviazione di Azure che conterrà i dati:

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

   3. Eseguire il comando Set-Az Archiviazione BlobContent per caricare un file. L'esempio seguente carica textfile.csv dalla cartella D:\testFiles nella memoria locale nel contenitore creato.

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

   Per altre informazioni sull'uso di Archiviazione di Azure in PowerShell, seguire questa Archiviazione di Azure guida di PowerShell.

2. Eseguire il comando New-AzDataShare per creare il Condivisione dati:

   New-AzDataShare -ResourceGroupName <String> -AccountName <String> -Name <String> -Description <String> -TermsOfUse <String>
   

3. Usare il comando New-AzDataShareInvitation per creare l'invito per l'indirizzo specificato:

   New-AzDataShareInvitation -ResourceGroupName <String> -AccountName <String> -ShareName <String> -Name <String> -TargetEmail <String>
   

4. Usare il comando New-AzDataShareSynchronizationSetting per impostare una ricorrenza di sincronizzazione per la condivisione. Può essere giornaliera, oraria o in un determinato momento.

   New-AzDataShareSynchronizationSetting -ResourceGroupName <String> -AccountName <String> -ShareName <String> -Name <String> -RecurrenceInterval <String> -SynchronizationTime <DateTime>
   

La condivisione dati di Azure è stata creata e il suo destinatario è ora pronto ad accettare l'invito.

Pulire le risorse

Quando la risorsa non è più necessaria, passare alla pagina Panoramica di Condivisione dati e selezionare Elimina per rimuoverla.

Passaggi successivi

In questa esercitazione si è appreso come creare un Condivisione dati di Azure e invitare i destinatari. Per informazioni su come un consumer di dati può accettare e ricevere una condivisione dati, continuare con l'esercitazione Accettare e ricevere dati.

Esercitazione: Accettare e ricevere dati con Azure Condivisione dati