Azure CLI を使用して Azure Data Lake Storage でディレクトリとファイルを管理する
この記事では、階層型名前空間が有効になっているストレージ アカウントで、Azure CLI を使用してディレクトリとファイルを作成および管理する方法を示します。
ディレクトリとファイルのアクセス制御リスト (ACL) を取得、設定、更新する方法については、「Azure Data Lake Storage で Azure CLI を使用して ACL を管理する」を参照してください。
前提条件
Azure サブスクリプション。 詳細については、Azure 無料試用版の取得に関するページを参照してください。
階層型名前空間が有効になっているストレージ アカウント。 作成するには、こちらの手順に従います。
Azure CLI バージョン
2.6.0
以上。
正しいバージョンの Azure CLI がインストールされていることを確認する
Azure Cloud Shell を開きます。または、Azure CLI をローカルにインストールした場合は、Windows PowerShell などのコマンド コンソール アプリケーションを開きます。
次のコマンドを使用して、インストールされている Azure CLI のバージョンが
2.6.0
以上であることを確認します。az --version
Azure CLI のバージョンが
2.6.0
より低い場合は、新しいバージョンをインストールします。 詳細については、「 Azure CLI のインストール」を参照してください。
アカウントに接続する
Azure CLI をローカルで使用している場合は、login コマンドを実行します。
az login
CLI で既定のブラウザーを開くことができる場合、開いたブラウザに Azure サインイン ページが読み込まれます。
それ以外の場合は、 https://aka.ms/devicelogin でブラウザー ページを開き、ターミナルに表示されている認証コードを入力します。 次に、ブラウザーでアカウントの資格情報を使用してサインインします。
さまざまな認証方法の詳細については、「Azure CLI を使用して BLOB またはキュー データへのアクセスを承認する」を参照してください。
自分の ID が複数のサブスクリプションに関連付けられていて、サブスクリプションを選択するように求められない場合は、アクティブなサブスクリプションを操作するストレージ アカウントのサブスクリプションに設定します。 この例では、
<subscription-id>
プレースホルダーの値をサブスクリプションの ID に置き換えます。az account set --subscription <subscription-id>
<subscription-id>
プレースホルダーの値をサブスクリプションの ID に置き換えます。
Note
この記事に示す例は、Microsoft Entra 認可を示しています。 認証方法の詳細については、「Azure CLI を使用して BLOB またはキュー データへのアクセスを承認する」を参照してください。
コンテナーを作成する
コンテナーは、ファイルのファイル システムとして機能します。 az storage fs create コマンドを使って作成できます。
この例では、my-file-system
という名前のコンテナーを作成します。
az storage fs create -n my-file-system --account-name mystorageaccount --auth-mode login
コンテナーのプロパティを表示する
az storage fs show コマンドを使って、コンテナーのプロパティをコンソールに出力できます。
az storage fs show -n my-file-system --account-name mystorageaccount --auth-mode login
コンテナーの内容を一覧表示する
ディレクトリの内容の一覧を表示するには、az storage fs file list コマンドを使います。
この例では、my-file-system
という名前のコンテナーの内容を一覧表示します。
az storage fs file list -f my-file-system --account-name mystorageaccount --auth-mode login
コンテナーを削除する
コンテナーを削除するには、az storage fs delete コマンドを使います。
この例では、my-file-system
という名前のコンテナーを削除します。
az storage fs delete -n my-file-system --account-name mystorageaccount --auth-mode login
ディレクトリを作成する
ディレクトリ参照を作成するには、az storage fs directory create コマンドを使います。
この例では、mystorageaccount
という名前のアカウントにある my-file-system
という名前のコンテナーに my-directory
という名前のディレクトリを追加します。
az storage fs directory create -n my-directory -f my-file-system --account-name mystorageaccount --auth-mode login
ディレクトリのプロパティを表示する
az storage fs directory show コマンドを使って、ディレクトリのプロパティをコンソールに出力できます。
az storage fs directory show -n my-directory -f my-file-system --account-name mystorageaccount --auth-mode login
ディレクトリ名の変更またはディレクトリの移動
ディレクトリの名前変更または移動を行うには、az storage fs directory move コマンドを使います。
この例では、同じコンテナー内でディレクトリの名前を my-directory
から my-new-directory
に変更します。
az storage fs directory move -n my-directory -f my-file-system --new-directory "my-file-system/my-new-directory" --account-name mystorageaccount --auth-mode login
この例では、ディレクトリを my-second-file-system
という名前のコンテナーに移動します。
az storage fs directory move -n my-directory -f my-file-system --new-directory "my-second-file-system/my-new-directory" --account-name mystorageaccount --auth-mode login
ディレクトリを削除する
ディレクトリを削除するには、az storage fs directory delete コマンドを使います。
この例では、my-directory
という名前のディレクトリを削除します。
az storage fs directory delete -n my-directory -f my-file-system --account-name mystorageaccount --auth-mode login
ディレクトリが存在するかどうか確認する
コンテナーに特定のディレクトリが存在するかどうかを確認するには、az storage fs directory exists コマンドを使います。
この例では、my-file-system
コンテナーに、my-directory
という名前のディレクトリが存在するかどうかを確認します。
az storage fs directory exists -n my-directory -f my-file-system --account-name mystorageaccount --auth-mode login
ディレクトリからダウンロードする
ディレクトリからファイルをダウンロードするには、az storage fs file download コマンドを使います。
この例では、my-directory
という名前のディレクトリから upload.txt
という名前のファイルをダウンロードします。
az storage fs file download -p my-directory/upload.txt -f my-file-system -d "C:\myFolder\download.txt" --account-name mystorageaccount --auth-mode login
ディレクトリの内容を一覧表示する
ディレクトリの内容の一覧を表示するには、az storage fs file list コマンドを使います。
この例では、mystorageaccount
という名前のストレージ アカウントの my-file-system
コンテナーにある my-directory
という名前のディレクトリの内容を一覧表示します。
az storage fs file list -f my-file-system --path my-directory --account-name mystorageaccount --auth-mode login
ファイルをディレクトリにアップロードする
ファイルをディレクトリにアップロードするには、az storage fs file upload コマンドを使います。
この例では、upload.txt
という名前のファイルを my-directory
という名前のディレクトリにアップロードします。
az storage fs file upload -s "C:\myFolder\upload.txt" -p my-directory/upload.txt -f my-file-system --account-name mystorageaccount --auth-mode login
ファイルのプロパティを表示する
az storage fs file show コマンドを使って、ファイルのプロパティをコンソールに出力できます。
az storage fs file show -p my-file.txt -f my-file-system --account-name mystorageaccount --auth-mode login
ファイル名の変更またはファイルの移動
ファイルの名前変更または移動を行うには、az storage fs file move コマンドを使います。
この例では、ファイルの名前を my-file.txt
から my-file-renamed.txt
に変更します。
az storage fs file move -p my-file.txt -f my-file-system --new-path my-file-system/my-file-renamed.txt --account-name mystorageaccount --auth-mode login
ファイルを削除する
ファイルを削除するには、az storage fs file delete コマンドを使います。
この例では、my-file.txt
という名前のファイルを削除します。
az storage fs file delete -p my-directory/my-file.txt -f my-file-system --account-name mystorageaccount --auth-mode login