Übertragen von Daten mit AzCopy unter WindowsTransfer data with the AzCopy on Windows

AzCopy ist ein Befehlszeilenprogramm, das entwickelt wurde, um Daten in/aus Microsoft Azure Blob, File und Table Storage zu kopieren. Hierbei werden einfache Befehle verwendet, die für optimale Leistung konzipiert sind.AzCopy is a command-line utility designed for copying data to/from Microsoft Azure Blob, File, and Table storage, using simple commands designed for optimal performance. Sie können Daten zwischen einem Dateisystem und einem Speicherkonto oder zwischen Speicherkonten kopieren.You can copy data between a file system and a storage account, or between storage accounts.

Wichtig

Dieser Artikel beschreibt eine ältere Version von AzCopy.This article describes an older version of AzCopy. Informationen zur Installation der neuesten Version von AzCopy finden Sie unter AzCopy v10.To install the most recent version of AzCopy, see AzCopy v10.

Wenn Sie die ältere Version von AzCopy (AzCopy v8.1) installieren möchten, stehen mehrere Versionen für den Download zur Verfügung.If you choose to install the older version of AzCopy (AzCopy v8.1), then there are multiple versions that you can download. AzCopy unter Windows bietet Befehlszeilenoptionen im Windows-Format.AzCopy on Windows offers Windows style command-line options. AzCopy unter Linux ist auf Linux-Plattformen ausgerichtet, die Befehlszeilenoptionen im POSIX-Format bieten.AzCopy on Linux targets Linux platforms offering POSIX style command-line options. Dieser Artikel behandelt AzCopy unter Windows.This article covers AzCopy on Windows.

Herunterladen und Installieren von AzCopy (v8.1) unter WindowsDownload and install AzCopy (v8.1) on Windows

Laden Sie AzCopy (v8.1) unter Windows herunter.Download the AzCopy (v8.1) on Windows.

Anmerkungen zu AzCopy unter Windows 8.1AzCopy on Windows 8.1 Release Notes

  • Der Tabellenspeicherdienst wird in der neuesten Version nicht mehr unterstützt.Table service is no longer supported in the latest version. Wenn Sie das Exportfeature des Tabellenspeicherdiensts verwenden, laden Sie AzCopy 7.3 herunter.If you use Table export feature, download AzCopy 7.3 version.
  • Diese Version wurde mit .NET Core 2.1 erstellt, und alle .NET Core-Abhängigkeiten werden jetzt in der Installation gepackt.Built with .NET Core 2.1, and all .NET Core dependencies are now packaged in the installation.
  • Unterstützung für OAuth-Authentifizierung hinzugefügt.Added OAuth authentication support. Verwenden Sie azcopy login, um sich mit Azure Active Directory anzumelden.Use azcopy login to log on using Azure Active Directory.

AzCopy mit Tabellenunterstützung (v7.3)Azcopy with Table support (v7.3)

Laden Sie AzCopy 7.3 mit Tabellenunterstützung herunter.Download the AzCopy 7.3 with Table support.

Schritte nach der InstallationPost-installation Step

Öffnen Sie nach dem Installieren von AzCopy unter Windows mithilfe des Installationsprogramms ein Befehlsfenster, und navigieren zum Installationsverzeichnis von AzCopy auf Ihrem Computer, in dem sich die ausführbare Datei AzCopy.exe befindet.After installing AzCopy on Windows using the installer, open a command window and navigate to the AzCopy installation directory on your computer - where the AzCopy.exe executable is located. Bei Bedarf können Sie den Speicherort für die AzCopy-Installation zum Systempfad hinzufügen.If desired, you can add the AzCopy installation location to your system path. In der Standardeinstellung ist AzCopy in %ProgramFiles(x86)%\Microsoft SDKs\Azure\AzCopy oder %ProgramFiles%\Microsoft SDKs\Azure\AzCopy installiert.By default, AzCopy is installed to %ProgramFiles(x86)%\Microsoft SDKs\Azure\AzCopy or %ProgramFiles%\Microsoft SDKs\Azure\AzCopy.

Schreiben Ihres ersten AzCopy-BefehlsWriting your first AzCopy command

Die grundlegende Syntax für AzCopy-Befehle ist:The basic syntax for AzCopy commands is:

AzCopy /Source:<source> /Dest:<destination> [Options]

Die folgenden Beispiele zeigen eine Vielzahl von Szenarien zum Kopieren von Daten von und zu Microsoft Azure Blobs, Dateien und Tabellen.The following examples demonstrate a variety of scenarios for copying data to and from Microsoft Azure Blobs, Files, and Tables. Für eine detailliertere Erklärung der in jedem Beispiel verwendeten Parameter gehen Sie zum Abschnitt Einführung in die Parameter .Refer to the AzCopy Parameters section for a detailed explanation of the parameters used in each sample.

Herunterladen von Blobs aus BlobspeicherDownload blobs from Blob storage

Betrachten wir nun mehrere Möglichkeiten, Blobs mithilfe von AzCopy herunterzuladen.Let's look at several ways to download blobs using AzCopy.

Herunterladen eines einzelnen BlobsDownload a single blob

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /Pattern:"abc.txt"

Beachten Sie, dass, AzCopy den Ordner C:\myfolder erstellt, wenn dieser noch nicht vorhanden ist, und abc.txt in den neuen Ordner herunterlädt.Note that if the folder C:\myfolder does not exist, AzCopy creates it and download abc.txt into the new folder.

Herunterladen eines einzelnen Blobs aus der sekundären RegionDownload a single blob from the secondary region

AzCopy /Source:https://myaccount-secondary.blob.core.windows.net/mynewcontainer /Dest:C:\myfolder /SourceKey:key /Pattern:"abc.txt"

Beachten Sie, dass georedundanter Speicher mit Lesezugriff aktiviert sein muss, damit Sie auf die sekundäre Region zugreifen können.Note that you must have read-access geo-redundant storage enabled to access the secondary region.

Herunterladen aller Blobs in einem ContainerDownload all blobs in a container

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /S

Nehmen Sie an, die folgenden BLOBs befinden sich im angegebenen Container:Assume the following blobs reside in the specified container:

abc.txt
abc1.txt
abc2.txt
vd1\a.txt
vd1\abcd.txt

Nach dem Herunterladen enthält das Verzeichnis C:\myfolder die folgenden Dateien:After the download operation, the directory C:\myfolder includes the following files:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt
C:\myfolder\vd1\a.txt
C:\myfolder\vd1\abcd.txt

Wenn Sie die Option /S nicht angeben, werden keine Blobs heruntergeladen.If you do not specify option /S, no blobs are downloaded.

Herunterladen von Blobs mit einem angegebenen PräfixDownload blobs with a specific prefix

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /Pattern:a /S

Nehmen Sie an, die folgenden BLOBs befinden sich im angegebenen Container.Assume the following blobs reside in the specified container. Alle Blobs, die mit dem Präfix a beginnen, werden heruntergeladen:All blobs beginning with the prefix a are downloaded:

abc.txt
abc1.txt
abc2.txt
xyz.txt
vd1\a.txt
vd1\abcd.txt

Nach dem Herunterladen enthält der Ordner C:\myfolder die folgenden Dateien:After the download operation, the folder C:\myfolder includes the following files:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt

Das Präfix gilt für das virtuelle Verzeichnis, das den ersten Teil des Blobnamens bildet.The prefix applies to the virtual directory, which forms the first part of the blob name. Im obigen Beispiel stimmt das virtuelle Verzeichnis nicht mit dem angegebenen Präfix überein. Daher wird es nicht heruntergeladen.In the example shown above, the virtual directory does not match the specified prefix, so it is not downloaded. Darüber hinaus lädt AzCopy keine Blobs herunter, wenn die Option /S nicht angegeben ist.In addition, if the option /S is not specified, AzCopy does not download any blobs.

Für exportierte Dateien und Quell-Blobs dieselbe Uhrzeit der letzten Änderung festlegenSet the last-modified time of exported files to be same as the source blobs

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /MT

Sie haben auch die Möglichkeit, Blobs auf Basis der Uhrzeit ihrer letzten Änderung vom Herunterladen auszuschließen.You can also exclude blobs from the download operation based on their last-modified time. Fügen Sie die Option /XN hinzu, falls Sie beispielsweise Blobs, deren Uhrzeit der letzten Änderung die gleiche oder eine spätere ist als die der Zieldatei, ausschließen wollen:For example, if you want to exclude blobs whose last modified time is the same or newer than the destination file, add the /XN option:

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /MT /XN

Fügen Sie die Option /XO hinzu, falls Sie Blobs, deren Uhrzeit der letzten Änderung die gleiche oder eine frühere ist als die der Zieldatei, ausschließen wollen:If you want to exclude blobs whose last modified time is the same or older than the destination file, add the /XO option:

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:key /MT /XO

Hochladen von Blobs in BlobspeicherUpload blobs to Blob storage

Betrachten wir nun mehrere Möglichkeiten, Blobs mithilfe von AzCopy hochzuladen.Let's look at several ways to upload blobs using AzCopy.

Hochladen eines einzelnen BlobsUpload a single blob

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Pattern:"abc.txt"

Wenn der angegebene Zielcontainer nicht vorhanden ist, wird er von AzCopy erstellt und die Datei anschließend in den Container hochgeladen.If the specified destination container does not exist, AzCopy creates it and uploads the file into it.

Hochladen eines einzelnen Blobs in ein virtuelles VerzeichnisUpload a single blob to a virtual directory

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer/vd /DestKey:key /Pattern:abc.txt

Wenn das angegebene virtuelle Verzeichnis nicht vorhanden ist, lädt AzCopy die Datei so hoch, dass das virtuelle Verzeichnis Teil ihres Namens ist (z.B. vd/abc.txt im obigen Beispiel).If the specified virtual directory does not exist, AzCopy uploads the file to include the virtual directory in its name (e.g., vd/abc.txt in the example above).

Hochladen aller Blobs in einem OrdnerUpload all blobs in a folder

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /S

Wenn Sie die Option /S angeben, werden die Inhalte des angegebenen Verzeichnisses rekursiv in den Blobspeicher hochgeladen. Das bedeutet, dass alle Unterordner und die darin enthaltenen Dateien ebenfalls hochgeladen werden.Specifying option /S uploads the contents of the specified directory to Blob storage recursively, meaning that all subfolders and their files are uploaded as well. Nehmen Sie z. B. an, die folgenden Dateien befinden sich im Ordner C:\myfolder:For instance, assume the following files reside in folder C:\myfolder:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt
C:\myfolder\subfolder\a.txt
C:\myfolder\subfolder\abcd.txt

Nach dem Hochladen enthält der Container die folgenden Dateien:After the upload operation, the container includes the following files:

abc.txt
abc1.txt
abc2.txt
subfolder\a.txt
subfolder\abcd.txt

Wenn Sie die Option /S nicht angeben, lädt AzCopy nicht rekursiv hoch.If you do not specify option /S, AzCopy does not upload recursively. Nach dem Hochladen enthält der Container die folgenden Dateien:After the upload operation, the container includes the following files:

abc.txt
abc1.txt
abc2.txt

Hochladen von Blobs, die mit einem bestimmten Muster übereinstimmenUpload blobs matching a specific pattern

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Pattern:a* /S

Nehmen Sie z. B. an, die folgenden Dateien befinden sich im Ordner C:\myfolder:Assume the following files reside in folder C:\myfolder:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt
C:\myfolder\xyz.txt
C:\myfolder\subfolder\a.txt
C:\myfolder\subfolder\abcd.txt

Nach dem Hochladen enthält der Container die folgenden Dateien:After the upload operation, the container includes the following files:

abc.txt
abc1.txt
abc2.txt
subfolder\a.txt
subfolder\abcd.txt

Wenn Sie die Option /S nicht angeben, lädt AzCopy nur die Blobs hoch, die sich nicht in einem virtuellen Verzeichnis befinden:If you do not specify option /S, AzCopy only uploads blobs that don't reside in a virtual directory:

C:\myfolder\abc.txt
C:\myfolder\abc1.txt
C:\myfolder\abc2.txt

Angeben des MIME-Inhaltstyps für Ziel-BlobsSpecify the MIME content type of a destination blob

AzCopy legt den Inhaltstyp eines Zielblobs standardmäßig als application/octet-streamfest.By default, AzCopy sets the content type of a destination blob to application/octet-stream. Ab Version 3.1.0 können Sie den Inhaltstyp mit der Option /SetContentType:[content-type]explizit angeben.Beginning with version 3.1.0, you can explicitly specify the content type via the option /SetContentType:[content-type]. Mit dieser Syntax wird der Inhaltstyp für alle Blobs in einem Hochladevorgang festgelegt.This syntax sets the content type for all blobs in an upload operation.

AzCopy /Source:C:\myfolder\ /Dest:https://myaccount.blob.core.windows.net/myContainer/ /DestKey:key /Pattern:ab /SetContentType:video/mp4

Wenn Sie für /SetContentType keinen Wert angeben, legt AzCopy den Inhaltstyp jedes Blobs und jeder Datei gemäß der jeweiligen Dateierweiterung fest.If you specify /SetContentType without a value, AzCopy sets each blob or file's content type according to its file extension.

AzCopy /Source:C:\myfolder\ /Dest:https://myaccount.blob.core.windows.net/myContainer/ /DestKey:key /Pattern:ab /SetContentType

Kopieren von Blobs in BlobspeicherCopy blobs in Blob storage

Betrachten wir nun mehrere Möglichkeiten, Blobs mithilfe von AzCopy aus einem Speicherort in einen anderen zu kopieren.Let's look at several ways to copy blobs from one location to another using AzCopy.

Kopieren eines einzelnen Blobs aus einem Container in einen anderen innerhalb desselben SpeicherkontosCopy a single blob from one container to another within the same storage account

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1 /Dest:https://myaccount.blob.core.windows.net/mycontainer2 /SourceKey:key /DestKey:key /Pattern:abc.txt

Wenn Sie einen Blob innerhalb eines Azure Storage-Kontos kopieren, wird ein serverseitiger Kopier -Vorgang ausgeführt.When you copy a blob within a Storage account, a server-side copy operation is performed.

Kopieren eines einzelnen Blobs aus einem Speicherkonto in ein anderesCopy a single blob from one storage account to another

AzCopy /Source:https://sourceaccount.blob.core.windows.net/mycontainer1 /Dest:https://destaccount.blob.core.windows.net/mycontainer2 /SourceKey:key1 /DestKey:key2 /Pattern:abc.txt

Wenn Sie einen Blob zwischen Azure Storage-Konten kopieren, wird ein serverseitiger Kopier -Vorgang ausgeführt.When you copy a blob across Storage accounts, a server-side copy operation is performed.

Kopieren eines einzelnen Blobs von der sekundären Region in die primäre RegionCopy a single blob from the secondary region to the primary region

AzCopy /Source:https://myaccount1-secondary.blob.core.windows.net/mynewcontainer1 /Dest:https://myaccount2.blob.core.windows.net/mynewcontainer2 /SourceKey:key1 /DestKey:key2 /Pattern:abc.txt

Beachten Sie, dass georedundanter Speicher mit Lesezugriff aktiviert sein muss, damit Sie auf den sekundären Speicher zugreifen können.Note that you must have read-access geo-redundant storage enabled to access secondary storage.

Kopieren eines einzelnen Blobs und seiner Momentaufnahmen aus einem Speicherkonto in ein anderesCopy a single blob and its snapshots from one storage account to another

AzCopy /Source:https://sourceaccount.blob.core.windows.net/mycontainer1 /Dest:https://destaccount.blob.core.windows.net/mycontainer2 /SourceKey:key1 /DestKey:key2 /Pattern:abc.txt /Snapshot

Nach dem Kopiervorgang enthält der Zielcontainer den Blob und seine Momentaufnahmen.After the copy operation, the target container includes the blob and its snapshots. Unter der Annahme, dass das Blob im obigen Beispiel zwei Momentaufnahmen aufweist, enthält der Container folgendes Blob und folgende Momentaufnahmen:Assuming the blob in the example above has two snapshots, the container includes the following blob and snapshots:

abc.txt
abc (2013-02-25 080757).txt
abc (2014-02-21 150331).txt

Kopieren aller Blobs in einem Container in ein anderes SpeicherkontoCopy all blobs in a container to another storage account

AzCopy /Source:https://sourceaccount.blob.core.windows.net/mycontainer1 
/Dest:https://destaccount.blob.core.windows.net/mycontainer2 /SourceKey:key1 /DestKey:key2 /S

Bei Angabe der Option „/S“ werden die Inhalte des angegebenen Containers rekursiv hochgeladen.Specifying option /S uploads the contents of the specified container recursively. Unter Upload all blobs in a folder (Hochladen aller Blobs in einem Ordner) finden Sie weitere Informationen und ein Beispiel.See Upload all blobs in a folder for more information and an example.

Synchrones Kopieren von Blobs aus einem Speicherkonto in ein anderesSynchronously copy blobs from one storage account to another

Standardmäßig kopiert AzCopy Daten zwischen zwei Speicherendpunkten auf asynchrone Weise.AzCopy by default copies data between two storage endpoints asynchronously. Der Kopiervorgang wird also im Hintergrund ausgeführt und verwendet nur nicht reservierte Bandbreite, für die bezüglich der Kopiergeschwindigkeit für Blobs kein SLA besteht. AzCopy überprüft den Kopierstatus regelmäßig, bis der Vorgang erfolgreich oder mit einem Fehler beendet wird.Therefore, the copy operation runs in the background using spare bandwidth capacity that has no SLA in terms of how fast a blob is copied, and AzCopy periodically checks the copy status until the copying is completed or failed.

Die Option /SyncCopy gewährleistet, dass der jeweilige Kopiervorgang mit gleichmäßiger Geschwindigkeit erfolgt.The /SyncCopy option ensures that the copy operation gets consistent speed. Beim synchronen Kopieren lädt AzCopy die zu kopierenden Blobs aus der angegebenen Quelle in den lokalen Arbeitsspeicher herunter und dann in das Speicherziel des jeweiligen Blobs hoch.AzCopy performs the synchronous copy by downloading the blobs to copy from the specified source to local memory, and then uploading them to the Blob storage destination.

AzCopy /Source:https://myaccount1.blob.core.windows.net/myContainer/ /Dest:https://myaccount2.blob.core.windows.net/myContainer/ /SourceKey:key1 /DestKey:key2 /Pattern:ab /SyncCopy

Anders als beim asynchronen Kopieren kann es bei der Verwendung von /SyncCopy zu Zusatzkosten für den ausgehenden Datenverkehr kommen. Um dies zu vermeiden, sollten Sie diese Option in einer Azure VM verwenden, die sich in derselben Region wie das Storage-Quellkonto befindet./SyncCopy might generate additional egress cost compared to asynchronous copy, the recommended approach is to use this option in an Azure VM that is in the same region as your source storage account to avoid egress cost.

Herunterladen von Dateien aus dem DateispeicherDownload files from File storage

Betrachten wir nun mehrere Möglichkeiten, Dateien mithilfe von AzCopy herunterzuladen.Let's look at several ways to download files using AzCopy.

Herunterladen einer einzelnen DateiDownload a single file

AzCopy /Source:https://myaccount.file.core.windows.net/myfileshare/myfolder1/ /Dest:C:\myfolder /SourceKey:key /Pattern:abc.txt

Wenn es sich bei der angegebenen Quelle um eine Azure-Dateifreigabe handelt, müssen Sie entweder den genauen Dateinamen angeben (z.B. abc.txt), um eine einzelne Datei herunterzuladen, oder die Option /S, um alle Dateien in der Freigabe rekursiv herunterzuladen.If the specified source is an Azure file share, then you must either specify the exact file name, (e.g. abc.txt) to download a single file, or specify option /S to download all files in the share recursively. Wenn Sie sowohl ein Dateimuster als auch die Option /S angeben, führt dies zu einem Fehler.Attempting to specify both a file pattern and option /S together results in an error.

Herunterladen aller Dateien in einem VerzeichnisDownload all files in a directory

AzCopy /Source:https://myaccount.file.core.windows.net/myfileshare/ /Dest:C:\myfolder /SourceKey:key /S

Beachten Sie, dass leere Ordner nicht heruntergeladen werden.Note that empty folders are not downloaded.

Hochladen von Dateien in eine Azure-DateifreigabeUpload files to an Azure file share

Betrachten wir nun mehrere Möglichkeiten, Dateien mithilfe von AzCopy hochzuladen.Let's look at several ways to upload files using AzCopy.

Hochladen einer einzelnen DateiUpload a single file

AzCopy /Source:C:\myfolder /Dest:https://myaccount.file.core.windows.net/myfileshare/ /DestKey:key /Pattern:abc.txt

Hochladen aller Dateien in einem OrdnerUpload all files in a folder

AzCopy /Source:C:\myfolder /Dest:https://myaccount.file.core.windows.net/myfileshare/ /DestKey:key /S

Beachten Sie, dass leere Ordner nicht hochgeladen werden.Note that empty folders are not uploaded.

Hochladen von Dateien, die mit einem bestimmten Muster übereinstimmenUpload files matching a specific pattern

AzCopy /Source:C:\myfolder /Dest:https://myaccount.file.core.windows.net/myfileshare/ /DestKey:key /Pattern:ab* /S

Kopieren von Dateien in den DateispeicherCopy files in File storage

Betrachten wir nun mehrere Möglichkeiten, Dateien mithilfe von AzCopy in eine Azure-Dateifreigabe zu kopieren.Let's look at several ways to copy files in an Azure file share using AzCopy.

Kopieren aus einer Dateifreigabe in eine andereCopy from one file share to another

AzCopy /Source:https://myaccount1.file.core.windows.net/myfileshare1/ /Dest:https://myaccount2.file.core.windows.net/myfileshare2/ /SourceKey:key1 /DestKey:key2 /S

Wenn Sie eine Datei zwischen Dateifreigaben kopieren, wird ein serverseitiger Kopiervorgang ausgeführt.When you copy a file across file shares, a server-side copy operation is performed.

Kopieren von Dateien aus einer Azure-Dateifreigabe in Blob StorageCopy from an Azure file share to Blob storage

AzCopy /Source:https://myaccount1.file.core.windows.net/myfileshare/ /Dest:https://myaccount2.blob.core.windows.net/mycontainer/ /SourceKey:key1 /DestKey:key2 /S

Wenn Sie eine Datei von einer Dateifreigabe in ein Blob kopieren, wird ein serverseitiger Kopiervorgang ausgeführt.When you copy a file from file share to blob, a server-side copy operation is performed.

Kopieren eines Blobs aus Blob Storage in eine Azure-DateifreigabeCopy a blob from Blob storage to an Azure file share

AzCopy /Source:https://myaccount1.blob.core.windows.net/mycontainer/ /Dest:https://myaccount2.file.core.windows.net/myfileshare/ /SourceKey:key1 /DestKey:key2 /S

Wenn Sie eine Datei aus einem Blob in eine Dateifreigabe kopieren, wird ein serverseitiger Kopiervorgang ausgeführt.When you copy a file from a blob to a file share, a server-side copy operation is performed.

Synchrones Kopieren von DateienSynchronously copy files

Sie können die Option /SyncCopy angeben, um Daten synchron aus einem File Storage in einen anderen File Storage, aus einem File Storage in einen Blob Storage oder aus einem Blob Storage in einen File Storage zu kopieren. AzCopy lädt dazu die Quelldaten in den lokalen Arbeitsspeicher herunter, um diese dann wieder in das Ziel hochzuladen.You can specify the /SyncCopy option to copy data from File Storage to File Storage, from File Storage to Blob Storage and from Blob Storage to File Storage synchronously, AzCopy does this by downloading the source data to local memory and upload it again to destination. Es gelten die Standardausgangskosten.Standard egress cost applies.

AzCopy /Source:https://myaccount1.file.core.windows.net/myfileshare1/ /Dest:https://myaccount2.file.core.windows.net/myfileshare2/ /SourceKey:key1 /DestKey:key2 /S /SyncCopy

Der Standardblobtyp beim Kopieren aus einem Dateispeicher in einen Blobspeicher ist das Blockblob. Benutzer können die Option /BlobType:page angeben, um den Zielblobtyp zu ändern.When copying from File storage to Blob storage, the default blob type is block blob; the user can specify the option /BlobType:page to change the destination blob type.

Beachten Sie, dass /SyncCopy im Vergleich zum asynchronen Kopieren zusätzliche Ausgangskosten verursachen kann.Note that /SyncCopy might generate additional egress costs compared to asynchronous copy. Um Ausgangskosten zu vermeiden, sollten Sie diese Option bei einer Azure-VM verwenden, die sich in derselben Region wie das Quellspeicherkonto befindet.The recommended approach is to use this option in the Azure VM which is in the same region as your source storage account to avoid egress cost.

Exportieren von Daten aus dem TabellenspeicherExport data from Table storage

Werfen wir nun einen Blick auf das Exportieren von Daten aus dem Azure-Tabellenspeicher mit AzCopy.Let's take a look at exporting data from Azure Table storage using AzCopy.

Exportieren einer TabelleExport a table

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key

AzCopy schreibt eine Manifestdatei in den angegebenen Zielordner.AzCopy writes a manifest file to the specified destination folder. Die Manifestdatei wird beim Importvorgang verwendet, um die erforderlichen Datendateien zu finden, und um die Datenüberprüfung durchzuführen.The manifest file is used in the import process to locate the necessary data files and perform data validation. Für die Manifestdatei wird standardmäßig die folgende Namenskonvention verwendet:The manifest file uses the following naming convention by default:

<account name>_<table name>_<timestamp>.manifest

Ein Benutzer kann auch die Option /Manifest:<manifest file name> angeben, um den Namen der Manifestdatei festzulegen.User can also specify the option /Manifest:<manifest file name> to set the manifest file name.

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key /Manifest:abc.manifest

Aufteilen eines Exports aus dem Tabellenspeicher auf mehrere DateienSplit an export from Table storage into multiple files

AzCopy /Source:https://myaccount.table.core.windows.net/mytable/ /Dest:C:\myfolder /SourceKey:key /S /SplitSize:100

AzCopy verwendet einen Volumeindex in den Dateinamen für die Aufteilungsdaten zum Unterscheiden mehrerer Dateien.AzCopy uses a volume index in the split data file names to distinguish multiple files. Der Volumeindex besteht aus zwei Teilen, einem Partitionsschlüsselbereichs-Index und einem Aufteilungsdateiindex.The volume index consists of two parts, a partition key range index and a split file index. Beide Indizes sind nullbasiert.Both indexes are zero-based.

Der Partitionsschlüsselbereichs-Index ist 0, wenn der Benutzer die Option /PKRS nicht angibt.The partition key range index is 0 if the user does not specify option /PKRS.

Angenommen, AzCopy generiert zwei Datendateien, nachdem der Benutzer die Option /SplitSizeangegeben hat.For instance, suppose AzCopy generates two data files after the user specifies option /SplitSize. Die daraus resultierenden Datendateinamen könnten wie folgt aussehen:The resulting data file names might be:

myaccount_mytable_20140903T051850.8128447Z_0_0_C3040FE8.json
myaccount_mytable_20140903T051850.8128447Z_0_1_0AB9AC20.json

Beachten Sie, dass der zulässige Mindestwert für die Option /SplitSize 32 MB lautet.Note that the minimum possible value for option /SplitSize is 32MB. Wenn es sich beim angegebenen Ziel um Blobspeicher handelt, teilt AzCopy die Datendatei auf, sobald die Größe die Blobgrößenbegrenzung (200 GB) erreicht, und zwar unabhängig davon, ob die Option /SplitSize angegeben wurde.If the specified destination is Blob storage, AzCopy splits the data file once its sizes reaches the blob size limitation (200GB), regardless of whether option /SplitSize has been specified by the user.

Exportieren einer Tabelle in das JSON- oder CSV-DatendateiformatExport a table to JSON or CSV data file format

AzCopy exportiert Tabellen standardmäßig als JSON-Datendateien.By default, AzCopy exports tables to JSON data files. Sie können mit der Option /PayloadFormat:JSON|CSV angeben, ob die Tabellen als JSON oder CSV exportiert werden sollen.You can specify the option /PayloadFormat:JSON|CSV to export the tables as JSON or CSV.

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key /PayloadFormat:CSV

Wenn das CSV-Nutzlastformat angegeben wird, generiert AzCopy auch eine Schemadatei mit der Dateierweiterung .schema.csv für jede Datendatei.When specifying the CSV payload format, AzCopy also generates a schema file with file extension .schema.csv for each data file.

Zeitgleiches Exportieren von TabellenentitätenExport table entities concurrently

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:C:\myfolder\ /SourceKey:key /PKRS:"aa#bb"

AzCopy startet gleichzeitige Vorgänge zum Exportieren von Entitäten, wenn der Benutzer die Option /PKRS angibt.AzCopy starts concurrent operations to export entities when the user specifies option /PKRS. Jeder Vorgang exportiert einen Partitionsschlüsselbereich.Each operation exports one partition key range.

Beachten Sie, dass die Anzahl gleichzeitiger Vorgänge auch durch die Option /NCgesteuert wird.Note that the number of concurrent operations is also controlled by option /NC. AzCopy verwendet beim Kopieren von Tabellenentitäten die Anzahl der Core-Prozessoren als den Standardwert von /NC, selbst wenn /NC nicht angegeben wurde.AzCopy uses the number of core processors as the default value of /NC when copying table entities, even if /NC was not specified. Wenn der Benutzer die Option /PKRSangibt, verwendet AzCopy den kleineren der beiden Werte (Partitionsschlüsselbereich im Vergleich zu implizit oder explizit angegebenen gleichzeitigen Vorgängen), um die Anzahl der zu startenden gleichzeitigen Vorgänge zu bestimmen.When the user specifies option /PKRS, AzCopy uses the smaller of the two values - partition key ranges versus implicitly or explicitly specified concurrent operations - to determine the number of concurrent operations to start. Geben Sie Geben Sie AzCopy /?:NC an der Befehlszeile ein, um weitere Informationen zu erhalten.For more details, type AzCopy /?:NC at the command line.

Exportieren einer Tabelle in den BlobspeicherExport a table to Blob storage

AzCopy /Source:https://myaccount.table.core.windows.net/myTable/ /Dest:https://myaccount.blob.core.windows.net/mycontainer/ /SourceKey:key1 /Destkey:key2

AzCopy generiert eine JSON-Datendatei im Blobcontainer mit der folgenden Namenskonvention:AzCopy generates a JSON data file into the blob container with following naming convention:

<account name>_<table name>_<timestamp>_<volume index>_<CRC>.json

Die generierte JSON-Datendatei folgt dem Nutzlastformat für minimale Metadaten.The generated JSON data file follows the payload format for minimal metadata. Details in Bezug auf dieses Nutzlastformat finden Sie unter Nutzlastformat für Tabellendienstvorgänge.For details on this payload format, see Payload Format for Table Service Operations.

Beachten Sie, dass AzCopy beim Export von Tabellen in Blobs die Tabellenentitäten in die lokalen temporären Datendateien herunterlädt und diese Entitäten dann in das Blob hochlädt.Note that when exporting tables to blobs, AzCopy downloads the Table entities to local temporary data files and then uploads those entities to the blob. Diese temporären Datendateien werden im Journaldateiordner mit dem Standardpfad %LocalAppData%\Microsoft\Azure\AzCopy gespeichert. Sie können die Option „/Z:[Journaldateiordner]“ angeben, um den Journaldateiordner-Speicherort und damit den temporären Speicherort für Datendateien zu ändern.These temporary data files are put into the journal file folder with the default path "%LocalAppData%\Microsoft\Azure\AzCopy", you can specify option /Z:[journal-file-folder] to change the journal file folder location and thus change the temporary data files location. Die Größe der temporären Datendateien wird durch die Tabellenentitäten und die Größe bestimmt, die Sie mit der Option „/SplitSize“ angegeben haben. Auch wenn die temporäre Datei auf dem lokalen Datenträger sofort gelöscht wird, sobald sie in das Blob hochgeladen wurde, sollten Sie sicherstellen, dass Sie über genügend lokalen Speicherplatz für diese temporären Datendateien verfügen, bevor sie gelöscht werden.The temporary data files' size is decided by your table entities' size and the size you specified with the option /SplitSize, although the temporary data file in local disk is deleted instantly once it has been uploaded to the blob, please make sure you have enough local disk space to store these temporary data files before they are deleted.

Importieren von Daten in den TabellenspeicherImport data into Table storage

Werfen wir nun einen Blick auf das Importieren von Daten in den Azure-Tabellenspeicher mit AzCopy.Let's take a look at importing data into Azure Table storage using AzCopy.

Importieren einer TabelleImport a table

AzCopy /Source:C:\myfolder\ /Dest:https://myaccount.table.core.windows.net/mytable1/ /DestKey:key /Manifest:"myaccount_mytable_20140103T112020.manifest" /EntityOperation:InsertOrReplace

Die Option /EntityOperation gibt an, wie Entitäten in die Tabelle eingefügt werden.The option /EntityOperation indicates how to insert entities into the table. Mögliche Werte:Possible values are:

  • InsertOrSkip: Überspringt eine vorhandene Entität oder fügt eine neue Entität ein, wenn sie in der Tabelle nicht vorhanden ist.InsertOrSkip: Skips an existing entity or inserts a new entity if it does not exist in the table.
  • InsertOrMerge: Führt eine vorhandene Entität zusammen oder fügt eine neue Entität ein, wenn sie in der Tabelle nicht vorhanden ist.InsertOrMerge: Merges an existing entity or inserts a new entity if it does not exist in the table.
  • InsertOrReplace: Ersetzt eine vorhandene Entität oder fügt eine neue Entität ein, wenn sie in der Tabelle nicht vorhanden ist.InsertOrReplace: Replaces an existing entity or inserts a new entity if it does not exist in the table.

Beachten Sie, dass Sie die Option /PKRS im Importszenario nicht angeben können.Note that you cannot specify option /PKRS in the import scenario. Im Gegensatz zum Exportszenario, in dem Sie die Option /PKRS zum Starten gleichzeitiger Vorgänge angeben müssen, startet AzCopy beim Importieren einer Tabelle standardmäßig gleichzeitige Vorgänge.Unlike the export scenario, in which you must specify option /PKRS to start concurrent operations, AzCopy starts concurrent operations by default when you import a table. Die standardmäßige Anzahl gleichzeitig gestarteter Vorgänge entspricht der Anzahl an Core-Prozessoren. Sie können jedoch eine unterschiedliche Anzahl gleichzeitiger Vorgänge mit der Option /NC angeben.The default number of concurrent operations started is equal to the number of core processors; however, you can specify a different number of concurrent with option /NC. Geben Sie Geben Sie AzCopy /?:NC an der Befehlszeile ein, um weitere Informationen zu erhalten.For more details, type AzCopy /?:NC at the command line.

Beachten Sie, dass AzCopy nur den Import für JSON, nicht aber für CSV unterstützt.Note that AzCopy only supports importing for JSON, not CSV. AzCopy unterstützt keine Tabellenimporte aus von Benutzern erstellten JSON- und Manifestdateien.AzCopy does not support table imports from user-created JSON and manifest files. Beide Dateien müssen aus einem AzCopy-Tabellenexport stammen.Both of these files must come from an AzCopy table export. Ändern Sie weder die exportierte JSON-Datei noch die exportierte Manifestdatei, um Fehler zu vermeiden.To avoid errors, please do not modify the exported JSON or manifest file.

Importieren von Entitäten aus dem Blobspeicher in eine TabelleImport entities into a table from Blob storage

Angenommen, ein Blobcontainer enthält folgende Dateien: eine JSON-Datei, die eine Azure-Tabelle darstellt, und deren Manifestdatei.Assume a Blob container contains the following: A JSON file representing an Azure Table and its accompanying manifest file.

myaccount_mytable_20140103T112020.manifest
myaccount_mytable_20140103T112020_0_0_0AF395F1DC42E952.json

Sie können den folgenden Befehl ausführen, um Entitäten mithilfe der Manifestdatei im Blobcontainer in eine Tabelle zu importieren:You can run the following command to import entities into a table using the manifest file in that blob container:

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer /Dest:https://myaccount.table.core.windows.net/mytable /SourceKey:key1 /DestKey:key2 /Manifest:"myaccount_mytable_20140103T112020.manifest" /EntityOperation:"InsertOrReplace"

Andere AzCopy-FunktionenOther AzCopy features

Werfen wir nun einen Blick auf einige andere AzCopy-Features.Let's take a look at some other AzCopy features.

Nur Daten kopieren, die im Ziel nicht vorhanden sind.Only copy data that doesn't exist in the destination

Die Parameter /XO und /XN erlauben Ihnen, jeweils ältere oder neuere Quellressourcen vom Kopieren auszuschließen.The /XO and /XN parameters allow you to exclude older or newer source resources from being copied, respectively. Falls Sie nur Quellressourcen kopieren wollen, die im Ziel nicht existieren, können Sie beide Parameter im AzCopy-Befehl angeben.If you only want to copy source resources that don't exist in the destination, you can specify both parameters in the AzCopy command:

/Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:<sourcekey> /S /XO /XN

/Source:C:\myfolder /Dest:http://myaccount.file.core.windows.net/myfileshare /DestKey:<destkey> /S /XO /XN

/Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:http://myaccount.blob.core.windows.net/mycontainer1 /SourceKey:<sourcekey> /DestKey:<destkey> /S /XO /XN

Beachten Sie, dass dies nicht unterstützt wird, wenn es sich bei Quelle oder Ziel um eine Tabelle handelt.Note that this is not supported when either the source or destination is a table.

Verwenden einer Antwortdatei zum Angeben von BefehlszeilenparameternUse a response file to specify command-line parameters

AzCopy /@:"C:\responsefiles\copyoperation.txt"

Sie können beliebige AzCopy-Befehlszeilenparameter in eine Antwortdatei einfügen.You can include any AzCopy command-line parameters in a response file. AzCopy verarbeitet die Parameter in der Datei ebenso wie bei der Angabe über die Befehlszeile, wobei mit den Inhalten der Datei ein direkter Austausch erfolgt.AzCopy processes the parameters in the file as if they had been specified on the command line, performing a direct substitution with the contents of the file.

Nehmen wir an, eine Antwortdatei namens copyoperation.txtenthält die folgenden Zeilen.Assume a response file named copyoperation.txt, that contains the following lines. Jeder AzCopy-Parameter kann in einer einzelnen Zeile angegeben werdenEach AzCopy parameter can be specified on a single line

/Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:<sourcekey> /S /Y

oder in verschiedenen Zeilen:or on separate lines:

/Source:http://myaccount.blob.core.windows.net/mycontainer
/Dest:C:\myfolder
/SourceKey:<sourcekey>
/S
/Y

Wenn Sie den Parameter auf zwei Zeilen verteilen, tritt bei der Ausführung von AzCopy ein Fehler auf, wie hier für den Parameter /sourcekey dargestellt:AzCopy fails if you split the parameter across two lines, as shown here for the /sourcekey parameter:

http://myaccount.blob.core.windows.net/mycontainer
 C:\myfolder
/sourcekey:
<sourcekey>
/S
/Y

Verwenden von mehreren Antwortdateien zum Angeben der BefehlszeilenparameterUse multiple response files to specify command-line parameters

Nehmen wir an, eine Antwortdatei namens source.txt gibt einen Quellcontainer an:Assume a response file named source.txt that specifies a source container:

/Source:http://myaccount.blob.core.windows.net/mycontainer

Und eine Antwortdatei namens dest.txt gibt einen Zielordner im Dateisystem an:And a response file named dest.txt that specifies a destination folder in the file system:

/Dest:C:\myfolder

Und eine Antwortdatei namens options.txt gibt die Optionen für AzCopy an:And a response file named options.txt that specifies options for AzCopy:

/S /Y

Verwenden Sie den folgenden Befehl, um AzCopy mit diesen Antwortdateien aufzurufen, die sich jeweils im Verzeichnis C:\responsefilesbefinden:To call AzCopy with these response files, all of which reside in a directory C:\responsefiles, use this command:

AzCopy /@:"C:\responsefiles\source.txt" /@:"C:\responsefiles\dest.txt" /SourceKey:<sourcekey> /@:"C:\responsefiles\options.txt"   

AzCopy verarbeitet diesen Befehl auf dieselbe Weise wie bei der Angabe der einzelnen Parameter in der Befehlszeile:AzCopy processes this command just as it would if you included all of the individual parameters on the command line:

AzCopy /Source:http://myaccount.blob.core.windows.net/mycontainer /Dest:C:\myfolder /SourceKey:<sourcekey> /S /Y

Angeben einer Shared Access Signature (SAS)Specify a shared access signature (SAS)

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1 /Dest:https://myaccount.blob.core.windows.net/mycontainer2 /SourceSAS:SAS1 /DestSAS:SAS2 /Pattern:abc.txt

Sie können auch eine SAS in der Container-URI angeben:You can also specify a SAS on the container URI:

AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1/?SourceSASToken /Dest:C:\myfolder /S

JournaldateiordnerJournal file folder

Sobald ein Befehl für AzCopy ausgeführt wird, prüft es, ob eine Journaldatei im Standardordner oder in einem Ordner vorhanden ist, den Sie über diese Option angegeben haben.Each time you issue a command to AzCopy, it checks whether a journal file exists in the default folder, or whether it exists in a folder that you specified via this option. Wenn die Journaldatei in keinem dieser Ordner vorhanden ist, behandelt AzCopy diesen Vorgang als neuen Vorgang und generiert somit eine neue Journaldatei.If the journal file does not exist in either place, AzCopy treats the operation as new and generates a new journal file.

Wenn die Journaldatei vorhanden ist, prüft AzCopy, ob die von Ihnen eingegebene Befehlszeile mit der Befehlszeile in der Journaldatei übereinstimmt.If the journal file does exist, AzCopy checks whether the command line that you input matches the command line in the journal file. Wenn die beiden Befehlszeilen übereinstimmen, setzt AzCopy den unvollständigen Vorgang fort.If the two command lines match, AzCopy resumes the incomplete operation. Wenn sie nicht übereinstimmen, werden Sie aufgefordert, entweder die Journaldatei zu überschreiben, um einen neuen Vorgang zu starten, oder den aktuellen Vorgang abzubrechen.If they do not match, you are prompted to either overwrite the journal file to start a new operation, or to cancel the current operation.

Falls Sie den Standardspeicherort für die Journaldatei verwenden wollen:If you want to use the default location for the journal file:

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Z

Wenn Sie die Option /Z auslassen oder die Option /Z ohne den Ordnerpfad angeben (wie oben gezeigt), dann erstellt AzCopy die Journaldatei am Standardspeicherort %SystemDrive%\Users\%username%\AppData\Local\Microsoft\Azure\AzCopy.If you omit option /Z, or specify option /Z without the folder path, as shown above, AzCopy creates the journal file in the default location, which is %SystemDrive%\Users\%username%\AppData\Local\Microsoft\Azure\AzCopy. Wenn die Journaldatei bereits vorhanden ist, setzt AzCopy den Vorgang auf Basis der Journaldatei fort.If the journal file already exists, then AzCopy resumes the operation based on the journal file.

Falls Sie einen benutzerdefinierten Speicherort für die Journaldatei angeben wollen:If you want to specify a custom location for the journal file:

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /Z:C:\journalfolder\

In diesem Beispiel wird die Journaldatei erstellt, sofern diese nicht bereits vorhanden ist.This example creates the journal file if it does not already exist. Wenn sie vorhanden ist, setzt AzCopy den Vorgang auf Basis der Journaldatei fort.If it does exist, then AzCopy resumes the operation based on the journal file.

Falls Sie einen AzCopy-Vorgang fortsetzen wollen:If you want to resume an AzCopy operation:

AzCopy /Z:C:\journalfolder\

In diesem Beispiel wird der letzte Vorgang fortgesetzt, der möglicherweise nicht abgeschlossen werden konnte.This example resumes the last operation, which may have failed to complete.

Generieren einer ProtokolldateiGenerate a log file

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /V

Wenn Sie die Option /V ohne einen Dateipfad zum ausführlichen Protokoll angeben, dann erstellt AzCopy die Protokolldatei am Standardspeicherort %SystemDrive%\Users\%username%\AppData\Local\Microsoft\Azure\AzCopy.If you specify option /V without providing a file path to the verbose log, then AzCopy creates the log file in the default location, which is %SystemDrive%\Users\%username%\AppData\Local\Microsoft\Azure\AzCopy.

Ansonsten können Sie eine Protokolldatei an einem benutzerdefinierten Speicherort erstellen:Otherwise, you can create an log file in a custom location:

AzCopy /Source:C:\myfolder /Dest:https://myaccount.blob.core.windows.net/mycontainer /DestKey:key /V:C:\myfolder\azcopy1.log

Wenn Sie nach der Option /V einen relativen Pfad angeben, z. B. /V:test/azcopy1.log, dann wird das ausführliche Protokoll im aktuellen Arbeitsverzeichnis in einem Unterordner namens test erstellt.Note that if you specify a relative path following option /V, such as /V:test/azcopy1.log, then the verbose log is created in the current working directory within a subfolder named test.

Angeben der Anzahl der zu startenden gleichzeitigen VorgängenSpecify the number of concurrent operations to start

Die Option /NC gibt die Anzahl der gleichzeitigen Kopiervorgänge an.Option /NC specifies the number of concurrent copy operations. AzCopy startet standardmäßig eine bestimmte Anzahl gleichzeitiger Vorgänge zum Erhöhen des Datenübertragungsdurchsatzes.By default, AzCopy starts a certain number of concurrent operations to increase the data transfer throughput. Bei Tabellenvorgängen entspricht die Anzahl gleichzeitiger Vorgänge der Anzahl der verfügbaren Prozessoren.For Table operations, the number of concurrent operations is equal to the number of processors you have. Bei Blob- und Dateivorgängen entspricht die Anzahl gleichzeitiger Vorgänge der achtfachen Anzahl der verfügbaren Prozessoren.For Blob and File operations, the number of concurrent operations is equal 8 times the number of processors you have. Wenn Sie AzCopy in einem Netzwerk mit geringer Bandbreite ausführen, können Sie eine niedrigere Anzahl für „/NC“ angeben, um Fehler durch gleichzeitig verwendete Ressourcen zu vermeiden.If you are running AzCopy across a low-bandwidth network, you can specify a lower number for /NC to avoid failure caused by resource competition.

Ausführen von AzCopy mit dem Azure-SpeicheremulatorRun AzCopy against the Azure Storage Emulator

Sie können AzCopy mit dem Azure-Speicheremulator für Blobs ausführen:You can run AzCopy against the Azure Storage Emulator for blobs:

AzCopy /Source:https://127.0.0.1:10000/myaccount/mycontainer/ /Dest:C:\myfolder /SourceKey:key /SourceType:Blob /S

Sie können das Programm auch für Tabellen ausführen:You can also run it for tables:

AzCopy /Source:https://127.0.0.1:10002/myaccount/mytable/ /Dest:C:\myfolder /SourceKey:key /SourceType:Table

Automatisches Festlegen des Inhaltstyps eines BlobsAutomatically determine Content Type of a Blob

AzCopy legt den Inhaltstyp eines Blobs anhand einer JSON-Datei fest, in der der Inhaltstyp für die Dateierweiterungszuordnung gespeichert wird.AzCopy determines content type of a blob based on a JSON file that stores content type to file extension mapping. Diese JSON-Datei heißt „AzCopyConfig.json“ und befindet sich im AzCopy-Verzeichnis.This JSON file is named AzCopyConfig.json, and is located in the AzCopy directory. Wenn Sie über einen Dateityp verfügen, der nicht in der Liste enthalten ist, können Sie die Zuordnung an die JSON-Datei anfügen:If you have a file type that is not in the list you can append the mapping to the JSON file:

{
  "MIMETypeMapping": {
    ".myext": "text/mycustomtype",
    .
    .
  }
}

Einführung in die ParameterAzCopy Parameters

Parameter für AzCopy werden unten beschrieben.Parameters for AzCopy are described below. Sie können auch einen der folgenden Befehle von der Befehlszeile für die Unterstützung in Bezug auf die Verwendung von AzCopy eingeben:You can also type one of the following commands from the command line for help in using AzCopy:

  • Für eine detaillierte Befehlszeilenhilfe für AzCopy: AzCopy /?For detailed command-line help for AzCopy: AzCopy /?
  • Für eine detaillierte Hilfe zu einzelnen AzCopy-Parametern: AzCopy /?:SourceKeyFor detailed help with any AzCopy parameter: AzCopy /?:SourceKey
  • Für Befehlszeilenbeispiele: AzCopy /?:SampleFor command-line examples: AzCopy /?:Sample

/Source: "Quelle"/Source:"source"

Gibt die Quelldaten an, aus denen kopiert werden soll.Specifies the source data from which to copy. Die Quelle kann ein Dateisystemverzeichnis, ein Blobcontainer, ein virtuelles Blobverzeichnis, eine Speicherdateifreigabe, ein Speicherdateiverzeichnis oder eine Azure-Tabelle sein.The source can be a file system directory, a blob container, a blob virtual directory, a storage file share, a storage file directory, or an Azure table.

Geltungsbereich: Blobs, Dateien, TabellenApplicable to: Blobs, Files, Tables

/Dest:"Ziel"/Dest:"destination"

Geben das Ziel für das Kopieren an.Specifies the destination to copy to. Das Ziel kann ein Dateisystemverzeichnis, ein Blobcontainer, ein virtuelles Blobverzeichnis, eine Speicherdateifreigabe, ein Speicherdateiverzeichnis oder eine Azure-Tabelle sein.The destination can be a file system directory, a blob container, a blob virtual directory, a storage file share, a storage file directory, or an Azure table.

Geltungsbereich: Blobs, Dateien, TabellenApplicable to: Blobs, Files, Tables

/Pattern:"Dateimuster"/Pattern:"file-pattern"

Gibt ein Dateimuster an, das angibt, welche Dateien kopiert werden sollen.Specifies a file pattern that indicates which files to copy. Das Verhalten des „/Pattern“-Parameters wird über den Speicherort der Quelldaten und über die Angabe der Option für den rekursiven Modus bestimmt.The behavior of the /Pattern parameter is determined by the location of the source data, and the presence of the recursive mode option. Der rekursive Modus wird über die Option „/S“ angegeben.Recursive mode is specified via option /S.

Wenn es sich bei der angegebenen Quelle um ein Verzeichnis im Dateisystem handelt, dann sind Standardplatzhalter wirksam und das bereitgestellte Dateimuster wird anhand von Dateien in diesem Verzeichnis verglichen.If the specified source is a directory in the file system, then standard wildcards are in effect, and the file pattern provided is matched against files within the directory. Wenn die Option „/S“ angegeben ist, vergleicht AzCopy das angegebene Muster auch mit allen Dateien in sämtlichen Unterordnern dieses Verzeichnisses.If option /S is specified, then AzCopy also matches the specified pattern against all files in any subfolders beneath the directory.

Wenn die angegebene Quelle ein BLOB-Container oder ein virtuelles Verzeichnis ist, werden keine Platzhalter angewendet.If the specified source is a blob container or virtual directory, then wildcards are not applied. Wenn die Option „/S“ angegeben ist, interpretiert AzCopy die angegebenen Dateimuster als Blobpräfix.If option /S is specified, then AzCopy interprets the specified file pattern as a blob prefix. Wenn die Option „/S“ nicht angegeben ist, vergleicht AzCopy die angegebenen Dateimuster mit den genauen Blobnamen.If option /S is not specified, then AzCopy matches the file pattern against exact blob names.

Wenn es sich bei der angegebenen Quelle um eine Azure-Dateifreigabe handelt, müssen Sie entweder den genauen Dateinamen (z. B. „abc.txt“) angeben, um eine einzelne Datei zu kopieren, oder die Option „/S“ angeben, um alle Dateien in der Freigabe rekursiv zu kopieren.If the specified source is an Azure file share, then you must either specify the exact file name, (e.g. abc.txt) to copy a single file, or specify option /S to copy all files in the share recursively. Wenn Sie sowohl ein Dateimuster als auch die Option „/S“ angeben, führt dies zu einem Fehler.Attempting to specify both a file pattern and option /S together results in an error.

AzCopy beachtet für das Abgleichen die Groß-/Kleinschreibung, wenn die Quelle (/Source) ein BLOB-Container oder ein virtuelles BLOB-Verzeichnis ist. In allen anderen Fällen wird die Groß-/Kleinschreibung nicht beachtet.AzCopy uses case-sensitive matching when the /Source is a blob container or blob virtual directory, and uses case-insensitive matching in all the other cases.

Wenn kein Dateimuster angegeben ist, ist das Standarddateimuster für einen Dateisystem-Speicherort auskennen.The default file pattern used when no file pattern is specified is . oder ein leeres Präfix für einen Azure Storage-Speicherort.for a file system location or an empty prefix for an Azure Storage location. Das Angeben mehrerer Dateimuster wird nicht unterstützt.Specifying multiple file patterns is not supported.

Geltungsbereich: Blobs, DateienApplicable to: Blobs, Files

/DestKey:"Speicherschlüssel"/DestKey:"storage-key"

Gibt den Speicherkontoschlüssel für die Zielressource an.Specifies the storage account key for the destination resource.

Geltungsbereich: Blobs, Dateien, TabellenApplicable to: Blobs, Files, Tables

/DestSAS:"SAS-Token"/DestSAS:"sas-token"

Gibt eine SAS (Shared Access Signature) mit LESE- und SCHREIB-Berechtigung für das Ziel an (falls zutreffend).Specifies a Shared Access Signature (SAS) with READ and WRITE permissions for the destination (if applicable). Schließen Sie die SAS in doppelte Anführungszeichen ein, da sie möglicherweise spezielle Befehlszeilenzeichen enthält.Surround the SAS with double quotes, as it may contains special command-line characters.

Wenn die Zielressource ein BLOB-Container, eine Dateifreigabe oder eine Tabelle ist, können Sie entweder diese Option gefolgt vom SAS-Token oder die SAS als Teil des Ziel-BLOB-Containers, der Dateifreigabe oder des URI der Tabelle ohne diese Option angeben.If the destination resource is a blob container, file share or table, you can either specify this option followed by the SAS token, or you can specify the SAS as part of the destination blob container, file share or table's URI, without this option.

Wenn es sich bei der Quelle und beim Ziel um Blobs handelt, muss sich das Zielblob im selben Speicherkonto wie das Quellblob befinden.If the source and destination are both blobs, then the destination blob must reside within the same storage account as the source blob.

Geltungsbereich: Blobs, Dateien, TabellenApplicable to: Blobs, Files, Tables

/SourceKey:"Speicherschlüssel"/SourceKey:"storage-key"

Gibt den Speicherkontoschlüssel für die Quellressource an.Specifies the storage account key for the source resource.

Geltungsbereich: Blobs, Dateien, TabellenApplicable to: Blobs, Files, Tables

/SourceSAS:"SAS-Token"/SourceSAS:"sas-token"

Gibt eine Shared Access Signature mit LESE- und AUFLISTUNGS-Berechtigung für die Quelle an (falls zutreffend).Specifies a Shared Access Signature with READ and LIST permissions for the source (if applicable). Schließen Sie die SAS in doppelte Anführungszeichen ein, da sie möglicherweise spezielle Befehlszeilenzeichen enthält.Surround the SAS with double quotes, as it may contains special command-line characters.

Wenn die Quellressource ein Blobcontainer ist und weder ein Schlüssel noch eine SAS angegeben wurde, wird der Blobcontainer über den anonymen Zugriff gelesen.If the source resource is a blob container, and neither a key nor a SAS is provided, then the blob container is read via anonymous access.

Wenn die Quelle eine Dateifreigabe oder Tabelle ist, muss ein Schlüssel oder eine SAS angegeben werden.If the source is a file share or table, a key or a SAS must be provided.

Geltungsbereich: Blobs, Dateien, TabellenApplicable to: Blobs, Files, Tables

/S/S

Gibt den rekursiven Modus für Kopiervorgänge an.Specifies recursive mode for copy operations. Im rekursiven Modus kopiert AzCopy alle Blobs oder Dateien, die mit dem angegebenen Dateimuster übereinstimmen, einschließlich der Blobs oder Dateien in den Unterordnern.In recursive mode, AzCopy copies all blobs or files that match the specified file pattern, including those in subfolders.

Geltungsbereich: Blobs, DateienApplicable to: Blobs, Files

/BlobType:"block" | "page" | "append"/BlobType:"block" | "page" | "append"

Gibt an, ob es sich beim Zielblob um ein Block-, Seiten- oder Anfügeblob handelt.Specifies whether the destination blob is a block blob, a page blob, or an append blob. Diese Option gilt nur, wenn Sie einen Blob hochladen.This option is applicable only when you are uploading a blob. Andernfalls tritt ein Fehler auf.Otherwise, an error is generated. Wenn das Ziel ein Blob ist und diese Option nicht angegeben wurde, erstellt AzCopy standardmäßig ein Blockblob.If the destination is a blob and this option is not specified, by default, AzCopy creates a block blob.

Geltungsbereich: Blobs (in englischer Sprache)Applicable to: Blobs

/CheckMD5/CheckMD5

Berechnet einen MD5-Hash für heruntergeladene Daten und überprüft, ob der in der Content-MD5-Eigenschaft des BLOBs oder der Datei gespeicherte MD5-Hash mit dem berechneten Hash übereinstimmt.Calculates an MD5 hash for downloaded data and verifies that the MD5 hash stored in the blob or file's Content-MD5 property matches the calculated hash. Wenn die Werte nicht übereinstimmen, tritt beim Herunterladen der Daten durch AzCopy ein Fehler auf.If the values do not match, AzCopy will fail to download the data. Die MD5-Prüfung ist standardmäßig deaktiviert, daher müssen Sie diese Option angeben, um die MD5-Prüfung beim Herunterladen von Daten auszuführen.The MD5 check is turned off by default, so you must specify this option to perform the MD5 check when downloading data.

Beachten Sie, dass Azure Storage nicht dafür garantiert, dass der für den BLOB oder die Datei gespeicherte MD5-Hash auf dem neuesten Stand ist.Note that Azure Storage doesn't guarantee that the MD5 hash stored for the blob or file is up-to-date. Der Client ist für die MD5-Aktualisierung zuständig, wenn der BLOB oder die Datei geändert wird.It is client's responsibility to update the MD5 whenever the blob or file is modified. Im Fall von Datenträgerimages (verwaltete oder nicht verwaltete Datenträger) aktualisieren virtuelle Azure-Computer den MD5-Wert nicht, wenn sich die Datenträgerinhalte ändern. Daher wird beim Herunterladen von Datenträgerimages von „/CheckMD5“ ein Fehler ausgegeben.In the case of disk images (managed or unmanaged disks), Azure VMs do not update the MD5 value as the disk contents change, hence /CheckMD5 will throw an error when downloading disk images.

AzCopy v8 legt die Content-MD5-Eigenschaft für ein Azure-Blob oder eine Azure-Datei immer fest, nachdem diese(s) in den Dienst hochgeladen wurde.AzCopy v8 always sets the Content-MD5 property for an Azure blob or file after uploading it to the service.

Geltungsbereich: Blobs, DateienApplicable to: Blobs, Files

/Snapshot/Snapshot

Gibt an, ob Momentaufnahmen übertragen werden.Indicates whether to transfer snapshots. Diese Option ist nur gültig, wenn es sich bei der Quelle um einen BLOB handelt.This option is only valid when the source is a blob.

Die übertragenen Blobmomentaufnahmen werden im folgenden Format umbenannt: „Blob-Name (Zeitpunkt-der-Momentaufnahme).Erweiterung“.The transferred blob snapshots are renamed in this format: blob-name (snapshot-time).extension

Momentaufnahmen werden standardmäßig nicht kopiert.By default, snapshots are not copied.

Geltungsbereich: Blobs (in englischer Sprache)Applicable to: Blobs

/V:[Ausführliche Protokolldatei]/V:[verbose-log-file]

Gibt ausführliche Statusmeldungen in eine Protokolldatei aus.Outputs verbose status messages into a log file.

Die ausführliche Protokolldatei erhält in %LocalAppData%\Microsoft\Azure\AzCopystandardmäßig die Bezeichnung „AzCopyVerbose.log“.By default, the verbose log file is named AzCopyVerbose.log in %LocalAppData%\Microsoft\Azure\AzCopy. Wenn Sie für diese Option einen vorhandenen Dateispeicherort angeben, wird das ausführliche Protokoll an diese Datei angefügt.If you specify an existing file location for this option, the verbose log is appended to that file.

Geltungsbereich: Blobs, Dateien, TabellenApplicable to: Blobs, Files, Tables

/Z:[Journaldatei-Ordner]/Z:[journal-file-folder]

Gibt einen Journaldateiordner zum Fortsetzen eines Vorgangs an.Specifies a journal file folder for resuming an operation.

AzCopy unterstützt die Fortsetzung immer, wenn ein Vorgang unterbrochen wurde.AzCopy always supports resuming if an operation has been interrupted.

Wenn diese Option nicht oder ohne Ordnerpfad angegeben wird, erstellt AzCopy die Journaldatei am Standardspeicherort „%LocalAppData%\Microsoft\Azure\AzCopy“.If this option is not specified, or it is specified without a folder path, then AzCopy creates the journal file in the default location, which is %LocalAppData%\Microsoft\Azure\AzCopy.

Sobald ein Befehl für AzCopy ausgeführt wird, prüft es, ob eine Journaldatei im Standardordner oder in einem Ordner vorhanden ist, den Sie über diese Option angegeben haben.Each time you issue a command to AzCopy, it checks whether a journal file exists in the default folder, or whether it exists in a folder that you specified via this option. Wenn die Journaldatei in keinem dieser Ordner vorhanden ist, behandelt AzCopy diesen Vorgang als neuen Vorgang und generiert somit eine neue Journaldatei.If the journal file does not exist in either place, AzCopy treats the operation as new and generates a new journal file.

Wenn die Journaldatei vorhanden ist, prüft AzCopy, ob die von Ihnen eingegebene Befehlszeile mit der Befehlszeile in der Journaldatei übereinstimmt.If the journal file does exist, AzCopy checks whether the command line that you input matches the command line in the journal file. Wenn die beiden Befehlszeilen übereinstimmen, setzt AzCopy den unvollständigen Vorgang fort.If the two command lines match, AzCopy resumes the incomplete operation. Wenn sie nicht übereinstimmen, werden Sie aufgefordert, entweder die Journaldatei zu überschreiben, um einen neuen Vorgang zu starten, oder den aktuellen Vorgang abzubrechen.If they do not match, you are prompted to either overwrite the journal file to start a new operation, or to cancel the current operation.

Nachdem der Vorgang erfolgreich abgeschlossen wurde, wird die Journaldatei gelöscht.The journal file is deleted upon successful completion of the operation.

Beachten Sie, dass die Fortsetzung eines Vorgangs aus einer Journaldatei nicht unterstützt wird, die mit einer früheren Version von AzCopy erstellt wurde.Note that resuming an operation from a journal file created by a previous version of AzCopy is not supported.

Geltungsbereich: Blobs, Dateien, TabellenApplicable to: Blobs, Files, Tables

/@:"Parameterdatei"/@:"parameter-file"

Gibt eine Datei an, die Parameter enthält.Specifies a file that contains parameters. AzCopy verarbeitet die Parameter in der Datei auf die gleiche Weise wie bei der Angabe über die Befehlszeile.AzCopy processes the parameters in the file just as if they had been specified on the command line.

In einer Antwortdatei können Sie entweder mehrere Parameter in einer einzelnen Zeile oder jeden Parameter in einer eigenen Zeile angeben.In a response file, you can either specify multiple parameters on a single line, or specify each parameter on its own line. Beachten Sie, dass ein einzelner Parameter nicht mehrere Zeilen umfassen darf.Note that an individual parameter cannot span multiple lines.

Antwortdateien können Kommentarzeilen einbeziehen, die mit dem Symbol „#“ beginnen.Response files can include comments lines that begin with the # symbol.

Sie können mehrere Antwortdateien angeben.You can specify multiple response files. Beachten Sie jedoch, dass AzCopy geschachtelte Antwortdateien nicht unterstützt.However, note that AzCopy does not support nested response files.

Geltungsbereich: Blobs, Dateien, TabellenApplicable to: Blobs, Files, Tables

/Y/Y

Unterdrückt alle Bestätigungsaufforderungen von AzCopy.Suppresses all AzCopy confirmation prompts. Diese Option ermöglicht zudem die Verwendung von lesegeschützten SAS-Token für Datenuploadszenarien, wenn /XO und /XN nicht angegeben sind.This option also allows the use of write-only SAS tokens for data upload scenarios, when /XO and /XN are not specified.

Geltungsbereich: Blobs, Dateien, TabellenApplicable to: Blobs, Files, Tables

/L/L

Gibt nur einen Auflistungsvorgang an. Dabei werden keine Daten kopiert.Specifies a listing operation only; no data is copied.

AzCopy interpretiert die Verwendung dieser Option so, als ob ein Ausführen der Befehlszeile ohne die Option „/L“ simuliert wird, und zählt, wie viele Objekte kopiert werden. Sie können gleichzeitig die Option „/V“ angeben, um zu überprüfen, welche Objekte in das ausführliche Protokoll kopiert werden.AzCopy interprets the using of this option as a simulation for running the command line without this option /L and counts how many objects are copied, you can specify option /V at the same time to check which objects are copied in the verbose log.

Das Verhalten dieser Option wird auch durch den Speicherort der Quelldaten sowie dadurch bestimmt, ob die Option "/S" für den rekursiven Modus und die Dateimusteroption "/Pattern" vorhanden sind.The behavior of this option is also determined by the location of the source data and the presence of the recursive mode option /S and file pattern option /Pattern.

Wird diese Option verwendet, benötigt AzCopy AUFLISTUNGS- und LESE-Berechtigung für den Quellspeicherort.AzCopy requires LIST and READ permission of this source location when using this option.

Geltungsbereich: Blobs, DateienApplicable to: Blobs, Files

/MT/MT

Legt für die Uhrzeit der letzten Änderung der heruntergeladenen Datei denselben Zeitpunkt wie für den Quell-BLOB oder die Quelldatei fest.Sets the downloaded file's last-modified time to be the same as the source blob or file's.

Geltungsbereich: Blobs, DateienApplicable to: Blobs, Files

/XN/XN

Schließt eine neuere Quellressource aus.Excludes a newer source resource. Die Ressource wird nicht kopiert, wenn der Zeitpunkt der letzten Änderung der Quelle mit dem Ziel identisch ist oder danach liegt.The resource is not copied if the last modified time of the source is the same or newer than destination.

Geltungsbereich: Blobs, DateienApplicable to: Blobs, Files

/XO/XO

Schließt eine ältere Quellressource aus.Excludes an older source resource. Die Ressource wird nicht kopiert, wenn der Zeitpunkt der letzten Änderung der Quelle mit dem Ziel identisch ist oder davor liegt.The resource is not copied if the last modified time of the source is the same or older than destination.

Geltungsbereich: Blobs, DateienApplicable to: Blobs, Files

/A/A

Lädt ausschließlich Dateien hoch, für die das Archivattribut festgelegt ist.Uploads only files that have the Archive attribute set.

Geltungsbereich: Blobs, DateienApplicable to: Blobs, Files

/IA:[RASHCNETOI]/IA:[RASHCNETOI]

Lädt ausschließlich Dateien hoch, für die eines der angegebenen Attribute festgelegt ist.Uploads only files that have any of the specified attributes set.

Zu den verfügbaren Attributen zählen:Available attributes include:

  • R = Schreibgeschützte DateienR = Read-only files
  • A = Dateien, die bereit sind für die ArchivierungA = Files ready for archiving
  • S = SystemdateienS = System files
  • H = Versteckte DateienH = Hidden files
  • C = Komprimierte DateienC = Compressed files
  • N = Normale DateienN = Normal files
  • E = Verschlüsselte DateienE = Encrypted files
  • T = Temporäre DateienT = Temporary files
  • O = OfflinedateienO = Offline files
  • I = Nicht indizierte DateienI = Non-indexed files

Geltungsbereich: Blobs, DateienApplicable to: Blobs, Files

/XA:[RASHCNETOI]/XA:[RASHCNETOI]

Schließt Dateien aus, für die eines der angegebenen Attribute festgelegt ist.Excludes files that have any of the specified attributes set.

Zu den verfügbaren Attributen zählen:Available attributes include:

  • R = Schreibgeschützte DateienR = Read-only files
  • A = Dateien, die bereit sind für die ArchivierungA = Files ready for archiving
  • S = SystemdateienS = System files
  • H = Versteckte DateienH = Hidden files
  • C = Komprimierte DateienC = Compressed files
  • N = Normale DateienN = Normal files
  • E = Verschlüsselte DateienE = Encrypted files
  • T = Temporäre DateienT = Temporary files
  • O = OfflinedateienO = Offline files
  • I = Nicht indizierte DateienI = Non-indexed files

Geltungsbereich: Blobs, DateienApplicable to: Blobs, Files

/Delimiter:"Trennzeichen"/Delimiter:"delimiter"

Zeigt das Trennzeichen an, mit dem virtuelle Verzeichnisse in einem BLOB-Namen getrennt werden.Indicates the delimiter character used to delimit virtual directories in a blob name.

AzCopy verwendet „/“ standardmäßig als Trennzeichen.By default, AzCopy uses / as the delimiter character. AzCopy unterstützt jedoch die Verwendung beliebiger allgemeiner Zeichen (z. B. @, # oder %) als Trennzeichen.However, AzCopy supports using any common character (such as @, #, or %) as a delimiter. Wenn Sie eines dieser Sonderzeichen auf der Befehlszeile einbeziehen müssen, schließen Sie den Dateinamen in doppelte Anführungszeichen ein.If you need to include one of these special characters on the command line, enclose the file name with double quotes.

Diese Option kann nur zum Herunterladen von BLOBs angewendet werden.This option is only applicable for downloading blobs.

Geltungsbereich: Blobs (in englischer Sprache)Applicable to: Blobs

/NC:"Anzahl-gleichzeitiger-Vorgänge"/NC:"number-of-concurrent-operations"

Gibt die Anzahl gleichzeitiger Vorgänge an.Specifies the number of concurrent operations.

AzCopy startet standardmäßig eine bestimmte Anzahl gleichzeitiger Vorgänge zum Erhöhen des Datenübertragungsdurchsatzes.AzCopy by default starts a certain number of concurrent operations to increase the data transfer throughput. Beachten Sie, dass eine große Anzahl gleichzeitiger Vorgänge in einer Umgebung mit geringer Bandbreite die Netzwerkverbindung überlasten kann, wodurch möglicherweise verhindert wird, dass die Vorgänge vollständig abgeschlossen werden.Note that large number of concurrent operations in a low-bandwidth environment may overwhelm the network connection and prevent the operations from fully completing. Senken Sie die Anzahl gleichzeitiger Vorgänge auf Basis der tatsächlich verfügbaren Netzwerkbandbreite.Throttle concurrent operations based on actual available network bandwidth.

Maximal können 512 gleichzeitige Vorgänge ausgeführt werden.The upper limit for concurrent operations is 512.

Geltungsbereich: Blobs, Dateien, TabellenApplicable to: Blobs, Files, Tables

/SourceType:"Blob" | "Table"/SourceType:"Blob" | "Table"

Gibt an, dass die Ressource source ein Blob ist, das in der lokalen Entwicklungsumgebung verfügbar ist und im Speicheremulator ausgeführt wird.Specifies that the source resource is a blob available in the local development environment, running in the storage emulator.

Geltungsbereich: Blobs, TabellenApplicable to: Blobs, Tables

/DestType:"Blob" | "Table"/DestType:"Blob" | "Table"

Gibt an, dass die Ressource destination ein Blob ist, das in der lokalen Entwicklungsumgebung verfügbar ist und im Speicheremulator ausgeführt wird.Specifies that the destination resource is a blob available in the local development environment, running in the storage emulator.

Geltungsbereich: Blobs, TabellenApplicable to: Blobs, Tables

/PKRS:"Schlüssel1#Schlüssel2#Schlüssel3#..."/PKRS:"key1#key2#key3#..."

Teilt den Partitionsschlüsselbereich auf, um parallel das Exportieren von Tabellendaten zu ermöglichen, wodurch die Geschwindigkeit des Exportvorgangs erhöht wird.Splits the partition key range to enable exporting table data in parallel, which increases the speed of the export operation.

Wenn diese Option nicht angegeben ist, verwendet AzCopy einen einzelnen Thread zum Exportieren von Tabellenentitäten.If this option is not specified, then AzCopy uses a single thread to export table entities. Wenn der Benutzer beispielsweise /PKRS:"aa#bb" angibt, startet AzCopy drei gleichzeitige Vorgänge.For example, if the user specifies /PKRS:"aa#bb", then AzCopy starts three concurrent operations.

Jeder Vorgang exportiert einen der drei Partitionsschlüsselbereiche, wie dies im Folgenden gezeigt wird.Each operation exports one of three partition key ranges, as shown below:

[erster Partitionsschlüssel, aa)[first-partition-key, aa)

[aa, bb)[aa, bb)

[bb, letzter Partitionsschlüssel][bb, last-partition-key]

Geltungsbereich: TabellenApplicable to: Tables

/SplitSize:"Dateigröße"/SplitSize:"file-size"

Gibt die Teilungsgröße der exportierten Datei in MB an. Der zulässige Mindestwert ist 32.Specifies the exported file split size in MB, the minimal value allowed is 32.

Wenn diese Option nicht angegeben ist, exportiert AzCopy Tabellendaten in eine einzelne Datei.If this option is not specified, AzCopy exports table data to a single file.

Wenn die Tabellendaten in ein Blob exportiert werden und die exportierte Dateigröße die 200-GB-Begrenzung für die Blobgröße erreicht, teilt AzCopy die exportierte Datei auf, selbst wenn diese Option nicht angegeben ist.If the table data is exported to a blob, and the exported file size reaches the 200 GB limit for blob size, then AzCopy splits the exported file, even if this option is not specified.

Geltungsbereich: TabellenApplicable to: Tables

/EntityOperation:"InsertOrSkip" | "InsertOrMerge" | "InsertOrReplace"/EntityOperation:"InsertOrSkip" | "InsertOrMerge" | "InsertOrReplace"

Gibt das Tabellendaten-Importverhalten an.Specifies the table data import behavior.

  • InsertOrSkip – Überspringt eine vorhandene Entität oder fügt eine neue Entität ein, wenn sie in der Tabelle nicht vorhanden ist.InsertOrSkip - Skips an existing entity or inserts a new entity if it does not exist in the table.
  • InsertOrMerge – Führt eine vorhandene Entität zusammen oder fügt eine neue Entität ein, wenn sie in der Tabelle nicht vorhanden ist.InsertOrMerge - Merges an existing entity or inserts a new entity if it does not exist in the table.
  • InsertOrReplace – Ersetzt eine vorhandene Entität oder fügt eine neue Entität ein, wenn sie in der Tabelle nicht vorhanden ist.InsertOrReplace - Replaces an existing entity or inserts a new entity if it does not exist in the table.

Geltungsbereich: TabellenApplicable to: Tables

/Manifest: "Manifestdatei"/Manifest:"manifest-file"

Gibt die Manifestdatei für den Tabellenexport- und -importvorgang an.Specifies the manifest file for the table export and import operation.

Diese Option ist beim Exportvorgang optional. AzCopy generiert eine Manifestdatei mit vordefiniertem Namen, wenn diese Option nicht angegeben wurde.This option is optional during the export operation, AzCopy generates a manifest file with predefined name if this option is not specified.

Diese Option ist während eines Importvorgangs erforderlich, damit die Datendateien gefunden werden.This option is required during the import operation for locating the data files.

Geltungsbereich: TabellenApplicable to: Tables

/SyncCopy/SyncCopy

Gibt an, ob Blobs oder Dateien synchron zwischen zwei Azure-Speicherendpunkten kopiert werden sollen.Indicates whether to synchronously copy blobs or files between two Azure Storage endpoints.

Standardmäßig führt AzCopy serverseitige asynchrone Kopiervorgänge aus.AzCopy by default uses server-side asynchronous copy. Geben Sie diese Option an, um Kopiervorgänge synchron ausführen zu lassen. Blobs und Dateien werden so in den lokalen Arbeitsspeicher herunter- und dann in den Azure-Speicher hochgeladen.Specify this option to perform a synchronous copy, which downloads blobs or files to local memory and then uploads them to Azure Storage.

Diese Option eignet sich zum Kopieren von Dateien innerhalb eines Blob-Speichers oder eines Dateispeichers sowie zwischen Blob- und Dateispeicher.You can use this option when copying files within Blob storage, within File storage, or from Blob storage to File storage or vice versa.

Geltungsbereich: Blobs, DateienApplicable to: Blobs, Files

/SetContentType: "Inhaltstyp"/SetContentType:"content-type"

Gibt den MIME-Inhaltstyp für Ziel-Blobs oder -dateien an.Specifies the MIME content type for destination blobs or files.

AzCopy legt den Inhaltstyp eines Blobs oder einer Datei standardmäßig als „application/octet-stream“ fest.AzCopy sets the content type for a blob or file to application/octet-stream by default. Sie können den Inhaltstyp für alle Blobs oder Dateien ändern, indem Sie für diese Option einen Wert angeben.You can set the content type for all blobs or files by explicitly specifying a value for this option.

Wenn Sie für diese Option keinen Wert angeben, legt AzCopy den Inhaltstyp jedes Blobs und jeder Datei gemäß der jeweiligen Dateierweiterung fest.If you specify this option without a value, then AzCopy sets each blob or file's content type according to its file extension.

Geltungsbereich: Blobs, DateienApplicable to: Blobs, Files

/ PayloadFormat: "JSON" | "CSV"/PayloadFormat:"JSON" | "CSV"

Gibt das Format der exportierten Tabellendatendatei an.Specifies the format of the table exported data file.

Ist diese Option nicht angegeben, exportiert AzCopy eine Tabellendatendatei standardmäßig im JSON-Format.If this option is not specified, by default AzCopy exports table data file in JSON format.

Geltungsbereich: TabellenApplicable to: Tables

Bekannte Probleme und Best PracticesKnown Issues and Best Practices

Werfen wir nun einen Blick auf einige bekannte Probleme und bewährte Methoden.Let's take a look at some of the known issues and best practices.

Einschränken gleichzeitiger Schreibvorgänge beim Kopieren von DatenLimit concurrent writes while copying data

Wenn Sie BLOBs oder Dateien mit AzCopy kopieren, denken Sie daran, dass eine andere Anwendung die Daten möglicherweise modifiziert, während Sie diese kopieren.When you copy blobs or files with AzCopy, keep in mind that another application may be modifying the data while you are copying it. Stellen Sie nach Möglichkeit sicher, dass die von Ihnen kopierten Daten während des Kopiervorgangs nicht verändert werden.If possible, ensure that the data you are copying is not being modified during the copy operation. Wenn Sie z. B. eine virtuelle Festplatte (Virtual Hard Disk, VHD) mit einem virtuellen Azure-Computer kopieren, stellen Sie sicher, dass derzeit keine anderen Anwendungen auf diese virtuelle Festplatte schreiben.For example, when copying a VHD associated with an Azure virtual machine, make sure that no other applications are currently writing to the VHD. Eine gute Möglichkeit hierfür bietet das Leasen der Ressource, die kopiert werden soll.A good way to do this is by leasing the resource to be copied. Alternativ können Sie zunächst eine Momentaufnahme der virtuellen Festplatte (VHD) erstellen und anschließend die Momentaufnahme kopieren.Alternately, you can create a snapshot of the VHD first and then copy the snapshot.

Wenn Sie andere Anwendungen nicht daran hindern können, während des Kopiervorgangs in BLOBs oder Dateien zu schreiben, beachten Sie, dass die kopierten Ressourcen bei der Beendigung des Auftrags möglicherweise nicht mehr vollständig mit den Quellressourcen übereinstimmen.If you cannot prevent other applications from writing to blobs or files while they are being copied, then keep in mind that by the time the job finishes, the copied resources may no longer have full parity with the source resources.

Aktivieren Sie den FIPS-konformen MD5-Algorithmus für AzCopy, wenn Sie „FIPS-konformen Algorithmus für Verschlüsselung, Hashing und Signatur verwenden“.Enable FIPS-compliant MD5 algorithms for AzCopy when you "Use FIPS-compliant algorithms for encryption, hashing and signing."

AzCopy verwendet standardmäßig die MD5-Implementierung von .NET, um MD5 beim Kopieren von Objekten zu berechnen. Es gibt aber einige Sicherheitsanforderungen, die zu berücksichtigen sind, damit AzCopy eine FIPS-konforme MD5-Einstellung aktivieren kann.AzCopy by default uses .NET MD5 implementation to calculate the MD5 when copying objects, but there are some security requirements that need AzCopy to enable FIPS-compliant MD5 setting.

Sie können eine Anwendungskonfigurationsdatei namens AzCopy.exe.config erstellen, die die Eigenschaft AzureStorageUseV1MD5 enthält, und diese Datei im selben Speicherort wie "AzCopy.exe" ablegen.You can create an app.config file AzCopy.exe.config with property AzureStorageUseV1MD5 and put it aside with AzCopy.exe.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <appSettings>
    <add key="AzureStorageUseV1MD5" value="false"/>
  </appSettings>
</configuration>

Für die Eigenschaft „AzureStorageUseV1MD5“:For property "AzureStorageUseV1MD5":

  • „True“ – Standardwert, AzCopy verwendet die MD5-Implementierung von .NET.True - The default value, AzCopy uses .NET MD5 implementation.
  • „False“ – AzCopy verwendet den FIPS-konformen MD5-Algorithmus.False – AzCopy uses FIPS-compliant MD5 algorithm.

FIPS-konforme Algorithmen werden unter Windows standardmäßig deaktiviert.FIPS-compliant algorithms are disabled by default on Windows. Sie können diese Richtlinieneinstellung auf dem Computer ändern.You can change this policy setting on your machine. Geben Sie im Fenster „Ausführen“ (Windows + R) „secpol.msc“ ein, um das Fenster Lokale Sicherheitsrichtlinie zu öffnen.In the Run window (Windows+R), type secpol.msc to open the Local Security Policy window. Navigieren Sie im Fenster Sicherheitseinstellungen zu Sicherheitseinstellungen > Lokale Richtlinien > Sicherheitsoptionen.In the Security Settings window, navigate to Security Settings > Local Policies > Security Options. Suchen Sie die Richtlinie Systemkryptografie: FIPS-konformen Algorithmus für Verschlüsselung, Hashing und Signatur verwenden.Locate the System cryptography: Use FIPS-compliant algorithms for encryption, hashing and signing policy. Doppelklicken Sie auf die Richtlinie und beachten Sie den in der Spalte Sicherheitseinstellung angezeigten Wert.Double-click on the policy to see the value displayed in the Security Setting column.

Nächste SchritteNext steps

Weitere Informationen zu Azure Storage und zu AzCopy finden Sie in den folgenden Ressourcen:For more information about Azure Storage and AzCopy, see the following resources:

Azure Storage-Dokumentation:Azure Storage documentation:

Azure Storage-Blogbeiträge:Azure Storage blog posts: