Použití knihoven Azure (SDK) pro Python

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

Podrobnosti, které opravdu chcete znát

• Pomocí knihoven Azure můžete komunikovat se službami Azure from Python kód, který spouštíte místně nebo v cloudu. To, jestli můžete spustit Python kód v rámci konkrétní služby, závisí na tom, jestli tato služba aktuálně podporuje Python.

• Knihovny podporují Python 3.9 nebo novější. Další informace o podporovaných verzích Python najdete v tématu Azure SDKs Python zásady podpory verzí. Pokud používáte PyPy, ujistěte se, že verze, kterou používáte, alespoň podporuje verzi Python uvedenou výše.

• Azure SDK pro Python se skládá pouze z více než 180 jednotlivých Python knihoven, 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í pomocí Azure spoléhá na proměnné prostředí, jak je popsáno v Jak ověřovat Python aplikace pro Azure služby pomocí 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. Pokud chcete nainstalovat balíčky knihovny v prostředích conda, použijte conda install <package_name> pomocí názvů z kanálu Microsoft na anaconda.org. Další informace najdete v tématu Instalace balíčků knihovny Azure.

• Existují různé knihovny pro správu a knihovny klienta (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:

  • Vytvoř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

• Dokumentaci ke knihovnám najdete v Azure pro Python Reference, které jsou uspořádané službou Azure Service nebo prohlížečem rozhraní API Python, který je uspořádaný podle názvu balíčku.

• Pokud si chcete knihovny vyzkoušet sami, nejprve nastavte 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í): Example: Vytvoření skupiny prostředků, Example: Vytvoření a použití Azure Storage, Example: Vytvoření a nasazení webové aplikace, Example: Vytvoření a dotazování databáze MySQL, a Example: Vytvoření virtuálního počítače

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

Nezbytné, ale podrobnosti stále zajímavé

• Vzhledem k tomu, že Azure CLI je napsaný ve Pythonu a používá knihovny pro správu, můžete pomocí příkazů Azure CLI dělat cokoliv, co můžete dělat i pomocí Python skriptu. 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ězce a další. Takže použití rozhraní příkazového řádku (nebo jeho ekvivalentu Azure PowerShell) pro automatizované vytváření a správu skriptů může být pohodlnější než psaní ekvivalentního kódu Python, pokud nechcete mít mnohem přesnější stupeň kontroly nad procesem.

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

• Zdrojový kód knihoven Azure najdete na 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é Microsoft netestuje, 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 společnost Microsoft aktualizovala knihovny Azure Python 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 dodržují aktuální pokyny pro Azure SDK.

  • Dne 31. března 2023 společnost Microsoft vyřadila podporu pro knihovny Azure SDK, které neodpovídají aktuálním Azure SDK pokynům. Starší knihovny je sice možné používat i po 31. březnu 2023, ale od Microsoftu už nedostávají oficiální podporu a aktualizace. Další informace najdete v tématu Aktualizace knihoven Azure SDK.

  • Pokud se chcete vyhnout vymeškání aktualizací zabezpečení a výkonu Azure SDK, upgradujte na nejnovější knihovny Azure SDK do 31. března 2023.

  • Informace o ovlivněných Python knihovnách najdete v tématu Azure SDK zastaralé verze Python.

• Podrobnosti o pokynech, které aplikuje Microsoft na knihovny, najdete v Pokyny k Pythonu: Úvod.

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

Knihovny správy (neboli "rovina správy") sady SDK, jejichž názvy začínají na azure-mgmt-, vám pomohou při vytváření, konfiguraci a správě prostředků Azure prostřednictvím skriptů v Pythonu. Všechny služby Azure mají odpovídající knihovny pro správu. Další informace najdete v tématu Azure řídicí rovina a rovina dat.

Pomocí knihoven pro správu můžete psát skripty konfigurace a nasazení pro provádění stejných úloh, které můžete provádět prostřednictvím portálu Azure nebo Azure CLI. (Jak jsme uvedli dříve, Azure CLI je zapsán v Python a používá knihovny pro správu k implementaci svých 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řte skupinu prostředků
• Seznam skupin zdrojů v rámci předplatného
• Vytvořte účet pro Azure Storage a kontejner pro Blob Storage
• 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 jednotlivými knihovnami pro správu najdete v souboru README.md nebo README.rst umístěný ve složce projektu knihovny v úložišti SDK GitHub. Další fragmenty kódu najdete také v dokumentaci k reference a Azure Samples.

Migrace ze starších knihoven pro management

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í k prostředkům Azure a jejich používání s klientskými knihovnami

Knihovny sady SDK client (nebo "rovina dat") vám pomůžou psát kód aplikace Python pro interakci s již zřízenými službami. Klientské knihovny existují pouze pro služby, které podporují klientské rozhraní API.

Článek Example: Použití Azure Storage poskytuje základní ilustraci použití klientské knihovny.

Různé Azure služby také poskytují příklady, které tyto knihovny používají. 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ý ve složce projektu knihovny v úložišti SDK GitHub. Další fragmenty kódu najdete také v dokumentaci k reference a Azure Samples.

Získejte pomoc a spojte se s týmem SDK

• Navštivte knihovny Azure pro dokumentaci k Python
• Publikování otázek komunitě na Webu Stack Overflow
• Problémy s otevřením sady SDK v GitHub
• Zmínka @AzureSDK na Twitteru
• Položte krátký průzkum o Azure SDK pro Python

Další krok

Nastavte místní vývojové prostředí, abyste mohli pro Python snadno používat libovolnou knihovnu Azure.

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