Začínáme s nástrojem AzCopy

AzCopy je nástroj příkazového řádku, do kterého můžete kopírovat data z účtů úložiště nebo mezi těmito účty. Tento článek vám pomůže stáhnout AzCopy, připojit se k účtu úložiště a přenášet data.

AzCopy v10 je aktuálně podporovaná verze Nástroje AzCopy. Podporuje se jenom ve verzích Windows, Linuxu nebo macOS, které jsou oficiálně udržovány. Pokud potřebujete použít předchozí verzi Nástroje AzCopy, přečtěte si část Použití předchozí verze nástroje AzCopy tohoto článku.

Případy použití nástroje AzCopy

Pomocí AzCopy zkopírujte data do účtů úložiště Azure nebo mezi těmito účty. Mezi běžné případy použití patří:

  • Kopírování dat z místního zdroje do účtu úložiště Azure
  • Kopírování dat z účtu úložiště Azure do místního zdroje
  • Kopírování dat z jednoho účtu úložiště do jiného účtu úložiště

AzCopy podporuje každý případ použití s konkrétními příkazy a možnostmi. AzCopy má například nativní příkazy pro kopírování a synchronizaci dat, což z něj dělá flexibilní nástroj pro jednorázové aktivity kopírování a průběžné scénáře synchronizace. Můžete cílit na konkrétní služby úložiště, jako je Azure Blob Storage nebo Azure Files, a můžete mezi nimi také kopírovat. Můžete například kopírovat data z kontejnerů Azure Blob Storage do sdílených složek Azure nebo naopak.

Úplný seznam průvodců přenosem dat najdete v části Přenos dat v tomto článku.

Získání nástroje AzCopy

Pokud používáte AzCopy na počítači s Linuxem, můžete použít správce balíčků. Pro všechny ostatní operační systémy stáhněte přenosný binární soubor. Podrobné informace o verzích AzCopy najdete na stránce verzí AzCopy.

Použití správce balíčků (jenom Linux)

Instalace Nástroje AzCopy prostřednictvím správce balíčků distribuce Linuxu je nejpohodlnější a nejúdržnější přístup. Instalace správce balíčků poskytuje automatické řešení závislostí, zjednodušené aktualizace a integraci se správou softwaru vašeho systému. Podrobné pokyny najdete v tématu Instalace Nástroje AzCopy v Linuxu pomocí správce balíčků.

Stažení přenosného binárního souboru

Instalační balíček je k dispozici pouze pro Linux. Pro všechny ostatní operační systémy stáhněte spustitelný soubor AzCopy v10 do libovolného adresáře v počítači.

Tyto soubory jsou komprimované jako soubor ZIP (Windows a macOS) nebo soubor tar (Linux). Pokud chcete stáhnout a dekompresi souboru tar v Linuxu, přečtěte si dokumentaci k distribuci Linuxu.

Přidejte AzCopy do systémové cesty

Pro usnadnění použití zvažte přidání umístění adresáře spustitelného souboru AzCopy do systémové cesty. Tento doplněk umožňuje psát azcopy z libovolného adresáře v systému. Pokud do cesty nepřidáte adresář AzCopy, musíte změnit adresáře na umístění spustitelného souboru AzCopy a zadat azcopy nebo .\azcopy v příkazovém prostředí.

Autorizace nástroje AzCopy

Jako vlastník účtu Azure Storage nemáte automaticky přiřazená oprávnění pro přístup k datům. Než budete moct s Nástrojem AzCopy něco smysluplného udělat, musíte se rozhodnout, jak službě úložiště poskytnete přihlašovací údaje pro autorizaci. Přihlašovací údaje můžete zadat pomocí ID Microsoft Entra nebo pomocí tokenu SAS.

Ověřování pomocí Microsoft Entra ID

Pomocí ID Microsoft Entra zadáte přihlašovací údaje jednou místo připojení tokenu SAS ke každému příkazu. Začněte výběrem typu objektu zabezpečení , který chcete autorizovat. Jako vodítko použijte následující tabulku.

Bezpečnostní hlavní prvek Pokyny
Identita uživatele Autorizace přístupu pro AzCopy s identitou uživatele
Spravovaná identita Autorizace přístupu pro AzCopy pomocí spravované identity
Hlavní služba Autorizace přístupu pro AzCopy pomocí aplikačního objektu

Autorizace pomocí tokenu SAS

Připojte token SAS ke každé zdrojové nebo cílové adrese URL, kterou používáte v příkazech AzCopy. Tento ukázkový příkaz rekurzivně kopíruje data z místního adresáře do kontejneru objektů blob. Fiktivní token SAS se připojí na konec adresy URL kontejneru.

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

Token SAS v příkladu výše obsahuje parametry dotazu, které definují přístup udělený prostředku úložiště. Například sv určuje verzi služby úložiště, sp určuje povolené operace st a se definuje dobu platnosti, spr určuje povolený protokol a sig obsahuje kryptografický podpis. Příznak --recursive=true zkopíruje všechny soubory a podadresáře ze zadaného místního adresáře. Další informace o tokenech SAS a o tom, jak nějaký získat, najdete v článku sdílené přístupové podpisy (SAS).

Přenos dat

Po autorizaci identity nebo získání tokenu SAS můžete začít přenášet data.

Například příkazy najdete v některém z těchto článků.

Služba Článek
Azure Blob Storage Nahrání souborů do služby Azure Blob Storage
Azure Blob Storage Stažení objektů blob ze služby Azure Blob Storage
Azure Blob Storage Kopírování objektů blob mezi účty úložiště Azure
Azure Blob Storage Synchronizace se službou Azure Blob Storage
Azure Files Přenos dat s použitím AzCopy a úložiště souborů
Amazon S3 Kopírování dat z AmazonU S3 do Azure Storage
Cloudové úložiště Googlu Kopírování dat z Google Cloud Storage do Azure Storage (Preview)
Azure Stack Storage Přenos dat pomocí nástroje AzCopy a úložiště Azure Stack

Příkazy AzCopy můžete spouštět interaktivně. AzCopy můžete také začlenit do automatizovaných skriptů pro dávkové operace, plánované přenosy dat nebo kanály kontinuální integrace. Další informace najdete v tématu Použití nástroje AzCopy ve skriptech a plánovaných přenosech.

Poznámka:

AzCopy nepodporuje scénáře, kdy se během přenosu aktivně mění zdroj nebo cíl.

Získání nápovědy k příkazům

Pokud chcete zobrazit seznam příkazů, zadejte azcopy -h a stiskněte klávesu ENTER.

Pokud se chcete dozvědět o konkrétním příkazu, zadejte název příkazu (například: azcopy list -h).

Vestavěná nápověda

Seznam příkazů

V následující tabulce jsou uvedeny všechny příkazy AzCopy v10. Každý příkaz odkazuje na referenční článek.

Příkaz Popis
azcopy bench Spustí srovnávací test výkonu tak, že nahraje nebo stáhne testovací data do zadaného umístění nebo z daného umístění.
azcopy copy Zkopíruje zdrojová data do cílového umístění.
azcopy doc Generuje dokumentaci pro nástroj ve formátu Markdown.
azcopy env Zobrazuje proměnné prostředí, které můžou konfigurovat chování nástroje AzCopy.
azcopy jobs Dílčí příkazy související se správou úloh
azcopy jobs clean Odebere všechny protokolové soubory a plánovací soubory ze všech úloh.
seznam úloh azcopy Zobrazí informace o všech úlohách.
azcopy úlohy odstranit Odebere všechny soubory přidružené k danému ID úlohy.
Životopis úloh azcopy Obnoví existující úlohu s daným ID úlohy.
azcopy úlohy zobrazit Zobrazuje podrobné informace o daném ID úlohy.
azcopy list Zobrazí seznam entit v daném prostředku.
azcopy přihlášení Přihlaste se k MICROSOFT Entra ID pro přístup k prostředkům Azure Storage.
Stav přihlášení azcopy Zobrazí aktuální stav ověřování Azure.
azcopy logout Odhlásí uživatele a ukončí přístup k prostředkům Azure Storage.
azcopy make Vytvoří kontejner nebo sdílenou složku.
azcopy remove Odstraní objekty blob nebo soubory z účtu úložiště Azure.
azcopy sync Replikuje zdrojové umístění na cílové umístění.
azcopy set-properties Změní úroveň přístupu jednoho nebo více objektů blob a nahradí (přepíše) metadata a indexové značky jednoho nebo více objektů blob.

Poznámka:

AzCopy nemá příkaz k přejmenování souborů.

Konfigurace, optimalizace a řešení potíží s AzCopy

Podívejte se na některý z následujících zdrojů informací:

Další kroky

Pokud máte dotazy, problémy nebo obecnou zpětnou vazbu, odešlete je na GitHubu.

  • Last updated on