Udostępnij za pośrednictwem

Rozpoczynanie pracy z usługą Azure Data Lake Storage Gen1 przy użyciu interfejsu wiersza polecenia platformy Azure

  • Artykuł

Uwaga

Usługa Azure Data Lake Storage Gen1 została wycofana. Zobacz ogłoszenie o wycofaniu tutaj. Zasoby usługi Data Lake Storage Gen1 nie są już dostępne.

Dowiedz się, jak za pomocą interfejsu wiersza polecenia platformy Azure utworzyć konto usługi Azure Data Lake Storage Gen1 i wykonywać podstawowe operacje, takie jak tworzenie folderów, przekazywanie i pobieranie plików danych, usuwanie konta itp. Aby uzyskać więcej informacji na temat usługi Data Lake Storage Gen1, zobacz Omówienie usługi Data Lake Storage Gen1.

Interfejs wiersza polecenia platformy Azure to środowisko wiersza polecenia platformy Azure do zarządzania jej zasobami. Można go używać w systemach macOS, Linux i Windows. Aby uzyskać więcej informacji, zobacz Omówienie interfejsu wiersza polecenia platformy Azure. Możesz również zapoznać się z dokumentacją interfejsu wiersza polecenia usługi Azure Data Lake Storage Gen1, aby uzyskać pełną listę poleceń i składni.

Wymagania wstępne

Przed rozpoczęciem korzystania z informacji zawartych w tym artykule należy dysponować następującymi elementami:

Uwierzytelnianie

W tym artykule użyto prostszego podejścia do uwierzytelniania w usłudze Data Lake Storage Gen1, w którym logujesz się jako użytkownik końcowy. Poziom dostępu do konta i systemu plików usługi Data Lake Storage Gen1 podlega poziomowi dostępu zalogowanego użytkownika. Istnieją jednak inne podejścia do uwierzytelniania za pomocą usługi Data Lake Storage Gen1, które są uwierzytelnianiem użytkowników końcowych lub uwierzytelnianiem typu usługa-usługa. Aby uzyskać instrukcje i więcej informacji na temat uwierzytelniania, zobacz Uwierzytelnianie użytkowników końcowych lub Uwierzytelnianie między usługami.

Logowanie się do subskrypcji platformy Azure

  1. Zaloguj się do subskrypcji platformy Azure.

    az login

    Uzyskasz kod do użycia w następnym kroku. Otwórz stronę https://aka.ms/devicelogin w przeglądarce internetowej i wprowadź kod, aby się uwierzytelnić. Zostanie wyświetlony monit o zalogowanie się przy użyciu poświadczeń.

  2. Po zalogowaniu w oknie zostanie wyświetlona lista wszystkich subskrypcji platformy Azure, które są skojarzone z Twoim kontem. Za pomocą następującego polecenia użyj konkretnej subskrypcji.

    az account set --subscription <subscription id>

Tworzenie konta usługi Azure Data Lake Storage Gen1

  1. Tworzenie nowej grupy zasobów W poniższym poleceniu podaj wartości parametrów, których chcesz użyć. Jeśli nazwa lokalizacji zawiera spacje, umieść ją w cudzysłowie. Na przykład „Wschodnie stany USA 2”.

    az group create --location "East US 2" --name myresourcegroup

  2. Utwórz konto usługi Data Lake Storage Gen1.

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

Tworzenie folderów na koncie usługi Data Lake Storage Gen1

Foldery można tworzyć na koncie usługi Azure Data Lake Storage Gen1, aby zarządzać danymi i przechowywać je. Użyj następującego polecenia, aby utworzyć folder o nazwie mynewfolder w katalogu głównym konta usługi Data Lake Storage Gen1.

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

Uwaga

Parametr --folder gwarantuje, że polecenie utworzy folder. Jeśli ten parametr nie jest obecny, polecenie tworzy pusty plik o nazwie mynewfolder w katalogu głównym konta usługi Data Lake Storage Gen1.

Przekazywanie danych na konto usługi Data Lake Storage Gen1

Dane można przekazać do usługi Data Lake Storage Gen1 bezpośrednio na poziomie głównym lub do folderu utworzonego w ramach konta. Poniższe fragmenty kodu przedstawiają sposób przekazywania przykładowych danych do folderu (mojnowyfolder), który został utworzony w poprzedniej sekcji.

Jeśli szukasz przykładowych danych do przekazania, możesz pobrać folder Ambulance Data z repozytorium Git usługi Azure Data Lake. Pobierz plik i zapisz go w katalogu lokalnym na komputerze, takim jak C:\sampledata.

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

Uwaga

W przypadku podawania miejsca docelowego należy określić pełną ścieżkę, łącznie z nazwą pliku.

Wyświetlanie listy plików na koncie usługi Data Lake Storage Gen1

Użyj następującego polecenia, aby wyświetlić listę plików na koncie usługi Data Lake Storage Gen1.

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

Dane wyjściowe będą mieć postać podobną do następującej:

[
    {
        "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"
    }
]

Zmienianie nazwy, pobieranie i usuwanie danych z konta usługi Data Lake Storage Gen1

  • Aby zmienić nazwę pliku, użyj następującego polecenia:

    az dls fs move --account mydatalakestoragegen1 --source-path /mynewfolder/vehicle1_09142014.csv --destination-path /mynewfolder/vehicle1_09142014_copy.csv

  • Aby pobrać plik, użyj następującego polecenia. Upewnij się, że ścieżka docelowa już istnieje.

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

    Uwaga

    Polecenie tworzy folder docelowy, jeśli nie istnieje.

  • Aby usunąć plik, użyj następującego polecenia:

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

    Jeśli chcesz usunąć folder mojnowyfolder i plik vehicle1_09142014_copy.csv za pomocą jednego polecenia, użyj parametru --recurse

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

Praca z uprawnieniami i listami ACL dla konta usługi Data Lake Storage Gen1

W tej sekcji dowiesz się, jak zarządzać listami ACL i uprawnieniami przy użyciu interfejsu wiersza polecenia platformy Azure. Aby zapoznać się ze szczegółowym omówieniem implementacji list ACL w usłudze Azure Data Lake Storage Gen1, zobacz Kontrola dostępu w usłudze Azure Data Lake Storage Gen1.

  • Aby zaktualizować właściciela pliku/folderu, użyj następującego polecenia:

    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

  • Aby zaktualizować uprawnienia do pliku/folderu, użyj następującego polecenia:

    az dls fs access set-permission --account mydatalakestoragegen1 --path /mynewfolder/vehicle1_09142014.csv --permission 777

  • Aby uzyskać listy ACL dla danej ścieżki, użyj następującego polecenia:

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

    Dane wyjściowe będą podobne do następujących:

    {
    "entries": [
    "user::rwx",
    "group::rwx",
    "other::---"
    ],
    "group": "1808bd5f-62af-45f4-89d8-03c5e81bac20",
    "owner": "1808bd5f-62af-45f4-89d8-03c5e81bac20",
    "permission": "770",
    "stickyBit": false
}

  • Aby ustawić pozycję listy ACL, użyj następującego polecenia:

    az dls fs access set-entry --account mydatalakestoragegen1 --path /mynewfolder --acl-spec user:6360e05d-c381-4275-a932-5535806bb323:-w-

  • Aby usunąć pozycję z listy ACL, użyj następującego polecenia:

    az dls fs access remove-entry --account mydatalakestoragegen1 --path /mynewfolder --acl-spec user:6360e05d-c381-4275-a932-5535806bb323

  • Aby usunąć całą domyślną listę ACL, użyj następującego polecenia:

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

  • Aby usunąć całą inną niż domyślną listę ACL, użyj następującego polecenia:

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

Usuwanie konta usługi Data Lake Storage Gen1

Użyj następującego polecenia, aby usunąć konto usługi Data Lake Storage Gen1.

az dls account delete --account mydatalakestoragegen1

Po wyświetleniu monitu wpisz Y, aby usunąć konto.

Następne kroki