Compartilhar via


CosmosDBv4FunctionOptions interface

Extends

Propriedades

handler
retry

Uma política de repetição opcional para executar novamente uma execução com falha até que ocorra uma conclusão bem-sucedida ou o número máximo de tentativas seja atingido. Saiba mais aqui

trigger

Propriedades herdadas

connection

Uma configuração de aplicativo (ou variável de ambiente) com a cadeia de conexão do Cosmos DB

containerName

O nome do contêiner que está sendo monitorado

createLeaseContainerIfNotExists

Verifica a existência e cria automaticamente o contêiner de concessões. O padrão é false

databaseName

O nome do banco de dados do Azure Cosmos DB com o contêiner sendo monitorado

extraInputs

Configuração para um conjunto opcional de entradas secundárias durante a invocação, obtenha esses valores com context.extraInputs.get()

extraOutputs

Configuração para um conjunto opcional de saídas secundárias durante a invocação, defina esses valores com context.extraOutputs.set()

feedPollDelay

O tempo (em milissegundos) para o atraso entre sondar uma partição para novas alterações no feed, depois que todas as alterações atuais forem drenadas. O padrão é 5.000 milissegundos ou 5 segundos.

leaseAcquireInterval

Quando definido, ele define, em milissegundos, o intervalo para iniciar uma tarefa a ser computada se as partições forem distribuídas uniformemente entre instâncias de host conhecidas. O padrão é 13000 (13 segundos).

leaseConnection

O nome de uma configuração de aplicativo que contém a cadeia de conexão para o serviço que contém o contêiner de concessão. Se não for definido, ele se conectará ao serviço definido por connection

leaseContainerName

O nome do contêiner para armazenar concessões. Se não for definido, ele usará "concessões"

leaseContainerPrefix

Quando definido, o valor é adicionado como um prefixo às concessões criadas no contêiner de Concessão para essa função. O uso de um prefixo permite que duas Azure Functions separadas compartilhem o mesmo contêiner de concessão usando prefixos diferentes.

leaseDatabaseName

O nome do banco de dados que contém o contêiner para armazenar concessões. Se não estiver definido, ele usará o valor de databaseName

leaseExpirationInterval

Quando definido, ele define, em milissegundos, o intervalo para o qual a concessão é realizada em uma concessão que representa uma partição. Se a concessão não for renovada dentro desse intervalo, ela fará com que ela expire e a propriedade da partição será movida para outra instância. O padrão é 60000 (60 segundos).

leaseRenewInterval

Quando definido, ele define, em milissegundos, o intervalo de renovação para todas as concessões de partições atualmente mantidas por uma instância. O padrão é 17000 (17 segundos).

leasesContainerThroughput

Quando createLeaseContainerIfNotExists é definido como true, define a quantidade de Unidades de Solicitação a serem atribuídas ao contêiner de concessão criado

maxItemsPerInvocation

Quando definida, essa propriedade define o número máximo de itens recebidos por chamada de função. Se as operações no contêiner monitorado forem executadas por meio de procedimentos armazenados, o escopo da transação será preservado ao ler itens do feed de alterações. Como resultado, o número de itens recebidos pode ser maior do que o valor especificado para que os itens alterados pela mesma transação sejam retornados como parte de um lote atômico.

preferredLocations

Define locais preferenciais (regiões) para contas de banco de dados replicadas geograficamente no serviço do Azure Cosmos DB. Os valores devem ser separados por vírgula. Por exemplo, Leste dos EUA, Centro-Sul dos EUA, Norte da Europa

return

Configuração para a saída primária opcional da função Esta é a saída principal que você deve definir como o valor retornado do manipulador de funções durante a invocação

startFromBeginning

Essa opção informa ao Gatilho para ler as alterações do início do histórico de alterações do contêiner em vez de começar no momento atual. A leitura desde o início só funciona na primeira vez que o gatilho é iniciado, como nas execuções subsequentes, os pontos de verificação já estão armazenados. Definir essa opção como true quando houver concessões já criadas não tem efeito.

startFromTime

Obtém ou define a data e a hora da qual inicializar a operação de leitura do feed de alterações. O formato recomendado é ISO 8601 com o designador UTC, como 2021-02-16T14:19:29Z. Isso só é usado para definir o estado inicial do gatilho. Depois que o gatilho tiver um estado de concessão, alterar esse valor não terá efeito.

Detalhes da propriedade

handler

handler: CosmosDBv4Handler

Valor da propriedade

retry

Uma política de repetição opcional para executar novamente uma execução com falha até que ocorra uma conclusão bem-sucedida ou o número máximo de tentativas seja atingido. Saiba mais aqui

retry?: RetryOptions

Valor da propriedade

trigger

trigger?: CosmosDBv4Trigger

Valor da propriedade

Detalhes das propriedades herdadas

connection

Uma configuração de aplicativo (ou variável de ambiente) com a cadeia de conexão do Cosmos DB

connection: string

Valor da propriedade

string

Herdado deCosmosDBv4TriggerOptions.connection

containerName

O nome do contêiner que está sendo monitorado

containerName: string

Valor da propriedade

string

Herdado de CosmosDBv4TriggerOptions.containerName

createLeaseContainerIfNotExists

Verifica a existência e cria automaticamente o contêiner de concessões. O padrão é false

createLeaseContainerIfNotExists?: boolean

Valor da propriedade

boolean

Herdado deCosmosDBv4TriggerOptions.createLeaseContainerIfNotExists

databaseName

O nome do banco de dados do Azure Cosmos DB com o contêiner sendo monitorado

databaseName: string

Valor da propriedade

string

Herdado deCosmosDBv4TriggerOptions.databaseName

extraInputs

Configuração para um conjunto opcional de entradas secundárias durante a invocação, obtenha esses valores com context.extraInputs.get()

extraInputs?: FunctionInput[]

Valor da propriedade

herdado de partial.extraInputs

extraOutputs

Configuração para um conjunto opcional de saídas secundárias durante a invocação, defina esses valores com context.extraOutputs.set()

extraOutputs?: FunctionOutput[]

Valor da propriedade

herdado de partial.extraOutputs

feedPollDelay

O tempo (em milissegundos) para o atraso entre sondar uma partição para novas alterações no feed, depois que todas as alterações atuais forem drenadas. O padrão é 5.000 milissegundos ou 5 segundos.

feedPollDelay?: number

Valor da propriedade

number

Herdado de CosmosDBv4TriggerOptions.feedPollDelay

leaseAcquireInterval

Quando definido, ele define, em milissegundos, o intervalo para iniciar uma tarefa a ser computada se as partições forem distribuídas uniformemente entre instâncias de host conhecidas. O padrão é 13000 (13 segundos).

leaseAcquireInterval?: number

Valor da propriedade

number

Herdado deCosmosDBv4TriggerOptions.leaseAcquireInterval

leaseConnection

O nome de uma configuração de aplicativo que contém a cadeia de conexão para o serviço que contém o contêiner de concessão. Se não for definido, ele se conectará ao serviço definido por connection

leaseConnection?: string

Valor da propriedade

string

Herdado deCosmosDBv4TriggerOptions.leaseConnection

leaseContainerName

O nome do contêiner para armazenar concessões. Se não for definido, ele usará "concessões"

leaseContainerName?: string

Valor da propriedade

string

Herdado deCosmosDBv4TriggerOptions.leaseContainerName

leaseContainerPrefix

Quando definido, o valor é adicionado como um prefixo às concessões criadas no contêiner de Concessão para essa função. O uso de um prefixo permite que duas Azure Functions separadas compartilhem o mesmo contêiner de concessão usando prefixos diferentes.

leaseContainerPrefix?: string

Valor da propriedade

string

Herdado deCosmosDBv4TriggerOptions.leaseContainerPrefix

leaseDatabaseName

O nome do banco de dados que contém o contêiner para armazenar concessões. Se não estiver definido, ele usará o valor de databaseName

leaseDatabaseName?: string

Valor da propriedade

string

Herdado deCosmosDBv4TriggerOptions.leaseDatabaseName

leaseExpirationInterval

Quando definido, ele define, em milissegundos, o intervalo para o qual a concessão é realizada em uma concessão que representa uma partição. Se a concessão não for renovada dentro desse intervalo, ela fará com que ela expire e a propriedade da partição será movida para outra instância. O padrão é 60000 (60 segundos).

leaseExpirationInterval?: number

Valor da propriedade

number

Herdado deCosmosDBv4TriggerOptions.leaseExpirationInterval

leaseRenewInterval

Quando definido, ele define, em milissegundos, o intervalo de renovação para todas as concessões de partições atualmente mantidas por uma instância. O padrão é 17000 (17 segundos).

leaseRenewInterval?: number

Valor da propriedade

number

Herdado deCosmosDBv4TriggerOptions.leaseRenewInterval

leasesContainerThroughput

Quando createLeaseContainerIfNotExists é definido como true, define a quantidade de Unidades de Solicitação a serem atribuídas ao contêiner de concessão criado

leasesContainerThroughput?: number

Valor da propriedade

number

Herdado deCosmosDBv4TriggerOptions.leasesContainerThroughput

maxItemsPerInvocation

Quando definida, essa propriedade define o número máximo de itens recebidos por chamada de função. Se as operações no contêiner monitorado forem executadas por meio de procedimentos armazenados, o escopo da transação será preservado ao ler itens do feed de alterações. Como resultado, o número de itens recebidos pode ser maior do que o valor especificado para que os itens alterados pela mesma transação sejam retornados como parte de um lote atômico.

maxItemsPerInvocation?: number

Valor da propriedade

number

Herdado deCosmosDBv4TriggerOptions.maxItemsPerInvocation

preferredLocations

Define locais preferenciais (regiões) para contas de banco de dados replicadas geograficamente no serviço do Azure Cosmos DB. Os valores devem ser separados por vírgula. Por exemplo, Leste dos EUA, Centro-Sul dos EUA, Norte da Europa

preferredLocations?: string

Valor da propriedade

string

Herdado deCosmosDBv4TriggerOptions.preferredLocations

return

Configuração para a saída primária opcional da função Esta é a saída principal que você deve definir como o valor retornado do manipulador de funções durante a invocação

return?: FunctionOutput

Valor da propriedade

Herdado de Partial.return

startFromBeginning

Essa opção informa ao Gatilho para ler as alterações do início do histórico de alterações do contêiner em vez de começar no momento atual. A leitura desde o início só funciona na primeira vez que o gatilho é iniciado, como nas execuções subsequentes, os pontos de verificação já estão armazenados. Definir essa opção como true quando houver concessões já criadas não tem efeito.

startFromBeginning?: boolean

Valor da propriedade

boolean

Herdado deCosmosDBv4TriggerOptions.startFromBeginning

startFromTime

Obtém ou define a data e a hora da qual inicializar a operação de leitura do feed de alterações. O formato recomendado é ISO 8601 com o designador UTC, como 2021-02-16T14:19:29Z. Isso só é usado para definir o estado inicial do gatilho. Depois que o gatilho tiver um estado de concessão, alterar esse valor não terá efeito.

startFromTime?: string

Valor da propriedade

string

Herdado deCosmosDBv4TriggerOptions.startFromTime