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


Интегрируйте SQL Azure Database с коннектором службы

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

Поддерживаемые службы вычислений

Соединитель служб можно использовать для подключения следующих вычислительных служб к База данных SQL Azure:

  • Служба приложений Azure
  • Приложения-контейнеры Azure
  • Функции Azure
  • Служба Azure Kubernetes (AKS)
  • Azure Spring Apps

Поддерживаемые типы проверки подлинности и клиенты

В следующей таблице показано, какие сочетания методов проверки подлинности и клиентов поддерживаются для подключения вычислительной службы к базе данных SQL Azure с помощью соединителя служб. Значение "Да " указывает, что сочетание поддерживается, а значение No указывает, что оно не поддерживается.

Тип клиента Управляемое удостоверение, назначаемое системой Управляемое удостоверение, назначаемое пользователем Секрет/строка подключения Субъект-служба
.NET Да Да Да Да
Go Нет Нет Да Нет
Java Да Да Да Да
Java — Spring Boot Да Да Да Да
Node.js Да Да Да Да
PHP Нет Нет Да Нет
Python Да Да Да Да
Python — Django Нет Нет Да Нет
Ruby Нет Нет Да Нет
нет Да Да Да Да

Примечание.

Назначаемое системой управляемое удостоверение, назначаемое пользователем, и проверка подлинности субъекта-службы поддерживается только в Azure CLI.

Имена переменных среды по умолчанию или свойства приложения и пример кода

Используйте следующие сведения о подключении для подключения вычислительных служб к базе данных SQL Azure. В каждом примере замените текст заполнителя <sql-server>, <sql-database>, <sql-username> и <sql-password> на ваше собственное имя сервера, имя базы данных, идентификатор пользователя и пароль. Дополнительные сведения о соглашениях об именовании см. во внутренней статье соединителя служб.

Управляемое удостоверение, назначаемое системой

Имя переменной среды по умолчанию Описание Пример значения
AZURE_SQL_CONNECTIONSTRING Строка подключения к базе данных Azure SQL Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;Authentication=ActiveDirectoryManagedIdentity

Пример кода

Чтобы подключиться к базе данных SQL Azure с помощью управляемого удостоверения, назначаемого системой, см. следующие действия и пример кода.

  1. Установите зависимости.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Получите строку подключения базы данных Azure SQL из переменной окружения, добавленной соединителем службы.

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("AZURE_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

    Для получения дополнительной информации см. Использование проверки подлинности управляемого удостоверения Active Directory.

Дополнительные сведения см. на домашней странице клиентского программирования для Microsoft SQL Server.

Управляемое удостоверение, назначаемое пользователем

Имя переменной среды по умолчанию Описание Пример значения
AZURE_SQL_CONNECTIONSTRING Строка подключения к базе данных Azure SQL Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;User ID=<identity-client-ID>;Authentication=ActiveDirectoryManagedIdentity

Пример кода

Чтобы подключиться к базе данных SQL Azure с помощью управляемого удостоверения, назначаемого пользователем, см. следующие действия и пример кода.

  1. Установите зависимости.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Получите строку подключения базы данных Azure SQL из переменной окружения, добавленной соединителем службы.

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("AZURE_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

    Для получения дополнительной информации см. Использование проверки подлинности управляемого удостоверения Active Directory.

Дополнительные сведения см. на домашней странице клиентского программирования для Microsoft SQL Server.

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

Предупреждение

Корпорация Майкрософт рекомендует использовать самый безопасный поток проверки подлинности. Поток проверки подлинности, описанный в этой процедуре, требует высокого уровня доверия к приложению и несет риски, которые не присутствуют в других потоках. Этот поток следует использовать только в том случае, если другие более безопасные потоки, такие как управляемые удостоверения, невозможны.

Имя переменной среды по умолчанию Описание Пример значения
AZURE_SQL_CONNECTIONSTRING Строка подключения к базе данных Azure SQL Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;Password=<sql-password>

Пример кода

Чтобы подключиться к базе данных SQL Azure с помощью строки подключения, выполните следующие действия и пример кода.

  1. Установите зависимости.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Получите строку подключения базы данных Azure SQL из переменной окружения, добавленной соединителем службы.

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("AZURE_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

Дополнительные сведения см. на домашней странице клиентского программирования для Microsoft SQL Server.

Субъект-служба

Имя переменной среды по умолчанию Описание Пример значения
AZURE_SQL_CLIENTID Идентификатор клиента <client-ID>
AZURE_SQL_CLIENTSECRET Секрет клиента <client-secret>
AZURE_SQL_TENANTID Идентификатор клиента <tenant-ID>
AZURE_SQL_CONNECTIONSTRING Строка подключения к базе данных Azure SQL Data Source=<sql-server>.database.windows.net,1433;Initial Catalog=<sql-database>;User ID=<client-Id>;Password=<client-secret>;Authentication=ActiveDirectoryServicePrincipal

Пример кода

Чтобы подключиться к базе данных SQL Azure с помощью субъекта-службы, выполните следующие действия и пример кода.

  1. Установите зависимости.

    dotnet add package Microsoft.Data.SqlClient
    
  2. Получите строку подключения базы данных Azure SQL из переменной окружения, добавленной соединителем службы.

    using Microsoft.Data.SqlClient;
    
    string connectionString = 
        Environment.GetEnvironmentVariable("AZURE_SQL_CONNECTIONSTRING")!;
    
    using var connection = new SqlConnection(connectionString);
    connection.Open();
    

    Для получения дополнительной информации см. Использование проверки подлинности управляемого удостоверения Active Directory.

Дополнительные сведения см. на домашней странице клиентского программирования для Microsoft SQL Server.

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

Более подробную информацию о Service Connector можно найти в данном руководстве.