使用 Azure PowerShell 開始使用 Azure Data Lake Storage Gen1
注意
Azure Data Lake Storage Gen1 現已淘汰。 請參閱這裡的淘汰公告。Data Lake Storage Gen1 資源無法再存取。
了解如何使用 Azure PowerShell 建立 Azure Data Lake Storage Gen1 帳戶並執行基本作業,例如建立資料夾、上傳和下載資料檔案、刪除您的帳戶等等。如需有關 Data Lake Storage Gen1 的詳細資訊,請參閱 Data Lake Storage Gen1 概觀。
必要條件
注意
建議您使用 Azure Az PowerShell 模組來與 Azure 互動。 請參閱安裝 Azure PowerShell 以開始使用。 若要了解如何移轉至 Az PowerShell 模組,請參閱將 Azure PowerShell 從 AzureRM 移轉至 Az。
- Azure 訂用帳戶。 請參閱取得 Azure 免費試用。
- Azure PowerShell 1.0 或更新版本。 請參閱 如何安裝和設定 Azure PowerShell。
驗證
本文搭配使用較簡單的驗證方法與 Data Lake Storage Gen1,系統會提示您輸入 Azure 帳號認證。 Data Lake Storage Gen1 帳戶和檔案系統的存取層級則由已登入使用者的存取層級所控管。 不過,還有其他方法可向 Data Lake Storage Gen1 進行驗證:使用者驗證或服務對服務驗證。 如需有關如何驗證的指示和詳細資訊,請參閱使用者驗證或服務對服務驗證。
建立 Data Lake Storage Gen1 帳戶
從桌面開啟新的 Windows PowerShell 視窗。 輸入下列程式碼片段登入 Azure 帳戶、設定訂用帳戶,然後註冊 Data Lake Storage Gen1 提供者。 系統提示您登入時,請務必使用其中一個訂用帳戶管理員/擁有者身分登入:
# 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"
Data Lake Storage Gen1 帳戶與 Azure 資源群組建立關聯。 從建立資源群組著手。
$resourceGroupName = "<your new resource group name>" New-AzResourceGroup -Name $resourceGroupName -Location "East US 2"
建立 Data Lake Storage Gen1 帳戶。 您指定的名稱必須只包含小寫字母和數字。
$dataLakeStorageGen1Name = "<your new Data Lake Storage Gen1 account name>" New-AzDataLakeStoreAccount -ResourceGroupName $resourceGroupName -Name $dataLakeStorageGen1Name -Location "East US 2"
確認已成功建立帳戶。
Test-AzDataLakeStoreAccount -Name $dataLakeStorageGen1Name
此 Cmdlet 的輸出應為 True。
建立目錄結構
您可以在您的 Data Lake Storage Gen1 帳戶下建立用於管理與儲存資料的目錄。
指定根目錄。
$myrootdir = "/"
在指定的根目錄下建立名為 mynewdirectory 的新目錄。
New-AzDataLakeStoreItem -Folder -AccountName $dataLakeStorageGen1Name -Path $myrootdir/mynewdirectory
確認已成功建立新目錄。
Get-AzDataLakeStoreChildItem -AccountName $dataLakeStorageGen1Name -Path $myrootdir
輸出應如下列螢幕擷取畫面所示:
上傳資料
您可以在根層級直接將資料上傳至 Data Lake Storage Gen1,或上傳至您在帳戶內建立的目錄。 本節的程式碼範例說明如何將一些範例資料上傳至您在上一節中建立的目錄 (mynewdirectory)。
如果您正在尋找一些可上傳的範例資料,您可以從 Azure Data Lake Git 存放庫 取得 Ambulance Data資料夾。 下載檔案並將它儲存在電腦的本機目錄上,例如 C:\sampledata\。
Import-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
-Path "C:\sampledata\vehicle1_09142014.csv" `
-Destination $myrootdir\mynewdirectory\vehicle1_09142014.csv
重新命名、下載及刪除資料
若要重新命名檔案,請使用下列命令:
Move-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
-Path $myrootdir\mynewdirectory\vehicle1_09142014.csv `
-Destination $myrootdir\mynewdirectory\vehicle1_09142014_Copy.csv
若要下載檔案,請使用下列命令:
Export-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
-Path $myrootdir\mynewdirectory\vehicle1_09142014_Copy.csv `
-Destination "C:\sampledata\vehicle1_09142014_Copy.csv"
若要刪除檔案,請使用下列命令:
Remove-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
-Paths $myrootdir\mynewdirectory\vehicle1_09142014_Copy.csv
出現提示時,請輸入 Y 刪除項目。 如果您要刪除多個檔案,可以提供所有的路徑並以逗號分隔。
Remove-AzDataLakeStoreItem -AccountName $dataLakeStorageGen1Name `
-Paths $myrootdir\mynewdirectory\vehicle1_09142014.csv, $myrootdir\mynewdirectoryvehicle1_09142014_Copy.csv
建立您的帳戶
使用下列命令刪除您的 Data Lake Storage Gen1 帳戶。
Remove-AzDataLakeStoreAccount -Name $dataLakeStorageGen1Name
出現提示時,請輸入 Y 刪除帳戶。