Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Verwenden Sie Laufzeiteigenschaften in Managed Service für Apache Flink
Sie können *Laufzeiteigenschaften* verwenden, um Ihre Anwendung zu konfigurieren, ohne Ihren Anwendungscode neu zu kompilieren.
**Topics**
+ [Verwalten Sie Runtime-Eigenschaften mithilfe der Konsole](#how-properties-console)
+ [Laufzeiteigenschaften mit der CLI verwalten](#how-properties-cli)
+ [Greifen Sie auf Laufzeiteigenschaften in einer Managed Service for Apache Flink-Anwendung zu](#how-properties-access)
## Verwalten Sie Runtime-Eigenschaften mithilfe der Konsole
Sie können Runtime-Eigenschaften zu Ihrer Managed Service for Apache Flink-Anwendung hinzufügen, aktualisieren oder entfernen, indem Sie AWS-Managementkonsole
**Anmerkung**
Wenn Sie eine frühere unterstützte Version von Apache Flink verwenden und Ihre vorhandenen Anwendungen auf Apache Flink 1.19.1 aktualisieren möchten, können Sie dazu direkte Apache Flink-Versionsupgrades verwenden. Mit direkten Versionsupgrades behalten Sie die Rückverfolgbarkeit von Anwendungen anhand eines einzigen ARN für alle Apache Flink-Versionen, einschließlich Snapshots, Logs, Metriken, Tags, Flink-Konfigurationen und mehr. Sie können diese Funktion in jedem beliebigen Bundesstaat verwenden. `RUNNING` `READY` Weitere Informationen finden Sie unter [Verwenden Sie direkte Versionsupgrades für Apache Flink](how-in-place-version-upgrades.md).
**Aktualisieren von Laufzeiteigenschaften für eine Anwendung, die Managed Service für Apache Flink nutzt**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon MSF-Konsole unter https://console.aws.amazon.com /flink.
1. Wählen Sie Ihre Anwendung, die Managed Service für Apache Flink nutzt. Wählen Sie **Anwendungsdetails** aus.
1. Wählen Sie auf der Seite für Ihre Anwendung **Konfigurieren** aus.
1. Erweitern Sie den Bereich **Eigenschaften**.
1. Verwenden Sie die Steuerelemente im Abschnitt **Eigenschaften**, um eine Eigenschaftsgruppe mit Schlüssel-Wert-Paaren zu definieren. Verwenden Sie diese Steuerelemente, um Eigenschaftsgruppen und Laufzeiteigenschaften hinzuzufügen, zu aktualisieren oder zu entfernen.
1. Wählen Sie **Aktualisieren** aus.
## Laufzeiteigenschaften mit der CLI verwalten
Sie können Laufzeiteigenschaften mit der [AWS CLI](https://docs.aws.amazon.com/cli) hinzufügen, aktualisieren oder entfernen.
Dieser Abschnitt enthält Beispielanfragen für API-Aktionen zur Konfiguration von Laufzeiteigenschaften für eine Anwendung. Weitere Informationen zur Verwendung einer JSON-Datei für die Eingabe einer API-Aktion finden Sie unter [Beispielcode für Managed Service für Apache Flink API](api-examples.md).
**Anmerkung**
Ersetzen Sie die beispielhafte Konto-ID (*`012345678901`*) im folgenden Beispiel durch Ihre tatsächliche Konto-ID.
### Fügen Sie Runtime-Eigenschaften hinzu, wenn Sie eine Anwendung erstellen
Die folgende Beispielanfrage für die [https://docs.aws.amazon.com/managed-service-for-apache-flink/latest/apiv2/API_CreateApplication.html](https://docs.aws.amazon.com/managed-service-for-apache-flink/latest/apiv2/API_CreateApplication.html)-Aktion fügt zwei Laufzeiteigenschaftsgruppen (`ProducerConfigProperties` und `ConsumerConfigProperties`) hinzu, wenn Sie eine Anwendung erstellen:
```
{
"ApplicationName": "MyApplication",
"ApplicationDescription": "my java test app",
"RuntimeEnvironment": "FLINK-1_19",
"ServiceExecutionRole": "arn:aws:iam::012345678901:role/MF-stream-rw-role",
"ApplicationConfiguration": {
"ApplicationCodeConfiguration": {
"CodeContent": {
"S3ContentLocation": {
"BucketARN": "arn:aws:s3:::ka-app-code-username",
"FileKey": "java-getting-started-1.0.jar"
}
},
"CodeContentType": "ZIPFILE"
},
"EnvironmentProperties": {
"PropertyGroups": [
{
"PropertyGroupId": "ProducerConfigProperties",
"PropertyMap" : {
"flink.stream.initpos" : "LATEST",
"aws.region" : "us-west-2",
"AggregationEnabled" : "false"
}
},
{
"PropertyGroupId": "ConsumerConfigProperties",
"PropertyMap" : {
"aws.region" : "us-west-2"
}
}
]
}
}
}
```
### Fügen Sie Runtime-Eigenschaften in einer vorhandenen Anwendung hinzu und aktualisieren Sie sie
Mit der folgenden Beispielanfrage für die [https://docs.aws.amazon.com/managed-service-for-apache-flink/latest/apiv2/API_UpdateApplication.html](https://docs.aws.amazon.com/managed-service-for-apache-flink/latest/apiv2/API_UpdateApplication.html)-Aktion werden Laufzeiteigenschaften für eine bestehende Anwendung hinzugefügt oder aktualisiert:
```
{
"ApplicationName": "MyApplication",
"CurrentApplicationVersionId": 2,
"ApplicationConfigurationUpdate": {
"EnvironmentPropertyUpdates": {
"PropertyGroups": [
{
"PropertyGroupId": "ProducerConfigProperties",
"PropertyMap" : {
"flink.stream.initpos" : "LATEST",
"aws.region" : "us-west-2",
"AggregationEnabled" : "false"
}
},
{
"PropertyGroupId": "ConsumerConfigProperties",
"PropertyMap" : {
"aws.region" : "us-west-2"
}
}
]
}
}
}
```
**Anmerkung**
Wenn Sie in einer Eigenschaftsgruppe einen Schlüssel verwenden, für den keine entsprechende Laufzeiteigenschaft vorhanden ist, fügt Managed Service für Apache Flink das Schlüssel-Wert-Paar als neue Eigenschaft hinzu. Wenn Sie einen Schlüssel für eine vorhandene Laufzeiteigenschaft in einer Eigenschaftsgruppe verwenden, aktualisiert Managed Service für Apache Flink den Eigenschaftswert.
### Laufzeiteigenschaften entfernen
Mit der folgenden Beispielanfrage für die [https://docs.aws.amazon.com/managed-service-for-apache-flink/latest/apiv2/API_UpdateApplication.html](https://docs.aws.amazon.com/managed-service-for-apache-flink/latest/apiv2/API_UpdateApplication.html)-Aktion werden alle Laufzeiteigenschaften und Eigenschaftsgruppen aus einer bestehenden Anwendung entfernt:
```
{
"ApplicationName": "MyApplication",
"CurrentApplicationVersionId": 3,
"ApplicationConfigurationUpdate": {
"EnvironmentPropertyUpdates": {
"PropertyGroups": []
}
}
}
```
**Wichtig**
Wenn Sie eine vorhandene Eigenschaftsgruppe oder einen vorhandenen Eigenschaftsschlüssel in einer Eigenschaftsgruppe weglassen, wird diese Eigenschaftsgruppe oder Eigenschaft entfernt.
## Greifen Sie auf Laufzeiteigenschaften in einer Managed Service for Apache Flink-Anwendung zu
Sie rufen Laufzeiteigenschaften in Ihrem Java-Anwendungscode mithilfe der statischen `KinesisAnalyticsRuntime.getApplicationProperties()`-Methode ab, die ein `Map`-Objekt zurückgibt.
Im folgenden Java-Codebeispiel werden Laufzeiteigenschaften für Ihre Anwendung abgerufen:
```
Map applicationProperties = KinesisAnalyticsRuntime.getApplicationProperties();
```
Sie rufen eine Eigenschaftsgruppe (als `Java.Util.Properties`-Objekt) wie folgt ab:
```
Properties consumerProperties = applicationProperties.get("ConsumerConfigProperties");
```
Normalerweise konfigurieren Sie eine Apache-Flink-Quelle oder -Senke, indem Sie das `Properties`-Objekt übergeben, ohne die einzelnen Eigenschaften abrufen zu müssen. Das folgende Codebeispiel zeigt, wie Sie eine Flink-Quelle erstellen, indem Sie ein `Properties`-Objekt übergeben, das aus Laufzeiteigenschaften abgerufen wurde:
```
private static FlinkKinesisProducer createSinkFromApplicationProperties() throws IOException {
Map applicationProperties = KinesisAnalyticsRuntime.getApplicationProperties();
FlinkKinesisProducer sink = new FlinkKinesisProducer(new SimpleStringSchema(),
applicationProperties.get("ProducerConfigProperties"));
sink.setDefaultStream(outputStreamName);
sink.setDefaultPartition("0");
return sink;
}
```
Codebeispiele finden Sie unter [Beispiele für die Erstellung und Arbeit mit Managed Service für Apache Flink-Anwendungen](examples-collapsibles.md).