CosmosDBv4TriggerOptions interface

パッケージ:

@azure/functions

プロパティ

connection	Cosmos DB 接続文字列を含むアプリ設定 (または環境変数)
containerName	監視対象のコンテナーの名前
createLeaseContainerIfNotExists	存在を確認し、リース コンテナーを自動的に作成します。 既定値は false
databaseName	監視対象のコンテナーを含む Azure Cosmos DB データベースの名前
feedPollDelay	現在のすべての変更がドレインされた後の、フィードの新しい変更についてパーティションをポーリングするまでの遅延時間 (ミリ秒)。 既定値は 5,000 ミリ秒または 5 秒です。
leaseAcquireInterval	設定すると、既知のホスト インスタンス間でパーティションが均等に分散されているかどうかを計算するタスクを開始する間隔がミリ秒単位で定義されます。 既定値は 13000 (13 秒) です。
leaseConnection	リース コンテナーを保持するサービスへの接続文字列を含むアプリ設定の名前。 設定しない場合、connection によって定義されたサービスに接続されます
leaseContainerName	リースを格納するコンテナーの名前。 設定されていない場合は、"リース" を使用します
leaseContainerPrefix	この値を設定すると、この関数の Lease コンテナーで作成されたリースにプレフィックスとして値が追加されます。 プレフィックスを使用すると、2 つの異なる Azure Functions で、異なるプレフィックスを使用して同じリース コンテナーを共有できます。
leaseDatabaseName	リースを格納するコンテナーを保持するデータベースの名前。 設定されていない場合は、databaseName の値が使用されます
leaseExpirationInterval	設定すると、パーティションを表すリースでリースを取得する間隔をミリ秒単位で定義します。 リースがこの期間内に更新されない場合、リースは期限切れになり、パーティションの所有権は別のインスタンスに移動します。 既定値は 60000 (60 秒) です。
leaseRenewInterval	設定すると、インスタンスによって現在保持されているパーティションのすべてのリースの更新間隔がミリ秒単位で定義されます。 既定値は 17000 (17 秒) です。
leasesContainerThroughput	createLeaseContainerIfNotExists が trueに設定されている場合、作成されたリース コンテナーに割り当てる要求ユニットの量を定義します
maxItemsPerInvocation	このプロパティを設定すると、関数呼び出しごとに受信したアイテムの最大数が設定されます。 監視対象コンテナーの操作がストアド プロシージャを通じて実行される場合、変更フィードから項目を読み取るときにトランザクション スコープが保持されます。 その結果、同じトランザクションによって変更されたアイテムが 1 つのアトミック バッチの一部として返されるように、受信した項目の数が指定された値より大きくなる可能性があります。
preferredLocations	Azure Cosmos DB サービスで geo レプリケートされたデータベース アカウントの優先する場所 (リージョン) を定義します。 値はコンマ区切りにする必要があります。 たとえば、米国東部、米国中南部、北ヨーロッパなどです。
startFromBeginning	このオプションは、現在の時刻から開始するのではなく、コンテナーの変更履歴の先頭から変更を読み取るようにトリガーに指示します。 最初からの読み取りは、トリガーが初めて開始されたときにのみ機能します。後続の実行と同様に、チェックポイントは既に格納されています。 リースが既に作成されている場合にこのオプションを true に設定しても効果はありません。
startFromTime	変更フィードの読み取り操作を初期化する日付と時刻を取得または設定します。 推奨される形式は、2021-02-16T14:19:29Z など、UTC 指定子を含む ISO 8601 です。 これは、初期トリガーの状態を設定するためにのみ使用されます。 トリガーがリース状態になると、この値を変更しても効果はありません。

プロパティの詳細

connection

Cosmos DB 接続文字列を含むアプリ設定 (または環境変数)

connection: string

プロパティ値

string

containerName

監視対象のコンテナーの名前

containerName: string

プロパティ値

string

createLeaseContainerIfNotExists

存在を確認し、リース コンテナーを自動的に作成します。 既定値は false

createLeaseContainerIfNotExists?: boolean

プロパティ値

boolean

databaseName

監視対象のコンテナーを含む Azure Cosmos DB データベースの名前

databaseName: string

プロパティ値

string

feedPollDelay

現在のすべての変更がドレインされた後の、フィードの新しい変更についてパーティションをポーリングするまでの遅延時間 (ミリ秒)。 既定値は 5,000 ミリ秒または 5 秒です。

feedPollDelay?: number

プロパティ値

number

leaseAcquireInterval

設定すると、既知のホスト インスタンス間でパーティションが均等に分散されているかどうかを計算するタスクを開始する間隔がミリ秒単位で定義されます。 既定値は 13000 (13 秒) です。

leaseAcquireInterval?: number

プロパティ値

number

leaseConnection

リース コンテナーを保持するサービスへの接続文字列を含むアプリ設定の名前。 設定しない場合、connection によって定義されたサービスに接続されます

leaseConnection?: string

プロパティ値

string

leaseContainerName

リースを格納するコンテナーの名前。 設定されていない場合は、"リース" を使用します

leaseContainerName?: string

プロパティ値

string

leaseContainerPrefix

この値を設定すると、この関数の Lease コンテナーで作成されたリースにプレフィックスとして値が追加されます。 プレフィックスを使用すると、2 つの異なる Azure Functions で、異なるプレフィックスを使用して同じリース コンテナーを共有できます。

leaseContainerPrefix?: string

プロパティ値

string

leaseDatabaseName

リースを格納するコンテナーを保持するデータベースの名前。 設定されていない場合は、databaseName の値が使用されます

leaseDatabaseName?: string

プロパティ値

string

leaseExpirationInterval

設定すると、パーティションを表すリースでリースを取得する間隔をミリ秒単位で定義します。 リースがこの期間内に更新されない場合、リースは期限切れになり、パーティションの所有権は別のインスタンスに移動します。 既定値は 60000 (60 秒) です。

leaseExpirationInterval?: number

プロパティ値

number

leaseRenewInterval

設定すると、インスタンスによって現在保持されているパーティションのすべてのリースの更新間隔がミリ秒単位で定義されます。 既定値は 17000 (17 秒) です。

leaseRenewInterval?: number

プロパティ値

number

leasesContainerThroughput

createLeaseContainerIfNotExists が trueに設定されている場合、作成されたリース コンテナーに割り当てる要求ユニットの量を定義します

leasesContainerThroughput?: number

プロパティ値

number

maxItemsPerInvocation

このプロパティを設定すると、関数呼び出しごとに受信したアイテムの最大数が設定されます。 監視対象コンテナーの操作がストアド プロシージャを通じて実行される場合、変更フィードから項目を読み取るときにトランザクション スコープが保持されます。 その結果、同じトランザクションによって変更されたアイテムが 1 つのアトミック バッチの一部として返されるように、受信した項目の数が指定された値より大きくなる可能性があります。

maxItemsPerInvocation?: number

プロパティ値

number

preferredLocations

Azure Cosmos DB サービスで geo レプリケートされたデータベース アカウントの優先する場所 (リージョン) を定義します。 値はコンマ区切りにする必要があります。 たとえば、米国東部、米国中南部、北ヨーロッパなどです。

preferredLocations?: string

プロパティ値

string

startFromBeginning

このオプションは、現在の時刻から開始するのではなく、コンテナーの変更履歴の先頭から変更を読み取るようにトリガーに指示します。 最初からの読み取りは、トリガーが初めて開始されたときにのみ機能します。後続の実行と同様に、チェックポイントは既に格納されています。 リースが既に作成されている場合にこのオプションを true に設定しても効果はありません。

startFromBeginning?: boolean

プロパティ値

boolean

startFromTime

変更フィードの読み取り操作を初期化する日付と時刻を取得または設定します。 推奨される形式は、2021-02-16T14:19:29Z など、UTC 指定子を含む ISO 8601 です。 これは、初期トリガーの状態を設定するためにのみ使用されます。 トリガーがリース状態になると、この値を変更しても効果はありません。

startFromTime?: string

プロパティ値

string