Erstellen einer Python-App mit dem Azure SDK für Python

Dieses Dokument enthält Beispiele für den Zugriff auf Ihre Daten in Azure App Configuration unter Verwendung des Azure SDK für Python.

Tipp

App Configuration bietet eine Python-Anbieterbibliothek, die auf dem Python SDK basiert und mit umfangreicheren Features einfacher zu verwenden ist. Konfigurationseinstellungen können damit wie ein Wörterbuch verwendet werden. Außerdem stehen weitere Features wie die Konfigurationserstellung auf der Grundlage mehrerer Bezeichnungen, die Kürzung von Schlüsselnamen sowie die automatische Auflösung von Key Vault-Verweisen zur Verfügung. Weitere Informationen finden Sie in der Python-Schnellstartanleitung.

Voraussetzungen

• Azure-Abonnement – Erstellen eines kostenlosen Kontos
• Python 3.8 oder höher: Informationen zum Einrichten von Python unter Windows finden Sie in der Dokumentation zu Python unter Windows.
• Ein App Configuration-Speicher. Hier finden Sie Informationen zum Erstellen eines Speichers.

Erstellen eines Schlüssel-Wert-Paars

Fügen Sie dem App Configuration-Speicher die folgenden Schlüssel-Wert-Paare hinzu, und übernehmen Sie für Bezeichnung und Inhaltstyp die Standardwerte. Weitere Informationen zum Hinzufügen von Schlüssel-Wert-Paaren zu einem Speicher mithilfe des Azure-Portals oder der CLI finden Sie unter Erstellen eines Schlüssel-Wert-Paars.

Schlüssel	Wert
TestApp:Settings:Message	Daten aus Azure App Configuration

Einrichten der Python-App

1. Erstellen Sie ein neues Verzeichnis für das Projekt, und nennen Sie es app-configuration-example.

   mkdir app-configuration-example
   

2. Wechseln Sie zu dem neu erstellten Verzeichnis app-configuration-example.

   cd app-configuration-example
   

3. Installieren Sie die Azure App Configuration-Clientbibliothek mit dem Befehl pip install.

   pip install azure-appconfiguration
   

4. Erstellen Sie im Verzeichnis app-configuration-example eine neue Datei mit dem Namen app-configuration-example.py, und fügen Sie ihr den folgenden Code hinzu:

   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)
   

Hinweis

Die Codeschnipsel in dieser Schnellstartanleitung helfen Ihnen bei den ersten Schritten mit der App Configuration-Clientbibliothek für Python. Für Ihre Anwendung sollten Sie auch berücksichtigen, dass Ausnahmen je nach Ihren Anforderungen verarbeitet werden. Weitere Informationen zur Behandlung von Ausnahmen finden Sie in unserer Dokumentation zum Python SDK.

Konfigurieren der App Configuration-Verbindungszeichenfolge

1. Legen Sie eine Umgebungsvariable mit dem Namen AZURE_APPCONFIG_CONNECTION_STRING auf die Verbindungszeichenfolge für Ihren App Configuration-Speicher fest. Führen Sie an der Befehlszeile den folgenden Befehl aus:

   Windows-Eingabeaufforderung

   Um die App mithilfe der Windows-Eingabeaufforderung lokal auszuführen, führen Sie den folgenden Befehl aus, und ersetzen Sie dabei <app-configuration-store-connection-string> durch die Verbindungszeichenfolge Ihres App-Konfigurationsspeichers:

   setx AZURE_APPCONFIG_CONNECTION_STRING "connection-string-of-your-app-configuration-store"
   

   PowerShell

   Wenn Sie Windows PowerShell verwenden, führen Sie den folgenden Befehl aus, und ersetzen Sie dabei <app-configuration-store-connection-string> durch die Verbindungszeichenfolge Ihres App-Konfigurationsspeichers:

   $Env:AZURE_APPCONFIG_CONNECTION_STRING = "<app-configuration-store-connection-string>"
   

   macOS

   Wenn Sie macOS verwenden, führen Sie den folgenden Befehl aus, und ersetzen Sie dabei <app-configuration-store-connection-string> durch die Verbindungszeichenfolge Ihres App-Konfigurationsspeichers:

   export AZURE_APPCONFIG_CONNECTION_STRING='<app-configuration-store-connection-string>'
   

   Linux

   Wenn Sie Linux verwenden, führen Sie den folgenden Befehl aus, und ersetzen Sie dabei <app-configuration-store-connection-string> durch die Verbindungszeichenfolge Ihres App-Konfigurationsspeichers:

   export AZURE_APPCONFIG_CONNECTION_STRING='<app-configuration-store-connection-string>'
   

2. Geben Sie mit dem unten stehenden Befehl den Wert der Umgebungsvariablen aus, um zu überprüfen, ob sie richtig festgelegt wurde.

   Windows-Eingabeaufforderung

   Starten Sie die Eingabeaufforderung über eine Windows-Eingabeaufforderung neu, damit die Änderung wirksam wird, und führen Sie den folgenden Befehl aus:

   echo %AZURE_APPCONFIG_CONNECTION_STRING%
   

   PowerShell

   Führen Sie bei Verwendung von Windows PowerShell den folgenden Befehl aus:

   $Env:AZURE_APPCONFIG_CONNECTION_STRING
   

   macOS

   Führen Sie bei Verwendung von macOS den folgenden Befehl aus:

   echo "$AZURE_APPCONFIG_CONNECTION_STRING"
   

   Linux

   Führen Sie bei Verwendung von Linux den folgenden Befehl aus:

   echo "$AZURE_APPCONFIG_CONNECTION_STRING"
   

Codebeispiele

Anhand der Beispielcodeausschnitte in diesem Abschnitt wird veranschaulicht, wie Sie häufige Vorgänge mit der App Configuration-Clientbibliothek für Python durchführen. Fügen Sie diese Codeausschnipsel dem Block try in der Datei app-configuration-example.py hinzu, die Sie weiter oben erstellt haben.

Hinweis

In der App Configuration-Clientbibliothek wird auf ein Schlüssel-Wert-Objekt als ConfigurationSetting verwiesen. Daher werden die Schlüsselwerte im App Configuration-Speicher als Konfigurationseinstellungen bezeichnet.

Unter den folgenden Links finden Sie Anleitungen für die entsprechenden Aktionen:

• Herstellen einer Verbindung mit einem App Configuration-Speicher
• Abrufen einer Konfigurationseinstellung
• Hinzufügen einer Konfigurationseinstellung
• Abrufen einer Liste mit Konfigurationseinstellungen
• Sperren einer Konfigurationseinstellung
• Entsperren einer Konfigurationseinstellung
• Aktualisieren einer Konfigurationseinstellung
• Löschen einer Konfigurationseinstellung

Herstellen einer Verbindung mit einem App Configuration-Speicher

Mit dem folgenden Codeausschnitt wird eine Instanz von AzureAppConfigurationClient erstellt, indem die in Ihren Umgebungsvariablen gespeicherte Verbindungszeichenfolge verwendet wird.

    connection_string = os.getenv('AZURE_APPCONFIG_CONNECTION_STRING')
    app_config_client = AzureAppConfigurationClient.from_connection_string(connection_string)

Abrufen einer Konfigurationseinstellung

Mit dem folgenden Codeausschnitt wird eine Konfigurationseinstellung anhand des key-Namens abgerufen.

    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)

Hinzufügen einer Konfigurationseinstellung

Mit dem folgenden Codeausschnitt wird ein ConfigurationSetting-Objekt mit den Feldern key und value erstellt und die Methode add_configuration_setting aufgerufen. Diese Methode löst eine Ausnahme aus, wenn Sie versuchen, eine Konfigurationseinstellung hinzuzufügen, die in Ihrem Speicher bereits vorhanden ist. Wenn Sie die Nutzung dieser Ausnahme vermeiden möchten, können Sie stattdessen die Methode set_configuration_setting verwenden.

    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)

Abrufen einer Liste mit Konfigurationseinstellungen

Mit dem folgenden Codeausschnitt wird eine Liste mit Konfigurationseinstellungen abgerufen. Die Argumente key_filter und label_filter können bereitgestellt werden, um Schlüsselwerte nach key bzw. label zu filtern. Weitere Informationen zum Filtern finden Sie unter Abfragen von Konfigurationseinstellungen.

    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)

Sperren einer Konfigurationseinstellung

Der Sperrstatus eines Schlüsselwerts in App Configuration wird mit dem Attribut read_only des Objekts ConfigurationSetting angegeben. Wenn read_only auf True festgelegt ist, ist diese Einstellung gesperrt. Die Methode set_read_only kann mit dem Argument read_only=True aufgerufen werden, um die Konfigurationseinstellung zu sperren.

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

Entsperren einer Konfigurationseinstellung

Wenn das Attribut read_only für eine Konfigurationseinstellung (ConfigurationSetting) auf False festgelegt ist, ist die Einstellung entsperrt. Die Methode set_read_only kann mit dem Argument read_only=False aufgerufen werden, um die Konfigurationseinstellung zu entsperren.

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

Aktualisieren einer Konfigurationseinstellung

Die Methode set_configuration_setting kann verwendet werden, um eine vorhandene Einstellung zu aktualisieren oder eine neue zu erstellen. Mit dem folgenden Codeausschnitt wird der Wert einer vorhandenen Konfigurationseinstellung geändert.

    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)

Löschen einer Konfigurationseinstellung

Mit dem folgenden Codeausschnitt wird eine Konfigurationseinstellung anhand des key-Namens gelöscht.

    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)

Ausführen der App

In diesem Beispiel haben Sie eine Python-App erstellt, bei der die Azure App Configuration-Clientbibliothek zum Abrufen einer Konfigurationseinstellung verwendet wurde, die mit dem Azure-Portal erstellt wurde. Sie haben eine neue Einstellung hinzugefügt, eine Liste mit vorhandenen Einstellungen abgerufen und eine Einstellung gesperrt, entsperrt, aktualisiert und schließlich gelöscht.

An diesem Punkt sollte Ihre Datei app-configuration-example.py den folgenden Code enthalten:

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)

Navigieren Sie im Konsolenfenster zu dem Verzeichnis, das die Datei app-configuration-example.py enthält, und führen Sie den folgenden Python-Befehl aus, um die App auszuführen:

python app-configuration-example.py

Die folgende Ausgabe wird angezeigt:

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!

Bereinigen von Ressourcen

Wenn Sie die in diesem Artikel erstellten Ressourcen nicht mehr verwenden möchten, löschen Sie die erstellte Ressourcengruppe, um Kosten zu vermeiden.

Wichtig

Das Löschen einer Ressourcengruppe kann nicht rückgängig gemacht werden. Die Ressourcengruppe und alle darin enthaltenen Ressourcen werden unwiderruflich gelöscht. Achten Sie daher darauf, dass Sie nicht versehentlich die falsche Ressourcengruppe oder die falschen Ressourcen löschen. Falls Sie die Ressourcen für diesen Artikel in einer Ressourcengruppe erstellt haben, die andere beizubehaltende Ressourcen enthält, löschen Sie die Ressourcen einzeln über den entsprechenden Bereich, statt die Ressourcengruppe zu löschen.

1. Melden Sie sich beim Azure-Portal an, und klicken Sie auf Ressourcengruppen.
2. Geben Sie im Feld Nach Name filtern den Namen Ihrer Ressourcengruppe ein.
3. Wählen Sie in der Ergebnisliste den Ressourcengruppennamen aus, um eine Übersicht anzuzeigen.
4. Wählen Sie die Option Ressourcengruppe löschen.
5. Sie werden aufgefordert, das Löschen der Ressourcengruppe zu bestätigen. Geben Sie zur Bestätigung den Namen Ihrer Ressourcengruppe ein, und klicken Sie auf Löschen.

Daraufhin werden die Ressourcengruppe und alle darin enthaltenen Ressourcen gelöscht.

Nächste Schritte

In diesem Leitfaden wurde gezeigt, wie Sie das Azure SDK für Python verwenden, um auf Ihre Daten in Azure App Configuration zuzugreifen.

Weitere Codebeispiele finden Sie unter:

Azure App Configuration-Clientbibliothek: Beispiele

Informationen zur Verwendung von Azure App Configuration mit Python-Apps finden Sie hier:

Erstellen einer Python-App mit Azure App Configuration