Benutzerdefinierte Konfigurationsparameter an Funktionen übergeben

Erfahren Sie, wie Sie benutzerdefinierte Konfigurationsparameter an ausgeführte Funktionen mit OCI Functions übergeben.

Der Code in Funktionen, die Sie in OCI Functions bereitstellen, erfordert in der Regel Werte für verschiedene Parameter. Einige vordefinierte Parameter sind für Ihre Funktionen als Umgebungsvariablen verfügbar (siehe Von OCI Functions aufgefüllte Umgebungsvariablen). Häufig sollen Ihre Funktionen jedoch Parameter verwenden, die Sie selbst definiert haben. Beispiel: Sie können eine Funktion erstellen, die aus einer Datenbank liest und in eine Datenbank schreibt. Die Funktion erfordert eine Datenbankverbindungszeichenfolge, die einen Benutzernamen, ein Kennwort und einen Hostnamen enthält. Möglicherweise möchten Sie Benutzername, Kennwort und Hostname als Parameter definieren, die an die Funktion bei ihrem Aufruf übergeben werden.

Um benutzerdefinierte Parameter an eine Funktion zu übergeben, die in OCI Functions bereitgestellt wird, erstellen Sie Schlüssel/Wert-Paare. Diese werden als benutzerdefinierte Konfigurationsparameter bezeichnet. Sie können benutzerdefinierte Konfigurationsparameter erstellen, die:

  • anwendungsweit sind, d.h. sie werden an jede Funktion in einer Anwendung übergeben.
  • funktionsspezifisch sind, d.h. sie werden an die bestimmte Funktion übergeben, für die sie definiert sind (funktionsspezifische Parameter setzen anwendungsweite Parameter mit demselben Namen außer Kraft).

Die von Ihnen erstellten benutzerdefinierten Konfigurationsparameter werden auch als Umgebungsvariablen festgelegt.

Um benutzerdefinierte Konfigurationsparameter zu erstellen, können Sie Folgendes verwenden:

  • Abschnitt config: der Datei "func.yaml" einer Funktion, um funktionsspezifische benutzerdefinierte Konfigurationsparameter zu definieren
  • Konsole und Fn-Projekt-CLI, um anwendungs- und funktionsspezifische benutzerdefinierte Konfigurationsparameter zu definieren

OCI Functions kombiniert alle benutzerdefinierten Konfigurationsparameter (anwendungsweit und funktionsspezifisch) in der Anwendung in einem einzelnen, seriell codierten Konfigurationsobjekt mit einer maximal zulässigen Größe von 4 Kb.

Wenn Sie anschließend den Wert eines benutzerdefinierten Konfigurationsparameters ändern, wird die Änderung fast sofort angewendet. Die Änderung wird jedoch erst wirksam, wenn die Funktion erneut aufgerufen wird.

Sie können benutzerdefinierte Konfigurationsparameter angeben, die mit der Konsole, der Fn-Projekt-CLI und der API an Funktionen übergeben werden sollen. Siehe Benutzerdefinierte Konfigurationsparameter zum Übergeben an Funktionen angeben.