Bien démarrer avec Azure Data Lake Storage Gen1 à l’aide de PowerShell

Notes

Azure Data Lake Storage Gen1 est maintenant mis hors service. Consultez l’annonce de mise hors service ici. Data Lake Storage Gen1 ressources ne sont plus accessibles. Si vous avez besoin d’une assistance spéciale, veuillez nous contacter.

Découvrez comment utiliser Azure PowerShell pour créer un compte Azure Data Lake Storage Gen1 et effectuer des opérations de base comme créer des dossiers, charger et télécharger des fichiers de données, supprimer votre compte, etc. Pour plus d’informations sur Data Lake Store Gen1, consultez Vue d’ensemble de Data Lake Storage Gen1.

Prérequis

Notes

Nous vous recommandons d’utiliser le module Azure Az PowerShell pour interagir avec Azure. Pour commencer, consultez Installer Azure PowerShell. Pour savoir comment migrer vers le module Az PowerShell, consultez Migrer Azure PowerShell depuis AzureRM vers Az.

Authentification

Pour l’authentification auprès de Data Lake Storage Gen1, cet article utilise une approche plus simple où vous êtes invité à entrer les informations d’identification de votre compte Azure. Le niveau d’accès au compte et au système de fichiers Data Lake Storage Gen1 est alors régi par le niveau d’accès de l’utilisateur connecté. Cependant, il existe d’autres approches pour l’authentification sur Data Lake Storage Gen1, à savoir l’authentification de l’utilisateur final ou l’authentification de service à service. Pour obtenir des instructions et plus d’informations sur l’authentification, consultez l’authentification de l’utilisateur final ou l’authentification de service à service.

Créer un compte Data Lake Storage Gen1

  1. Sur votre Bureau, ouvrez une nouvelle fenêtre Windows PowerShell. Entrez l’extrait de code suivant pour vous connecter à votre compte Azure, définir l’abonnement et inscrire le fournisseur Data Lake Storage Gen1. À l’invite de connexion, vérifiez que vous vous connectez en tant qu’administrateur/propriétaire de l’abonnement :

    # Log in to your Azure account
    Connect-AzAccount
    
    # List all the subscriptions associated to your account
    Get-AzSubscription
    
    # Select a subscription
    Set-AzContext -SubscriptionId <subscription ID>
    
    # Register for Azure Data Lake Storage Gen1
    Register-AzResourceProvider -ProviderNamespace "Microsoft.DataLakeStore"
    
  2. Un compte Data Lake Storage Gen1 est associé à un groupe de ressources Azure. Commencez par créer un groupe de ressources.

    $resourceGroupName = "<your new resource group name>"
    New-AzResourceGroup -Name $resourceGroupName -Location "East US 2"
    

    Créer un groupe de ressources Azure

  3. Créer un compte Data Lake Storage Gen1. Le nom que vous spécifiez doit contenir uniquement des lettres minuscules et des chiffres.

    $dataLakeStorageGen1Name = "<your new Data Lake Storage Gen1 account name>"
    New-AzDataLakeStoreAccount -ResourceGroupName $resourceGroupName -Name $dataLakeStorageGen1Name -Location "East US 2"
    

    Créer un compte Data Lake Storage Gen1

  4. Vérifiez que le compte a bien été créé.

    Test-AzDataLakeStoreAccount -Name $dataLakeStorageGen1Name
    

    Le résultat de la cmdlet doit être True.

Créer des structures de répertoire

Vous pouvez créer des répertoires sous votre compte Data Lake Storage Gen1 pour gérer et stocker des données.

  1. Spécifiez un répertoire racine.

    $myrootdir = "/"
    
  2. Créez un répertoire appelé mynewdirectory sous la racine spécifiée.

    New-AzDataLakeStoreItem -Folder -AccountName $dataLakeStorageGen1Name -Path $myrootdir/mynewdirectory
    
  3. Vérifiez que le répertoire a bien été créé.

    Get-AzDataLakeStoreChildItem -AccountName $dataLakeStorageGen1Name -Path $myrootdir
    

    Ceci devrait afficher un résultat, comme illustré sur la capture d’écran suivante :

    Vérifier le répertoire

Charger des données

Vous pouvez charger des données sur Data Lake Storage Gen1 directement à la racine ou dans un répertoire que vous avez créé dans le compte. Les extraits de code de cette section montrent comment télécharger des exemples de données dans le répertoire (mynewdirectory) que vous avez créé dans la section précédente.

Si vous recherchez des exemples de données à charger, vous pouvez récupérer le dossier Données Ambulance dans le Référentiel Git Azure Data Lake. Téléchargez le fichier et stockez-le dans un répertoire local sur votre ordinateur, comme C:\sampledata.

Import-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
   -Path "C:\sampledata\vehicle1_09142014.csv" `
   -Destination $myrootdir\mynewdirectory\vehicle1_09142014.csv

Renommer, télécharger et supprimer des données

Utilisez la commande suivante pour renommer un fichier :

Move-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
    -Path $myrootdir\mynewdirectory\vehicle1_09142014.csv `
    -Destination $myrootdir\mynewdirectory\vehicle1_09142014_Copy.csv

Utilisez la commande suivante pour télécharger un fichier :

Export-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
    -Path $myrootdir\mynewdirectory\vehicle1_09142014_Copy.csv `
    -Destination "C:\sampledata\vehicle1_09142014_Copy.csv"

Utilisez la commande suivante pour supprimer un fichier :

Remove-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
    -Paths $myrootdir\mynewdirectory\vehicle1_09142014_Copy.csv

Quand vous y êtes invité, entrez Y pour supprimer l’élément. Si vous avez plusieurs fichiers à supprimer, vous pouvez fournir tous les chemins d'accès séparés par des virgules.

Remove-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
    -Paths $myrootdir\mynewdirectory\vehicle1_09142014.csv, $myrootdir\mynewdirectoryvehicle1_09142014_Copy.csv

Supprimer votre compte

Utilisez la commande suivante pour supprimer votre compte Data Lake Storage Gen1.

Remove-AzDataLakeStoreAccount -Name $dataLakeStorageGen1Name

Quand vous y êtes invité, entrez Y pour supprimer le compte.

Étapes suivantes