Az Azure-kódtárak (SDK) használata Pythonhoz
A Pythonhoz készült nyílt forráskódú Azure-kódtárak leegyszerűsítik az Azure-erőforrások Python-alkalmazáskódból való kiépítését, kezelését és használatát.
Azokat a részleteket, amelyeket igazán tudni szeretne
Az Azure-kódtárak segítségével kommunikálhat az Azure-szolgáltatásokkal a helyileg vagy a felhőben futtatott Python-kódból . (Attól függ, hogy egy adott szolgáltatás hatókörén belül futtatható-e Python-kód, attól függ, hogy maga a szolgáltatás jelenleg támogatja-e a Pythont.)
A kódtárak támogatják a Python 3.8-at vagy újabb verziót. A Python támogatott verzióiról további információt az Azure SDKs Python verziótámogatási szabályzatában talál. Ha PyPy-t 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.
Az Azure SDK for Python 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 helyileg futtat kódokat, az Azure-ral való hitelesítés a Pythonhoz készült Azure SDK használatával a Python-alkalmazások Azure-szolgáltatásokban való hitelesítéséről szóló cikkben ismertetett környezeti változókra támaszkodik.
A kódtárcsomagok pipkel való telepítéséhez használja
pip install <library_name>
a csomagindex kódtárneveit. A kódtárcsomagok Conda-környezetekben való telepítéséhez használjaconda install <package_name>
a Microsoft-csatorna neveit a anaconda.org. További információ: Azure-kódtárcsomagok telepítése.Különböző felügyeleti és ügyfélkó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:
A kódtárak dokumentációja megtalálható az Azure for Python-referenciában, amelyet az Azure Service vagy a Python API böngésző szervez csomagnév alapján.
A kódtárak kipróbálásához először javasoljuk a helyi fejlesztői környezet beállítását. Ezután a következő különálló példák bármelyikét kipróbálhatja (bármilyen sorrendben): Például: Erőforráscsoport létrehozása, Példa: Azure Storage létrehozása és használata, Példa: Webalkalmazás létrehozása és üzembe helyezése, Példa: MySQL-adatbázis létrehozása és lekérdezése, valamint példa: Virtuális gép létrehozása.
Bemutató videókért tekintse meg az Azure SDK for Python (PyCon 2021) és az Azure SDK-k használata Azure-erőforrásokkal való interakcióját (PyCon 2020).
Nem alapvető, de mégis érdekes részletek
Mivel az Azure CLI a felügyeleti kódtárak használatával van megírva a Pythonban, az Azure CLI-parancsokkal bármilyen műveletet elvégezhet Egy Python-szkriptből is. A CLI-parancsok 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 kimenetek (például kapcsolati sztring) formázását stb. Így a parancssori felület (vagy annak megfelelője, az Azure PowerShell) használata az automatizált létrehozási és felügyeleti szkriptekhez kényelmesebb lehet, mint az egyenértékű Python-kód megírása, hacsak nem szeretne sokkal pontosabban szabályozni a folyamatot.
A PythonHoz készült Azure-kódtárak az alapul szolgáló Azure REST API-ra épülnek, így ezeket az API-kat ismerős Python-paradigmákon keresztül használhatja. A REST API-t azonban igény szerint közvetlenül a Python-kódból is használhatja.
Az Azure-kódtárak https://github.com/Azure/azure-sdk-for-pythonforráskódját itt 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 nem tesztelünk, elszigetelt problémákba és inkompatibilitásba ütközhet.
A kódtár API referenciadokumentációjának forrás-adattára a következő helyen https://github.com/MicrosoftDocs/azure-docs-sdk-python/található: .
2019-től kezdve frissítettük az Azure Python-kódtárakat olyan gyakori felhőbeli minták megosztására, 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 az Azure SDK aktuális irányelveinek.
2023. március 31-én megszüntettük az 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, a Microsoft már nem kap hivatalos támogatást és frissítéseket. További információ: Az Azure SDK-kódtárak frissítése című közlemény.
Az Azure SDK-k biztonsági és teljesítményfrissítéseinek hiányának elkerülése érdekében 2023. március 31-ig frissítsen a legújabb Azure SDK-kódtárakra .
Annak ellenőrzéséhez, hogy mely Python-kódtárakra van hatással, tekintse meg az Azure SDK elavult Python-kiadásait.
A kódtárakra vonatkozó irányelvekkel kapcsolatos részletekért tekintse meg a Python-irányelvek: Bevezetés című témakört.
Azure-erőforrások létrehozása és kezelése felügyeleti kódtárakkal
Az SDK felügyeleti (vagy "felügyeleti sík") kódtárai, amelyek nevével azure-mgmt-
kezdődnek, segítenek létrehozni, konfigurálni és más módon kezelni az Azure-erőforrásokat Python-szkriptekből. Minden Azure-szolgáltatáshoz megfelelő felügyeleti kódtárak tartoznak. További információ: Azure vezérlősík és adatsík.
A felügyeleti kódtárakkal konfigurációs és üzembehelyezési szkripteket írhat, hogy ugyanazokat a feladatokat hajtsa végre, mint az Azure Portalon vagy az Azure CLI-ben. (Ahogy korábban említettük, az Azure CLI Pythonban van megírva, é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:
- Erőforráscsoport létrehozása
- Erőforráscsoportok listázása előfizetésben
- Azure Storage-fiók és Blob Storage-tároló létrehozása
- Webalkalmazás létrehozása és üzembe helyezése az App Service-ben
- Azure MySQL-adatbázis létrehozása és lekérdezése
- Virtuális gép létrehozása
Az egyes felügyeleti tárak kezelésével kapcsolatos részletekért tekintse meg az SDK GitHub-adattár könyvtárának projektmappájában található README.md vagy README.rst fájlt. További kódrészleteket a referenciadokumentációban és az Azure-mintákban is találhat.
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 az osztályt használja, olvassa el a
ServicePrincipalCredentials
Hitelesítés token hitelesítő adatokkal című témakört. - Az aszinkron API-k neve módosult a könyvtárhasználati mintákban leírtak szerint – aszinkron műveletek. Az újabb kódtárak aszinkron API-jainak nevei a következővel
begin_
kezdődnek: . A legtöbb esetben az API-aláírás ugyanaz marad.
Azure-erőforrások Csatlakozás és használata ügyfélkódtárakkal
Az SDK ügyféloldali (vagy adatsíkos) kódtárai segítségével Python-alkalmazáskódot írhat 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 példa: Az Azure Storage használata című cikk alapvető illusztrációt nyújt az ügyfélkódtár használatáról.
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:
- Alkalmazás üzemeltetése
- Cognitive Services
- Adatmegoldások
- Identitás és biztonság
- Gépi tanulás
- Üzenetkezelés és IoT
- Egyéb szolgáltatások
Az egyes ügyféltárak használatával kapcsolatos részletekért tekintse meg az SDK GitHub-adattárában, a tár projektmappájában található README.md vagy README.rst fájlt. További kódrészleteket a referenciadokumentációban és az Azure-mintákban is találhat.
Segítség kérése és csatlakozás az SDK-csapathoz
- A Pythonhoz készült Azure-kódtárak megtekintése
- Kérdések közzététele a közösségnek a Stack Overflow-on
- Az SDK-val kapcsolatos problémák megnyitása a GitHubon
- Említés @AzureSDK a Twitteren
- Rövid felmérés befejezése a Pythonhoz készült Azure SDK-ról
Következő lépés
Határozottan javasoljuk, hogy a helyi fejlesztési környezet egyszeri beállítását végezze el, hogy könnyen használhassa a Pythonhoz készült Azure-kódtárakat.
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: