Azure CLI を使用して Azure Data Lake Store の使用を開始するGet started with Azure Data Lake Store using Azure CLI

注意

Azure Data Lake Storage Gen2 の一般提供が開始されました。Azure Data Lake Storage Gen2 is now generally available. 今すぐ使用を開始することをお勧めします。We recommend that you start using it today. 詳細については、製品に関するページを参照してください。For more information, see the product page.

Azure CLI を使用して Azure Data Lake Storage Gen1 アカウントを作成し、フォルダーの作成、データ ファイルのアップロードとダウンロード、ご自分のアカウントの削除などの基本操作を行う方法について説明します。Data Lake Storage Gen1 の詳細については、Data Lake Storage Gen1 の概要に関する記事をご覧ください。Learn how to use the Azure CLI to create an Azure Data Lake Storage Gen1 account and perform basic operations such as create folders, upload and download data files, delete your account, etc. For more information about Data Lake Storage Gen1, see Overview of Data Lake Storage Gen1.

Azure CLI は、Azure リソースを管理するための、Azure のコマンド ライン エクスペリエンスです。The Azure CLI is Azure's command-line experience for managing Azure resources. macOS、Linux、および Windows で使用できます。It can be used on macOS, Linux, and Windows. 詳細については、Azure CLI の概要に関するページを参照してください。For more information, see Overview of Azure CLI. コマンドと構文の完全な一覧については、Azure Data Lake Storage Gen1 CLI リファレンスを参照することもできます。You can also look at the Azure Data Lake Storage Gen1 CLI reference for a complete list of commands and syntax.

前提条件Prerequisites

この記事を読み始める前に、次の項目を用意する必要があります。Before you begin this article, you must have the following:

AuthenticationAuthentication

この記事では、Data Lake Storage Gen1 に対してエンド ユーザーとしてログインする比較的単純な認証方法を使用します。This article uses a simpler authentication approach with Data Lake Storage Gen1 where you log in as an end-user user. その後、Data Lake Storage Gen1 アカウントとファイル システムに対するアクセス レベルは、そのログイン ユーザーのアクセス レベルで管理されます。The access level to the Data Lake Storage Gen1 account and file system is then governed by the access level of the logged in user. ただし、Data Lake Storage Gen1 には他の認証方法も存在します (エンド ユーザー認証サービス間認証)。However, there are other approaches as well to authenticate with Data Lake Storage Gen1, which are end-user authentication or service-to-service authentication. 認証方法の詳細については、エンドユーザー認証またはサービス間認証に関するページを参照してください。For instructions and more information on how to authenticate, see End-user authentication or Service-to-service authentication.

Azure サブスクリプションにログインLog in to your Azure subscription

  1. Azure サブスクリプションにログインします。Log into your Azure subscription.

    az login
    

    使用するコードは次の手順で示します。You get a code to use in the next step. Web ブラウザーを使用して https://aka.ms/devicelogin ページを開き、コードを入力して認証を行います。Use a web browser to open the page https://aka.ms/devicelogin and enter the code to authenticate. 資格情報を使用してログインするように求めるメッセージが表示されます。You are prompted to log in using your credentials.

  2. ログインすると、アカウントに関連付けられているすべての Azure サブスクリプションの一覧がウィンドウに表示されます。Once you log in, the window lists all the Azure subscriptions that are associated with your account. 次のコマンドを使用して、特定のサブスクリプションを使用します。Use the following command to use a specific subscription.

    az account set --subscription <subscription id> 
    

Azure Data Lake Storage Gen1 アカウントを作成するCreate an Azure Data Lake Storage Gen1 account

  1. 新しいリソース グループを作成します。Create a new resource group. 次のコマンドで、使用するパラメーター値を指定します。In the following command, provide the parameter values you want to use. 場所の名前にスペースが含まれる場合は、名前を引用符で囲みます。If the location name contains spaces, put it in quotes. たとえば、"East US 2" などとします。For example "East US 2".

    az group create --location "East US 2" --name myresourcegroup
    
  2. Data Lake Storage Gen1 アカウントを作成します。Create the Data Lake Storage Gen1 account.

    az dls account create --account mydatalakestoragegen1 --resource-group myresourcegroup
    

Data Lake Storage Gen1 アカウントでフォルダーを作成するCreate folders in a Data Lake Storage Gen1 account

Data Lake Storage Gen1 アカウントにフォルダーを作成し、データを管理したり、保存したりできます。You can create folders under your Azure Data Lake Storage Gen1 account to manage and store data. 次のコマンドを使用して、Data Lake Storage Gen1 アカウントのルートに mynewfolder という名前のフォルダーを作成します。Use the following command to create a folder called mynewfolder at the root of the Data Lake Storage Gen1 account.

az dls fs create --account mydatalakestoragegen1 --path /mynewfolder --folder

注意

--folder パラメーターを指定すると、フォルダーが作成されます。The --folder parameter ensures that the command creates a folder. このパラメーターを指定しない場合、コマンドによって Data Lake Storage Gen1 アカウントのルートに mynewfolder という名前の空のファイルが作成されます。If this parameter is not present, the command creates an empty file called mynewfolder at the root of the Data Lake Storage Gen1 account.

Data Lake Storage Gen1 アカウントへのデータのアップロードUpload data to a Data Lake Storage Gen1 account

データは Data Lake Storage Gen1 のルート レベルで直接アップロードするか、アカウント内で作成したフォルダーにアップロードすることができます。You can upload data to Data Lake Storage Gen1 directly at the root level or to a folder that you created within the account. 以下のスニペットは、前のセクションで作成したフォルダー (mynewfolder) にいくつかのサンプル データをアップロードする方法を示します。The snippets below demonstrate how to upload some sample data to the folder (mynewfolder) you created in the previous section.

アップロードするいくつかのサンプル データを探している場合は、 Azure Data Lake Git リポジトリ から Ambulance Dataフォルダーを取得できます。If you are looking for some sample data to upload, you can get the Ambulance Data folder from the Azure Data Lake Git Repository. ファイルをダウンロードし、コンピューター上のローカル ディレクトリ (C:\sampledata\ など) に保存します。Download the file and store it in a local directory on your computer, such as C:\sampledata.

az dls fs upload --account mydatalakestoragegen1 --source-path "C:\SampleData\AmbulanceData\vehicle1_09142014.csv" --destination-path "/mynewfolder/vehicle1_09142014.csv"

注意

保存先として、ファイル名を含む完全なパスを指定する必要があります。For the destination, you must specify the complete path including the file name.

Data Lake Storage Gen1 アカウントのファイルを一覧表示するList files in a Data Lake Storage Gen1 account

Data Lake Storage Gen1 アカウントのファイルを一覧表示するには、次のコマンドを使用します。Use the following command to list the files in a Data Lake Storage Gen1 account.

az dls fs list --account mydatalakestoragegen1 --path /mynewfolder

この出力は次のように表示されます。The output of this should be similar to the following:

[
    {
        "accessTime": 1491323529542,
        "aclBit": false,
        "blockSize": 268435456,
        "group": "1808bd5f-62af-45f4-89d8-03c5e81bac20",
        "length": 1589881,
        "modificationTime": 1491323531638,
        "msExpirationTime": 0,
        "name": "mynewfolder/vehicle1_09142014.csv",
        "owner": "1808bd5f-62af-45f4-89d8-03c5e81bac20",
        "pathSuffix": "vehicle1_09142014.csv",
        "permission": "770",
        "replication": 1,
        "type": "FILE"
    }
]

Data Lake Storage Gen1 アカウントのデータの名前変更、ダウンロード、削除を行うRename, download, and delete data from a Data Lake Storage Gen1 account

  • ファイルの名前を変更するには、次のコマンドを使用します。To rename a file, use the following command:

    az dls fs move --account mydatalakestoragegen1 --source-path /mynewfolder/vehicle1_09142014.csv --destination-path /mynewfolder/vehicle1_09142014_copy.csv
    
  • ファイルをダウンロードするには、次のコマンドを使用します。To download a file, use the following command. 既に存在するパスをダウンロード先として指定してください。Make sure the destination path you specify already exists.

    az dls fs download --account mydatalakestoragegen1 --source-path /mynewfolder/vehicle1_09142014_copy.csv --destination-path "C:\mysampledata\vehicle1_09142014_copy.csv"
    

    注意

    対象フォルダーが存在しない場合は、作成されます。The command creates the destination folder if it does not exist.

  • ファイルを削除するには、次のコマンドを使用します。To delete a file, use the following command:

    az dls fs delete --account mydatalakestoragegen1 --path /mynewfolder/vehicle1_09142014_copy.csv
    

    フォルダー mynewfolder とファイル vehicle1_09142014_copy.csv を 1 つのコマンドでまとめて削除する場合は、--recurse パラメーターを使用します。If you want to delete the folder mynewfolder and the file vehicle1_09142014_copy.csv together in one command, use the --recurse parameter

    az dls fs delete --account mydatalakestoragegen1 --path /mynewfolder --recurse
    

Data Lake Storage Gen1 アカウントのアクセス許可と ACL を操作するWork with permissions and ACLs for a Data Lake Storage Gen1 account

このセクションでは、Azure CLI を使用して ACL とアクセス許可を管理する方法について説明します。In this section you learn about how to manage ACLs and permissions using the Azure CLI. Azure Data Lake Storage Gen1 で ACL がどのように実装されているかについては「Azure Data Lake Storage Gen1 のアクセス制御」に説明があります。そちらをご参照ください。For a detailed discussion on how ACLs are implemented in Azure Data Lake Storage Gen1, see Access control in Azure Data Lake Storage Gen1.

  • ファイルまたはフォルダーの所有者を更新するには、次のコマンドを使用します。To update the owner of a file/folder, use the following command:

    az dls fs access set-owner --account mydatalakestoragegen1 --path /mynewfolder/vehicle1_09142014.csv --group 80a3ed5f-959e-4696-ba3c-d3c8b2db6766 --owner 6361e05d-c381-4275-a932-5535806bb323
    
  • ファイルまたはフォルダーのアクセス許可を更新するには、次のコマンドを使用します。To update the permissions for a file/folder, use the following command:

    az dls fs access set-permission --account mydatalakestoragegen1 --path /mynewfolder/vehicle1_09142014.csv --permission 777
    
  • 特定のパスの ACL を取得するには、次のコマンドを使用します。To get the ACLs for a given path, use the following command:

    az dls fs access show --account mydatalakestoragegen1 --path /mynewfolder/vehicle1_09142014.csv
    

    出力は次のようになります。The output should be similar to the following:

      {
          "entries": [
          "user::rwx",
          "group::rwx",
          "other::---"
        ],
        "group": "1808bd5f-62af-45f4-89d8-03c5e81bac20",
        "owner": "1808bd5f-62af-45f4-89d8-03c5e81bac20",
        "permission": "770",
        "stickyBit": false
      }
    
  • ACL のエントリを設定するには、次のコマンドを使用します。To set an entry for an ACL, use the following command:

    az dls fs access set-entry --account mydatalakestoragegen1 --path /mynewfolder --acl-spec user:6360e05d-c381-4275-a932-5535806bb323:-w-
    
  • ACL のエントリを削除するには、次のコマンドを使用します。To remove an entry for an ACL, use the following command:

    az dls fs access remove-entry --account mydatalakestoragegen1 --path /mynewfolder --acl-spec user:6360e05d-c381-4275-a932-5535806bb323
    
  • 既定の ACL エントリ全体を削除するには、次のコマンドを使用します。To remove an entire default ACL, use the following command:

    az dls fs access remove-all --account mydatalakestoragegen1 --path /mynewfolder --default-acl
    
  • 既定でない ACL エントリ全体を削除するには、次のコマンドを使用します。To remove an entire non-default ACL, use the following command:

    az dls fs access remove-all --account mydatalakestoragegen1 --path /mynewfolder
    

Data Lake Storage Gen1 アカウントの削除Delete a Data Lake Storage Gen1 account

Data Lake Storage Gen1 アカウントを削除するには、次のコマンドを使用します。Use the following command to delete a Data Lake Storage Gen1 account.

az dls account delete --account mydatalakestoragegen1

確認を求めるメッセージが表示されたら、「 Y 」と入力して、アカウントを削除します。When prompted, enter Y to delete the account.

次の手順Next steps