Używanie bibliotek platformy Azure (SDK) dla języka Python

Artykuł
10/19/2023

Biblioteki platformy Azure typu open source dla języka Python upraszczają aprowizowanie, zarządzanie zasobami platformy Azure i korzystanie z ich z kodu aplikacji w języku Python.

Szczegóły, które naprawdę chcesz znać

Biblioteki platformy Azure to sposób komunikowania się z usługami platformy Azure z poziomu kodu języka Python uruchamianego lokalnie lub w chmurze. (Niezależnie od tego, czy można uruchamiać kod języka Python w zakresie określonej usługi, zależy od tego, czy ta usługa obecnie obsługuje język Python).
Biblioteki obsługują język Python w wersji 3.8 lub nowszej. Aby uzyskać więcej informacji na temat obsługiwanych wersji języka Python, zobacz Zasady obsługi wersji języka Python zestawów SDK platformy Azure. Jeśli używasz biblioteki PyPy, upewnij się, że używana wersja obsługuje co najmniej wersję języka Python wymienioną wcześniej.
Zestaw Azure SDK dla języka Python składa się wyłącznie z ponad 180 pojedynczych bibliotek języka Python, które odnoszą się do określonych usług platformy Azure. W zestawie SDK nie ma żadnych innych narzędzi.
Podczas lokalnego uruchamiania kodu uwierzytelnianie za pomocą platformy Azure opiera się na zmiennych środowiskowych zgodnie z opisem w temacie Jak uwierzytelniać aplikacje języka Python w usługach platformy Azure przy użyciu zestawu Azure SDK dla języka Python.
Aby zainstalować pakiety biblioteki za pomocą narzędzia pip, użyj pip install <library_name> nazw bibliotek z indeksu pakietów. Aby zainstalować pakiety biblioteki w środowiskach conda, użyj conda install <package_name> nazw z kanału firmy Microsoft w anaconda.org. Aby uzyskać więcej informacji, zobacz Instalowanie pakietów bibliotek platformy Azure.
Istnieją różne biblioteki zarządzania i klienta (czasami nazywane "płaszczyzną zarządzania" i "płaszczyzną danych"). Każdy zestaw służy do różnych celów i jest używany przez różne rodzaje kodu. Aby uzyskać więcej informacji, zobacz następujące sekcje w dalszej części tego artykułu:
- Tworzenie zasobów platformy Azure i zarządzanie nimi za pomocą bibliotek zarządzania
- Połączenie do zasobów platformy Azure i korzystania z nich z bibliotekami klienta
Dokumentacja bibliotek znajduje się na platformie Azure for Python Reference, która jest zorganizowana przez usługę platformy Azure lub przeglądarkę interfejsu API języka Python, która jest zorganizowana według nazwy pakietu.
Aby samodzielnie wypróbować biblioteki, zalecamy skonfigurowanie lokalnego środowiska deweloperskiego. Następnie możesz wypróbować dowolny z następujących autonomicznych przykładów (w dowolnej kolejności): Przykład: tworzenie grupy zasobów, przykład: tworzenie i używanie usługi Azure Storage, przykład: tworzenie i wdrażanie aplikacji internetowej, przykład: tworzenie i wykonywanie zapytań względem bazy danych MySQL oraz przykład: tworzenie maszyny wirtualnej.
Aby zapoznać się z pokazowymi filmami wideo, zobacz Wprowadzenie do zestawu Azure SDK dla języka Python (PyCon 2021) i Używanie zestawów SDK platformy Azure do interakcji z zasobami platformy Azure (PyCon 2020).

Nieistotnych, ale nadal interesujących szczegółów

Ponieważ interfejs wiersza polecenia platformy Azure jest napisany w języku Python przy użyciu bibliotek zarządzania, wszystko, co można zrobić za pomocą poleceń interfejsu wiersza polecenia platformy Azure, można również wykonać za pomocą skryptu języka Python. Oznacza to, że polecenia interfejsu wiersza polecenia zapewniają wiele przydatnych funkcji, takich jak wykonywanie wielu zadań razem, automatyczne obsługiwanie operacji asynchronicznych, formatowanie danych wyjściowych, takich jak parametry połączenia itd. Dlatego użycie interfejsu wiersza polecenia (lub jego odpowiednika, programu Azure PowerShell) do automatycznego tworzenia skryptów i zarządzania może być wygodniejsze niż pisanie równoważnego kodu w języku Python, chyba że chcesz mieć znacznie dokładniejszy stopień kontroli nad procesem.
Biblioteki platformy Azure dla języka Python bazują na podstawowym interfejsie API REST platformy Azure, co umożliwia korzystanie z tych interfejsów API za pomocą znanych paradygmatów języka Python. Jednak zawsze możesz używać interfejsu API REST bezpośrednio z poziomu kodu języka Python, jeśli jest to konieczne.
Kod źródłowy bibliotek platformy Azure można znaleźć w witrynie https://github.com/Azure/azure-sdk-for-python. W ramach projektu open source współtworzenie jest mile widziane!
Mimo że można używać bibliotek z interpreterami, takimi jak IronPython i Jython, których nie testujemy, mogą wystąpić izolowane problemy i niezgodności.
Repozytorium źródłowe dla dokumentacji referencyjnej interfejsu API biblioteki znajduje się w witrynie https://github.com/MicrosoftDocs/azure-docs-sdk-python/.
Począwszy od 2019 r., zaktualizowaliśmy biblioteki języka Python platformy Azure, aby współużytkować typowe wzorce chmury, takie jak protokoły uwierzytelniania, rejestrowanie, śledzenie, protokoły transportu, buforowane odpowiedzi i ponawianie prób. Zaktualizowane biblioteki są zgodne z bieżącymi wytycznymi dotyczącymi zestawu Azure SDK.
- 31 marca 2023 r. wycofaliśmy obsługę bibliotek zestawu Azure SDK, które nie są zgodne z bieżącymi wytycznymi dotyczącymi zestawu Azure SDK. Chociaż starsze biblioteki mogą być nadal używane poza 31 marca 2023 r., nie będą już otrzymywać oficjalnej pomocy technicznej i aktualizacji od firmy Microsoft. Aby uzyskać więcej informacji, zobacz powiadomienie Aktualizowanie bibliotek zestawu Azure SDK.
- Aby uniknąć brakujących aktualizacji zabezpieczeń i wydajności zestawów SDK platformy Azure, przeprowadź uaktualnienie do najnowszych bibliotek zestawu Azure SDK do 31 marca 2023 r.
- Aby sprawdzić, które biblioteki języka Python mają wpływ, zobacz Przestarzałe wersje zestawu Azure SDK dla języka Python.
Aby uzyskać szczegółowe informacje na temat wytycznych dotyczących bibliotek, zobacz Wytyczne dotyczące języka Python: Wprowadzenie.

Tworzenie zasobów platformy Azure i zarządzanie nimi za pomocą bibliotek zarządzania

Biblioteki zarządzania (lub "płaszczyzny zarządzania") zestawu SDK, nazwy, których nazwy zaczynają się od azure-mgmt-, ułatwiają tworzenie, konfigurowanie i zarządzanie zasobami platformy Azure za pomocą skryptów języka Python. Wszystkie usługi platformy Azure mają odpowiednie biblioteki zarządzania. Aby uzyskać więcej informacji, zobacz Płaszczyzna sterowania i płaszczyzna danych platformy Azure.

Za pomocą bibliotek zarządzania można pisać skrypty konfiguracji i wdrażania, aby wykonywać te same zadania, które można wykonać za pośrednictwem witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure. (Jak wspomniano wcześniej, interfejs wiersza polecenia platformy Azure jest napisany w języku Python i używa bibliotek zarządzania do implementowania różnych poleceń).

W poniższych przykładach pokazano, jak używać niektórych podstawowych bibliotek zarządzania:

Aby uzyskać szczegółowe informacje na temat pracy z każdą biblioteką zarządzania, zobacz plik README.md lub README.rst znajdujący się w folderze projektu biblioteki w repozytorium GitHub zestawu SDK. Więcej fragmentów kodu można również znaleźć w dokumentacji referencyjnej i przykładach platformy Azure.

Migrowanie ze starszych bibliotek zarządzania

Jeśli migrujesz kod ze starszych wersji bibliotek zarządzania, zobacz następujące szczegóły:

Jeśli używasz ServicePrincipalCredentials klasy, zobacz Uwierzytelnianie przy użyciu poświadczeń tokenu.
Nazwy asynchronicznych interfejsów API zostały zmienione zgodnie z opisem w temacie Wzorce użycia biblioteki — operacje asynchroniczne. Nazwy asynchronicznych interfejsów API w nowszych bibliotekach zaczynają się od begin_. W większości przypadków sygnatura interfejsu API pozostaje taka sama.

Połączenie do zasobów platformy Azure i korzystania z nich z bibliotekami klienta

Biblioteki klienta zestawu SDK (lub "płaszczyzny danych") ułatwiają pisanie kodu aplikacji w języku Python w celu interakcji z już aprowizowanymi usługami. Biblioteki klienckie istnieją tylko dla tych usług, które obsługują interfejs API klienta.

Artykuł Przykład: Korzystanie z usługi Azure Storage zawiera podstawową ilustrację korzystania z biblioteki klienta.

Różne usługi platformy Azure udostępniają również przykłady użycia tych bibliotek. Aby uzyskać inne linki, zobacz następujące strony indeksu:

Aby uzyskać szczegółowe informacje na temat pracy z każdą biblioteką klienta, zobacz plik README.md lub README.rst znajdujący się w folderze projektu biblioteki w repozytorium GitHub zestawu SDK. Więcej fragmentów kodu można również znaleźć w dokumentacji referencyjnej i przykładach platformy Azure.

Uzyskiwanie pomocy i nawiązywanie połączenia z zespołem zestawu SDK

Odwiedź dokumentację bibliotek platformy Azure dla języka Python
Opublikuj pytania do społeczności w witrynie Stack Overflow
Otwarte problemy dotyczące zestawu SDK w usłudze GitHub
Wzmianka @AzureSDK na Twitterze
Wykonaj krótką ankietę dotyczącą zestawu Azure SDK dla języka Python

Następny krok

Zdecydowanie zalecamy przeprowadzenie jednorazowej konfiguracji lokalnego środowiska deweloperskiego, aby można było łatwo użyć dowolnej biblioteki platformy Azure dla języka Python.

Konfigurowanie lokalnego środowiska deweloperskiego >>>