CosmosDBv3FunctionOptions interface

Extends

プロパティ

handler
retry

成功した完了または再試行の最大数に達するまで、失敗した実行を再実行するオプションの再試行ポリシー。 詳細 については、こちらを参照してください。

trigger

継承されたプロパティ

checkpointDocumentCount

リース チェックポイント間のドキュメントの量をカスタマイズします。 既定値は、すべての関数呼び出しの後です。

checkpointInterval

設定すると、リース チェックポイント間の間隔がミリ秒単位で定義されます。 既定値は、各関数呼び出しの後に常に設定されます。

collectionName

監視対象のコレクションの名前

connectionStringSetting

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

createLeaseCollectionIfNotExists

存在するかどうかを確認し、リース コレクションを自動的に作成します。 既定値は false です

databaseName

監視対象のコレクションを含む Azure Cosmos DB データベースの名前

extraInputs

呼び出し中にオプションのセカンダリ入力セットの構成を行い、context.extraInputs.get() を使用してこれらの値を取得します

extraOutputs

呼び出し中にオプションのセカンダリ出力セットの構成を行う場合は、これらの値を context.extraOutputs.set()

feedPollDelay

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

leaseAcquireInterval

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

leaseCollectionName

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

leaseCollectionPrefix

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

leaseCollectionThroughput

createLeaseCollectionIfNotExiststrueに設定されている場合、作成されたリース コレクションに割り当てる要求ユニットの量を定義します

leaseConnectionStringSetting

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

leaseDatabaseName

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

leaseExpirationInterval

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

leaseRenewInterval

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

maxItemsPerInvocation

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

preferredLocations

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

return

関数のオプションのプライマリ出力の構成 これは、呼び出し時に関数ハンドラーの戻り値として設定する必要があるメイン出力です。

startFromBeginning

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

useMultipleWriteLocations

リース コレクションに書き込むための複数リージョン アカウントを有効にします。

プロパティの詳細

handler

handler: CosmosDBv3Handler

プロパティ値

retry

成功した完了または再試行の最大数に達するまで、失敗した実行を再実行するオプションの再試行ポリシー。 詳細 については、こちらを参照してください。

retry?: RetryOptions

プロパティ値

trigger

trigger?: CosmosDBv3Trigger

プロパティ値

継承されたプロパティの詳細

checkpointDocumentCount

リース チェックポイント間のドキュメントの量をカスタマイズします。 既定値は、すべての関数呼び出しの後です。

checkpointDocumentCount?: number

プロパティ値

number

承元CosmosDBv3TriggerOptions.checkpointDocumentCount

checkpointInterval

設定すると、リース チェックポイント間の間隔がミリ秒単位で定義されます。 既定値は、各関数呼び出しの後に常に設定されます。

checkpointInterval?: number

プロパティ値

number

承元CosmosDBv3TriggerOptions.checkpointInterval

collectionName

監視対象のコレクションの名前

collectionName: string

プロパティ値

string

承元CosmosDBv3TriggerOptions.collectionName

connectionStringSetting

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

connectionStringSetting: string

プロパティ値

string

承元CosmosDBv3TriggerOptions.connectionStringSetting

createLeaseCollectionIfNotExists

存在するかどうかを確認し、リース コレクションを自動的に作成します。 既定値は false です

createLeaseCollectionIfNotExists?: boolean

プロパティ値

boolean

CosmosDBv3TriggerOptions.createLeaseCollectionIfNotExistsから継承

databaseName

監視対象のコレクションを含む Azure Cosmos DB データベースの名前

databaseName: string

プロパティ値

string

承元CosmosDBv3TriggerOptions.databaseName

extraInputs

呼び出し中にオプションのセカンダリ入力セットの構成を行い、context.extraInputs.get() を使用してこれらの値を取得します

extraInputs?: FunctionInput[]

プロパティ値

Partial.extraInputs から継承された

extraOutputs

呼び出し中にオプションのセカンダリ出力セットの構成を行う場合は、これらの値を context.extraOutputs.set()

extraOutputs?: FunctionOutput[]

プロパティ値

Partial.extraOutputs から継承

feedPollDelay

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

feedPollDelay?: number

プロパティ値

number

承元CosmosDBv3TriggerOptions.feedPollDelay

leaseAcquireInterval

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

leaseAcquireInterval?: number

プロパティ値

number

承元CosmosDBv3TriggerOptions.leaseAcquireInterval

leaseCollectionName

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

leaseCollectionName?: string

プロパティ値

string

承元CosmosDBv3TriggerOptions.leaseCollectionName

leaseCollectionPrefix

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

leaseCollectionPrefix?: string

プロパティ値

string

CosmosDBv3TriggerOptions.leaseCollectionPrefixから継承

leaseCollectionThroughput

createLeaseCollectionIfNotExiststrueに設定されている場合、作成されたリース コレクションに割り当てる要求ユニットの量を定義します

leaseCollectionThroughput?: number

プロパティ値

number

承元:CosmosDBv3TriggerOptions.leaseCollectionThroughput

leaseConnectionStringSetting

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

leaseConnectionStringSetting?: string

プロパティ値

string

CosmosDBv3TriggerOptions.leaseConnectionStringSettingから継承

leaseDatabaseName

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

leaseDatabaseName?: string

プロパティ値

string

承元CosmosDBv3TriggerOptions.leaseDatabaseName

leaseExpirationInterval

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

leaseExpirationInterval?: number

プロパティ値

number

承元CosmosDBv3TriggerOptions.leaseExpirationInterval

leaseRenewInterval

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

leaseRenewInterval?: number

プロパティ値

number

承元CosmosDBv3TriggerOptions.leaseRenewInterval

maxItemsPerInvocation

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

maxItemsPerInvocation?: number

プロパティ値

number

承元CosmosDBv3TriggerOptions.maxItemsPerInvocation

preferredLocations

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

preferredLocations?: string

プロパティ値

string

CosmosDBv3TriggerOptions.preferredLocationsから継承

return

関数のオプションのプライマリ出力の構成 これは、呼び出し時に関数ハンドラーの戻り値として設定する必要があるメイン出力です。

return?: FunctionOutput

プロパティ値

partial.return から継承された

startFromBeginning

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

startFromBeginning?: boolean

プロパティ値

boolean

CosmosDBv3TriggerOptions.startFromBeginningから継承

useMultipleWriteLocations

リース コレクションに書き込むための複数リージョン アカウントを有効にします。

useMultipleWriteLocations?: boolean

プロパティ値

boolean

承元:CosmosDBv3TriggerOptions.useMultipleWriteLocations