Guida introduttiva: Usare lo strumento Copia dati per copiare i datiQuickstart: Use the Copy Data tool to copy data

In questa guida introduttiva si userà il portale di Azure per creare una data factory.In this quickstart, you use the Azure portal to create a data factory. Viene quindi usato lo strumento Copia dati per creare una pipeline che copia i dati da una cartella dell'archivio BLOB di Azure a un'altra cartella.Then, you use the Copy Data tool to create a pipeline that copies data from a folder in Azure Blob storage to another folder.

Nota

Se non si ha familiarità con Azure Data Factory, vedere Introduzione ad Azure Data Factory prima di seguire la guida introduttiva.

PrerequisitiPrerequisites

Sottoscrizione di AzureAzure subscription

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don't have an Azure subscription, create a free account before you begin.

Ruoli di AzureAzure roles

Per creare istanze di Data Factory, l'account utente usato per accedere ad Azure deve essere un membro del ruolo collaboratore o proprietario oppure un amministratore della sottoscrizione di Azure.To create Data Factory instances, the user account that you use to sign in to Azure must be a member of the contributor or owner role, or an administrator of the Azure subscription. Per visualizzare le autorizzazioni disponibili nella sottoscrizione, nel portale di Azure selezionare il nome utente nell'angolo in alto a destra e quindi selezionare Autorizzazioni.To view the permissions that you have in the subscription, in the Azure portal, select your username in the upper-right corner, and then select Permissions. Se si accede a più sottoscrizioni, selezionare quella appropriata.If you have access to multiple subscriptions, select the appropriate subscription.

Per creare e gestire le risorse figlio per Data Factory, inclusi i set di dati, i servizi collegati, le pipeline, i trigger e i runtime di integrazione, sono applicabili i requisiti seguenti:To create and manage child resources for Data Factory - including datasets, linked services, pipelines, triggers, and integration runtimes - the following requirements are applicable:

  • Per creare e gestire le risorse figlio nel portale di Azure, è necessario appartenere al ruolo Collaboratore Data Factory a livello di gruppo di risorse o superiore.To create and manage child resources in the Azure portal, you must belong to the Data Factory Contributor role at the resource group level or above.
  • Per creare e gestire le risorse figlio con PowerShell o l'SDK, è sufficiente il ruolo di collaboratore a livello di risorsa o superiore.To create and manage child resources with PowerShell or the SDK, the contributor role at the resource level or above is sufficient.

Per istruzioni di esempio su come aggiungere un utente a un ruolo, vedere l'articolo Aggiungere i ruoli.For sample instructions about how to add a user to a role, see the Add roles article.

Per altre informazioni, vedere gli articoli seguenti:For more info, see the following articles:

Account di archiviazione di AzureAzure storage account

In questa guida introduttiva si usa un account di archiviazione di Azure per utilizzo generico (specificamente, di archiviazione BLOB) come archivio dati sia di origine che di destinazione.You use a general-purpose Azure storage account (specifically Blob storage) as both source and destination data stores in this quickstart. Se non si ha un account di archiviazione di Azure per utilizzo generico, vedere Creare un account di archiviazione per informazioni su come crearne uno.If you don't have a general-purpose Azure storage account, see Create a storage account to create one.

Recuperare il nome e la chiave dell'account di archiviazioneGet the storage account name and account key

Per questa guida introduttiva è necessario avere il nome e la chiave dell'account di archiviazione di Azure.You will need the name and key of your Azure storage account for this quickstart. La procedura seguente illustra i passaggi per recuperare il nome e la chiave dell'account di archiviazione:The following procedure provides steps to get the name and key of your storage account:

  1. In un Web browser passare al portale di Azure.In a web browser, go to the Azure portal. Accedere con nome utente e password di Azure.Sign in by using your Azure username and password.

  2. Selezionare Tutti i servizi nel menu a sinistra, filtrare con la parola chiave archiviazione e selezionare Account di archiviazione.Select All services on the left menu, filter with the Storage keyword, and select Storage accounts.

    Cercare un account di archiviazione

  3. Nell'elenco degli account di archiviazione filtrare, se necessario, e quindi selezionare il proprio account di archiviazione.In the list of storage accounts, filter for your storage account (if needed), and then select your storage account.

  4. Nella pagina Account di archiviazione selezionare Chiavi di accesso nel menu.On the Storage account page, select Access keys on the menu.

    Recuperare il nome e la chiave dell'account di archiviazione

  5. Copiare negli Appunti i valori delle caselle Nome account di archiviazione e key1.Copy the values for the Storage account name and key1 boxes to the clipboard. Incollarli in un blocco note o in qualsiasi altro editor e salvarli.Paste them into Notepad or any other editor and save it. Verranno usati più avanti in questa guida introduttiva.You use them later in this quickstart.

Creare la cartella e i file di inputCreate the input folder and files

In questa sezione viene creato un contenitore BLOB denominato adftutorial nell'archivio BLOB di Azure.In this section, you create a blob container named adftutorial in Azure Blob storage. Viene creata una cartella denominata input nel contenitore e viene caricato un file di esempio in tale cartella.You create a folder named input in the container, and then upload a sample file to the input folder.

  1. Nella pagina Account di archiviazione passare a Panoramica e quindi selezionare BLOB.On the Storage account page, switch to Overview, and then select Blobs.

    Selezionare l'opzione BLOB

  2. Nella pagina Servizio BLOB selezionare + Contenitore sulla barra degli strumenti.On the Blob service page, select + Container on the toolbar.

    Pulsante Aggiungi contenitore

  3. Nella finestra di dialogo Nuovo contenitore immettere adftutorial come nome e quindi fare clic su OK.In the New container dialog box, enter adftutorial for the name, and then select OK.

    Immettere il nome del contenitore

  4. Selezionare adftutorial nell'elenco di contenitori.Select adftutorial in the list of containers.

    Selezionare il contenitore

  5. Nella pagina Contenitore selezionare Carica sulla barra degli strumenti.On the Container page, select Upload on the toolbar.

    Pulsante Carica

  6. Nella pagina Carica BLOB selezionare Avanzate.On the Upload blob page, select Advanced.

    Selezionare il collegamento Avanzate

  7. Avviare il Blocco note e creare un file denominato emp.txt con il contenuto seguente.Start Notepad and create a file named emp.txt with the following content. Salvarlo nella cartella c:\ADFv2QuickStartPSH.Save it in the c:\ADFv2QuickStartPSH folder. Se non esiste ancora, creare la cartella ADFv2QuickStartPSH.Create the ADFv2QuickStartPSH folder if it does not already exist.

    John, Doe
    Jane, Doe
    
  8. Nella pagina Carica BLOB del portale di Azure cercare e selezionare il file emp.txt nella casella File.In the Azure portal, on the Upload blob page, browse to and select the emp.txt file for the Files box.

  9. Immettere il valore input nella casella Carica nella cartella.Enter input as a value for the Upload to folder box.

    Caricare le impostazioni BLOB

  10. Verificare che la cartella sia input e il file sia emp.txt e selezionare Carica.Confirm that the folder is input and the file is emp.txt, and select Upload.

    Verranno visualizzati il file emp.txt e lo stato del caricamento nell'elenco.You should see the emp.txt file and the status of the upload in the list.

  11. Chiudere la pagina Carica BLOB facendo clic su X nell'angolo.Close the Upload blob page by clicking X in the corner.

    Chiudere la pagina Carica BLOB

  12. Tenere aperta la pagina ContenitoreKeep the Container page open. perché verrà usata per verificare l'output alla fine di questa guida introduttiva.You use it to verify the output at the end of this quickstart.

Creare una data factoryCreate a data factory

  1. Scegliere Nuovo dal menu a sinistra, selezionare Dati e analisi e quindi selezionare Data Factory.Select New on the left menu, select Data + Analytics, and then select Data Factory.

    Selezione di Data Factory nel riquadro "Nuovo"

  2. Nella pagina Nuova data factory immettere ADFTutorialDataFactory per Nome.On the New data factory page, enter ADFTutorialDataFactory for Name.

    Pagina "Nuova data factory"

    Il nome della data factory di Azure deve essere univoco a livello globale.The name of the Azure data factory must be globally unique. Se viene visualizzato l'errore seguente, modificare il nome della data factory, ad esempio, <nomeutente>ADFTutorialDataFactory, e provare di nuovo a crearla.If you see the following error, change the name of the data factory (for example, <yourname>ADFTutorialDataFactory) and try creating again. Per le regole di denominazione per gli elementi di Data Factory, vedere l'articolo Data Factory - Regole di denominazione.For naming rules for Data Factory artifacts, see the Data Factory - naming rules article.

    Errore quando un nome non è disponibile

  3. Per Sottoscrizione selezionare la sottoscrizione di Azure in cui creare la data factory.For Subscription, select your Azure subscription in which you want to create the data factory.

  4. In Gruppo di risorse eseguire una di queste operazioni:For Resource Group, use one of the following steps:

    • Selezionare Usa esistentee scegliere un gruppo di risorse esistente dall'elenco.Select Use existing, and select an existing resource group from the list.
    • Selezionare Crea nuovoe immettere un nome per il gruppo di risorse.Select Create new, and enter the name of a resource group.

    Per informazioni sui gruppi di risorse, vedere l'articolo relativo all'uso di gruppi di risorse per la gestione delle risorse di Azure.To learn about resource groups, see Using resource groups to manage your Azure resources.

  5. Per Versione selezionare V2.For Version, select V2.

  6. Per Località selezionare la località per la data factory.For Location, select the location for the data factory.

    L'elenco mostra solo le località supportate da Data Factory e in cui verranno archiviati i metadati di Azure Data Factory.The list shows only locations that Data Factory supports, and where your Azure Data Factory meta data will be stored. Si noti che gli archivi dati associati (ad esempio, Archiviazione di Azure e il database SQL di Azure) e le risorse di calcolo (ad esempio, Azure HDInsight) usati da Data Factory possono essere eseguiti in altre aree.Please note that the associated data stores (like Azure Storage and Azure SQL Database) and computes (like Azure HDInsight) that Data Factory uses can run in other regions.

  7. Selezionare Create.Select Create.

  8. Al termine della creazione verrà visualizzata la pagina Data factory.After the creation is complete, you see the Data Factory page. Selezionare il riquadro Crea e monitora per avviare l'applicazione dell'interfaccia utente di Azure Data Factory in una scheda separata.Select the Author & Monitor tile to start the Azure Data Factory user interface (UI) application on a separate tab.

    Home page della data factory, con il riquadro "Crea e monitora"

Avviare lo strumento Copia datiStart the Copy Data tool

  1. Nella pagina Attività iniziali selezionare il riquadro Copia dati per avviare lo strumento Copia dati.On the Let's get started page, select the Copy Data tile to start the Copy Data tool.

    Riquadro "Copia dati"

  2. Nella pagina Proprietà dello strumento Copia dati è possibile specificare un nome per la pipeline e la relativa descrizione, quindi selezionare Avanti.On the Properties page of the Copy Data tool, you can specify a name for the pipeline and its description, then select Next.

    Pagina "Proprietà"

  3. Nella pagina Archivio dati di origine completare la procedura seguente:On the Source data store page, complete the following steps:

    a.a. Fare clic su + Crea nuova connessione per aggiungere una connessione.Click + Create new connection to add a connection.

    Pagina "Source data store" (Archivio dati di origine)

    b.b. Selezionare Archiviazione BLOB di Azure dalla raccolta e quindi selezionare Avanti.Select Azure Blob Storage from the gallery, and then select Next.

    Selezionare l'archiviazione BLOB dalla raccolta

    c.c. Nella pagina Specify the Azure Blob storage account (Specificare l'account di archiviazione BLOB di Azure) selezionare l'account di archiviazione nell'elenco Nome account di archiviazione e quindi selezionare Fine.On the Specify the Azure Blob storage account page, select your storage account from the Storage account name list, and then select Finish.

    Configurare l'account di archiviazione BLOB di Azure

    d.d. Selezionare il servizio collegato appena creato come origine, quindi fare clic su Avanti.Select the newly created linked service as source, then click Next.

    Selezionare il servizio collegato di origine

  4. Nella pagina Choose the input file or folder (Scegliere il file o la cartella di input) completare questa procedura:On the Choose the input file or folder page, complete the following steps:

    a.a. Fare clic su Sfoglia per passare alla cartella adftutorial/input, selezionare il file emp.txt, quindi fare clic su Scegli.Click Browse to navigate to the adftutorial/input folder, select the emp.txt file, then click Choose.

    Pagina "Choose the input file or folder" (Scegliere il file o la cartella di input)

    d.d. Selezionare l'opzione Binary copy (Copia binaria) per copiare il file così com'è, quindi selezionare Avanti.Check the Binary copy option to copy file as-is, then select Next.

    Pagina "Choose the input file or folder" (Scegliere il file o la cartella di input)

  5. Nella pagina Destination data store (Archivio dati di destinazione) selezionare il servizio collegato Archiviazione BLOB di Azure appena creato e quindi selezionare Avanti.On the Destination data store page, select the Azure Blob Storage linked service you just created, and then select Next.

    Pagina "Destination data store" (Archivio dati di destinazione)

  6. Nella pagina Choose the output file or folder (Scegliere il file o la cartella di output) immettere adftutorial/output come percorso della cartella, quindi selezionare Avanti.On the Choose the output file or folder page, enter adftutorial/output for the folder path, then select Next.

    Pagina "Choose the output file or folder" (Scegliere il file o la cartella di output)

  7. Nella pagina Impostazioni selezionare Avanti per usare le configurazioni predefinite.On the Settings page, select Next to use the default configurations.

  8. Nella pagina Riepilogo verificare tutte le impostazioni e selezionare Avanti.On the Summary page, review all settings, and select Next.

    Pagina "Riepilogo"

  9. Nella pagina Distribuzione completata selezionare Monitoraggio per monitorare la pipeline creata.On the Deployment complete page, select Monitor to monitor the pipeline that you created.

    Pagina "Distribuzione completata"

  10. L'applicazione passa alla scheda Monitoraggio. In questa scheda viene visualizzato lo stato della pipeline. Selezionare Aggiorna per aggiornare l'elenco.The application switches to the Monitor tab. You see the status of the pipeline on this tab. Select Refresh to refresh the list.

    Monitorare l'esecuzione della pipeline

  11. Selezionare il collegamento View Activity Runs (Visualizza le esecuzioni di attività) nella colonna Azioni.Select the View Activity Runs link in the Actions column. La pipeline ha solo un'attività di tipo Copia.The pipeline has only one activity of type Copy.

    Monitorare l'esecuzione delle attività

  12. Per visualizzare informazioni dettagliate sull'operazione di copia, selezionare il collegamento Dettagli (immagine degli occhiali) nella colonna Azioni.To view details about the copy operation, select the Details (eyeglasses image) link in the Actions column. Per informazioni dettagliate sulle proprietà, vedere Panoramica dell'attività Copia.For details about the properties, see Copy Activity overview.

    Dettagli dell'operazione di copia

  13. Verificare che il file emp.txt sia stato creato nella cartella output del contenitore adftutorial.Verify that the emp.txt file is created in the output folder of the adftutorial container. Se la cartella output non esiste, il servizio Data Factory la crea automaticamente.If the output folder does not exist, the Data Factory service automatically creates it.

  14. Passare alla scheda Autore sopra la scheda Monitoraggio nel pannello sinistro, per poter modificare i servizi collegati, i set di dati e le pipeline.Switch to the Author tab above the Monitor tab on the left panel so that you can edit linked services, datasets, and pipelines. Per informazioni sulla modifica di questi elementi nell'interfaccia utente di Data Factory, vedere Creare una data factory con il portale di Azure.To learn about editing them in the Data Factory UI, see Create a data factory by using the Azure portal.

Passaggi successiviNext steps

La pipeline in questo esempio copia i dati da una posizione a un'altra nell'archivio BLOB di Azure.The pipeline in this sample copies data from one location to another location in Azure Blob storage. Per informazioni sull'uso di Data Factory in più scenari, vedere le esercitazioni.To learn about using Data Factory in more scenarios, go through the tutorials.