Поделиться через

Начало работы с AzCopy

AzCopy — это программа командной строки, позволяющая копировать данные между учетными записями хранения. С помощью сведений из этой статьи вы сможете скачать AzCopy, подключиться к учетной записи хранения, а затем передать данные.

AzCopy V10 — это текущая поддерживаемая версия AzCopy. Она поддерживается только в версиях Windows, Linux или macOS, которые официально поддерживаются. Если вам нужно использовать предыдущую версию AzCopy, см. раздел Использование предыдущей версии AzCopy в этой статье.

Варианты использования AzCopy

Используйте AzCopy для копирования данных в учетные записи хранения Azure или между ними. Типичные примеры такой ситуации:

  • Копирование данных из локального источника в учетную запись хранения Azure
  • Копирование данных из учетной записи хранения Azure в локальный источник
  • Копирование данных из одной учетной записи хранения в другую учетную запись хранения

AzCopy поддерживает каждый вариант использования с командами и параметрами. Например, AzCopy имеет собственные команды для копирования или синхронизации данных. Эта поддержка делает AzCopy гибким инструментом, который можно использовать для однократных действий копирования и текущих сценариев синхронизации. Вы можете нацелиться на конкретные службы хранилища, такие как хранилище BLOB-объектов Azure или файлы Azure, и также копировать данные между ними. Например, можно скопировать данные из контейнеров хранилища BLOB-объектов Azure в общие папки Azure или наоборот.

Полный список руководств по передаче данных см. в разделе "Передача данных " этой статьи.

Получить AzCopy

Если вы используете AzCopy на компьютере Linux, можно использовать диспетчер пакетов. Для всех других операционных систем скачайте переносимый двоичный файл. Подробные сведения о выпусках AzCopy см. на странице выпусков AzCopy.

Использование диспетчера пакетов (только для Linux)

Установка AzCopy с помощью менеджера пакетов вашего дистрибутива Linux — это самый удобный и поддерживаемый способ получения этого средства. Установка диспетчера пакетов включает автоматическое разрешение зависимостей, упрощенное обновление и интеграцию с управлением программным обеспечением системы. Пошаговые инструкции см. в разделе "Установка AzCopy в Linux" с помощью диспетчера пакетов.

Скачивание переносимого двоичного файла

Пакет установки доступен только для Linux. Для всех других операционных систем можно скачать исполняемый файл AzCopy версии 10 в любой каталог на компьютере.

Эти файлы сжаты в ZIP-файл (Windows и Mac) или TAR-файл (Linux). Сведения о том, как скачать и распаковать TAR файл в Linux, см. в документации по своему дистрибутиву Linux.

Примечание.

Если вы хотите скопировать данные в службу хранилища таблиц Azure и из нее, установите AzCopy версии 7.3.

Добавление AzCopy в системный путь

Для удобства рекомендуется добавить расположение каталога исполняемого файла AzCopy в системный путь. Таким образом можно ввести команду azcopy из любого каталога в системе. Если каталог AzCopy не добавлен в путь, необходимо перейти в каталог, где находится исполняемый файл AzCopy, и ввести azcopy или .\azcopy в командной оболочке.

Авторизовать AzCopy

Как владельцу учетной записи службы хранилища Azure вам автоматически не назначаются разрешения на доступ к данным. Прежде чем выполнять какие-либо значимые действия с AzCopy, необходимо решить, как вы будете предоставлять учетные данные авторизации для службы хранилища. Вы можете предоставить учетные данные с помощью идентификатора Microsoft Entra или с помощью маркера SAS.

Авторизация с использованием Microsoft Entra ID

С помощью идентификатора Microsoft Entra можно указать учетные данные один раз, а не добавлять маркер SAS к каждой команде. Начните с выбора типа субъекта безопасности , который требуется авторизовать. Используйте следующую таблицу для справки.

Принцип безопасности Руководство
Удостоверение пользователя Авторизация доступа для AzCopy с помощью удостоверения пользователя
Манажируемая идентичность Авторизация доступа для AzCopy с помощью управляемого удостоверения
Принципал службы Авторизуйте доступ для AzCopy с помощью учетной записи службы

Авторизация с помощью токена SAS

Маркер SAS можно добавить к каждому исходному или целевому URL-адресу, используемому в командах AzCopy. В этом примере команда рекурсивно копирует данные из локального каталога в объектный контейнер. Вымышленный маркер SAS добавляется в конец URL-адреса контейнера.

azcopy copy "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 и их получении см. в разделе Использование подписанных URL-адресов (SAS).

Передача данных

После авторизации удостоверения или получения маркера SAS можно начать передачу данных.

Примеры команд см. в любой из этих статей.

Сервис Статья
Хранилище BLOB-объектов Azure Отправка файлов в хранилище BLOB-объектов Azure
Хранилище BLOB-объектов Azure Скачивание объектов BLOB из Azure Blob Storage
Хранилище BLOB-объектов Azure Копирование blob-объектов между учетными записями Azure Storage
Хранилище BLOB-объектов Azure Синхронизация с Хранилищем BLOB-объектов Azure
Файлы Azure Перенос данных с помощью AzCopy и хранилища файлов
Amazon S3 Копирование данных из Amazon S3 в службу хранилища Azure
Google Cloud Storage Копирование данных из Google Cloud Storage в службу хранилища Azure (предварительная версия)
Хранилище Azure Stack Передача данных с помощью AzCopy и хранилища Azure Stack

Команды AzCopy можно запускать в интерактивном режиме. Можно также включить AzCopy в автоматизированные скрипты для пакетных операций, запланированных передач данных или конвейеров непрерывной интеграции. Для получения дополнительной информации см. Использование AzCopy в сценариях и запланированных передачах.

Примечание.

AzCopy не поддерживает сценарии, в которых источник или назначение активно изменяются во время передачи.

Получите справку по командам

Чтобы просмотреть список команд, введите azcopy -h и нажмите клавишу ВВОД.

Чтобы узнать о конкретной команде, добавьте имя команды (например: azcopy list -h).

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

Список команд

В таблице ниже перечислены все команды AzCopy версии 10. Каждая команда связана со справочной статьей.

Приказ Описание
Скамья Azcopy Запускает тест производительности, отправляя проверочные данные в указанное место назначения или загружая их оттуда.
azcopy copy Копирует исходные данные в пункт назначения.
azcopy doc Создает документацию для инструмента в формате Markdown.
Azcopy env Показывает переменные среды, которые могут настраивать поведение AzCopy.
azcopy jobs Подкоманды, связанные с управлением заданиями.
azcopy jobs clean Удаляет все файлы журналов и планов для всех заданий.
список заданий azcopy Отображает информацию обо всех работах.
удалить задания azcopy Удаляет все файлы, связанные с заданным идентификатором задания.
azcopy jobs резюме Возобновляет существующее задание с указанным идентификатором задания.
Azcopy Вакансии Показать Показывает подробные сведения для задания с указанным идентификатором.
Список azcopy Выводит список сущностей в заданном ресурсе.
azcopy login Войдите в службу Microsoft Entra ID для доступа к ресурсам Azure Storage.
azcopy статус входа в систему Выводит список сущностей в заданном ресурсе.
azcopy logout Выходит из учетной записи пользователя и прекращает доступ к ресурсам Azure Storage.
Azcopy make Создает контейнер или общий доступ к файлам.
azcopy remove Удаляет объекты BLOB или файлы из учетной записи хранения Azure.
azcopy sync Дублирует исходное местоположение в целевое местоположение.
azcopy set-properties Изменяет уровень доступа одного или нескольких блобов и заменяет (перезаписывает) метаданные и теги индекса одного или нескольких блобов.

Примечание.

AzCopy не имеет команды для переименования файлов.

Настройка, оптимизация и исправление

См. следующие ресурсы:

Использование предыдущей версии (не рекомендуется)

Если вам нужно использовать предыдущую версию AzCopy, ознакомьтесь со следующими ссылками:

Примечание.

Эти версии AzCopy устарели. Корпорация Майкрософт рекомендует использовать AzCopy версии 10.

Следующие шаги

Если у вас есть вопросы, проблемы или общие отзывы, отправьте их на GitHub.

  • Last updated on