Подключение к хранилищу данных в Microsoft Fabric

  • Статья

Область применения:✅ конечная точка аналитики SQL и хранилище в Microsoft Fabric

В Microsoft Fabric конечная точка аналитики ИЛИ хранилище SQL Lakehouse доступна через конечную точку табличного потока данных или TDS, знакомую всем современным веб-приложениям, взаимодействующим с конечной точкой SQL Server. Это называется строкой подключения SQL в пользовательском интерфейсе Microsoft Fabric.

В этой статье описано, как подключиться к конечной точке аналитики SQL или хранилищу.

Чтобы приступить к работе, необходимо выполнить следующие предварительные требования:

Проверка подлинности в хранилищах в Fabric

В Microsoft Fabric поддерживаются два типа пользователей, прошедших проверку подлинности, через строка подключения SQL:

  • Субъекты-пользователи Microsoft Entra ID (ранее — Azure Active Directory) или удостоверения пользователей
  • Субъекты-службы Microsoft Entra ID (ранее — Azure Active Directory)

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

Для строка подключения SQL требуется открыть TCP-порт 1433. TCP 1433 — это стандартный номер порта SQL Server. Sql строка подключения также учитывает модель безопасности конечных точек аналитики SQL Warehouse или Lakehouse SQL для доступа к данным. Данные можно получить для всех объектов, к которым у пользователя есть доступ.

Разрешить служба Power BI теги через брандмауэр

Чтобы обеспечить надлежащий доступ, необходимо разрешить служба Power BI теги для доступа к брандмауэру. Дополнительные сведения см. в разделе "Теги службы Power BI". Полное доменное имя (FQDN) конечной точки TDS нельзя использовать только. Разрешение служба Power BI тегов необходимо для подключения через брандмауэр.

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

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

  1. Перейдите в рабочую область, выберите хранилище и выберите ... многоточие для дополнительных параметров.

    Снимок экрана: элемент рабочей области для хранилища. Флажок

  2. Выберите Копировать SQL строка подключения, чтобы скопировать строка подключения в буфер обмена.

    Снимок экрана: экран рабочей области с открытым контекстным меню.

Начало работы с SQL Server Management Studio (SSMS)

Ниже описано, как начать работу с рабочей областью Microsoft Fabric и подключить хранилище к SQL Server Management Studio (SSMS).

  1. При открытии SSMS появится окно "Подключение к серверу ". Если вы уже открыли, вы можете подключиться вручную, выбрав обозреватель объектов> Connect> ядро СУБД.

    Снимок экрана: выбор ядро СУБД в меню

  2. После открытия окна подключения к серверу вставьте строка подключения, скопированные из предыдущего раздела этой статьи, в поле имени сервера. Выберите "Подключиться " и перейдите к соответствующим учетным данным для проверки подлинности. Помните, что поддерживается только многофакторная проверка подлинности Microsoft Entra (MFA) с помощью параметра Microsoft Entra MFA.

    Снимок экрана: окно

  3. После установки подключения обозреватель объектов отображает подключенное хранилище из рабочей области и соответствующих таблиц и представлений, все из которых готовы к запросу.

    Снимок экрана, на котором отображается имя подключенного сервера в области обозреватель объектов.

При подключении через SSMS (или ADS) вы увидите как конечную точку аналитики SQL, так и хранилище, перечисленные как склады, и трудно различать два типа элементов и их функциональные возможности. По этой причине мы настоятельно рекомендуем принять соглашение об именовании, которое позволяет легко различать два типа элементов при работе с инструментами за пределами портала Microsoft Fabric. Поддерживается только SSMS 19 или более поздней версии.

Подключение с помощью Power BI

Конечная точка аналитики SQL Warehouse или Lakehouse — это полностью поддерживаемый и собственный источник данных в Power BI, и не требуется использовать строку подключения SQL. Панель данных предоставляет доступ ко всем хранилищам, к которых у вас есть доступ напрямую. Это позволяет легко находить склады по рабочей области и:

  1. Выберите хранилище.
  2. Выберите сущности.
  3. Загрузка данных — выберите режим подключения к данным: импорт или DirectQuery.

Дополнительные сведения см. в статье "Создание отчетов в Microsoft Fabric".

Подключение с помощью OLE DB

Мы поддерживаем подключение к конечной точке хранилища или аналитики SQL с помощью OLE DB. Убедитесь, что вы используете последний драйвер Microsoft OLE DB для SQL Server.

Подключение с помощью ODBC

Microsoft Fabric поддерживает подключение к конечной точке хранилища или аналитики SQL с помощью ODBC. Убедитесь, что вы используете последний драйвер ODBC для SQL Server. Используйте проверку подлинности Microsoft Entra ID (прежнее название — Azure Active Directory). Поддерживаются только версии ODBC 18 или более поздних версий.

Подключение с помощью JDBC

Microsoft Fabric также поддерживает подключение к конечной точке хранилища или аналитики SQL с помощью драйвера подключения к базе данных Java (JDBC).

При установке подключения через JDBC проверьте наличие следующих зависимостей:

  1. Добавьте артефакты. Выберите " Добавить артефакт " и добавьте следующие четыре зависимости, а затем нажмите кнопку "Скачать или обновить ", чтобы загрузить все зависимости. Например:

    Снимок экрана: место для выбора

  2. Выберите "Проверить подключение" и "Готово".

    Снимок экрана: вкладка 

    <dependency>
   <groupId>com.microsoft.azure</groupId>
   <artifactId>msal4j</artifactId>
   <version>1.13.3</version>

</dependency>

<dependency>
   <groupId>com.microsoft.sqlserver</groupId>
   <artifactId>mssql-jdbc_auth</artifactId>
   <version>11.2.1.x86</version>
</dependency>

 <dependency>
   <groupId>com.microsoft.sqlserver</groupId>
   <artifactId>mssql-jdbc</artifactId>
   <version>12.1.0.jre11-preview</version>
</dependency>

 <dependency>
   <groupId>com.microsoft.aad</groupId>
   <artifactId>adal</artifactId>
   <version>4.2.2</version>
</dependency>

Подключение с помощью dbt

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

Подключаемые dbt модули адаптера для конкретной платформы данных позволяют пользователям подключаться к выбранному хранилищу данных. Подключение к хранилищу данных Synapse в Microsoft Fabric из dbt адаптера использования dbt-fabric . Аналогичным образом выделенный источник данных пула SQL Azure Synapse Analytics имеет собственный адаптер dbt-synapse.

Оба адаптера поддерживают проверку подлинности Microsoft Entra ID (ранее Azure Active Directory) и позволяют разработчикам использовать az cli authentication. Однако проверка подлинности SQL не поддерживается для dbt-fabric

Адаптер DW DBT Fabric использует pyodbc библиотеку для установления подключения к хранилищу. Библиотека pyodbc — это реализация ODBC на языке Python, использующая спецификацию API базы данных Python версии 2.0.  Библиотека pyodbc напрямую передает строка подключения драйверу базы данных через SQLDriverConnect в msodbc структуре подключения к Microsoft Fabric с помощью прокси-службы TDS (потоковая передача табличных данных).

Дополнительные сведения см. в настройке адаптера dbt хранилища данных Microsoft Fabric Synapse и конфигурации адаптера dbt хранилища данных Microsoft Fabric Synapse.

Подключение с помощью других средств

Любое стороннее средство может использовать строку подключения SQL с помощью драйверов ODBC или OLE DB для подключения к конечной точке хранилища Microsoft Fabric или аналитики SQL с помощью проверки подлинности Microsoft Entra ID (прежнее название — Azure Active Directory). Дополнительные сведения и примеры строка подключения см. в статье о проверке подлинности Microsoft Entra в качестве альтернативы проверке подлинности SQL.

Пользовательские приложения

В Microsoft Fabric хранилище и конечная точка аналитики SQL Lakehouse предоставляют строка подключения SQL. Данные доступны из обширной экосистемы средств SQL, при условии, что они могут пройти проверку подлинности с помощью идентификатора Microsoft Entra (ранее — Azure Active Directory). Дополнительные сведения см. в разделе "Библиотеки подключений" для Microsoft База данных SQL. Дополнительные сведения и примеры строка подключения см. в статье о проверке подлинности Microsoft Entra в качестве альтернативы проверке подлинности SQL.

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

Мы рекомендуем добавлять повторные попытки в заданиях или заданиях ETL для создания устойчивости. Дополнительные сведения см. в следующих документах:

Рекомендации и ограничения

  • Проверка подлинности SQL не поддерживается.
  • Несколько активных результирующих наборов (MARS) не поддерживаются для хранилища Microsoft Fabric. Mars отключен по умолчанию, однако если MultipleActiveResultSets он включен в строка подключения, его следует удалить или задать значение false.
  • Если вы получите эту ошибку "Не удалось завершить операцию, так как мы достигли ограничения системы", это связано с размером маркера системы, достигаемого его предела. Эта проблема может быть вызвана, если в рабочей области слишком много хранилищ или конечных точек аналитики SQL, если пользователь является частью слишком большого количества групп Entra или комбинацией двух. Рекомендуется использовать 40 или меньше хранилищ и конечную точку аналитики SQL для каждой рабочей области, чтобы предотвратить эту ошибку. Если проблема не исчезла, обратитесь в службу поддержки.
  • Если вы получаете код ошибки 24804 с сообщением "Не удалось завершить операцию из-за обновления системы. Закройте это подключение, снова войдите и повторите операцию" или код ошибки 6005 с сообщением "ЗАВЕРШЕНИЕ работы выполняется. Сбой выполнения с sql server. Обратитесь к группе SQL Server, если вам нужна дополнительная поддержка." Это связано с временной потерей подключения, вероятно, из-за развертывания системы или перенастройки. Чтобы устранить эту проблему, выполните вход еще раз и повторите попытку. Сведения о создании устойчивости и повторных попыток в приложении см. в рекомендациях.
  • Подключения к связанному серверу из SQL Server не поддерживаются.

Связанный контент