CosmosDBv4FunctionOptions interface

Extends

Eigenschaften

handler
retry

Eine optionale Wiederholungsrichtlinie, um eine fehlgeschlagene Ausführung erneut auszuführen, bis entweder der erfolgreiche Abschluss erfolgt oder die maximale Anzahl von Wiederholungen erreicht ist. Weitere hier

trigger

Geerbte Eigenschaften

connection

Eine App-Einstellung (oder Umgebungsvariable) mit der Cosmos DB-Verbindungszeichenfolge

containerName

Der Name des überwachten Containers

createLeaseContainerIfNotExists

Überprüft das Vorhandensein und erstellt automatisch den Leasecontainer. Der Standardwert ist false

databaseName

Der Name der Azure Cosmos DB-Datenbank mit dem zu überwachenden Container

extraInputs

Konfiguration für einen optionalen Satz sekundärer Eingaben während des Aufrufs erhalten Sie diese Werte mit context.extraInputs.get()

extraOutputs

Konfiguration für einen optionalen Satz von sekundären Ausgaben während des Aufrufs, legen Sie diese Werte mit context.extraOutputs.set()

feedPollDelay

Die Zeit (in Millisekunden) für die Verzögerung zwischen dem Abrufen einer Partition für neue Änderungen am Feed, nachdem alle aktuellen Änderungen entwässert wurden. Der Standardwert ist 5.000 Millisekunden oder 5 Sekunden.

leaseAcquireInterval

Wenn festgelegt, definiert es in Millisekunden das Intervall, um eine Aufgabe zu starten, um zu berechnen, ob Partitionen gleichmäßig auf bekannte Hostinstanzen verteilt werden. Der Standardwert ist 13000 (13 Sekunden).

leaseConnection

Der Name einer App-Einstellung, die die Verbindungszeichenfolge mit dem Dienst enthält, der den Leasecontainer enthält. Wenn sie nicht festgelegt ist, wird eine Verbindung mit dem von connection definierten Dienst hergestellt.

leaseContainerName

Der Name des Containers zum Speichern von Leases. Wenn nicht festgelegt, wird "Leases" verwendet.

leaseContainerPrefix

Bei Festlegung wird der Wert als Präfix zu den im Leasecontainer für diese Funktion erstellten Leases hinzugefügt. Durch die Verwendung eines Präfixes können zwei separate Azure-Funktionen denselben Leasecontainer mit unterschiedlichen Präfixen gemeinsam nutzen.

leaseDatabaseName

Der Name der Datenbank, die den Container zum Speichern von Leases enthält. Wenn sie nicht festgelegt ist, wird der Wert von databaseName

leaseExpirationInterval

Wenn festgelegt, definiert sie in Millisekunden das Intervall, für das die Lease für eine Lease übernommen wird, die eine Partition darstellt. Wenn die Lease innerhalb dieses Intervalls nicht verlängert wird, läuft sie ab, und der Besitz der Partition wird zu einer anderen Instanz verschoben. Der Standardwert ist 60000 (60 Sekunden).

leaseRenewInterval

Wenn festgelegt, definiert sie in Millisekunden das Verlängerungsintervall für alle Leases für Partitionen, die derzeit von einer Instanz gehalten werden. Der Standardwert ist 17000 (17 Sekunden).

leasesContainerThroughput

Wenn createLeaseContainerIfNotExists auf truefestgelegt ist, definiert die Anzahl der Anforderungseinheiten, die dem erstellten Leasecontainer zugewiesen werden sollen.

maxItemsPerInvocation

Bei Festlegung legt diese Eigenschaft die maximale Anzahl der pro Funktionsaufruf empfangenen Elemente fest. Wenn Vorgänge im überwachten Container über gespeicherte Prozeduren ausgeführt werden, wird der Transaktionsbereich beim Lesen von Elementen aus dem Änderungsfeed beibehalten. Daher könnte die Anzahl der empfangenen Elemente höher als der angegebene Wert sein, sodass die von derselben Transaktion geänderten Elemente als Teil eines Atombatches zurückgegeben werden.

preferredLocations

Definiert bevorzugte Standorte (Regionen) für georeplizierte Datenbankkonten im Azure Cosmos DB-Dienst. Werte sollten durch Trennzeichen getrennt sein. Beispiel: Ost-USA,Süd-Mittel-USA,Nordeuropa

return

Konfiguration für die optionale primäre Ausgabe der Funktion Dies ist die Hauptausgabe, die Sie während des Aufrufs als Rückgabewert des Funktionshandlers festlegen sollten.

startFromBeginning

Diese Option weist den Trigger an, Änderungen vom Anfang des Änderungsverlaufs des Containers zu lesen, anstatt zur aktuellen Zeit zu beginnen. Das Lesen von Anfang an funktioniert nur, wenn der Trigger zum ersten Mal gestartet wird, wie in nachfolgenden Läufen, die Prüfpunkte bereits gespeichert sind. Das Festlegen dieser Option auf "true", wenn bereits erstellte Leases vorhanden sind, hat keine Auswirkung.

startFromTime

Dient zum Abrufen oder Festlegen des Datums und der Uhrzeit zum Initialisieren des Änderungsfeedlesevorgangs. Das empfohlene Format ist ISO 8601 mit dem UTC-Kennzeichner, z. B. 2021-02-16T14:19:29Z. Dies wird nur verwendet, um den anfänglichen Triggerzustand festzulegen. Nachdem der Auslöser einen Leasestatus aufweist, hat das Ändern dieses Werts keine Auswirkung.

Details zur Eigenschaft

handler

handler: CosmosDBv4Handler

Eigenschaftswert

retry

Eine optionale Wiederholungsrichtlinie, um eine fehlgeschlagene Ausführung erneut auszuführen, bis entweder der erfolgreiche Abschluss erfolgt oder die maximale Anzahl von Wiederholungen erreicht ist. Weitere hier

retry?: RetryOptions

Eigenschaftswert

trigger

trigger?: CosmosDBv4Trigger

Eigenschaftswert

Geerbte Eigenschaftsdetails

connection

Eine App-Einstellung (oder Umgebungsvariable) mit der Cosmos DB-Verbindungszeichenfolge

connection: string

Eigenschaftswert

string

geerbt vonCosmosDBv4TriggerOptions.connection

containerName

Der Name des überwachten Containers

containerName: string

Eigenschaftswert

string

vonCosmosDBv4TriggerOptions.containerName

createLeaseContainerIfNotExists

Überprüft das Vorhandensein und erstellt automatisch den Leasecontainer. Der Standardwert ist false

createLeaseContainerIfNotExists?: boolean

Eigenschaftswert

boolean

geerbt vonCosmosDBv4TriggerOptions.createLeaseContainerIfNotExists

databaseName

Der Name der Azure Cosmos DB-Datenbank mit dem zu überwachenden Container

databaseName: string

Eigenschaftswert

string

vonCosmosDBv4TriggerOptions.databaseName

extraInputs

Konfiguration für einen optionalen Satz sekundärer Eingaben während des Aufrufs erhalten Sie diese Werte mit context.extraInputs.get()

extraInputs?: FunctionInput[]

Eigenschaftswert

geerbt von Partial.extraInputs

extraOutputs

Konfiguration für einen optionalen Satz von sekundären Ausgaben während des Aufrufs, legen Sie diese Werte mit context.extraOutputs.set()

extraOutputs?: FunctionOutput[]

Eigenschaftswert

geerbt von Partial.extraOutputs

feedPollDelay

Die Zeit (in Millisekunden) für die Verzögerung zwischen dem Abrufen einer Partition für neue Änderungen am Feed, nachdem alle aktuellen Änderungen entwässert wurden. Der Standardwert ist 5.000 Millisekunden oder 5 Sekunden.

feedPollDelay?: number

Eigenschaftswert

number

Geerbt vonCosmosDBv4TriggerOptions.feedPollDelay

leaseAcquireInterval

Wenn festgelegt, definiert es in Millisekunden das Intervall, um eine Aufgabe zu starten, um zu berechnen, ob Partitionen gleichmäßig auf bekannte Hostinstanzen verteilt werden. Der Standardwert ist 13000 (13 Sekunden).

leaseAcquireInterval?: number

Eigenschaftswert

number

geerbt vonCosmosDBv4TriggerOptions.leaseAcquireInterval

leaseConnection

Der Name einer App-Einstellung, die die Verbindungszeichenfolge mit dem Dienst enthält, der den Leasecontainer enthält. Wenn sie nicht festgelegt ist, wird eine Verbindung mit dem von connection definierten Dienst hergestellt.

leaseConnection?: string

Eigenschaftswert

string

geerbt vonCosmosDBv4TriggerOptions.leaseConnection

leaseContainerName

Der Name des Containers zum Speichern von Leases. Wenn nicht festgelegt, wird "Leases" verwendet.

leaseContainerName?: string

Eigenschaftswert

string

geerbt vonCosmosDBv4TriggerOptions.leaseContainerName

leaseContainerPrefix

Bei Festlegung wird der Wert als Präfix zu den im Leasecontainer für diese Funktion erstellten Leases hinzugefügt. Durch die Verwendung eines Präfixes können zwei separate Azure-Funktionen denselben Leasecontainer mit unterschiedlichen Präfixen gemeinsam nutzen.

leaseContainerPrefix?: string

Eigenschaftswert

string

vonCosmosDBv4TriggerOptions.leaseContainerPrefix geerbt

leaseDatabaseName

Der Name der Datenbank, die den Container zum Speichern von Leases enthält. Wenn sie nicht festgelegt ist, wird der Wert von databaseName

leaseDatabaseName?: string

Eigenschaftswert

string

geerbt vonCosmosDBv4TriggerOptions.leaseDatabaseName

leaseExpirationInterval

Wenn festgelegt, definiert sie in Millisekunden das Intervall, für das die Lease für eine Lease übernommen wird, die eine Partition darstellt. Wenn die Lease innerhalb dieses Intervalls nicht verlängert wird, läuft sie ab, und der Besitz der Partition wird zu einer anderen Instanz verschoben. Der Standardwert ist 60000 (60 Sekunden).

leaseExpirationInterval?: number

Eigenschaftswert

number

vonCosmosDBv4TriggerOptions.leaseExpirationInterval

leaseRenewInterval

Wenn festgelegt, definiert sie in Millisekunden das Verlängerungsintervall für alle Leases für Partitionen, die derzeit von einer Instanz gehalten werden. Der Standardwert ist 17000 (17 Sekunden).

leaseRenewInterval?: number

Eigenschaftswert

number

vonCosmosDBv4TriggerOptions.leaseRenewInterval

leasesContainerThroughput

Wenn createLeaseContainerIfNotExists auf truefestgelegt ist, definiert die Anzahl der Anforderungseinheiten, die dem erstellten Leasecontainer zugewiesen werden sollen.

leasesContainerThroughput?: number

Eigenschaftswert

number

Geerbt vonCosmosDBv4TriggerOptions.leasesContainerThroughput

maxItemsPerInvocation

Bei Festlegung legt diese Eigenschaft die maximale Anzahl der pro Funktionsaufruf empfangenen Elemente fest. Wenn Vorgänge im überwachten Container über gespeicherte Prozeduren ausgeführt werden, wird der Transaktionsbereich beim Lesen von Elementen aus dem Änderungsfeed beibehalten. Daher könnte die Anzahl der empfangenen Elemente höher als der angegebene Wert sein, sodass die von derselben Transaktion geänderten Elemente als Teil eines Atombatches zurückgegeben werden.

maxItemsPerInvocation?: number

Eigenschaftswert

number

geerbt vonCosmosDBv4TriggerOptions.maxItemsPerInvocation

preferredLocations

Definiert bevorzugte Standorte (Regionen) für georeplizierte Datenbankkonten im Azure Cosmos DB-Dienst. Werte sollten durch Trennzeichen getrennt sein. Beispiel: Ost-USA,Süd-Mittel-USA,Nordeuropa

preferredLocations?: string

Eigenschaftswert

string

Geerbt vonCosmosDBv4TriggerOptions.preferredLocations

return

Konfiguration für die optionale primäre Ausgabe der Funktion Dies ist die Hauptausgabe, die Sie während des Aufrufs als Rückgabewert des Funktionshandlers festlegen sollten.

return?: FunctionOutput

Eigenschaftswert

Geerbt von Partial.return

startFromBeginning

Diese Option weist den Trigger an, Änderungen vom Anfang des Änderungsverlaufs des Containers zu lesen, anstatt zur aktuellen Zeit zu beginnen. Das Lesen von Anfang an funktioniert nur, wenn der Trigger zum ersten Mal gestartet wird, wie in nachfolgenden Läufen, die Prüfpunkte bereits gespeichert sind. Das Festlegen dieser Option auf "true", wenn bereits erstellte Leases vorhanden sind, hat keine Auswirkung.

startFromBeginning?: boolean

Eigenschaftswert

boolean

Geerbt vonCosmosDBv4TriggerOptions.startFromBeginning

startFromTime

Dient zum Abrufen oder Festlegen des Datums und der Uhrzeit zum Initialisieren des Änderungsfeedlesevorgangs. Das empfohlene Format ist ISO 8601 mit dem UTC-Kennzeichner, z. B. 2021-02-16T14:19:29Z. Dies wird nur verwendet, um den anfänglichen Triggerzustand festzulegen. Nachdem der Auslöser einen Leasestatus aufweist, hat das Ändern dieses Werts keine Auswirkung.

startFromTime?: string

Eigenschaftswert

string

Geerbt vonCosmosDBv4TriggerOptions.startFromTime-