Python için Azure kitaplıklarını (SDK) kullanma

Makale
10/23/2023

Python için açık kaynak Azure kitaplıkları, Python uygulama kodundan Azure kaynaklarını sağlamayı, yönetmeyi ve kullanmayı basitleştirir.

Gerçekten bilmek istediğiniz ayrıntılar

Azure kitaplıkları, yerel olarak veya bulutta çalıştırdığınız Python kodundan Azure hizmetleriyle nasıl iletişim kurabileceğinizdir. (Python kodunu belirli bir hizmet kapsamında çalıştırıp çalıştıramayacağınız, hizmetin şu anda Python'ı destekleyip desteklemediğine bağlıdır.)
Kitaplıklar Python 3.8 veya üzerini destekler. Desteklenen Python sürümleri hakkında daha fazla bilgi için bkz . Azure SDK'ları Python sürümü destek ilkesi. PyPy kullanıyorsanız kullandığınız sürümün en azından daha önce bahsedilen Python sürümünü desteklediğinden emin olun.
Python için Azure SDK yalnızca belirli Azure hizmetleriyle ilgili 180'den fazla bireysel Python kitaplığından oluşur. "SDK" içinde başka araç yoktur.
Kodu yerel olarak çalıştırdığınızda Azure ile kimlik doğrulaması, Python için Azure SDK'sını kullanarak Azure hizmetlerinde Python uygulamalarının kimliğini doğrulama bölümünde açıklandığı gibi ortam değişkenlerini kullanır.
Pip ile kitaplık paketlerini yüklemek için paket dizinindeki kitaplık adlarını kullanınpip install <library_name>. Conda ortamlarına kitaplık paketleri yüklemek için anaconda.org'da Microsoft kanalındaki adları kullanınconda install <package_name>. Daha fazla bilgi için bkz. Azure kitaplık paketlerini yükleme.
Ayrı yönetim ve istemci kitaplıkları vardır (bazen "yönetim düzlemi" ve "veri düzlemi" kitaplıkları olarak da adlandırılır). Her küme farklı amaçlara hizmet eder ve farklı kod türleri tarafından kullanılır. Daha fazla bilgi için bu makalenin devamında yer alan aşağıdaki bölümlere bakın:
- Yönetim kitaplıklarıyla Azure kaynakları oluşturma ve yönetme
- azure kaynaklarını istemci kitaplıklarıyla Bağlan ve kullanma
Kitaplıklara yönelik belgeler, Azure Hizmeti tarafından düzenlenen Python için Azure Başvurusu'nda veya paket adına göre düzenlenmiş Python API tarayıcısı üzerinde bulunur.
Kitaplıkları kendiniz denemek için öncelikle yerel geliştirme ortamınızı ayarlamanızı öneririz. Ardından aşağıdaki tek başına örneklerden herhangi birini (herhangi bir sırayla) deneyebilirsiniz: Örnek: Kaynak grubu oluşturma, Örnek: Azure Depolama oluşturma ve kullanma, Örnek: Web uygulaması oluşturma ve dağıtma, Örnek: MySQL veritabanı oluşturma ve sorgulama ve Örnek: Sanal makine oluşturma.
Tanıtım videoları için bkz . Python için Azure SDK'sına Giriş (PyCon 2021) ve Azure kaynaklarıyla etkileşime geçmek için Azure SDK'larını kullanma (PyCon 2020).

Temel olmayan ama yine de ilginç ayrıntılar

Azure CLI yönetim kitaplıkları kullanılarak Python'da yazıldığından, Azure CLI komutlarıyla yapabileceğiniz her şeyi python betiğinden de yapabilirsiniz. Buna göre, CLI komutları birden çok görevi birlikte gerçekleştirme, zaman uyumsuz işlemleri otomatik olarak işleme, bağlantı dizesi gibi çıktıları biçimlendirme gibi birçok yararlı özellik sağlar. Bu nedenle, otomatik oluşturma ve yönetim betikleri için CLI(veya eşdeğeri Azure PowerShell) kullanmak, işlem üzerinde çok daha kesin bir denetim derecesine sahip olmak istemiyorsanız eşdeğer Python kodunu yazmaktan daha kullanışlı olabilir.
Python için Azure kitaplıkları, temel alınan Azure REST API'nin üzerinde derlenir ve bu API'leri tanıdık Python paradigmalarıyla kullanmanıza olanak sağlar. Ancak, isterseniz REST API'yi doğrudan Python kodundan kullanabilirsiniz.
Azure kitaplıklarının kaynak kodunu üzerinde https://github.com/Azure/azure-sdk-for-pythonbulabilirsiniz. Açık kaynak bir proje olarak, katkılar memnuniyetle karşılanır!
Kitaplıkları test etmediğimiz IronPython ve Jython gibi yorumlayıcılarla kullanabilirsiniz ancak yalıtılmış sorunlarla ve uyumsuzluklarla karşılaşabilirsiniz.
Kitaplık API'sine başvuru belgelerinin kaynak deposu üzerinde https://github.com/MicrosoftDocs/azure-docs-sdk-python/bulunur.
2019'dan itibaren Azure Python kitaplıklarını kimlik doğrulama protokolleri, günlüğe kaydetme, izleme, aktarım protokolleri, arabelleğe alınan yanıtlar ve yeniden denemeler gibi yaygın bulut desenlerini paylaşacak şekilde güncelleştirdik. Güncelleştirilmiş kitaplıklar geçerli Azure SDK yönergelerine bağlıdır.
- 31 Mart 2023'te, geçerli Azure SDK yönergelerine uymayan Azure SDK kitaplıkları desteğini kullanımdan kaldırdık. Eski kitaplıklar 31 Mart 2023'ten sonra da kullanılabilir olsa da artık Microsoft'tan resmi destek ve güncelleştirmeler almayacaktır. Daha fazla bilgi için Bkz . Azure SDK kitaplıklarınızı güncelleştirme.
- Azure SDK'larında güvenlik ve performans güncelleştirmelerinin eksik olmasını önlemek için 31 Mart 2023'e kadar en son Azure SDK kitaplıklarına yükseltin.
- Hangi Python kitaplıklarının etkilendiğini denetlemek için bkz . Python için Azure SDK Kullanım Dışı Sürümleri.
Kitaplıklara uyguladığımız yönergelerle ilgili ayrıntılar için bkz . Python Yönergeleri: Giriş.

Yönetim kitaplıklarıyla Azure kaynakları oluşturma ve yönetme

Adları ile azure-mgmt-başlayan SDK'nın yönetim (veya "yönetim düzlemi") kitaplıkları, Python betiklerinden Azure kaynaklarını oluşturmanıza, yapılandırmanıza ve yönetmenize yardımcı olur. Tüm Azure hizmetlerinin karşılık gelen yönetim kitaplıkları vardır. Daha fazla bilgi için bkz . Azure denetim düzlemi ve veri düzlemi.

Yönetim kitaplıklarıyla, Azure portalı veya Azure CLI aracılığıyla gerçekleştirebileceğiniz görevlerin aynısını gerçekleştirmek için yapılandırma ve dağıtım betikleri yazabilirsiniz. (Daha önce belirtildiği gibi, Azure CLI Python'da yazılı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:

Her yönetim kitaplığıyla çalışma hakkında ayrıntılı bilgi için sdk GitHub deposunda kitaplığın proje klasöründe bulunan README.md veya README.rst dosyasına bakın. Başvuru belgelerinde ve Azure Örnekleri'nde daha fazla kod parçacığı da 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:

sınıfını ServicePrincipalCredentials kullanıyorsanız bkz . Belirteç kimlik bilgileriyle kimlik doğrulaması.
Zaman uyumsuz API'lerin adları Kitaplık kullanım desenleri - zaman uyumsuz işlemler bölümünde açıklandığı gibi değişmiştir. Yeni kitaplıklardaki zaman uyumsuz API'lerin adları ile begin_başlar. Çoğu durumda API imzası aynı kalır.

azure kaynaklarını istemci kitaplıklarıyla Bağlan ve kullanma

SDK'nın istemci (veya "veri düzlemi") kitaplıkları, önceden sağlanan hizmetlerle etkileşime geçmek için Python uygulama kodu yazmanıza yardımcı olur. İstemci kitaplıkları yalnızca bir istemci API'sini destekleyen hizmetler için mevcuttur.

Örnek: Azure Depolama kullanma makalesi, istemci kitaplığını kullanmaya ilişkin temel bir çizim sağlar.

Farklı Azure hizmetleri de bu kitaplıkları kullanarak örnekler sağlar. Diğer bağlantılar için aşağıdaki dizin sayfalarına bakın:

Her istemci kitaplığıyla çalışma hakkında ayrıntılı bilgi için SDK'nın GitHub deposunda kitaplığın proje klasöründe bulunan README.md veya README.rst dosyasına bakın. Başvuru belgelerinde ve Azure Örnekleri'nde daha fazla kod parçacığı da bulabilirsiniz.

Yardım alın ve SDK ekibiyle bağlantı kurun

Python için Azure kitaplıkları belgelerini ziyaret edin
Stack Overflow'da topluluğa sorular gönderin
GitHub'da SDK ile ilgili sorunları açma
Twitter'da @AzureSDK bahsetme
Python için Azure SDK hakkında kısa bir anket tamamlama

Sonraki adım

Python için Azure kitaplıklarından herhangi birini kolayca kullanabilmeniz için yerel geliştirme ortamınızı tek seferlik ayarlamanızı kesinlikle öneririz.

Yerel geliştirme ortamınızı ayarlama >>>