Szybki start: przekazywanie, pobieranie i wyświetlanie listy obiektów blob za pomocą interfejsu wiersza polecenia platformy AzureQuickstart: Upload, download, and list blobs using the Azure CLI

Interfejs wiersza polecenia platformy Azure to środowisko wiersza polecenia platformy Azure do zarządzania jej zasobami.The Azure CLI is Azure's command-line experience for managing Azure resources. Można używać go w przeglądarce za pośrednictwem usługi Azure Cloud Shell.You can use it in your browser with Azure Cloud Shell. Istnieje także możliwość zainstalowania go w systemach macOS, Linux lub Windows, a następnie uruchomienia z poziomu wiersza polecenia.You can also install it on macOS, Linux, or Windows and run it from the command line. Ten przewodnik Szybki start zawiera opis użycia interfejsu wiersza polecenia platformy Azure do przekazywania danych do/pobierania danych z usługi Azure Blob Storage.In this quickstart, you learn to use the Azure CLI to upload and download data to and from Azure Blob storage.

Uwaga

Funkcje opisane w tym artykule są teraz dostępne dla kont, które mają hierarchiczną przestrzeń nazw.The features described in this article are now available to accounts that have a hierarchical namespace. Aby zapoznać się z ograniczeniami, zobacz znane problemy dotyczące Azure Data Lake Storage Gen2 artykułu.To review limitations, see the Known issues with Azure Data Lake Storage Gen2 article.

Wymagania wstępnePrerequisites

Aby uzyskać dostęp do usługi Azure Storage, potrzebujesz subskrypcji platformy Azure.To access Azure Storage, you'll need an Azure subscription. Jeśli nie masz jeszcze subskrypcji, przed rozpoczęciem Utwórz bezpłatne konto .If you don't already have a subscription, create a free account before you begin.

Cały dostęp do usługi Azure Storage odbywa się za pośrednictwem konta magazynu.All access to Azure Storage takes place through a storage account. Na potrzeby tego samouczka Szybki start utwórz konto magazynu przy użyciu witryny Azure Portal, programu Azure PowerShell lub interfejsu wiersza polecenia platformy Azure.For this quickstart, create a storage account using the Azure portal, Azure PowerShell, or Azure CLI. Aby uzyskać pomoc przy tworzeniu konta, zobacz Tworzenie konta magazynu.For help creating the account, see Create a storage account.

Używanie usługi Azure Cloud ShellUse Azure Cloud Shell

Platforma Azure obsługuje Azure Cloud Shell, interaktywne środowisko powłoki, z którego można korzystać w przeglądarce.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Do pracy z usługami platformy Azure można używać bash lub PowerShell z Cloud Shell.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. Możesz użyć wstępnie zainstalowanych poleceń Cloud Shell, aby uruchomić kod w tym artykule bez konieczności instalowania niczego w środowisku lokalnym.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Aby rozpocząć Azure Cloud Shell:To start Azure Cloud Shell:

OpcjaOption Przykład/linkExample/Link
Wybierz pozycję Wypróbuj w prawym górnym rogu bloku kodu.Select Try It in the upper-right corner of a code block. Wybranie przycisku Wypróbuj nie powoduje automatycznego skopiowania kodu do Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Przykład try dla Azure Cloud Shell
Przejdź do https://shell.azure.comlub wybierz przycisk Uruchom Cloud Shell , aby otworzyć Cloud Shell w przeglądarce.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. uruchamiania Cloud Shell w nowym oknieLaunch Cloud Shell in a new window
Wybierz przycisk Cloud Shell w prawym górnym pasku menu w Azure Portal.Select the Cloud Shell button on the top-right menu bar in the Azure portal. Przycisk Cloud Shell w witrynie Azure Portal

Aby uruchomić kod w tym artykule w Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Rozpocznij Cloud Shell.Start Cloud Shell.

  2. Aby skopiować kod, wybierz przycisk Kopiuj w bloku kodu.Select the Copy button on a code block to copy the code.

  3. Wklej kod do sesji Cloud Shell, wybierając kolejno pozycje Ctrl+SHIFT+v w systemach Windows i Linux lub wybierając polecenie cmd+SHIFT+v w macOS.Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

  4. Wybierz klawisz ENTER , aby uruchomić kod.Select Enter to run the code.

Jeśli zdecydujesz się zainstalować interfejs wiersza polecenia i korzystać z niego lokalnie, ten przewodnik szybkiego startu będzie wymagał interfejsu wiersza polecenia platformy Azure w wersji 2.0.4 lub nowszej.If you choose to install and use the CLI locally, this quickstart requires that you are running the Azure CLI version 2.0.4 or later. Uruchom polecenie az --version, aby sprawdzić wersję.Run az --version to determine your version. Jeśli konieczna będzie instalacja lub uaktualnienie interfejsu, zobacz Instalowanie interfejsu wiersza polecenia platformy Azure.If you need to install or upgrade, see Install the Azure CLI.

Tworzenie grupy zasobówCreate a resource group

Grupę zasobów platformy Azure można utworzyć za pomocą polecenia az group create.Create an Azure resource group with the az group create command. Grupa zasobów to logiczny kontener przeznaczony do wdrażania zasobów platformy Azure i zarządzania nimi.A resource group is a logical container into which Azure resources are deployed and managed.

Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach ostrych własnymi wartościami:Remember to replace placeholder values in angle brackets with your own values:

az group create \
    --name <resource-group-name> \
    --location <location>

Tworzenie konta magazynuCreate a storage account

Do utworzenia konta magazynu (ogólnego przeznaczenia) służy polecenie az storage account create.Create a general-purpose storage account with the az storage account create command. Konta magazynu można używać z wszystkimi czterema usługami: obiektami blob, plikami, tabelami i kolejkami.The general-purpose storage account can be used for all four services: blobs, files, tables, and queues.

Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach ostrych własnymi wartościami:Remember to replace placeholder values in angle brackets with your own values:

az storage account create \
    --name <account-name> \
    --resource-group <resource-group-name> \
    --location <location> \
    --sku Standard_ZRS \
    --encryption blob

Podawanie poświadczeń konta magazynuSpecify storage account credentials

Większość poleceń interfejsu wiersza polecenia platformy Azure zawartych w tym samouczku wymaga poświadczeń do konta magazynu.The Azure CLI needs your storage account credentials for most of the commands in this tutorial. Dostępnych jest kilka opcji podania tych poświadczeń, ale najprostszy sposób polega na ustawieniu zmiennych środowiskowych AZURE_STORAGE_ACCOUNT i AZURE_STORAGE_KEY.While there are several options for doing so, one of the easiest ways to provide them is to set AZURE_STORAGE_ACCOUNT and AZURE_STORAGE_KEY environment variables.

Uwaga

W tym artykule pokazano, jak ustawić zmienne środowiskowe za pomocą bash.This article shows how to set environment variables using Bash. Inne środowiska mogą wymagać modyfikacji składni.Other environments may require syntax modifications.

Najpierw Wyświetl klucze konta magazynu przy użyciu polecenia AZ Storage account Keys list .First, display your storage account keys by using the az storage account keys list command. Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach ostrych własnymi wartościami:Remember to replace placeholder values in angle brackets with your own values:

az storage account keys list \
    --account-name <account-name> \
    --resource-group <resource-group-name> \
    --output table

Teraz ustaw zmienne środowiskowe AZURE_STORAGE_ACCOUNT i AZURE_STORAGE_KEY.Now, set the AZURE_STORAGE_ACCOUNT and AZURE_STORAGE_KEY environment variables. Można to zrobić w powłoce bash za pomocą polecenia export.You can do this in the Bash shell by using the export command. Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach ostrych własnymi wartościami:Remember to replace placeholder values in angle brackets with your own values:

export AZURE_STORAGE_ACCOUNT="<account-name>"
export AZURE_STORAGE_KEY="<account-key>"

Aby uzyskać więcej informacji na temat pobierania kluczy dostępu do konta przy użyciu Azure Portal, zobacz klucze dostępu w obszarze Zarządzaj ustawieniami konta magazynu w Azure Portal.For more information on how to retrieve the account access keys using the Azure portal, see Access keys in Manage storage account settings in the Azure portal.

Tworzenie konteneraCreate a container

Obiekty blob są zawsze przesyłane do kontenera.Blobs are always uploaded into a container. Możesz organizować grupy obiektów blob w sposób podobny do organizowania plików w folderach na komputerze.You can organize groups of blobs similar to the way you organize your files on your computer in folders.

Do tworzenia kontenera do przechowywania obiektów blob służy polecenie az storage container create.Create a container for storing blobs with the az storage container create command.

az storage container create --name sample-container

Przesyłanie obiektów blobUpload a blob

Usługa Blob Storage obsługuje blokowe, uzupełnialne i stronicowe obiekty blob.Blob storage supports block blobs, append blobs, and page blobs. Przykłady w tym przewodniku szybki start pokazują, jak korzystać z blokowych obiektów BLOB.The examples in this quickstart show how to work with block blobs.

Najpierw utwórz plik do przekazania do blokowego obiektu BLOB.First, create a file to upload to a block blob. Jeśli używasz Azure Cloud Shell, użyj następującego polecenia, aby utworzyć plik:If you're using Azure Cloud Shell, use the following command to create a file:

vi helloworld

Gdy plik zostanie otwarty, naciśnij klawisz INSERT.When the file opens, press insert. Wpisz Hello World, a następnie naciśnij klawisz ESC. Następnie wpisz : x, a następnie naciśnij klawisz Enter.Type Hello world, then press Esc. Next, type :x, then press Enter.

W tym przykładzie do kontenera utworzonego w ostatnim kroku zostanie przekazany obiekt blob za pomocą polecenia az storage blob upload.In this example, you upload a blob to the container you created in the last step using the az storage blob upload command. Nie trzeba określać ścieżki pliku, ponieważ plik został utworzony w katalogu głównym:It's not necessary to specify a file path since the file was created at the root directory:

az storage blob upload \
    --container-name sample-container \
    --name helloworld \
    --file helloworld

Jeśli obiekt blob nie istnieje, zostanie utworzony. W przeciwnym razie zostanie zastąpiony.This operation creates the blob if it doesn't already exist, and overwrites it if it does. Przed kontynuowaniem można przesłać dowolną liczbę plików.Upload as many files as you like before continuing.

Aby przekazać jednocześnie wiele plików, możesz użyć polecenia az storage blob upload-batch.To upload multiple files at the same time, you can use the az storage blob upload-batch command.

Wyświetlanie listy obiektów blob w kontenerzeList the blobs in a container

Do wyświetlania listy obiektów blob w kontenerze służy polecenie az storage blob list.List the blobs in the container with the az storage blob list command.

az storage blob list \
    --container-name sample-container \
    --output table

Pobieranie obiektu blobDownload a blob

Użyj polecenia az storage blob download, aby pobrać przesłany wcześniej obiekt blob.Use the az storage blob download command to download the blob you uploaded earlier.

az storage blob download \
    --container-name sample-container \
    --name helloworld \
    --file ~/destination/path/for/file

Transfer danych przy użyciu narzędzia AzCopyData transfer with AzCopy

Narzędzie AzCopy to kolejna opcja umożliwiająca wydajny transfer danych do usługi Azure Storage z użyciem skryptów.The AzCopy utility is another option for high-performance scriptable data transfer for Azure Storage. Narzędzia AzCopy można używać do transferu danych do i z magazynu obiektów blob, plików i tabel.You can use AzCopy to transfer data to and from Blob, File, and Table storage.

Poniższy przykład używa AzCopy do przekazania pliku o nazwie plik . txt do kontenera przykładowego kontenera .The following example uses AzCopy to upload a file called myfile.txt to the sample-container container. Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach ostrych własnymi wartościami:Remember to replace placeholder values in angle brackets with your own values:

azcopy \
    --source /mnt/myfiles \
    --destination https://<account-name>.blob.core.windows.net/sample-container \
    --dest-key <account-key> \
    --include "myfile.txt"

Oczyszczanie zasobówClean up resources

Jeśli nie potrzebujesz już żadnych zasobów w grupie zasobów, w tym konta magazynu utworzonego w ramach tego przewodnika Szybki Start, Usuń grupę zasobów za pomocą polecenia AZ Group Delete .If you no longer need any of the resources in your resource group, including the storage account you created in this quickstart, delete the resource group with the az group delete command. Pamiętaj, aby zastąpić wartości symboli zastępczych w nawiasach ostrych własnymi wartościami:Remember to replace placeholder values in angle brackets with your own values:

az group delete --name <resource-group-name>

Następne krokiNext steps

W tym przewodniku szybki start przedstawiono sposób transferu plików między lokalnym systemem plików i kontenerem w usłudze Azure Blob Storage.In this quickstart, you learned how to transfer files between a local file system and a container in Azure Blob storage. Aby dowiedzieć się więcej na temat pracy z obiektami blob w usłudze Azure Storage, przejdź do samouczka dotyczącego pracy z usługą Azure Blob Storage.To learn more about working with blobs in Azure Storage, continue to the tutorial for working with Azure Blob storage.