Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Область применения:✅ конечная точка аналитики SQL и хранилище в Microsoft Fabric
В Microsoft Fabric конечная точка аналитики SQL Lakehouse или хранилище доступно через конечную точку табличного потока данных (TDS), знакомую всем современным веб-приложениям, взаимодействующим с конечной точкой TDS SQL Server. Это называется строкой подключения SQL в пользовательском интерфейсе Microsoft Fabric.
В этой статье описано, как подключиться к конечной точке аналитики SQL или хранилищу.
Чтобы приступить к работе, необходимо выполнить следующие предварительные требования:
- Вам нужен доступ к точке аналитики SQL или хранилищу в рабочей области с Premium-емкостью с разрешениями сотрудника или более высокого уровня.
Аутентификация в хранилищах данных в системе 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 для доступа к данным. Данные можно получить для всех объектов, к которым у пользователя есть доступ.
Разрешить теги службы Power BI через брандмауэр
Чтобы обеспечить надлежащий доступ, необходимо разрешить теги службы Power BI для доступа к брандмауэру. Дополнительные сведения см. в разделе "Теги службы Power BI". Полное доменное имя (FQDN) конечной точки TDS само по себе использовать нельзя. Необходимо разрешить теги службы Power BI для подключения через брандмауэр.
Получить строку подключения SQL
Чтобы получить строку подключения, выполните следующие действия.
- Перейдите в рабочую область, выберите хранилище.
- Нажмите кнопку Копировать в поле строка подключения SQL, чтобы скопировать строку подключения в буфер обмена.
Или в OneLake:
- Выберите хранилище и выберите
...
многоточие для дополнительных параметров. - Выберите Копировать строку подключения SQL, чтобы скопировать строку подключения в буфер обмена.
Начало работы с SQL Server Management Studio (SSMS)
Ниже описано, как начать работу с рабочей областью Microsoft Fabric и подключить хранилище к SQL Server Management Studio (SSMS).
При открытии SSMS появится окно "Подключение к серверу ". Если она уже открыта, вы можете подключиться вручную, выбрав обозреватель объектов>Подключить>Движок базы данных.
После открытия окна подключения к серверу вставьте строка подключения, скопированные из предыдущего раздела этой статьи, в поле имени сервера. Выберите "Подключиться " и перейдите к соответствующим учетным данным для проверки подлинности. Помните, что поддерживается только многофакторная проверка подлинности Microsoft Entra (MFA) с помощью параметра Microsoft Entra MFA.
После установки подключения обозреватель объектов отображает подключенное хранилище из рабочей области и соответствующих таблиц и представлений, все из которых готовы к запросу.
При подключении через SSMS (или ADS) вы увидите как конечную точку аналитики SQL, так и хранилище, перечисленные как склады, и трудно различать два типа элементов и их функциональные возможности. По этой причине мы настоятельно рекомендуем принять соглашение об именовании, которое позволяет легко различать два типа элементов при работе с инструментами за пределами портала Microsoft Fabric. Поддерживается только SSMS 19 или более поздней версии.
Подключение с помощью Power BI
Конечная точка аналитики SQL Warehouse или Lakehouse — это полностью поддерживаемый и собственный источник данных в Power BI, и не требуется использовать строку подключения SQL. Панель данных предоставляет доступ ко всем хранилищам, к которых у вас есть доступ напрямую. Это позволяет легко находить склады по рабочей области и:
- Выберите хранилище.
- Выберите объекты.
- Загрузка данных — выберите режим подключения к данным: импорт или 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 проверьте наличие следующих зависимостей:
Добавьте артефакты. Выберите " Добавить артефакт " и добавьте следующие четыре зависимости, а затем нажмите кнопку "Скачать или обновить ", чтобы загрузить все зависимости. Например:
Выберите "Проверить подключение" и "Готово".
<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
, используйте dbt-fabric
адаптер. Аналогичным образом выделенный источник данных пула SQL Azure Synapse Analytics имеет собственный адаптер dbt-synapse
.
Оба адаптера поддерживают проверку подлинности идентификатора Microsoft Entra и позволяют разработчикам использовать az cli authentication
. Однако проверка подлинности SQL не поддерживается для dbt-fabric
Адаптер dbt
DW Fabric использует библиотеку pyodbc
для установления подключения к хранилищу. Библиотека pyodbc
— это реализация ODBC на языке Python, использующая спецификацию API базы данных Python версии 2.0. Библиотека pyodbc
напрямую передает строку подключения драйверу базы данных через SQLDriverConnect в структуру подключения msodbc
к Microsoft Fabric с помощью прокси-службы TDS (потоковая передача табличных данных).
Дополнительные сведения см. в следующих ресурсах:
- Подключите Microsoft Fabric для подключения в dbt Cloud.
- Настройка адаптера dbt хранилища данных Microsoft Fabric для подключения к dbt Core.
- Конфигурация адаптера dbt для хранилища данных Microsoft Fabric — для дополнительных сведений о конфигурации.
Подключение с помощью других средств
Любой сторонний инструмент также может использовать строку подключения 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 для повышения надежности. Дополнительные сведения см. в следующих документах:
- Шаблон повторных попыток — Центр архитектуры Azure
- Работа с временными ошибками — База данных SQL Azure
- Шаг 4. Устойчивое подключение к SQL с помощью ADO.NET — поставщик ADO.NET для SQL Server
- Шаг 4. Устойчивое подключение к SQL с помощью PHP — драйверы PHP для SQL Server
Рекомендации и ограничения
- Проверка подлинности SQL не поддерживается.
- Поддержка нескольких активных результирующих наборов (MARS) не предусмотрена для хранилища Microsoft Fabric. MARS отключен по умолчанию, однако если
MultipleActiveResultSets
включен в строке подключения, его следует удалить или задать значение false. - Если вы получите эту ошибку "Не удалось завершить операцию, так как мы достигли ограничения системы", это связано с тем, что размер токена системы достиг предела. Эта проблема может быть вызвана, если в рабочей области слишком много хранилищ или конечных точек аналитики SQL, если пользователь является частью слишком большого количества групп Microsoft Entra или комбинацией двух. Рекомендуется использовать 40 или меньше хранилищ и конечную точку аналитики SQL для каждой рабочей области, чтобы предотвратить эту ошибку. Если проблема не исчезла, обратитесь в службу поддержки.
- Если вы получаете код ошибки 24804 с сообщением "Не удалось завершить операцию из-за обновления системы. Закройте это соединение, снова войдите в систему и повторите операцию" или код ошибки 6005 с сообщением "Выключение выполняется. Сбой выполнения на сервере SQL. Обратитесь к группе SQL Server, если вам нужна дополнительная поддержка." Это связано с временной потерей подключения, вероятно, из-за развертывания системы или перенастройки. Чтобы устранить эту проблему, выполните вход еще раз и повторите попытку. Чтобы узнать, как построить устойчивость и повторы в вашем приложении, смотрите Рекомендации.
- Подключения к связанному серверу из SQL Server не поддерживаются.