İngilizce dilinde oku

Aracılığıyla paylaş


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

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.)

  • Kütüphaneler 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 . PyPykullanı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'da başka araç yoktur.

  • Kodu yerel olarak çalıştırdığınızda Azure kimlik doğrulaması, Pythoniçin Azure SDK'sını kullanarak Azure hizmetlerinde Python uygulamalarının kimliğini doğrulama konusunda açıklandığı gibi ortam değişkenlerini kullanır.

  • Pip ile kitaplık paketleri yüklemek için paket dizinikitaplık adlarını kullanarak pip install <library_name> kullanın. Conda ortamlarına kitaplık paketleri yüklemek için, anaconda.org üzerindekiMicrosoft kanalındaki adları kullanarak conda install <package_name> kullanın. Daha fazla bilgi için bkz. Azure kitaplık paketlerini yükleme.

  • Farklı 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:

  • Kitaplıklara yönelik belgeler, Azure Hizmeti'ne göre düzenlenmiş olan Python için Azure Referansıveya paket adına göre sıralanmış olan 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 Depolamaoluşturma ve kullanma Örnek:bir 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 sdk'larını kullanarak azure kaynakları (PyCon 2020) ile etkileşim kurma.

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ı dizeleri gibi çıkışı 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 denetime sahip olmak istemiyorsanız eşdeğer Python kodunu yazmaktan daha kullanışlı olabilir.

  • Python için Azure kitaplıkları, temel Azure REST APIü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 https://github.com/Azure/azure-sdk-for-python'da bulabilirsiniz. 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 https://github.com/MicrosoftDocs/azure-docs-sdk-python/üzerinde 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üncellenmiş kitaplıklar, geçerli Azure SDK yönergelerinebağlı kalmaktadı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 Azure SDK kitaplıklarınızı güncelleştirmebildirime bakın.

    • 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. Pythoniçin Azure SDK Kullanım Dışı Sürümleri.

  • Kitaplıklara uyguladığımız yönergeler hakkında ayrıntılı bilgi için bkz. Python Yönergeleri: Giriş.

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

SDK'nın adları azure-mgmt-ile başlayan 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 CLIaracı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 deposundaki kitaplığın proje klasöründe bulunan README.md veya README.rst dosyasınabakın. Ayrıca başvuru belgelerinde ve Azure Örnekleri daha fazla kod parçacığı bulabilirsiniz.

Eski yönetim kitaplıklarından geçiş yapma

Yönetim kitaplıklarının eski sürümlerinden kod geçiriyorsanız aşağıdaki ayrıntılara bakın:

İstemci kitaplıklarıyla Azure kaynaklarına bağlanma ve bunları 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 Depolamakullanımı makalesi, istemci kitaplığının nasıl kullanılacağına dair temel bir örnek sunar.

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'sının GitHub deposundaki kitaplığın proje klasöründe bulunan README.MD veya README.rst dosyasınabakın. Ayrıca başvuru belgelerinde ve Azure Örnekleri'te daha fazla kod parçacığı bulabilirsiniz.

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

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.