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 が複数のサブスクリプションに関連付けられている場合は、アクティブなサブスクリプションを、静的 Web サイトをホストするストレージ アカウントのサブスクリプションに設定します。
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