Az Azure könyvtárak (SDK) használata Pythonhoz

A nyílt forráskódú Azure kódtárak Python egyszerűbbé teszik Azure-erőforrások kiépítését, kezelését és használatát Python alkalmazáskódból.

Azokat a részleteket, amelyeket igazán tudni szeretne

Az Azure könyvtárak használatával kommunikálhat az Azure szolgáltatásokkal Python kódból, amelyet helyileg vagy a felhőben futtat. Attól függ, hogy egy adott szolgáltatás hatókörén belül futtathat-e Python kódot, attól függ, hogy maga a szolgáltatás jelenleg támogatja-e a Python.
A kódtárak támogatják a Python 3.9 vagy újabb verziót. A Python támogatott verzióival kapcsolatos további információkért lásd: Azure SDKs Python verziótámogatási szabályzat. Ha PyPy használ, győződjön meg arról, hogy a használt verzió legalább a korábban említett Python verziót támogatja.
A Python Azure SDK több mint 180 egyéni Python kódtárból áll, amelyek meghatározott Azure szolgáltatásokhoz kapcsolódnak. Az SDK-ban nincsenek más eszközök.
Ha helyben futtat kódot, az Azure hitelesítése a környezeti változókon keresztül történik, ahogyan azt a Hogyan lehet Python alkalmazásokat hitelesíteni Azure szolgáltatásokhoz az Azure SDK for Python használatával című dokumentáció leírja.
A könyvtárcsomagok pippel való telepítéséhez használja a pip install <library_name>-t a csomagindexből. A könyvtárcsomagok Conda-környezetekbe történő telepítéséhez használja conda install <package_name> a Microsoft csatornán található anaconda.org nevek felhasználásával. További információért lásd: Azure könyvtárcsomagok telepítése.
Különböző felügyeleti és ügyféloldali kódtárak (más néven "felügyeleti sík" és "adatsík" kódtárak). Minden készlet különböző célokat szolgál, és különböző kódtípusok használják. További információkért tekintse meg a cikk későbbi szakaszait:
- Azure erőforrások létrehozása és kezelése felügyeleti kódtárakkal
- Csatlakozás Azure erőforrásokhoz ügyfélkódtárakkal
A kódtárak dokumentációját a Azure Python Referencia Azure Szolgáltatás vagy a Python API-böngésző fájlban találja, amely csomagnév alapján van rendszerezve.
A kódtárak kipróbálásához először állítsa be a helyi fejlesztői környezetet. Ezután a következő különálló példák bármelyikét kipróbálhatja (bármilyen sorrendben): Example: Erőforráscsoport létrehozása, Example: Azure Storage, Example: Webalkalmazás létrehozása és üzembe helyezése, Example: MySQL-adatbázis létrehozása és lekérdezése, és Example: Virtuális gép létrehozása.
Bemutató videókért lásd: Az Azure SDK Python (PyCon 2021) és A Azure SDKs használata Azure erőforrásokkal való interakcióhoz (PyCon 2020).

Nem fontos, de mégis érdekes részletek

Mivel a Azure CLI Python van megírva, és a felügyeleti kódtárakat használja, bármit elvégezhet Azure CLI parancsokkal, amelyeket egy Python szkriptből is elvégezhet. A parancssori felület parancsai számos hasznos funkciót biztosítanak, például több feladat együttes végrehajtását, az aszinkron műveletek automatikus kezelését, a kimenet (például kapcsolati sztringek) formázását stb. Így a parancssori felület (vagy annak megfelelője, Azure PowerShell) használata az automatikus létrehozási és felügyeleti szkriptekhez kényelmesebb lehet, mint a megfelelő Python kód megírása, hacsak nem szeretne sokkal pontosabban szabályozni a folyamatot.
A Python Azure kódtárai a mögöttes Azure REST API fölé épülnek, így ezeket az API-kat ismerős Python paradigmákon keresztül használhatja. A REST API-t azonban mindig használhatja közvetlenül Python kódból, ha szükséges.
A Azure kódtárak forráskódját a https://github.com/Azure/azure-sdk-for-python webhelyen találja. Nyílt forráskódú projektként szívesen vesszük a közreműködést!
Bár a kódtárakat olyan értelmezőkkel használhatja, mint az IronPython és a Jython, amelyeken a Microsoft nem tesztel, elszigetelt problémákat és inkompatibilitásokat tapasztalhat.
A kódtár API referenciadokumentációjának forrás-adattára a https://github.com/MicrosoftDocs/azure-docs-sdk-python/található.
2019-től kezdve a Microsoft frissítette Azure Python kódtárakat, hogy olyan gyakori felhőbeli mintákat osszanak meg, mint a hitelesítési protokollok, a naplózás, a nyomkövetés, az átviteli protokollok, a pufferelt válaszok és az újrapróbálkozások. A frissített kódtárak megfelelnek kurzív Azure SDK irányelveknek.
- 2023. március 31-én a Microsoft visszavonta Azure SDK kódtárak támogatását, amelyek nem felelnek meg a jelenlegi Azure SDK irányelveknek. Bár a régebbi kódtárak 2023. március 31-e után is használhatók, már nem kapnak hivatalos támogatást és frissítéseket a Microsofttól. További információ: A Azure SDK kódtárak frissítése.
- A Azure SDKs hiányzó biztonsági és teljesítményfrissítéseinek elkerülése érdekében 2023. március 31-ig frissítsen a latest Azure SDK kódtárakra.
- Ha ellenőrizni szeretné, hogy mely Python kódtárakra van hatással, tekintse meg Azure SDK elavult kiadásokat Python.
A Microsoft által a kódtárakra vonatkozó irányelvekről további információt a Python Irányelvek: Bevezetés című témakörben talál.

Azure erőforrások létrehozása és kezelése felügyeleti kódtárakkal

Az SDK management (vagy "felügyeleti sík") kódtárai, amelyek neve azure-mgmt- kezdődik, segít Azure erőforrások létrehozásában, konfigurálásában és egyéb módon történő kezelésében Python szkriptekből. Minden Azure szolgáltatáshoz megfelelő felügyeleti kódtárak tartoznak. További információkért lásd: Azure vezérlősík és adatsík.

A kezelő könyvtárak használatával olyan konfigurációs és üzembehelyezési szkripteket írhat, amelyekkel az Azure portálon vagy a Azure CLI keresztül végrehajthatja ugyanazokat a feladatokat. (Ahogy korábban említettük, a Azure CLI Python íródik, és a felügyeleti kódtárak használatával implementálja a különböző parancsokat.)

Az alábbi példák az elsődleges felügyeleti kódtárak némelyikének használatát szemléltetik:

Az egyes felügyeleti tárak kezelésével kapcsolatos részletekért lásd a README.md vagy README.rst fájlt, amely a tár projektmappájában található a SDK GitHub adattárban. További kódrészleteket a referencia dokumentációjában és a Azure Minták talál.

Migrálás régebbi felügyeleti kódtárakból

Ha a felügyeleti kódtárak régebbi verzióiból telepít át kódot, tekintse meg az alábbi részleteket:

Ha a ServicePrincipalCredentials osztályt használja, olvassa el a Hitelesítés jogkivonat-hitelesítő adatokkalcímű témakört.
Az aszinkron API-k neve megváltozott az kódtár használati mintáiban leírtak szerint – aszinkron műveletek. Az aszinkron API-k neve az újabb kódtárakban begin_kezdődik. A legtöbb esetben az API-aláírás ugyanaz marad.

Csatlakozás Azure erőforrásokhoz ügyfélkódtárakkal

Az SDK client (vagy "adatsík") kódtárai segítenek Python alkalmazáskód írásában a már kiépített szolgáltatásokkal való interakcióhoz. Az ügyfélkódtárak csak az ügyfél API-t támogató szolgáltatásokhoz léteznek.

A Example: Az Azure Storage használata című cikk alapvető példát nyújt az ügyfélkönyvtár használatára.

A különböző Azure-szolgáltatások példákat is kínálnak ezekre a kódtárakra. További hivatkozásokért tekintse meg az alábbi indexoldalakat:

Az egyes ügyfélkódtárak használatával kapcsolatos részletekért lásd a README.md vagy README.rst fájlt, amely a SDK GitHub-adattárában található. További kódrészleteket a referencia dokumentációjában és a Azure Minták talál.

Segítség kérése és csatlakozás az SDK-csapathoz

Python dokumentációért látogasson el a Azure kódtárakba
Tegyél fel kérdéseket a közösségnek a Stack Overflow
Az SDK-val kapcsolatos problémák megnyitása a GitHub
Említsd meg @AzureSDK a Twitteren
Vegyen részt egy rövid felmérésben az Azure SDK Pythonért

Következő lépés

Állítsa be a helyi fejlesztési környezetet, hogy a Python bármely Azure kódtárát könnyen használhassa.

Helyi fejlesztői környezet beállítása >>>

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2026-03-12