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


Интегрировать базу данных SQL в Microsoft Fabric с служебным коннектором

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

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

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

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

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

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

Тип клиента Назначаемый системой управляемый идентификатор Управляемая идентификация, назначаемая пользователем Секретный ключ/строка подключения Принципал службы
.СЕТЬ Да Да нет нет
Иди Да Да нет нет
Ява Да Да нет нет
Java — Spring Boot Да Да нет нет
Питон Да Да нет нет
Отсутствует Да Да нет нет

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

Методы управляемого удостоверения, назначаемые системой, и управляемого удостоверения, назначаемые пользователем, поддерживаются для клиентских типов .NET, Java, Java, Spring Boot, Python, Go и None. Эти методы не поддерживаются для других типов.

Это важно

В настоящее время для полного внедрения требуется предоставление доступа вручную. См. раздел "Общий доступ к базе данных SQL" в Fabric.

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

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

Замечание

Хотя база данных SQL в Fabric отличается от базы данных SQL Azure, вы можете подключиться к базе данных SQL и запросить ее в Fabric так же, как и база данных SQL Azure. Подробнее.

Назначаемый системой управляемый идентификатор

Имя переменной среды по умолчанию Описание Пример значения
FABRIC_SQL_CONNECTIONSTRING Строка подключения к базе данных Azure SQL Data Source=tcp:<Fabric-SQL-Identifier>.msit-database.fabric.microsoft.com,1433;Initial Catalog=<SQL-DB-name>-<Fabric-DB-Identifier>;Authentication=ActiveDirectoryManagedIdentity

Пример кода

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

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

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

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

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

Дополнительные сведения см. в разделе "Подключение к базе данных SQL" в Microsoft Fabric.

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

Имя переменной среды по умолчанию Описание Пример значения
FABRIC_SQL_CONNECTIONSTRING Строка подключения к базе данных Azure SQL Data Source=tcp:<Fabric-SQL-Identifier>.msit-database.fabric.microsoft.com,1433;Initial Catalog=<SQL-DB-name>-<Fabric-DB-Identifier>;User ID=<msiClientId>;Authentication=ActiveDirectoryManagedIdentity

Пример кода

Ниже приведены шаги и фрагменты кода для подключения к базе данных SQL в Fabric с помощью управляемого удостоверения, назначаемого пользователем.

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

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

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

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

Дополнительные сведения см. в разделе "Подключение к базе данных SQL" в Microsoft Fabric.

Общий доступ к базе данных SQL в Fabric

  1. Завершите создание подключения к службе в Cloud Shell или локальном интерфейсе командной строки Azure.

  2. После создания подключения откройте ресурс службы вычислений на портале Azure, откройте меню соединителя служб и найдите базу данных SQL в подключении к службе Fabric. Выберите базу данных SQL , чтобы перейти на портал Fabric.

    Снимок экрана портала Azure с выбором ссылки SQL Database для перехода на портал Fabric.

  3. На портале Fabric найдите вкладку "Безопасность" и выберите "Управление безопасностью SQL".

    Снимок экрана: портал Fabric, в котором выберите

  4. Выберите роль db_ddladmin, а затем управление доступом.

    Снимок экрана портала Fabric, выбор роли db_ddladmin и нажатие кнопки

  5. Вы должны увидеть имя управляемой идентичности, назначенной системой, и/или любой управляемой идентичности, назначаемой пользователем, с подключением сервиса к этой базе данных SQL в Fabric. Выберите базу данных Share. Если вы не видите параметр Share database, вам не нужно следовать остальным шагам.

    Снимок экрана портала Fabric, просмотр списка групп, добавленных в роль, и нажатие кнопки

  6. Введите и выберите имя созданного управляемого удостоверения, назначаемого системой, и (или) все назначаемые пользователем управляемые удостоверения, как они отображаются на панели управления доступом . Добавьте любые другие идентичности по мере необходимости. Установите флажок "Чтение всех данных" с помощью базы данных SQL , а затем нажмите кнопку "Предоставить".

    Снимок экрана портала Fabric: введите имена любых назначенных управляемых удостоверений, выберите

  7. Теперь вы готовы использовать новое подключение службы к базе данных SQL в Fabric.

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

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