Python için Azure kitaplıklarını (SDK) kullanma
Python için açık kaynaklı Azure kitaplıkları, Python uygulama kodundan Azure kaynaklarını sağlamayı, yönetmeyi ve kullanmayı kolaylaştırır.
Gerçekten bilmeniz istediğiniz Ayrıntılar
Azure kitaplıkları, yerel olarak veya bulutta çalıştırdığınız Python kodundan Azure hizmetleriyle iletişim kurma yöntemlerdir. (Python kodunu belirli bir hizmetin kapsamında çalıştırıp çalıştıramayacağı, hizmetin Şu anda Python 'u destekleyip desteklemediğini gösterir.)
Kitaplıklar Python 2,7 ve Python 3,6 ya da üstünü destekler ve ayrıca PyPy 5.4 + ile de test edilmiştir.
Python için Azure SDK 'Sı yalnızca belirli Azure hizmetleriyle ilgili olan 180 'den fazla ayrı Python kitaplığı oluşur. "SDK" içinde başka hiçbir araç yok.
Kodu yerel olarak çalıştırırken Azure ile kimlik doğrulaması, yerel geliştirme ortamınızı yapılandırmakonusunda açıklandığı gibi ortam değişkenlerine bağımlıdır.
Kitaplık paketlerini PIP ile yüklemek için
pip install <library_name>pip install <library_name>kitaplık adlarını kullanma ' yı kullanın. Conda ortamlarında kitaplık paketleri yüklemek için, anaconda.org adresindekiconda install <package_name>conda install <package_name>adları kullanma ' yı kullanın. Daha fazla ayrıntı için bkz. Azure kitaplıklarını yüklemeyi.Ayrı Yönetim ve istemci kitaplıkları vardır (bazen "Yönetim düzlemi" ve "veri düzlemi" kitaplıkları olarak adlandırılır). Her küme farklı amaçlara hizmet eder ve farklı kod türleri tarafından kullanılır. Daha ayrıntılı bilgi için bu makalenin ilerleyen kısımlarında yer alarak aşağıdaki bölümlere bakın:
Kitaplıklara yönelik belgeler, Azure hizmeti tarafından düzenlenen ve paket adına göre düzenlenen Python API tarayıcısıIçin Azure for Python başvurusundabulunur. Mevcut olduğunda genellikle ilgilendiğiniz sınıflara ve yöntemlere ulaşmak için bir dizi katmana tıklamanız gerekir. Bu alt nominal deneyim için önceden ilerleme mıza izin verin. Geliştirme için çalışıyoruz!
Kitaplıkları kendiniz denemek için öncelikle yerel geliştirme ortamınızı ayarlamayıöneririz. ardından, aşağıdaki tek başına örneklerden birini deneyebilirsiniz (herhangi bir sırada): örnek: bir kaynak grubu sağlayın, örnek: Azure Depolamasağlayın ve kullanın, örnek: bir web uygulaması sağlayın ve kodu dağıtın, örnek: bir MySQL veritabanısağlayın ve kullanın ve örnek: bir sanal makine sağlayın.
Tanıtım videoları için bkz. Python Için Azure SDK 'Sını tanıtma (PyCon 2021) ve Azure Resource ile etkileşim kurmak için Azure SDK 'larını kullanma (PyCon 2020).
Önemli olmayan ancak yine de ilginç ayrıntılar
Azure CLı, yönetim kitaplıklarını kullanarak Python 'da yazıldığı için, Azure CLı komutlarıyla yapabileceğiniz her şeyi bir Python betiğinin içinden de yapabilirsiniz. Bu şekilde, CLı komutları birden çok görevi gerçekleştirme, zaman uyumsuz işlemleri otomatik olarak işleme, bağlantı dizeleri gibi biçimlendirme vb. gibi birçok yararlı özellik sağlar. sonuç olarak, otomatik sağlama ve yönetim betikleri için clı (veya eşdeğer, Azure PowerShell) kullanmak, işlem üzerinde çok daha fazla exacting denetime sahip olmak istemediğiniz sürece eşdeğer Python kodunu yazmadan önemli ölçüde daha kolay olabilir.
Temel Azure REST API üzerinde Python için Azure kitaplıkları, bu API 'Leri tanıdık Python paradigmalarına aracılığıyla kullanmanıza olanak sağlar. Ancak, isterseniz REST API her zaman doğrudan Python kodundan kullanabilirsiniz.
Üzerinde Azure kitaplıklarının kaynak kodunu bulabilirsiniz https://github.com/Azure/azure-sdk-for-python . Açık kaynaklı bir proje olarak, katılımlar hoş geldiniz!
Karşılaştırmakla karşılaşmadığımız IronPython ve Jithon yorumlayıcılarla kitaplıkları kullanabilseniz de, yalıtılmış sorunlar ve uyumsuzluklar yaşayabilirsiniz.
Kitaplık API 'SI başvuru belgelerinin Kaynak deposu üzerinde bulunur https://github.com/MicrosoftDocs/azure-docs-sdk-python/ .
Şu anda Python kitaplıklarının Azure kitaplıklarını, kimlik doğrulama protokolleri, günlüğe kaydetme, izleme, taşıma protokolleri, arabelleğe alınmış yanıtlar ve yeniden denemeler gibi ortak bulut düzenlerini paylaşacak şekilde güncelleştiriyoruz.
Bu paylaşılan işlev Azure çekirdek kitaplığı 'nda bulunur.
Şu anda çekirdek kitaplıkla birlikte çalışan kitaplıklar, Python en son sürümleri Için Azure SDK'da listelenir. Bu kitaplıklar, öncelikle istemci kitaplıkları, bazen "Track 2" olarak adlandırılır.
Yönetim kitaplıkları ve henüz güncelleştirilmemiş diğerleri bazen "Track 1" olarak adlandırılır.
Kitaplıklara uygulanan yönergeler hakkındaki ayrıntılar için bkz. Python yönergeleri: giriş.
Yönetim kitaplıklarıyla Azure kaynaklarını sağlama ve yönetme
SDK 'nın Yönetim (veya "Yönetim düzlemi") kitaplıkları, tümünün ile başlayan adları, Python betiklerinden Azure kaynaklarını oluşturmanıza, sağlamanıza ve başka şekilde yönetmenize yardımcı olur. Tüm Azure hizmetlerinde karşılık gelen yönetim kitaplıkları vardır.
Yönetim kitaplıklarıyla, Azure Portal veya Azure CLIaracılığıyla kullanabileceğiniz aynı görevleri gerçekleştirmek için yapılandırma ve dağıtım betikleri yazabilirsiniz. (Daha önce belirtildiği gibi, Azure CLı Python 'da yazılmıştır ve çeşitli komutlarını uygulamak için yönetim kitaplıklarını kullanır.)
Aşağıdaki örneklerde, bazı birincil yönetim kitaplıklarının nasıl kullanılacağı gösterilmektedir:
- Kaynak grubu sağlama
- Abonelik içindeki kaynak gruplarını listeleme
- Azure Depolama'yı sağlama
- Bir Web uygulaması sağlayın ve kodu dağıtın
- Veritabanı sağlama ve sorgulama
- Sanal makine sağlama
her bir yönetim kitaplığıyla çalışma hakkındaki ayrıntılar için bkz. SDK GitHub deposundakikitaplığın proje klasöründe bulunan README.md veya README. rst dosyası. Ayrıca, başvuru belgelerinde ve Azure örneklerindeek kod parçacıkları bulabilirsiniz.
Eski yönetim kitaplıklarından geçiş
Yönetim kitaplıklarının eski sürümlerinden kod geçiriyorsanız, aşağıdaki ayrıntılara bakın:
ServicePrincipalCredentialsSınıfını kullanırsanız, bkz.ServicePrincipalCredentials.- Zaman uyumsuz API 'lerin adları, kitaplık kullanım desenleri-zaman uyumsuz işlemlerbölümünde açıklandığı gibi değiştirilmiştir. Yalnızca daha yeni kitaplıklardaki zaman uyumsuz API 'lerin adları ile başlar
begin_. Çoğu durumda, API imzası aynı kalır.
istemci kitaplıklarıyla Azure kaynaklarını Bağlan ve kullanma
SDK 'nın istemci (veya "veri düzlemi") kitaplıkları, zaten sağlanmış hizmetlerle etkileşim kurmak için Python uygulama kodu yazmanıza yardımcı olur. İstemci kitaplıkları yalnızca bir istemci API 'sini destekleyen hizmetler için vardır.
makale, örnek: Azure Depolama kullanma, istemci kitaplığı kullanmanın temel bir resmini sağlar.
Farklı Azure Hizmetleri, bu kitaplıkları kullanan örnekler de sağlar. Ek bağlantılar için aşağıdaki dizin sayfalarına bakın:
- Uygulama barındırma
- Bilişsel Hizmetler
- Veri çözümleri
- Kimlik ve güvenlik
- Makine öğrenmesi
- Mesajlaşma ve IoT
- Diğer hizmetler
her istemci kitaplığıyla çalışma hakkında daha fazla bilgi için, SDK 'nın GitHub deposundakikitaplığın proje klasöründe bulunan README.md veya README. rst dosyasına bakın. Ayrıca, başvuru belgelerinde ve Azure örneklerindeek kod parçacıkları bulabilirsiniz.
Yardım alın ve SDK ekibine bağlanın
- Python Için Azure kitaplıklarını belgelerini ziyaret edin
- Stack Overflow topluluğa soru gönderin
- GITHUB SDK 'ya karşı açık sorunlar
- Twitter 'da @AzureSDK bahsetme
- Python için Azure SDK hakkında kısa bir anket doldurun
Sonraki adım
Python için Azure kitaplıklarını kolayca kullanabilmeniz için, yerel geliştirme ortamınızın tek seferlik kurulumunu yapmanız önemle önerilir.