Прочитать на английском

Поделиться через

Общие сведения о привязках SQL Azure для Функции Azure

  • Статья
  • 18.12.2024
Выбор языка программирования

В этой серии статей рассматривается, как работать с привязками Azure SQL в Функциях Azure. Функции Azure поддерживает входные привязки, выходные привязки и триггер функции для продуктов SQL Azure и SQL Server.

Действие Тип
Активация функции при обнаружении изменения в таблице SQL Триггер SQL
Чтение данных из базы данных Входная привязка
Сохранение данных в базу данных Выходная привязка

Установка расширения

Устанавливаемый пакет расширения NuGet зависит от режима C#, который используется в приложении-функции:

Функции выполняются в изолированном рабочем процессе C#. Дополнительные сведения см. в руководстве по запуску Функции Azure C# в изолированном рабочем процессе.

Добавьте расширение в проект, установив данный пакет NuGet.

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Sql

Чтобы использовать предварительную версию пакета Microsoft.Azure.Functions.Worker.Extensions.Sql, добавьте --prerelease флаг в команду. Вы можете просмотреть функции предварительной версии на странице выпуска расширений SQL Функции Azure.

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Sql --prerelease

Примечание

Критические изменения между предварительными версиями привязок SQL Azure для Функции Azure требуют, чтобы все функции, предназначенные для одной базы данных, использовали ту же версию пакета расширения SQL.

Установка пакета

Расширение привязок SQL является частью пакета расширений версии 4, который указан в файле проекта host.json.

Пакет расширений указан следующим кодом в host.json файле:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  }
}

Functions runtime (Среда выполнения функций)

Установка пакета

Расширение привязок SQL является частью пакета расширений версии 4, который указан в файле проекта host.json.

Пакет расширений указан следующим кодом в host.json файле:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  }
}

Установка пакета

Расширение привязок SQL является частью пакета расширений версии 4, который указан в файле проекта host.json.

Пакет расширений указан следующим кодом в host.json файле:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle",
    "version": "[4.*, 5.0.0)"
  }
}

Обновление пакетов

Добавьте библиотеку Java для привязок SQL в проект функций с обновлением pom.xml файла в проекте Java Функции Azure, как показано в следующем фрагменте кода:

<dependency>
    <groupId>com.microsoft.azure.functions</groupId>
    <artifactId>azure-functions-java-library-sql</artifactId>
    <version>2.1.0</version>
</dependency>

Пакет расширений предварительной версии можно использовать с обновлением pom.xml файла в проекте Java Функции Azure, как показано в следующем фрагменте кода:

<dependency>
    <groupId>com.microsoft.azure.functions</groupId>
    <artifactId>azure-functions-java-library-sql</artifactId>
    <version>2.1.0-preview</version>
</dependency>

Строка подключения SQL

Привязки SQL Azure для Функции Azure имеют необходимое свойство для строка подключения для всех привязок и триггеров. Эти строка подключения передаются в библиотеку Microsoft.Data.SqlClient и поддерживают строка подключения, как определено в документации по SqlClient ConnectionString.

Важно!

Для оптимальной безопасности следует использовать идентификатор Microsoft Entra с управляемыми удостоверениями для подключений между функциями и База данных SQL Azure. Управляемые удостоверения обеспечивают безопасность приложения, устраняя секреты из развертываний приложений, например учетные данные в строка подключения, именах серверов и используемых портах. Вы можете узнать, как использовать управляемые удостоверения в этом руководстве, подключить приложение-функцию к SQL Azure с управляемыми удостоверениями и привязками SQL.

Важные ключевые слова:

  • Authentication: позволяет функции подключаться к SQL Azure с помощью идентификатора Microsoft Entra и управляемых удостоверений. Дополнительные сведения см. в статье "Подключение приложения-функции к SQL Azure с управляемым удостоверением и привязками SQL".
  • Command timeout: позволяет функции ожидать указанного времени в секундах перед завершением запроса (по умолчанию 30 секунд)
  • ConnectRetryCount: позволяет функции автоматически выполнять дополнительные попытки повторного подключения, особенно применимые к База данных SQL Azure бессерверному уровню (по умолчанию 1).
  • Pooling: позволяет функции повторно использовать подключения к базе данных, что может повысить производительность (по умолчанию true). Дополнительные параметры для пула подключений включают Connection Lifetime, Max Pool Sizeи Min Pool Size. Дополнительные сведения о пуле подключений см. в документации по ADO.NET

Рекомендации

  • Привязка SQL Azure поддерживает версию 4.x и более позднюю версию среды выполнения функций.
  • Исходный код для привязок Azure SQL см. в этом репозитории GitHub.
  • Для этой привязки требуется подключение к базе данных Azure SQL или SQL Server.
  • Привязки выходных данных к таблицам со столбцами типов данных NTEXT, TEXT или IMAGE не поддерживаются, и upsert данных завершится ошибкой. Эти типы будут удалены в будущей версии SQL Server и несовместимы с функцией OPENJSON, используемой этой привязкой Функций Azure.
  • Используйте управляемые удостоверения вместо имен пользователей и паролей.
  • Рекомендуется использовать значение ключа Azure для хранения параметров приложения.

Примеры

Помимо примеров для C#, Java, JavaScript, PowerShell и Python, доступных в репозитории GitHub при привязках SQL Azure, дополнительные сведения доступны в примерах Azure:

Следующие шаги

Дополнительные ресурсы