Azure CLI を使用して Azure Data Lake Storage Gen2 でディレクトリとファイルを管理する

  • [アーティクル]

この記事では、階層型名前空間が有効になっているストレージ アカウントで、Azure CLI を使用してディレクトリとファイルを作成および管理する方法を示します。

ディレクトリとファイルのアクセス制御リスト (ACL) を取得、設定、更新する方法については、「Azure Data Lake Storage Gen2 で Azure CLI を使用して ACL を管理する」を参照してください。

サンプル | フィードバックを送る

前提条件

  • Azure サブスクリプション。 詳細については、Azure 無料試用版の取得に関するページを参照してください。

  • 階層型名前空間が有効になっているストレージ アカウント。 作成するには、こちらの手順に従います。

  • Azure CLI バージョン 2.6.0 以上。

正しいバージョンの Azure CLI がインストールされていることを確認する

  1. Azure Cloud Shell を開きます。または、Azure CLI をローカルにインストールした場合は、Windows PowerShell などのコマンド コンソール アプリケーションを開きます。

  2. 次のコマンドを使用して、インストールされている Azure CLI のバージョンが 2.6.0 以上であることを確認します。

     az --version

    Azure CLI のバージョンが 2.6.0 より低い場合は、新しいバージョンをインストールします。 詳細については、「 Azure CLI のインストール」を参照してください。

アカウントに接続する

  1. Azure CLI をローカルで使用している場合は、login コマンドを実行します。

    az login

    CLI で既定のブラウザーを開くことができる場合、開いたブラウザに Azure サインイン ページが読み込まれます。

    それ以外の場合は、 https://aka.ms/devicelogin でブラウザー ページを開き、ターミナルに表示されている認証コードを入力します。 次に、ブラウザーでアカウントの資格情報を使用してサインインします。

    さまざまな認証方法の詳細については、「Azure CLI を使用して BLOB またはキュー データへのアクセスを承認する」を参照してください。

  2. 自分の 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

関連項目