Python için Azure SDK ile Python uygulaması oluşturma
Bu belgede, Azure Uygulaması Yapılandırması'ndaki verilerinize erişmek için Python için Azure SDK'nın nasıl kullanılacağına ilişkin örnekler gösterilir.
İpucu
Uygulama Yapılandırması, Python SDK'sının üzerinde oluşturulmuş ve daha zengin özelliklerle kullanımı daha kolay olacak şekilde tasarlanmış bir Python sağlayıcı kitaplığı sunar. Yapılandırma ayarlarının sözlük gibi kullanılmasını sağlar ve birden çok etiketten yapılandırma oluşturma, anahtar adı kırpma ve Key Vault başvurularının otomatik çözünürlüğü gibi diğer özellikleri sunar. Daha fazla bilgi edinmek için Python hızlı başlangıcına gidin.
Önkoşullar
- Azure aboneliği - ücretsiz bir abonelik oluşturun
- Python 3.8 veya üzeri - Windows'ta Python'ı ayarlama hakkında bilgi için Windows üzerinde Python belgelerine bakın
- bir Uygulama Yapılandırması mağazası. Mağaza oluşturma.
Anahtar-değer oluşturma
Uygulama Yapılandırması deposuna aşağıdaki anahtar değerini ekleyin ve Etiket ve İçerik Türü değerlerini varsayılan değerleriyle bırakın. Azure portalını veya CLI'yı kullanarak bir depoya anahtar-değer ekleme hakkında daha fazla bilgi için Anahtar-değer oluşturma bölümüne gidin.
Anahtar | Değer |
---|---|
TestApp:Ayarlar:Message | Azure Uygulaması Yapılandırmasından Veriler |
Python uygulamasını ayarlama
Proje için app-configuration-example adlı yeni bir dizin oluşturun.
mkdir app-configuration-example
Yeni oluşturulan app-configuration-example dizinine geçin.
cd app-configuration-example
komutunu kullanarak Azure Uygulaması Yapılandırması istemci kitaplığını
pip install
yükleyin.pip install azure-appconfiguration
app-configuration-example dizininde app-configuration-example.py adlı yeni bir dosya oluşturun ve aşağıdaki kodu ekleyin:
import os from azure.appconfiguration import AzureAppConfigurationClient, ConfigurationSetting try: print("Azure App Configuration - Python example") # Example code goes here except Exception as ex: print('Exception:') print(ex)
Not
Bu örnekteki kod parçacıkları Python için Uygulama Yapılandırması istemci kitaplığını kullanmaya başlamanıza yardımcı olacaktır. Uygulamanız için özel durumları gereksinimlerinize göre işlemeyi de göz önünde bulundurmanız gerekir. Özel durum işleme hakkında daha fazla bilgi edinmek için lütfen Python SDK belgelerimize bakın.
Uygulama Yapılandırması bağlantı dizesi yapılandırma
AZURE_APPCONFIG_CONNECTION_STRING adlı bir ortam değişkeni ayarlayın ve bunu Uygulama Yapılandırması deponuzun bağlantı dizesi olarak ayarlayın. Komut satırında aşağıdaki komutu çalıştırın:
Uygulamayı Windows komut istemini kullanarak yerel olarak çalıştırmak için aşağıdaki komutu çalıştırın ve öğesini uygulama yapılandırma deponuzun bağlantı dizesi ile değiştirin
<app-configuration-store-connection-string>
:setx AZURE_APPCONFIG_CONNECTION_STRING "connection-string-of-your-app-configuration-store"
Ortam değişkeninin değerini yazdırarak aşağıdaki komutla doğru şekilde ayarlandığını doğrulayın.
Windows komut istemini kullanarak, değişikliğin etkili olması için komut istemini yeniden başlatın ve aşağıdaki komutu çalıştırın:
echo %AZURE_APPCONFIG_CONNECTION_STRING%
Kod örnekleri
Bu bölümdeki örnek kod parçacıkları, Python için Uygulama Yapılandırması istemci kitaplığıyla ortak işlemlerin nasıl gerçekleştirileceğini gösterir. Bu kod parçacıklarını try
daha önce oluşturduğunuz app-configuration-example.py dosyasındaki bloğa ekleyin.
Not
Uygulama Yapılandırması istemci kitaplığı, anahtar-değer nesnesine olarak ConfigurationSetting
başvurur. Bu nedenle, bu makalede, Uygulama Yapılandırması deposundaki anahtar-değerler yapılandırma ayarları olarak adlandırılır.
Aşağıdakilerin nasıl yapılacağını öğrenin:
- Uygulama Yapılandırması mağazasına Bağlan
- Yapılandırma ayarı alma
- Yapılandırma ayarı ekleme
- Yapılandırma ayarlarının listesini alma
- Yapılandırma ayarını kilitleme
- Yapılandırma ayarının kilidini açma
- Yapılandırma ayarını güncelleştirme
- Yapılandırma ayarını silme
Uygulama Yapılandırması mağazasına Bağlan
Aşağıdaki kod parçacığı, ortam değişkenlerinizde depolanan bağlantı dizesi kullanarak bir AzureAppConfigurationClient örneği oluşturur.
connection_string = os.getenv('AZURE_APPCONFIG_CONNECTION_STRING')
app_config_client = AzureAppConfigurationClient.from_connection_string(connection_string)
Yapılandırma ayarı alma
Aşağıdaki kod parçacığı ada göre key
bir yapılandırma ayarı alır.
retrieved_config_setting = app_config_client.get_configuration_setting(key='TestApp:Settings:Message')
print("\nRetrieved configuration setting:")
print("Key: " + retrieved_config_setting.key + ", Value: " + retrieved_config_setting.value)
Yapılandırma ayarı ekleme
Aşağıdaki kod parçacığı ve value
alanlarıyla key
bir ConfigurationSetting
nesne oluşturur ve yöntemini çağırıradd_configuration_setting
.
Deponuzda zaten var olan bir yapılandırma ayarı eklemeye çalışırsanız bu yöntem bir özel durum oluşturur. Bu özel durumdan kaçınmak istiyorsanız, bunun yerine set_configuration_setting yöntemi kullanılabilir.
config_setting = ConfigurationSetting(
key='TestApp:Settings:NewSetting',
value='New setting value'
)
added_config_setting = app_config_client.add_configuration_setting(config_setting)
print("\nAdded configuration setting:")
print("Key: " + added_config_setting.key + ", Value: " + added_config_setting.value)
Yapılandırma ayarlarının listesini alma
Aşağıdaki kod parçacığı yapılandırma ayarlarının listesini alır. key_filter
ve label_filter
bağımsız değişkenleri sırasıyla ve label
temelinde key
anahtar-değerleri filtrelemek için sağlanabilir. Filtreleme hakkında daha fazla bilgi için bkz. Yapılandırma ayarlarını sorgulama.
filtered_settings_list = app_config_client.list_configuration_settings(key_filter="TestApp*")
print("\nRetrieved list of configuration settings:")
for item in filtered_settings_list:
print("Key: " + item.key + ", Value: " + item.value)
Yapılandırma ayarını kilitleme
Uygulama Yapılandırması anahtar değerinin kilit durumu, nesnenin read_only
ConfigurationSetting
özniteliğiyle belirtilir. ise read_only
True
, ayar kilitlidir. yöntemi, set_read_only
yapılandırma ayarını kilitlemek için bağımsız değişkenle read_only=True
çağrılabilir.
locked_config_setting = app_config_client.set_read_only(added_config_setting, read_only=True)
print("\nRead-only status for " + locked_config_setting.key + ": " + str(locked_config_setting.read_only))
Yapılandırma ayarının kilidini açma
read_only
özniteliği ConfigurationSetting
ise False
ayarın kilidi açılır. yöntemi, set_read_only
yapılandırma ayarının kilidini açmak için bağımsız değişkenle read_only=False
çağrılabilir.
unlocked_config_setting = app_config_client.set_read_only(locked_config_setting, read_only=False)
print("\nRead-only status for " + unlocked_config_setting.key + ": " + str(unlocked_config_setting.read_only))
Yapılandırma ayarını güncelleştirme
yöntemi set_configuration_setting
mevcut bir ayarı güncelleştirmek veya yeni bir ayar oluşturmak için kullanılabilir. Aşağıdaki kod parçacığı, mevcut yapılandırma ayarının değerini değiştirir.
added_config_setting.value = "Value has been updated!"
updated_config_setting = app_config_client.set_configuration_setting(added_config_setting)
print("\nUpdated configuration setting:")
print("Key: " + updated_config_setting.key + ", Value: " + updated_config_setting.value)
Yapılandırma ayarını silme
Aşağıdaki kod parçacığı bir yapılandırma ayarını ada göre key
siler.
deleted_config_setting = app_config_client.delete_configuration_setting(key="TestApp:Settings:NewSetting")
print("\nDeleted configuration setting:")
print("Key: " + deleted_config_setting.key + ", Value: " + deleted_config_setting.value)
Uygulamayı çalıştırma
Bu örnekte, Azure portalı aracılığıyla oluşturulan bir yapılandırma ayarını almak, yeni bir ayar eklemek, var olan ayarların listesini almak, bir ayarı kilitleyip kilidini açmak, bir ayarı güncelleştirmek ve son olarak bir ayarı silmek için Azure Uygulaması Yapılandırma istemci kitaplığını kullanan bir Python uygulaması oluşturdunuz.
Bu noktada, app-configuration-example.py dosyanızda aşağıdaki kod bulunmalıdır:
import os
from azure.appconfiguration import AzureAppConfigurationClient, ConfigurationSetting
try:
print("Azure App Configuration - Python example")
# Example code goes here
connection_string = os.getenv('AZURE_APPCONFIG_CONNECTION_STRING')
app_config_client = AzureAppConfigurationClient.from_connection_string(connection_string)
retrieved_config_setting = app_config_client.get_configuration_setting(key='TestApp:Settings:Message')
print("\nRetrieved configuration setting:")
print("Key: " + retrieved_config_setting.key + ", Value: " + retrieved_config_setting.value)
config_setting = ConfigurationSetting(
key='TestApp:Settings:NewSetting',
value='New setting value'
)
added_config_setting = app_config_client.add_configuration_setting(config_setting)
print("\nAdded configuration setting:")
print("Key: " + added_config_setting.key + ", Value: " + added_config_setting.value)
filtered_settings_list = app_config_client.list_configuration_settings(key_filter="TestApp*")
print("\nRetrieved list of configuration settings:")
for item in filtered_settings_list:
print("Key: " + item.key + ", Value: " + item.value)
locked_config_setting = app_config_client.set_read_only(added_config_setting, read_only=True)
print("\nRead-only status for " + locked_config_setting.key + ": " + str(locked_config_setting.read_only))
unlocked_config_setting = app_config_client.set_read_only(locked_config_setting, read_only=False)
print("\nRead-only status for " + unlocked_config_setting.key + ": " + str(unlocked_config_setting.read_only))
added_config_setting.value = "Value has been updated!"
updated_config_setting = app_config_client.set_configuration_setting(added_config_setting)
print("\nUpdated configuration setting:")
print("Key: " + updated_config_setting.key + ", Value: " + updated_config_setting.value)
deleted_config_setting = app_config_client.delete_configuration_setting(key="TestApp:Settings:NewSetting")
print("\nDeleted configuration setting:")
print("Key: " + deleted_config_setting.key + ", Value: " + deleted_config_setting.value)
except Exception as ex:
print('Exception:')
print(ex)
Konsol pencerenizde, app-configuration-example.py dosyasını içeren dizine gidin ve aşağıdaki Python komutunu yürüterek uygulamayı çalıştırın:
python app-configuration-example.py
Aşağıdaki çıkışı görmeniz gerekir:
Azure App Configuration - Python example
Retrieved configuration setting:
Key: TestApp:Settings:Message, Value: Data from Azure App Configuration
Added configuration setting:
Key: TestApp:Settings:NewSetting, Value: New setting value
Retrieved list of configuration settings:
Key: TestApp:Settings:Message, Value: Data from Azure App Configuration
Key: TestApp:Settings:NewSetting, Value: New setting value
Read-only status for TestApp:Settings:NewSetting: True
Read-only status for TestApp:Settings:NewSetting: False
Updated configuration setting:
Key: TestApp:Settings:NewSetting, Value: Value has been updated!
Deleted configuration setting:
Key: TestApp:Settings:NewSetting, Value: Value has been updated!
Kaynakları temizleme
Bu makalede oluşturulan kaynakları kullanmaya devam etmek istemiyorsanız ücretlerden kaçınmak için burada oluşturduğunuz kaynak grubunu silin.
Önemli
Silinen kaynak grupları geri alınamaz. Kaynak grubu ve içindeki tüm kaynaklar kalıcı olarak silinir. Yanlış kaynak grubunu veya kaynakları yanlışlıkla silmediğinizden emin olun. Bu makalenin kaynaklarını, saklamak istediğiniz diğer kaynakları içeren bir kaynak grubu içinde oluşturduysanız, kaynak grubunu silmek yerine her kaynağı ilgili bölmeden tek tek silin.
- Azure portalında oturum açın ve Kaynak grupları'nı seçin.
- Ada göre filtrele kutusuna kaynak grubunuzun adını girin.
- Genel bir bakış görmek için sonuç listesinde kaynak grubu adını seçin.
- Kaynak grubunu sil'i seçin.
- Kaynak grubunun silinmesini onaylamanız istenir. Onaylamak için kaynak grubunuzun adını girin ve Sil'i seçin.
Birkaç dakika sonra kaynak grubu ve tüm kaynakları silinir.
Sonraki adımlar
Bu kılavuzda, Azure Uygulaması Yapılandırması'ndaki verilerinize erişmek için Python için Azure SDK'nın nasıl kullanılacağı gösterildi.
Ek kod örnekleri için şu adresi ziyaret edin:
Python uygulamalarıyla Azure Uygulaması Yapılandırması'nı kullanmayı öğrenmek için şuraya gidin: