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


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

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

В Microsoft Fabric конечная точка аналитики SQL Lakehouse или хранилище доступно через конечную точку табличного потока данных (TDS), знакомую всем современным веб-приложениям, взаимодействующим с конечной точкой 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 для доступа к данным. Данные можно получить для всех объектов, к которым у пользователя есть доступ.

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

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

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

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

  1. Перейдите в рабочую область, выберите хранилище.
  2. Нажмите кнопку Копировать в поле строка подключения SQL, чтобы скопировать строку подключения в буфер обмена.

Или в OneLake:

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

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

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

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

    Снимок экрана, показывающий, где выбрать движок базы данных в меню

  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, используйте 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 (потоковая передача табличных данных).

Дополнительные сведения см. в следующих ресурсах:

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

Любой сторонний инструмент также может использовать строку подключения 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, если пользователь является частью слишком большого количества групп Microsoft Entra или комбинацией двух. Рекомендуется использовать 40 или меньше хранилищ и конечную точку аналитики SQL для каждой рабочей области, чтобы предотвратить эту ошибку. Если проблема не исчезла, обратитесь в службу поддержки.
  • Если вы получаете код ошибки 24804 с сообщением "Не удалось завершить операцию из-за обновления системы. Закройте это соединение, снова войдите в систему и повторите операцию" или код ошибки 6005 с сообщением "Выключение выполняется. Сбой выполнения на сервере SQL. Обратитесь к группе SQL Server, если вам нужна дополнительная поддержка." Это связано с временной потерей подключения, вероятно, из-за развертывания системы или перенастройки. Чтобы устранить эту проблему, выполните вход еще раз и повторите попытку. Чтобы узнать, как построить устойчивость и повторы в вашем приложении, смотрите Рекомендации.
  • Подключения к связанному серверу из SQL Server не поддерживаются.