AzCopy を使用して Azure BLOB ストレージから BLOB をダウンロードする

AzCopy v10 コマンド ライン ユーティリティを使用して、BLOB ストレージから BLOB やディレクトリをダウンロードできます。

ファイルのアップロード、BLOB ストレージとの同期、アカウント間での BLOB のコピーなどの他の種類のタスクの例を確認するには、この記事の「次のステップ」のセクションに示されているリンクを参照してください。

はじめに

AzCopy のダウンロード方法と、ストレージ サービスに認証資格情報を与える方法については、AzCopy の作業開始に関するページをご覧ください。

BLOB をダウンロードする

azcopy copy コマンドを使用して BLOB をダウンロードします。

構文

azcopy copy 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<blob-path>' '<local-file-path>'

例

azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' 'C:\myDirectory\myTextFile.txt'

例 (Data Lake Storage エンドポイント)

azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myTextFile.txt' 'C:\myDirectory\myTextFile.txt'

ディレクトリをダウンロードする

azcopy copy コマンドを使用してディレクトリをダウンロードします。

構文

azcopy copy 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<directory-path>' '<local-directory-path>' --recursive

例

azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/myBlobDirectory' 'C:\myDirectory'  --recursive

例 (Data Lake Storage エンドポイント)

azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myBlobDirectory' 'C:\myDirectory'  --recursive

この例では、ダウンロードされたすべての BLOB を含む C:\myDirectory\myBlobDirectory という名前のディレクトリが生成されます。

ディレクトリの内容をダウンロードする

ワイルドカード記号 (*) を使用することで、ディレクトリ自体をコピーせずにディレクトリの内容をダウンロードできます。

構文

azcopy copy 'https://<storage-account-name>.blob.core.windows.net/<container-name>/*' '<local-directory-path>/'

例

azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/myBlobDirectory/*' 'C:\myDirectory'

すべてのサブディレクトリ内のファイルをダウンロードするには、--recursive フラグを追加します。

特定の BLOB をダウンロードする

完全なファイル名かワイルドカード文字 (*) による部分的な名前を使用して、または日付と時刻を使用して、特定の BLOB をダウンロードできます。

複数の完全な BLOB 名を指定する

azcopy copy コマンドを --include-path オプションと共に使用します。 個々の BLOB 名は、セミコロン (;) を使用して区切ります。

構文

azcopy copy 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-or-directory-name>' '<local-directory-path>' --include-path <semicolon-separated-file-list>

例

azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory' 'C:\myDirectory'  --include-path 'photos;documents\myFile.txt' --recursive

例 (Data Lake Storage エンドポイント)

azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/FileDirectory' 'C:\myDirectory'  --include-path 'photos;documents\myFile.txt'--recursive

この例では、AzCopy によって https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory/photos ディレクトリと https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory/documents/myFile.txt ファイルが転送されます。 https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory/photos ディレクトリ内のすべての BLOB を転送するには、--recursive オプションを含めます。

--exclude-path オプションを使用して BLOB を除外することもできます。 詳細については、「azcopy copy」リファレンス ドキュメントを参照してください。

ワイルドカード文字を使用する

azcopy copy コマンドを --include-pattern オプションと共に使用します。 ワイルドカード文字を含む名前の一部を指定します。 セミコロン (;) で名前を区切ります。

構文

azcopy copy 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-or-directory-name>' '<local-directory-path>' --include-pattern <semicolon-separated-file-list-with-wildcard-characters>

例

azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory' 'C:\myDirectory'  --include-pattern 'myFile*.txt;*.pdf*'

例 (階層型名前空間)

azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/FileDirectory' 'C:\myDirectory'  --include-pattern 'myFile*.txt;*.pdf*'

--exclude-pattern オプションを使用して BLOB を除外することもできます。 詳細については、「azcopy copy」リファレンス ドキュメントを参照してください。

--include-pattern および --exclude-pattern オプションは BLOB 名にのみ適用され、パスには適用されません。 ディレクトリ ツリー内に存在するすべてのテキスト ファイル (BLOB) をコピーする場合は、-recursive オプションを使用してディレクトリ ツリー全体を取得した後、-include-pattern を使用し、*.txt を指定してすべてのテキスト ファイルを取得します。

ある日付と時刻の前後に変更された BLOB をダウンロードする

azcopy copy コマンドを --include-before または --include-after オプションと共に使用します。 日付と時刻を ISO-8601 形式で指定します (例: 2020-08-19T15:04:00Z)。

次の例では、指定した日付以降に変更されたファイルをダウンロードします。

構文

azcopy copy 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-or-directory-name>/*' '<local-directory-path>' --include-after <Date-Time-in-ISO-8601-format>

例

azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/FileDirectory/*' 'C:\myDirectory'  --include-after '2020-08-19T15:04:00Z'

例 (Data Lake Storage エンドポイント)

azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/FileDirectory/*' 'C:\myDirectory'  --include-after '2020-08-19T15:04:00Z'

詳細なリファレンスについては、azcopy copy に関するリファレンス ドキュメントを参照してください。

前のバージョンの BLOB をダウンロードする

BLOB のバージョン管理を有効にした場合、BLOB の以前のバージョンを 1 つでも複数でもダウンロードできます。

まず、バージョン ID の一覧が含まれるテキスト ファイルを作成します。 各バージョン ID は別個の行に表示する必要があります。 次に例を示します。

2020-08-17T05:50:34.2199403Z
2020-08-17T05:50:34.5041365Z
2020-08-17T05:50:36.7607103Z

次に、azcopy copy コマンドを --list-of-versions オプションと共に使用します。 バージョンの一覧を含むテキスト ファイルの場所を指定します (例: D:\\list-of-versions.txt)。

BLOB のスナップショットをダウンロードする

BLOB スナップショットの DateTime 値を参照することによって、BLOB スナップショットをダウンロードできます。

構文

azcopy copy 'https://<storage-account-name>.<blob or dfs>.core.windows.net/<container-name>/<blob-path>?sharesnapshot=<DateTime-of-snapshot>' '<local-file-path>'

例

azcopy copy 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt?sharesnapshot=2020-09-23T08:21:07.0000000Z' 'C:\myDirectory\myTextFile.txt'

例 (Data Lake Storage エンドポイント)

azcopy copy 'https://mystorageaccount.dfs.core.windows.net/mycontainer/myTextFile.txt?sharesnapshot=2020-09-23T08:21:07.0000000Z' 'C:\myDirectory\myTextFile.txt'

オプションのフラグを使用してダウンロードする

オプションのフラグを使用して、ダウンロード操作を調整できます。 以下にいくつか例を示します。

完全な一覧については、オプションを参照してください。

次のステップ

他の例については、次の記事を参照してください。

• 例:アップロード
• 例:アカウント間でのコピー
• 例:同期
• 例:Amazon S3 バケット
• 例: Google Cloud Storage
• 例:Azure Files
• チュートリアル:AzCopy を使用したオンプレミス データのクラウド ストレージへの移行

設定の構成、パフォーマンスの最適化、および問題のトラブルシューティングを行うには、次の記事を参照してください。

• AzCopy の構成設定
• AzCopy のパフォーマンスを最適化する
• AzCopy でログとプラン ファイルを使用してエラーの検出とジョブの再開を行う
• AzCopy v10 に関する問題の解決