Привязки для долговечных функций (Функции Azure)

Модель программирования Python версии 2

Устойчивые функции поддерживаются в новой модели программирования Python версии 2. Чтобы использовать модель версии 2, необходимо установить пакет SDK устойчивых функций, который является пакетом azure-functions-durablePyPI, версией 1.2.2 или более поздней версией. Кроме того, необходимо проверить host.json, что ваше приложение ссылается на пакеты расширений версии 4.x, чтобы использовать модель версии 2 с Durable Functions.

Вы можете предоставить отзывы и предложения в пакете SDK устойчивых функций для репозитория Python.

При создании функций в .NET триггер оркестрации настраивается с помощью атрибута OrchestrationTriggerAttribute .NET.

Для Java аннотация @DurableOrchestrationTrigger используется для настройки триггера оркестрации.

При записи функций оркестратора триггер оркестрации определяется следующим объектом JSON в массиве bindings файла function.json :

{
    "name": "<Name of input parameter in function signature>",
    "orchestration": "<Optional - name of the orchestration>",
    "type": "orchestrationTrigger",
    "direction": "in"
}

• orchestration — это имя оркестрации, которую клиенты должны использовать при запуске новых экземпляров этой функции оркестратора. Это свойство является необязательным. Если это не указано, используется имя функции.

Функции Azure поддерживает две модели программирования для Python. Способ определения триггера оркестрации зависит от выбранной модели программирования.

{
    "name": "<Name of input parameter in function signature>",
    "orchestration": "<Optional - name of the orchestration>",
    "type": "orchestrationTrigger",
    "direction": "in"
}

Конкретный атрибут, используемый для определения триггера, зависит от того, выполняете ли функции C# в процессе или в изолированном рабочем процессе.

[FunctionName("HelloWorld")]
public static string Run([OrchestrationTrigger] IDurableOrchestrationContext context)
{
    string name = context.GetInput<string>();
    return $"Hello {name}!";
}

[Function("HelloWorld")]
public static string Run([OrchestrationTrigger] TaskOrchestrationContext context, string name)
{
    return $"Hello {name}!";
}

const df = require("durable-functions");

module.exports = df.orchestrator(function*(context) {
    const name = context.df.getInput();
    return `Hello ${name}!`;
});

param($Context)

$InputData = $Context.Input
$InputData

@FunctionName("HelloWorldOrchestration")
public String helloWorldOrchestration(
        @DurableOrchestrationTrigger(name = "ctx") TaskOrchestrationContext ctx) {
    return String.format("Hello %s!", ctx.getInput(String.class));
}

Большинство функций оркестратора вызывают функции действия, поэтому ниже приведен пример "Hello World", демонстрирующий вызов функции действия:

const df = require("durable-functions");

module.exports = df.orchestrator(function*(context) {
    const name = context.df.getInput();
    const result = yield context.df.callActivity("SayHello", name);
    return result;
});

@FunctionName("HelloWorld")
public String helloWorldOrchestration(
        @DurableOrchestrationTrigger(name = "ctx") TaskOrchestrationContext ctx) {
    String input = ctx.getInput(String.class);
    String result = ctx.callActivity("SayHello", input, String.class).await();
    return result;
}

Триггер действия настраивается с помощью атрибута ActivityTriggerAttribute .NET.

Триггер действия настраивается с помощью заметки @DurableActivityTrigger .

Триггер действия определяется следующим объектом JSON в массиве bindingsfunction.json:

{
    "name": "<Name of input parameter in function signature>",
    "activity": "<Optional - name of the activity>",
    "type": "activityTrigger",
    "direction": "in"
}

• activity — имя действия. Это значение — имя, используемое функциями оркестратора для вызова этой функции действия. Это свойство является необязательным. Если это не указано, используется имя функции.

Способ определения триггера действия зависит от выбранной модели программирования.

{
    "name": "<Name of input parameter in function signature>",
    "activity": "<Optional - name of the activity>",
    "type": "activityTrigger",
    "direction": "in"
}

module.exports = async function(context) {
    return `Hello ${context.bindings.name}!`;
};

Привязки JavaScript также могут передаваться в виде дополнительных параметров, поэтому такая же функция может быть упрощена следующим образом:

module.exports = async function(context, name) {
    return `Hello ${name}!`;
};

param($name)

"Hello $name!"

@FunctionName("SayHello")
public String sayHello(@DurableActivityTrigger(name = "name") String name) {
    return String.format("Hello %s!", name);
}

Например, можно использовать входные данные для привязки вашей активности и отправить сообщение в Концентратор событий с помощью выходной привязки Концентратора событий.

{
  "bindings": [
    {
      "name": "message",
      "type": "activityTrigger",
      "direction": "in"
    },
    {
      "type": "eventHub",
      "name": "outputEventHubMessage",
      "connection": "EventhubConnectionSetting",
      "eventHubName": "eh_messages",
      "direction": "out"
  }
  ]
}

module.exports = async function (context) {
    context.bindings.outputEventHubMessage = context.bindings.message;
};

Вы можете привязаться к клиенту оркестрации с помощью атрибута DurableClientAttribute (OrchestrationClientAttribute в устойчивых функциях версии 1.x).

Вы можете привязаться к клиенту оркестрации с помощью аннотации @DurableClientInput.

Триггер постоянного клиента определяется следующим объектом JSON в массиве bindingsfunction.json:

{
    "name": "<Name of input parameter in function signature>",
    "taskHub": "<Optional - name of the task hub>",
    "connectionName": "<Optional - name of the connection string app setting>",
    "type": "orchestrationClient",
    "direction": "in"
}

• taskHub — Используется в сценариях, в которых несколько приложений-функций используют одну и ту же учетную запись хранения, но их необходимо изолировать друг от друга. Если значение не указано, используется значение host.json по умолчанию. Это значение должно соответствовать значению, используемому целевыми функциями оркестратора.
• connectionName — имя параметра приложения, содержащего строку подключения учетной записи хранения. Учетная запись хранения, представленная этой строкой подключения, должна быть такой же, как та, которую используют целевые функции оркестратора. Если это не указано, используется строка подключения учетной записи хранения по умолчанию для приложения-функции.

Способ определения устойчивого триггера клиента зависит от выбранной модели программирования.

{
    "name": "<Name of input parameter in function signature>",
    "taskHub": "<Optional - name of the task hub>",
    "connectionName": "<Optional - name of the connection string app setting>",
    "type": "orchestrationClient",
    "direction": "in"
}

Обычно вы привязываетесь к IDurableClient (DurableOrchestrationClient в Durable Functions версии 1.x), что обеспечивает полный доступ ко всем API оркестрации, поддерживаемым Durable Functions.

Обычно вы привязываетесь к классу DurableClientContext.

Чтобы получить доступ к объекту клиента, необходимо использовать пакет SDK для конкретного языка.

function.json

{
  "bindings": [
    {
      "name": "input",
      "type": "queueTrigger",
      "queueName": "durable-function-trigger",
      "direction": "in"
    },
    {
      "name": "starter",
      "type": "durableClient",
      "direction": "in"
    }
  ]
}

index.js

const df = require("durable-functions");

module.exports = async function (context) {
    const client = df.getClient(context);
    return instanceId = await client.startNew("HelloWorld", undefined, context.bindings.input);
};

run.ps1

param([string] $input, $TriggerMetadata)

$InstanceId = Start-DurableOrchestration -FunctionName $FunctionName -Input $input

function.json

{
  "bindings": [
    {
      "name": "input",
      "type": "queueTrigger",
      "queueName": "durable-function-trigger",
      "direction": "in"
    },
    {
      "name": "starter",
      "type": "durableClient",
      "direction": "in"
    }
  ]
}

run.ps1

param([string]$InputData, $TriggerMetadata)

$InstanceId = Start-DurableOrchestration -FunctionName 'HelloWorld' -Input $InputData

@FunctionName("QueueStart")
public void queueStart(
        @QueueTrigger(name = "input", queueName = "durable-function-trigger", connection = "Storage") String input,
        @DurableClientInput(name = "durableContext") DurableClientContext durableContext) {
    // Orchestration input comes from the queue message content.
    durableContext.getClient().scheduleNewOrchestrationInstance("HelloWorld", input);
}

Триггер сущности настраивается с помощью атрибута EntityTriggerAttribute .NET.

Триггер сущности определяется следующим объектом JSON в массиве bindingsfunction.json:

{
    "name": "<Name of input parameter in function signature>",
    "entityName": "<Optional - name of the entity>",
    "type": "entityTrigger",
    "direction": "in"
}

По умолчанию имя сущности — это имя функции.

Способ определения триггера сущности зависит от выбранной модели программирования.

{
    "name": "<Name of input parameter in function signature>",
    "entityName": "<Optional - name of the entity>",
    "type": "entityTrigger",
    "direction": "in"
}

Вы можете привязаться к клиенту сущности с помощью атрибута DurableClientAttribute .NET в функциях библиотеки классов .NET.

Клиент сущности определяется следующим объектом JSON в массиве bindingsfunction.json:

{
    "name": "<Name of input parameter in function signature>",
    "taskHub": "<Optional - name of the task hub>",
    "connectionName": "<Optional - name of the connection string app setting>",
    "type": "durableClient",
    "direction": "in"
}

• taskHub — Используется в сценариях, в которых несколько приложений-функций используют одну и ту же учетную запись хранения, но их необходимо изолировать друг от друга. Если значение не указано, используется значение host.json по умолчанию. Это значение должно соответствовать значению, используемому целевыми функциями сущностей.
• connectionName — имя параметра приложения, содержащего строку подключения учетной записи хранения. Учетная запись хранения, представленная этой строкой подключения, должна быть той же, которая используется функциями целевой сущности. Если это не указано, используется строка подключения учетной записи хранения по умолчанию для приложения-функции.

Способ определения клиентской сущности зависит от выбранной модели программирования.

{
    "name": "<Name of input parameter in function signature>",
    "taskHub": "<Optional - name of the task hub>",
    "connectionName": "<Optional - name of the connection string app setting>",
    "type": "durableClient",
    "direction": "in"
}