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


Интеграция База данных SQL Azure с соединителем службы

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

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

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

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

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

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

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

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

Примечание.

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

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

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

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

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

Пример кода

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

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

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

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

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

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

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

Имя переменной среды по умолчанию Description Пример значения
AZURE_SQL_CONNECTIONSTRING База данных SQL Azure строка подключения 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. Получите База данных SQL Azure строка подключения из переменной среды, добавленной соединителем службы.

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

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

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

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

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

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

Имя переменной среды по умолчанию Description Пример значения
AZURE_SQL_CONNECTIONSTRING База данных SQL Azure строка подключения 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. Получите База данных SQL Azure строка подключения из переменной среды, добавленной соединителем службы.

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

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

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

Имя переменной среды по умолчанию Description Пример значения
AZURE_SQL_CLIENTID Идентификатор клиента <client-ID>
AZURE_SQL_CLIENTSECRET Секрет клиента <client-secret>
AZURE_SQL_TENANTID Идентификатор клиента <tenant-ID>
AZURE_SQL_CONNECTIONSTRING База данных SQL Azure строка подключения 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. Получите База данных SQL Azure строка подключения из переменной среды, добавленной соединителем службы.

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

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

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

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

Следуйте инструкциям, приведенным ниже, чтобы узнать больше о соединителе службы.