Начало работы с AzCopyGet started with AzCopy

AzCopy — программа командной строки, который можно использовать для копирования больших двоичных объектов или файлов из учетной записи хранения.AzCopy is a command-line utility that you can use to copy blobs or files to or from a storage account. Эта статья поможет вам скачать AzCopy, подключиться к вашей учетной записи хранения и затем передачи файлов.This article helps you download AzCopy, connect to your storage account, and then transfer files.

Примечание

AzCopy V10 — поддерживаемые в настоящее время версия AzCopy.AzCopy V10 is the currently supported version of AzCopy.

Если вам нужно использовать AzCopy v8.1, см. в разделе использовать предыдущую версию AzCopy этой статьи.If you need to use AzCopy v8.1, see the Use the previous version of AzCopy section of this article.

Скачивание AzCopyDownload AzCopy

Во-первых Загрузите исполняемый файл AzCopy V10 в любой каталог на компьютере.First, download the AzCopy V10 executable file to any directory on your computer.

Примечание

Если вы хотите скопировать данные из вашей хранилища таблиц Azure службы, а затем установить AzCopy версии 7.3.If you want to copy data to and from your Azure Table storage service, then install AzCopy version 7.3.

Запуск AzCopyRun AzCopy

Для удобства рекомендуется добавить расположение каталога исполняемый файл AzCopy к системному пути для удобства использования.For convenience, consider adding the directory location of the AzCopy executable to your system path for ease of use. Таким образом, можно ввести azcopy из любого каталога в вашей системе.That way you can type azcopy from any directory on your system.

Если вы не захотите добавить путь к каталогу AzCopy, необходимо будет измените каталоги на расположение исполняемый файл AzCopy и типа azcopy или .\azcopy в командной строке Windows PowerShell.If you choose not to add the AzCopy directory to your path, you'll have to change directories to the location of your AzCopy executable and type azcopy or .\azcopy in Windows PowerShell command prompts.

Чтобы просмотреть список команд, введите azcopy -h и нажмите клавишу ВВОД.To see a list of commands, type azcopy -h and then press the ENTER key.

Дополнительные сведения о конкретной команды, достаточно включить имя команды (например: azcopy list -h).To learn about a specific command, just include the name of the command (For example: azcopy list -h).

Встроенная справка

Примечание

Как владелец учетной записи хранилища Azure не назначаются автоматически разрешения для доступа к данным.As an owner of your Azure Storage account, you aren't automatically assigned permissions to access data. Прежде чем сделать что-нибудь с помощью AzCopy, вам нужно решить, каким образом необходимо предоставить учетные данные авторизации в службе хранилища.Before you can do anything meaningful with AzCopy, you need to decide how you'll provide authorization credentials to the storage service.

Выберите, каким образом необходимо предоставить учетные данные авторизацииChoose how you'll provide authorization credentials

Можно предоставить учетные данные авторизации с помощью Azure Active Directory (AD) или с помощью токена подписи общего доступа (SAS).You can provide authorization credentials by using Azure Active Directory (AD), or by using a Shared Access Signature (SAS) token.

Используйте эту таблицу в качестве руководства:Use this table as a guide:

Тип хранилищаStorage type Поддерживаемые в настоящее время метод авторизацииCurrently supported method of authorization
Хранилище BLOB-объектовBlob storage Azure AD & SASAzure AD & SAS
Хранилище BLOB-объектов (иерархические пространства имен)Blob storage (hierarchial namespace) Только Azure ADAzure AD only
Хранилище файловFile storage Только SASSAS only

Вариант 1. Использование Azure ADOption 1: Use Azure AD

Уровень авторизации, который требуется основан на планируете ли вы отправить файлы или просто загрузите их.The level of authorization that you need is based on whether you plan to upload files or just download them.

Если вы хотите скачать файлы, убедитесь, что модуль чтения данных хранилища BLOB-объектов был назначен вашей личности.If you just want to download files, then verify that the Storage Blob Data Reader has been assigned to your identity.

Если вы хотите отправить файлы, а затем проверьте, что одной из этих ролей был назначен личности:If you want to upload files, then verify that one of these roles has been assigned to your identity:

Эти роли могут назначаться личности в любом из этих областей:These roles can be assigned to your identity in any of these scopes:

  • Контейнер (файловая система)Container (file system)
  • Учетная запись храненияStorage account
  • Группа ресурсовResource group
  • ПодпискаSubscription

Чтобы узнать, как проверить и назначение ролей, см. в разделе предоставить доступ к BLOB-объектов и очереди данных Azure с помощью RBAC на портале Azure.To learn how to verify and assign roles, see Grant access to Azure blob and queue data with RBAC in the Azure portal.

Не нужно иметь одну из этих ролей, присваиваемый свое удостоверение личности добавляется в список управления доступом (ACL) целевой контейнер или каталога.You don't need to have one of these roles assigned to your identity if your identity is added to the access control list (ACL) of the target container or directory. В списке управления Доступом личности требуется разрешение на запись для целевого каталога и разрешение выполнения для контейнера и каждый родительский каталог.In the ACL, your identity needs write permission on the target directory, and execute permission on container and each parent directory.

Дополнительные сведения см. в разделе управление доступом в Azure Data Lake хранилища Gen2.To learn more, see Access control in Azure Data Lake Storage Gen2.

Проверки подлинностиAuthenticate your identity

Когда вы проверите, что ваше удостоверение получил нужный уровень авторизации, откройте командную строку, введите следующую команду и нажмите клавишу ВВОД.After you've verified that your identity has been given the necessary authorization level, open a command prompt, type the following command, and then press the ENTER key.

azcopy login

Если вы входите в более чем одной организации, включают идентификатор клиента организации, к которой принадлежит учетной записи хранения.If you belong to more than one organization, include the tenant ID of the organization to which the storage account belongs.

azcopy login --tenant-id=<tenant-id>

Замените <tenant-id> заполнитель идентификатор клиента организации, к которой принадлежит учетной записи хранения.Replace the <tenant-id> placeholder with the tenant ID of the organization to which the storage account belongs. Чтобы найти идентификатор клиента, выберите Azure Active Directory > Свойства > идентификатор каталога на портале Azure.To find the tenant ID, select Azure Active Directory > Properties > Directory ID in the Azure portal.

Эта команда возвращает код проверки подлинности и URL-адрес веб-сайта.This command returns an authentication code and the URL of a website. Откройте веб-сайт, укажите код и нажмите кнопку Далее.Open the website, provide the code, and then choose the Next button.

Создание контейнера

Откроется окно входа.A sign-in window will appear. В этом окне войдите в свою учетную запись Azure с помощью соответствующих данных.In that window, sign into your Azure account by using your Azure account credentials. Выполнив вход, можно закрыть окно браузера и начать работу с AzCopy.After you've successfully signed in, you can close the browser window and begin using AzCopy.

Вариант 2. Использование маркера SAS.Option 2: Use a SAS token

Маркер SAS можно добавить к каждой исходной или целевой URL-адрес, использовать в командах AzCopy.You can append a SAS token to each source or destination URL that use in your AzCopy commands.

Этом примере команда рекурсивно копирует данные из локального каталога в контейнер больших двоичных объектов.This example command recursively copies data from a local directory to a blob container. Вымышленная маркер SAS добавляется в конец URL-адреса контейнера.A fictitious SAS token is appended to the end of the of the container URL.

azcopy cp "C:\local\path" "https://account.blob.core.windows.net/mycontainer1/?sv=2018-03-28&ss=bjqt&srt=sco&sp=rwddgcup&se=2019-05-01T05:01:17Z&st=2019-04-30T21:01:17Z&spr=https&sig=MGCXiyEzbtttkr3ewJIh2AR8KrghSy1DGM9ovN734bQF4%3D" --recursive=true

Дополнительные сведения о маркерах SAS и как его получить, см. в разделе использование подписи общего доступа (SAS).To learn more about SAS tokens and how to obtain one, see Using shared access signatures (SAS).

Передача файловTransfer files

После проверки подлинности личности или полученный маркер SAS, можно начать передачу файлов.After you've authenticated your identity or obtained a SAS token, you can begin transferring files.

Примеры команд см. в статье любой из следующих статей.To find example commands, see any of these articles.

Использовать AzCopy в сценарииUse AzCopy in a script

Со временем, AzCopy ссылка для скачивания будет указывать на новые версии AzCopy.Over time, the AzCopy download link will point to new versions of AzCopy. Если ваш сценарий скачивает AzCopy, сценарий могут перестать функционировать более новой версии AzCopy изменяет компоненты, от которых зависит ваш скрипт.If your script downloads AzCopy, the script might stop working if a newer version of AzCopy modifies features that your script depends upon.

Чтобы избежать этих проблем, получения статического (без изменения) ссылки в текущей версии AzCopy.To avoid these issues, obtain a static (un-changing) link to the current version of AzCopy. Таким образом, сценарий загрузки точно такую же версию AzCopy каждый раз, в которой он выполняется.That way, your script downloads the same exact version of AzCopy each time that it runs.

Чтобы получить ссылку, выполните следующую команду:To obtain the link, run this command:

Операционная системаOperating system КомандаCommand
LinuxLinux curl -v https://aka.ms/downloadazcopy-v10-linux
WindowsWindows (curl https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction silentlycontinue).RawContent

Примечание

Для Linux --strip-components=1 на tar команда удаляет папку верхнего уровня, содержащий имя версии, а вместо этого извлекает двоичного файла непосредственно в текущей папке.For Linux, --strip-components=1 on the tar command removes the top-level folder that contains the version name, and instead extracts the binary directly into the current folder. Это позволит скрипту следует заменить на новую версию azcopy обновив только wget URL-адрес.This allows the script to be updated with a new version of azcopy by only updating the wget URL.

URL-адрес отображается в выходных данных этой команды.The URL appears in the output of this command. Затем сценарий может загрузить AzCopy с использованием этого URL-адреса.Your script can then download AzCopy by using that URL.

Операционная системаOperating system КомандаCommand
LinuxLinux wget -O azcopyv10.tar https://azcopyvnext.azureedge.net/release20190301/azcopy_linux_amd64_10.0.8.tar.gz tar -xf azcopyv10.tar --strip-components=1 ./azcopy
WindowsWindows Invoke-WebRequest https://azcopyvnext.azureedge.net/release20190517/azcopy_windows_amd64_10.1.2.zip -OutFile azcopyv10.zip <<Unzip here>>

Использование AzCopy в обозревателе службы хранилищаUse AzCopy in Storage Explorer

Если вы хотите получить преимущества производительности AzCopy, но вы предпочитаете использовать обозреватель службы хранилища, а не командной строки для взаимодействия с файлами, включите AzCopy в обозревателе службы хранилища.If you want to leverage the performance advantages of AzCopy, but you prefer to use Storage Explorer rather than the command line to interact with your files, then enable AzCopy in Storage Explorer.

В обозревателе службы хранилища выберите предварительной версии->использование AzCopy для Улучшенная передачи больших двоичных объектов и загрузки.In Storage Explorer, choose Preview->Use AzCopy for Improved Blob Upload and Download.

Включить AzCopy как механизм передачи в обозревателе службы хранилища Azure

Примечание

Включите этот параметр, если вы включили функцию иерархического пространства имен в вашей учетной записи хранения не нужно.You don't have to enable this setting if you've enabled a hierarchical namespace on your storage account. Том, что обозреватель хранилищ автоматически использует AzCopy в учетных записях хранения, имеющих иерархического пространства имен.That's because Storage Explorer automatically uses AzCopy on storage accounts that have a hierarchical namespace.

Обозреватель службы хранилища использует ключ учетной записи для выполнения операций, поэтому после входа в систему в обозревателе службы хранилища, не нужно будет предоставить учетные данные дополнительной авторизации.Storage Explorer uses your account key to perform operations, so after you sign into Storage Explorer, you won't need to provide additional authorization credentials.

Использовать предыдущую версию AzCopyUse the previous version of AzCopy

Если необходимо использовать предыдущую версию AzCopy (AzCopy v8.1), см. в статье из следующих ссылок:If you need to use the previous version of AzCopy (AzCopy v8.1), see either of the following links:

Настроить, оптимизировать и устранение неполадок с AzCopyConfigure, optimize, and troubleshoot AzCopy

См. в разделе Настройка, оптимизации и устранении неполадок AzCopySee Configure, optimize, and troubleshoot AzCopy

Дальнейшие действияNext steps

Если у вас есть вопросы, проблемы и отзывах общего характера, сообщите об этом на сайте GitHub страницы.If you have questions, issues, or general feedback, submit them on GitHub page.