Get started with AzCopy

  • Cikk

AzCopy is a command-line utility that you can use to copy blobs or files to or from a storage account. Ez a cikk segítséget nyújt az AzCopy letöltésében, a tárfiókhoz való csatlakozásban, majd az adatok átvitelében.

Megjegyzés:

Az AzCopy V10 az AzCopy jelenleg támogatott verziója.

Ha az AzCopy egy korábbi verzióját kell használnia, olvassa el a cikk AzCopy előző verziójának használata című szakaszát.

Ez a videó bemutatja, hogyan töltheti le és futtathatja az AzCopy segédprogramot.

A videó lépéseit a következő szakaszokban is ismertetjük.

Download AzCopy

Először töltse le az AzCopy V10 végrehajtható fájlt a számítógép bármely könyvtárába. Az AzCopy V10 csak végrehajtható fájl, ezért nincs mit telepíteni.

Ezek a fájlok zip-fájlként (Windows és Mac) vagy kátrányfájlként (Linux) vannak tömörítve. A kátrányfájl linuxos letöltéséhez és kibontásához tekintse meg a Linux-disztribúció dokumentációját.

Az AzCopy-kiadásokkal kapcsolatos részletes információkért tekintse meg az AzCopy kiadási oldalát.

Megjegyzés:

Ha adatokat szeretne átmásolni az Azure Table Storage szolgáltatásba és onnan, telepítse az AzCopy 7.3-at.

Run AzCopy

For convenience, consider adding the directory location of the AzCopy executable to your system path for ease of use. Így a rendszer bármely könyvtárából beírhat azcopy .

Ha úgy dönt, hogy nem adja hozzá az AzCopy-könyvtárat az elérési úthoz, módosítania kell a könyvtárakat az AzCopy végrehajtható helyére, és be kell gépelnie azcopy , vagy .\azcopy a Windows PowerShell parancssoraiban kell megadnia.

Az Azure Storage-fiók tulajdonosaként a rendszer nem rendeli hozzá automatikusan az adatokhoz való hozzáféréshez szükséges engedélyeket. Mielőtt bármi hasznosat tehet az AzCopyval, el kell döntenie, hogyan adja meg az engedélyezési hitelesítő adatokat a társzolgáltatásnak.

AzCopy engedélyezése

Megadhatja az engedélyezési hitelesítő adatokat a Microsoft Entra ID vagy a közös hozzáférésű jogosultságkód (SAS) jogkivonat használatával.

1. lehetőség: A Microsoft Entra-azonosító használata

A Microsoft Entra ID használatával egyszer megadhatja a hitelesítő adatokat ahelyett, hogy sas-jogkivonatot kellene hozzáfűznie az egyes parancsokhoz.

2. lehetőség: SAS-jogkivonat használata

Sas-jogkivonatot fűzhet az AzCopy-parancsokban használt forrás- vagy cél URL-címekhez.

Ez a példaparancs rekurzív módon másol adatokat egy helyi könyvtárból egy blobtárolóba. A rendszer egy fiktív SAS-jogkivonatot fűz hozzá a tároló URL-címének végéhez.

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

Az SAS-jogkivonatokról és azok beszerzéséről további információt a közös hozzáférésű jogosultságkódok (SAS) használata című témakörben talál.

Megjegyzés:

A tárfiók biztonságos átvitelhez szükséges beállítása határozza meg, hogy a tárfiókhoz való csatlakozást a Transport Layer Security (TLS) biztosítja-e. Alapértelmezés szerint ez a beállítás engedélyezett.

Adatátvitel

Miután engedélyezte a személyazonosságát, vagy beszerezte az SAS-jogkivonatot, megkezdheti az adatok átvitelét.

A példaparancsok megkereséséhez tekintse meg az alábbi cikkek bármelyikét.

Service Cikk
Azure Blob Storage Upload files to Azure Blob Storage
Azure Blob Storage Blobok letöltése az Azure Blob Storage-ból
Azure Blob Storage Blobok másolása Azure-tárfiókok között
Azure Blob Storage Synchronize with Azure Blob Storage
Azure Files Adatok átvitele az AzCopy használatával és fájltárolás
Amazon S3 Adatok másolása az Amazon S3-ból az Azure Storage-ba
Google Cloud Storage Adatok másolása a Google Cloud Storage-ból az Azure Storage-ba (előzetes verzió)
Azure Stack Storage Adatok átvitele az AzCopy és az Azure Stack Storage használatával

Parancs súgójának lekérése

A parancsok listájának megtekintéséhez írja be azcopy -h , majd nyomja le az ENTER billentyűt.

Egy adott parancs megismeréséhez egyszerűen adja meg a parancs nevét (például: azcopy list -h).

Inline help

Parancsok listája

Az alábbi táblázat az Összes AzCopy v10-parancsot felsorolja. Minden parancs hivatkozási cikkre mutat.

Parancs Leírás
azcopy pad Teljesítménymutatót futtat úgy, hogy feltölti vagy letölti a tesztadatokat egy megadott helyre vagy onnan.
azcopy copy Forrásadatok másolása célhelyre
azcopy doc Létrehozza az eszköz dokumentációját Markdown formátumban.
azcopy env Megjeleníti azOkat a környezeti változókat, amelyek konfigurálhatják az AzCopy viselkedését.
azcopy-feladatok Feladatok kezelésével kapcsolatos alparancsok.
azcopy jobs clean Távolítsa el az összes feladat napló- és tervfájljait.
azcopy jobs list Az összes feladat adatait jeleníti meg.
azcopy-feladatok eltávolítása Távolítsa el a megadott feladatazonosítóhoz társított összes fájlt.
azcopy jobs resume Folytatja a meglévő feladatot a megadott feladatazonosítóval.
azcopy jobs show A megadott feladatazonosító részletes adatait jeleníti meg.
azcopy list Egy adott erőforrás entitásainak listája.
azcopy login Bejelentkezik a Microsoft Entra ID-be az Azure Storage-erőforrások eléréséhez.
azcopy bejelentkezési állapota Egy adott erőforrás entitásainak listája.
azcopy logout Kijelentkezteti a felhasználót, és leállítja az Azure Storage-erőforrásokhoz való hozzáférést.
azcopy make Tárolót vagy fájlmegosztást hoz létre.
azcopy remove Blobok vagy fájlok törlése egy Azure Storage-fiókból.
azcopy sync Replikálja a forráshelyet a célhelyre.
azcopy set-properties Módosítsa egy vagy több blob hozzáférési szintjét, és cserélje le (felülírja) egy vagy több blob metaadatait és indexcímkéit.

Megjegyzés:

Az AzCopy nem rendelkezik a fájlok átnevezésére használható paranccsal.

Használat szkriptben

Idővel az AzCopy letöltési hivatkozása az AzCopy új verzióira mutat. Ha a szkript letölti az AzCopyt, a szkript működése leállhat, ha az AzCopy újabb verziója módosítja a szkripttől függő funkciókat.

A problémák elkerülése érdekében szerezze be az AzCopy aktuális verziójára mutató statikus (változatlan) hivatkozást. Így a szkript minden futtatáskor ugyanazt az AzCopy-verziót tölti le.

A hivatkozás beszerzéséhez futtassa a következő parancsot:

Operating system Command
Linux curl -s -D- https://aka.ms/downloadazcopy-v10-linux \| grep ^Location
Windows PowerShell (Invoke-WebRequest -Uri https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction SilentlyContinue).headers.location
PowerShell 6.1+ (Invoke-WebRequest -Uri https://aka.ms/downloadazcopy-v10-windows -MaximumRedirection 0 -ErrorAction SilentlyContinue -SkipHttpErrorCheck).headers.location

Megjegyzés:

Linux --strip-components=1 esetén a parancs eltávolítja a tar verziónevet tartalmazó legfelső szintű mappát, és ehelyett a bináris fájlt közvetlenül az aktuális mappába nyeri ki. Ez lehetővé teszi, hogy a szkript csak az URL-cím frissítésével frissüljön egy wget új verzióvalazcopy.

Az URL-cím megjelenik a parancs kimenetében. A szkript ezután az URL-cím használatával letöltheti az AzCopyt.

Linux

wget -O azcopy_v10.tar.gz https://aka.ms/downloadazcopy-v10-linux && tar -xf azcopy_v10.tar.gz --strip-components=1

Windows PowerShell

Invoke-WebRequest -Uri 'https://azcopyvnext.azureedge.net/release20220315/azcopy_windows_amd64_10.14.1.zip' -OutFile 'azcopyv10.zip'
Expand-archive -Path '.\azcopyv10.zip' -Destinationpath '.\'
$AzCopy = (Get-ChildItem -path '.\' -Recurse -File -Filter 'azcopy.exe').FullName
# Invoke AzCopy 
& $AzCopy

PowerShell 6.1+

Invoke-WebRequest -Uri 'https://azcopyvnext.azureedge.net/release20220315/azcopy_windows_amd64_10.14.1.zip' -OutFile 'azcopyv10.zip'
$AzCopy = (Expand-archive -Path '.\azcopyv10.zip' -Destinationpath '.\' -PassThru | where-object {$_.Name -eq 'azcopy.exe'}).FullName
# Invoke AzCopy
& $AzCopy

Speciális karakterek feloldása SAS-jogkivonatokban

A bővítményt .cmd tartalmazó kötegfájlokban meg kell szabadulnia az % SAS-jogkivonatokban megjelenő karakterek elől. Ezt úgy teheti meg, hogy hozzáad egy további % karaktert a meglévő % karakterek mellé az SAS-jogkivonat sztringjében. Az eredményként kapott karaktersorozat a következőképpen %%jelenik meg: . A karakterütemezés ^&létrehozásához minden egyes karakter előtt & adjon hozzá egy pluszt^.

Szkriptek futtatása a Jenkins használatával

Ha a Jenkinst használja szkriptek futtatására, mindenképpen helyezze a következő parancsot a szkript elejére.

/usr/bin/keyctl new_session

Használat az Azure Storage Explorerben

A Storage Explorer az AzCopy használatával hajtja végre az összes adatátviteli műveletet. A Storage Explorert akkor használhatja, ha az AzCopy teljesítménybeli előnyeit szeretné alkalmazni, de a parancssor helyett inkább grafikus felhasználói felületet szeretne használni a fájlok használatához.

A Storage Explorer a fiókkulcsot használja a műveletek végrehajtásához, így a Storage Explorerbe való bejelentkezés után nem kell további hitelesítési hitelesítő adatokat megadnia.

Konfigurálás, optimalizálás és javítás

Tekintse meg az alábbi erőforrások bármelyikét:

Korábbi verzió használata (elavult)

Ha az AzCopy előző verzióját kell használnia, tekintse meg az alábbi hivatkozások egyikét:

Megjegyzés:

Ezek az AzCopy-verziók elavultak. A Microsoft az AzCopy v10 használatát javasolja.

További lépések

Ha kérdése, problémája vagy általános visszajelzése van, küldje el őket a GitHub oldalán.