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

  • Artykuł

Uwaga

Azure Data Lake Storage Gen1 została wycofana. Zobacz ogłoszenie o wycofaniu tutaj. Data Lake Storage Gen1 zasoby nie są już dostępne. Jeśli potrzebujesz specjalnej pomocy, skontaktuj się z nami.

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 Data Lake Storage Gen1, zobacz Omówienie 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 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:

Authentication

W tym artykule użyto prostszego podejścia do uwierzytelniania z Data Lake Storage Gen1, w którym logujesz się jako użytkownik końcowy. Poziom dostępu do konta Data Lake Storage Gen1 i systemu plików podlega poziomowi dostępu zalogowanego użytkownika. Istnieją jednak inne metody uwierzytelniania przy użyciu Data Lake Storage Gen1, które są uwierzytelnianiem użytkowników końcowych lub uwierzytelnianiem typu usługa-usługa. Instrukcje i dodatkowe informacje na temat uwierzytelniania można znaleźć w następujących artykułach: End-user authentication (Uwierzytelnianie użytkowników końcowych) lub Service-to-service authentication (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 Data Lake Storage Gen1.

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

Tworzenie folderów na koncie Data Lake Storage Gen1

Foldery można tworzyć na koncie 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 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 Data Lake Storage Gen1.

Przekazywanie danych do konta Data Lake Storage Gen1

Dane można przekazać do 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 Data Lake Storage Gen1

Użyj następującego polecenia, aby wyświetlić listę plików na koncie 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 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 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 sposobu implementacji list kontroli dostępu 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 Data Lake Storage Gen1

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

az dls account delete --account mydatalakestoragegen1

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

Następne kroki