Použití knihoven Azure (SDK) pro Python

Opensourcové knihovny Azure pro Python zjednodušují zřizování, správu a používání prostředků Azure z kódu aplikace Pythonu.

Podrobnosti, které opravdu chcete znát

• Knihovny Azure komunikují se službami Azure z kódu Pythonu, který spouštíte místně nebo v cloudu. (Jestli můžete spustit kód Pythonu v rámci konkrétní služby, závisí na tom, jestli tato služba aktuálně podporuje Python.)

• Knihovny podporují Python 3.8 nebo novější. Další informace o podporovaných verzích Pythonu najdete v zásadách podpory verzí Pythonu pro sady Sdk. Pokud používáte PyPy, ujistěte se, že verze, kterou používáte, alespoň podporuje dříve uvedenou verzi Pythonu.

• Sada Azure SDK pro Python se skládá výhradně z více než 180 jednotlivých knihoven Pythonu, které se vztahují ke konkrétním službám Azure. Sada SDK neobsahuje žádné další nástroje.

• Při místním spuštění kódu se ověřování v Azure spoléhá na proměnné prostředí, jak je popsáno v tématu Ověřování aplikací Pythonu ve službách Azure pomocí sady Azure SDK pro Python.

• Chcete-li nainstalovat balíčky knihovny pomocí nástroje pip, použijte názvy pip install <library_name> knihoven z indexu balíčku. K instalaci balíčků knihovny v prostředí conda použijte conda install <package_name> názvy z kanálu Microsoftu na anaconda.org. Další informace najdete v tématu Instalace balíčků knihovny Azure.

• Existují různé knihovny pro správu a klienty (někdy označované jako "rovina správy" a "knihovny roviny dat"). Každá sada slouží různým účelům a používá se různými druhy kódu. Další informace najdete v následujících částech dále v tomto článku:

  • Vytváření a správa prostředků Azure pomocí knihoven pro správu
  • Připojení a používání prostředků Azure s klientskými knihovnami

• Dokumentace ke knihovnám najdete v referenčních informacích k Azure for Pythonu, které jsou uspořádané službou Azure Nebo prohlížečem rozhraní Python API, který je uspořádaný podle názvu balíčku.

• Pokud si chcete knihovny vyzkoušet sami, doporučujeme nejprve nastavit místní vývojové prostředí. Pak můžete vyzkoušet některý z následujících samostatných příkladů (v libovolném pořadí): Příklad: Vytvoření skupiny prostředků, Příklad: Vytvoření a použití Azure Storage, Příklad: Vytvoření a nasazení webové aplikace, Příklad: Vytvoření a dotazování databáze MySQL a příklad: Vytvoření virtuálního počítače.

• Ukázková videa najdete v tématu Představení sady Azure SDK pro Python (PyCon 2021) a použití sad Azure SDK k interakci s prostředky Azure (PyCon 2020).

Non-essential, ale stále zajímavé podrobnosti

• Vzhledem k tomu, že Rozhraní příkazového řádku Azure je napsané v Pythonu pomocí knihoven pro správu, všechno, co můžete dělat s příkazy Azure CLI, můžete také provádět ze skriptu Pythonu. Příkazy rozhraní příkazového řádku poskytují mnoho užitečných funkcí, jako je provádění více úloh společně, automatické zpracování asynchronních operací, formátování výstupu, jako jsou připojovací řetězec atd. Použití rozhraní příkazového řádku (nebo jeho ekvivalentu, Azure PowerShellu) pro automatizované vytváření a skripty pro správu může být pohodlnější než psaní ekvivalentního kódu Pythonu, pokud nechcete mít mnohem přesnější stupeň kontroly nad procesem.

• Knihovny Azure pro Python vycházejí z podkladového rozhraní Azure REST API, které umožňují používat tato rozhraní API prostřednictvím známých paradigmat Pythonu. V případě potřeby ale můžete rozhraní REST API vždy používat přímo z kódu Pythonu.

• Zdrojový kód knihoven Azure najdete na webu https://github.com/Azure/azure-sdk-for-python. Jako opensourcový projekt jsou příspěvky vítány!

• I když můžete knihovny používat s interprety, jako je IronPython a Jython, na které netestujeme, můžete narazit na izolované problémy a nekompatibility.

• Zdrojové úložiště pro referenční dokumentaci k rozhraní API knihovny se nachází na https://github.com/MicrosoftDocs/azure-docs-sdk-python/.

• Od roku 2019 jsme aktualizovali knihovny Azure Pythonu tak, aby sdílely běžné cloudové vzory, jako jsou ověřovací protokoly, protokolování, trasování, přenosové protokoly, odpovědi ve vyrovnávací paměti a opakování. Aktualizované knihovny odpovídají aktuálním pokynům k sadě Azure SDK.

  • Dne 31. března 2023 jsme vyřadili podporu knihoven sady Azure SDK, které nevyhovují aktuálním pokynům sady Azure SDK. Starší knihovny se sice dají používat i po 31. březnu 2023, ale už nebudou od Microsoftu dostávat oficiální podporu a aktualizace. Další informace najdete v oznámení o aktualizaci knihoven sady Azure SDK.

  • Pokud se chcete vyhnout chybějícím aktualizacím zabezpečení a výkonu sad SDK Azure, upgradujte do 31. března 2023 na nejnovější knihovny sady Azure SDK.

  • Informace o ovlivněných knihovnách Pythonu najdete v tématu Vyřazené verze sady Azure SDK pro Python.

• Podrobnosti o pokynech, které platí pro knihovny, najdete v pokynech pro Python: Úvod.

Vytváření a správa prostředků Azure pomocí knihoven pro správu

Knihovny pro správu (neboli "rovina správy") sady SDK, jejichž názvy začínají azure-mgmt-, pomáhají vytvářet, konfigurovat a jinak spravovat prostředky Azure ze skriptů Pythonu. Všechny služby Azure mají odpovídající knihovny pro správu. Další informace najdete v tématu Rovina řízení Azure a rovina dat.

Pomocí knihoven pro správu můžete psát skripty konfigurace a nasazení, které provádějí stejné úlohy, které můžete provádět prostřednictvím webu Azure Portal nebo Azure CLI. (Jak jsme si poznamenali dříve, Azure CLI je napsaný v Pythonu a používá knihovny pro správu k implementaci různých příkazů.)

Následující příklady ukazují, jak používat některé z primárních knihoven pro správu:

• Vytvoření skupiny prostředků
• Výpis skupin prostředků v předplatném
• Vytvoření účtu služby Azure Storage a kontejneru úložiště objektů blob
• Vytvoření a nasazení webové aplikace do služby App Service
• Vytvoření a dotazování databáze Azure MySQL
• Vytvoření virtuálního počítače

Podrobnosti o práci s každou knihovnou pro správu najdete v souboru README.md nebo README.rst umístěném ve složce projektu knihovny v úložišti GITHub sady SDK. Další fragmenty kódu najdete také v referenční dokumentaci a ukázkách Azure.

Migrace ze starších knihoven pro správu

Pokud migrujete kód ze starších verzí knihoven pro správu, projděte si následující podrobnosti:

• Pokud používáte ServicePrincipalCredentials třídu, přečtěte si téma Ověření pomocí přihlašovacích údajů tokenu.
• Názvy asynchronních rozhraní API se změnily, jak je popsáno v vzorech použití knihovny – asynchronních operacích. Názvy asynchronních rozhraní API v novějších knihovnách začínají na begin_. Ve většině případů zůstává podpis rozhraní API stejný.

Připojení a používání prostředků Azure s klientskými knihovnami

Klientské knihovny sady SDK (neboli "rovina dat") pomáhají psát kód aplikace Pythonu pro interakci s již zřízenými službami. Klientské knihovny existují pouze pro služby, které podporují klientské rozhraní API.

Příklad: Použití služby Azure Storage obsahuje základní ilustraci použití klientské knihovny.

Různé služby Azure také poskytují příklady použití těchto knihoven. Další odkazy najdete na následujících stránkách indexu:

• Hostování aplikací
• Cognitive Services
• Datová řešení
• Identita a zabezpečení
• strojové učení
• Zasílání zpráv a IoT
• Další služby

Podrobnosti o práci s každou klientskou knihovnou najdete v souboru README.md nebo README.rst umístěném ve složce projektu knihovny v úložišti GitHub sady SDK. Další fragmenty kódu najdete také v referenční dokumentaci a ukázkách Azure.

Získání nápovědy a připojení k týmu sady SDK

• Projděte si dokumentaci ke knihovnám Azure pro Python.
• Publikování otázek komunitě na Webu Stack Overflow
• Problémy s otevřením sady SDK na GitHubu
• Zmínka @AzureSDK na Twitteru
• Dokončení krátkého průzkumu o sadě Azure SDK pro Python

Další krok

Důrazně doporučujeme jednorázově nastavit místní vývojové prostředí, abyste mohli snadno používat některou z knihoven Azure pro Python.

Nastavení místního vývojového prostředí >>>