Použití knihoven Azure (SDK) pro Python

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

Podrobnosti, které opravdu chcete znát

• Knihovny Azure slouží jako způsob komunikace 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 rozsahu konkrétní služby závisí na tom, jestli tato služba aktuálně podporuje Python.)

• Knihovny podporují Python 2,7 a Python 3,6 nebo novější a jsou také testovány pomocí PyPy 5.4 +.

• Sada Azure SDK for Python se skládá výhradně z více než 180 samostatných knihoven Pythonu, které se vztahují na konkrétní služby Azure. V sadě SDK nejsou žádné další nástroje.

• Při místním spouštění kódu se ověřování pomocí Azure spoléhá na proměnné prostředí, jak je popsáno v tématu Konfigurace místního vývojového prostředí.

• Chcete-li nainstalovat balíčky knihovny pomocí PIP, použijte k použití pip install <library_name> názvů knihoven z pip install <library_name>. K instalaci balíčků knihoven do prostředí conda použijte conda install <package_name> používání názvů z conda install <package_name>. Další podrobnosti najdete v tématu instalace knihoven Azure.

• K dispozici jsou různé knihovny pro správu a klienta (někdy označované jako "rovina správy" a "datová rovina"). Každá sada slouží k různým účelům a používá se v různých druzích kódu. Další podrobnosti najdete v následujících částech dále v tomto článku:

  • Zřizování 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 k knihovnám najdete v referenčních informacích k Azure pro Python, které organizuje služba Azure, nebo v prohlížeči API Pythonu, který je uspořádaný podle názvu balíčku. V současné době často potřebujete kliknout na několik vrstev, abyste se dostali ke třídám a metodám, které vás zajímají. Umožňuje nám chvilku chvilku s tímto chováním. Pracujeme na vylepšování!

• Pokud si chcete knihovny vyzkoušet sami, doporučujeme nejdřív 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: zřízení skupiny prostředků, příklad: zřízení a použití Azure Storage, například: zřízení webové aplikace a nasazení kódu, příklad: zřízení a použití databáze MySQL, a příklad: zřízení virtuálního počítače.

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

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

• Vzhledem k tomu, že rozhraní příkazového řádku Azure CLI je napsané v Pythonu pomocí knihoven pro správu, můžete provádět i z skriptu Pythonu, který můžete dělat pomocí příkazů Azure CLI. Tyto příkazy rozhraní příkazového řádku poskytují mnoho užitečných funkcí, jako je například provádění více úloh dohromady, automatické zpracování asynchronních operací, formátování výstupů, jako jsou připojovací řetězce a tak dále. proto použití rozhraní příkazového řádku (nebo jeho ekvivalent, Azure PowerShell) pro skripty pro automatizované zřizování a správu může být výrazně pohodlnější než zápis ekvivalentního kódu pythonu, pokud nechcete mít mnohem přesnější míru kontroly nad procesem.

• Knihovny Azure pro Python se sestavují na základě základní REST API Azure, což vám umožní používat tato rozhraní API prostřednictvím známých paradigmat v Pythonu. V případě potřeby však můžete REST API kdykoli použít přímo z kódu Pythonu.

• Zdrojový kód pro knihovny Azure můžete najít v https://github.com/Azure/azure-sdk-for-python . Jako open source projekt jsou příspěvky Vítá vás!

• I když můžete knihovny používat s Překladači, jako je například Ironpythonu a Jython, které netestujeme proti, může dojít k izolovaným problémům a nekompatibilitám.

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

• Momentálně aktualizujeme knihovny Azure pro knihovny Pythonu, aby se sdílely běžné vzory cloudu, jako jsou protokoly ověřování, protokolování, trasování, přenosové protokoly, odpovědi ve vyrovnávací paměti a opakované pokusy.

  • Tato sdílená funkce je obsažena v knihovně Azure-Core .

  • Knihovny, které aktuálně pracují se základní knihovnou, jsou uvedené v sadě Azure SDK pro nejnovější verze Pythonu. Tyto knihovny, především klientské knihovny, jsou někdy označovány jako "Stop 2".

  • Knihovny pro správu a jiné, které ještě nejsou aktualizované, se někdy označují jako "stop 1".

• Podrobnosti o pokynech, které použijeme u knihoven, najdete v tématu pokyny pro Python: Úvod.

Zřizování a Správa prostředků Azure pomocí knihoven pro správu

Knihovny správy sady SDK (neboli "rovina správy"), jejichž názvy začínají s , vám pomůžou vytvořit, zřídit a jinak spravovat prostředky Azure ze skriptů Pythonu. Všechny služby Azure mají odpovídající knihovny pro správu.

Pomocí knihoven pro správu můžete psát skripty pro konfiguraci a nasazení, abyste mohli provádět stejné úlohy, jako Azure Portal nebo Azure CLI. (Jak bylo uvedeno dříve, rozhraní příkazového řádku Azure je napsané v Pythonu 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:

• Zřízení skupiny prostředků
• Výpis skupin prostředků v předplatném
• Zřízení Azure Storage
• Zřízení webové aplikace a nasazení kódu
• Zřízení a dotazování databáze
• Zřízení 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 , který se nachází ve složce projektu knihovny v sadě SDK GitHub úložišti. Další fragmenty kódu můžete najít také v referenční dokumentaci a v ukázkách Azure.

Migrace ze starší knihovny pro správu

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

• Pokud používáte ServicePrincipalCredentials třídu, přečtěte si téma ServicePrincipalCredentials.
• Názvy asynchronních rozhraní API se změnily, jak je popsáno v tématu vzory použití knihoven – asynchronní operace. Jednoduše řečeno, názvy asynchronních rozhraní API v novějších knihovnách začínají na begin_ . Ve většině případů podpis rozhraní API zůstává stejný.

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

Knihovny klienta sady SDK (neboli "rovina dat") vám pomůžou psát kód aplikace v Pythonu pro práci s již zajištěnými službami. Klientské knihovny existují jenom pro ty služby, které podporují klientské rozhraní API.

článek, příklad: použití Azure Storage, poskytuje základní ilustraci použití klientské knihovny.

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

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

podrobnosti o práci s jednotlivými klientskými knihovnami najdete v souboru README.md nebo readme. rst , který se nachází ve složce projektu knihovny v úložišti GitHub sady SDK. Další fragmenty kódu můžete najít také v referenční dokumentaci a v ukázkách Azure.

Získat nápovědu a připojit se ke týmu SDK

• Navštivte dokumentaci k knihovnám Azure pro Python .
• Vystavení otázek komunitě na Stack Overflow
• Otevřete problémy se sadou SDK na GitHub
• Zmínky @AzureSDK na Twitteru
• Dokončení krátkého průzkumu o sadě Azure SDK pro Python

Další krok

Důrazně doporučujeme provést jednorázovou instalaci místního vývojového prostředí, abyste mohli snadno použít kteroukoli z knihoven Azure pro Python.