Устарел ли класс Document при использовании CosmosDBTrigger?

Устарел ли класс Документ в пространстве имен Microsoft.Azure.Documents при разработке изолированных функций Azure?

Недавно я перенес/обновил функцию Azure .NET6 (v4) с запущенной в процессе на внепроцессную, также известную как изолированная (изолированная от сети).

Моя функция Azure использует CosmosDBTrigger для обработки событий канала изменений.

Одним из необходимых шагов для миграции является создание ссылок на пакеты:

Основные пакеты:

The following packages are required to run your .NET functions in an isolated process:

• Microsoft.Azure.Functions.Worker
• Microsoft.Azure.Functions.Worker.Sdk

Пакеты расширений:

Because functions that run in a .NET isolated process use different binding types, they require a unique set of binding extension packages.

Поскольку моя функция Azure использует CosmosDBTrigger, мне также нужна эта ссылка на пакет:

• Microsoft.Azure.Functions.Worker.Extensions.CosmosDB

Я протестировал создание новой функции Azure с помощью проекта изолированного шаблона .NET6 в Visual Studio 2022, чтобы сравнить свой код с образцом кода. Никаких других ссылок на пакеты не требуется.

Теперь я не могу использовать IReadOnlyList<Document>, так как необходимо обновить следующий старый код:

[FunctionName("CosmosTrigger")]
    public static void Run([CosmosDBTrigger(
        databaseName: "ToDoItems",
        collectionName: "Items",
        ConnectionStringSetting = "CosmosDBConnection",
        LeaseCollectionName = "leases",
        CreateLeaseCollectionIfNotExists = true)]IReadOnlyList<Document> documents,
        ILogger log)
    {
        if (documents != null && documents.Count > 0)
        {
            log.LogInformation($"Documents modified: {documents.Count}");
            log.LogInformation($"First document Id: {documents[0].Id}");
        }
    }

К этому:

  public class ToDoItem
  {
      public string Id { get; set; }
      public string Description { get; set; }
  }

[Function("CosmosTrigger")]
    public static void Run([CosmosDBTrigger(
        databaseName: "databaseName",
        containerName: "containerName",
        Connection = "CosmosDBConnectionSetting",
        LeaseContainerName = "leases",
        CreateLeaseContainerIfNotExists = true)]IReadOnlyList<ToDoItem> input, ILogger log)
    {
        if (input != null && input.Count > 0)
        {
            log.LogInformation("Documents modified " + input.Count);
            log.LogInformation("First document Id " + input[0].Id);
        }
    }

Нет смысла десериализовать входящие события канала изменений в пользовательский класс POCO, такой как ToDoItem в качестве примера, большой силой класса Document была возможность десериализовать события канала изменений в различные пользовательские классы POCO в зависимости от лежащей в основе структуры JSON документа CosmosDB.

Я не уверен, как обрабатывать будущие критические изменения в моих документах CosmosDB, в настоящее время у нас есть свойство documentVersion, содержащее целочисленное значение, чтобы десериализовать события канала изменений в правильный пользовательский класс POCO.

Приведенный выше пример кода вызовет исключение во время выполнения, если десериализация JSON не соответствует структуре данных класса ToDoItem.