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


Интеграция Fabric

Расширение MSSQL для Visual Studio Code поддерживает подключение к базе данных SQL в Microsoft Fabric. В диалоговом окне подключения включен параметр подключения Fabric, используемый для входа с помощью идентификатора Microsoft Entra. Рабочие области Fabric можно просматривать в виде дерева, выполнять поиск в разных рабочих областях и подключаться к базам данных ИЛИ конечным точкам SQL, не настраивая строки подключения вручную. Расширение поддерживает постоянный вход, переключение арендаторов и бесшовную функцию Open in MSSQL из расширения Fabric.

Вы можете создавать новые базы данных SQL в Fabric непосредственно из Visual Studio Code. Проверка подлинности, выбор или создание рабочей области, указание имени базы данных и подключение после завершения подготовки. Индикатор показывает ход выполнения.

Подключение Fabric (Обзор)

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

Capabilities

  • Специальный вариант для Fabric: параметр, специфичный для Fabric в диалоговом окне "Подключение", который используется для подключения к базам данных Fabric.

  • Простая проверка подлинности: использует учетную запись Майкрософт для входа. Проверка подлинности выполняется один раз, чтобы получить доступ ко всем рабочим областям и базам данных Fabric.

  • Просмотр рабочей области. Отображает все рабочие области Fabric в иерархическом представлении дерева с ресурсами, загруженными по запросу.

  • Поиск и обнаружение: поиск в режиме реального времени для поиска рабочих областей или баз данных без прокрутки длинных списков.

  • Поддержка кросс-расширений: базы данных Open Fabric в расширении MSSQL из расширения Fabric или портала.

Предпосылки

  • Установите последнюю версию расширения MSSQL для Visual Studio Code.
  • Разрешения на подписку и рабочую область Active Fabric.
  • Действующая учетная запись Microsoft с доступом к рабочим областям и ресурсам Fabric.
  • Идентификатор Microsoft Entra для проверки подлинности. После входа можно выбрать учетную запись и конкретный клиент, чтобы просмотреть правильный набор рабочих областей и баз данных Fabric.

Замечание

Для работы с интерфейсом подключения Fabric (Обзор) вам не нужны строки подключения или личные токены доступа.

Начало работы

  1. Откройте диалоговое окно «Подключение» и выберите «Просмотр Fabric».

    Снимок экрана: подключение Fabric в расширении MSSQL для Visual Studio Code.

  2. Войдите с помощью идентификатора Microsoft Entra.

    Проверка подлинности при первом запуске

    • Тип проверки подлинности по умолчанию — Microsoft Entra ID - универсальный с поддержкой MFA.
    • Если вы не вошли, откройте раскрывающийся список "Учетная запись" и выберите "Добавить учетную запись".
    • Выберите свою учетную запись и завершите процесс входа в открывшемся окне браузера.
    • Вернитесь в Visual Studio Code после успешного завершения процесса.

    Аутентификация возвращающегося пользователя

    • Когда вы часто входите в систему, информация вашей учетной записи будет отображаться уже заполненной.
    • Убедитесь, что выбрана правильная учетная запись и продолжить.
  3. (Optional) Выберите арендатора.

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

  5. Используйте панель поиска в верхней части дерева, чтобы быстро найти рабочую область или базу данных.

  6. Выберите нужную конечную точку базы данных или аналитики из списка.

  7. Подтвердите проверку подлинности выбранного ресурса, если появится запрос.

    Снимок экрана подключения к Fabric из обзорного интерфейса Fabric.

  8. Выберите "Подключиться" , чтобы добавить выбранную базу данных в список подключений .

  9. Новое подключение отображается в подключениях, а окно запроса открывается готово для использования.

    Снимок экрана: новое подключение Fabric в обозревателе объектов.

Подсказка

Используйте поиск в верхней части дерева, чтобы быстро найти рабочую область или базу данных. Результаты определяют приоритет ближайших совпадений и недавно использованных элементов.

Обработка ошибок и пограничные случаи

Если что-то не так, пользовательский интерфейс отображает четкое сообщение и рекомендуемые действия:

Тип Message Рекомендуемое действие
Нет доступа к рабочей области You do not have permission to view this workspace. Запрос доступа или переключения учетной записи.
Служба недоступна или ограничена Fabric service is temporarily unavailable. Повторите попытку или проверьте работоспособность службы.
Сеанс с истекшим сроком действия Your session has expired. Повторная проверка подлинности с помощью Microsoft Entra ID.
Ограничения сети Connection blocked by network policy. Проверьте параметры корпоративного, VPN или брандмауэра.

Это важно

Чтобы обеспечить отклик дерева, просмотр больших тенантов может загружать дочерние элементы по запросу. При развертывании узлов с большим количеством элементов можно заметить кратковременные индикаторы загрузки.

Известные ограничения

  • Поддерживаются только базы данных SQL и конечные точки аналитики SQL . Вы не можете открыть другие типы элементов Fabric из расширения MSSQL.
  • Вы можете переключаться между арендаторами, но при этом необходимо сделать отдельное подключение к каждой базе данных. Единого межтенантного или мультибазового подключения нет.
  • Офлайн потоки входа и аутентификация по коду устройства не поддерживаются.

База данных SQL в подготовке Fabric

Интерфейс подготовки базы данных SQL интегрирован на страницу "Развертывания" расширения MSSQL. Вы можете создавать и подключаться к новым базам данных SQL Fabric, не выходя из Visual Studio Code.

Capabilities

  • Интерактивный рабочий процесс: Пошаговое руководство по аутентификации, выбору или созданию рабочей области, именованию базы данных и подготовке на странице "Развертывания".

  • Немедленное подключение. Автоматически добавляет только что подготовленную базу данных в список подключений.

  • Согласованный опыт: Выполняет тот же процесс развертывания, что и другие поддерживаемые серверные решения, такие как локальные контейнеры SQL Server.

  • Осведомленность о емкости: указывает, когда ограничения емкости отключают рабочие области с подсказками, объясняющими причину.

Предпосылки

  • Действующая подписка Microsoft Fabric.
  • Достаточная емкость в целевой рабочей области для подготовки новых баз данных SQL.
  • Учетная запись Microsoft Entra ID с необходимыми разрешениями для рабочей области (администратор или участник).
  • Visual Studio Code с установленным расширением MSSQL.

Начало работы

  1. Откройте страницу "Развертывания" и выберите базу данных SQL в Fabric.
  2. Проверка подлинности с помощью идентификатора Microsoft Entra.
  3. Выберите или создайте рабочую область Fabric.
  4. Введите имя базы данных и нажмите кнопку "Создать".
  5. После завершения подготовки база данных подключена автоматически и отображается в разделе "Подключения" с подтверждением успешности.

Подсказка

Сквозной поток обычно завершается менее чем за минуту.

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

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

Сведения о осведомленности о емкости

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

Снимок экрана раскрывающегося списка рабочих областей с отключенными рабочими областями из-за лимитов на емкость.

Поведение после подготовки

  • Новое подключение принимает выбранную вами группу соединений (необязательно) для быстрой идентификации визуальных элементов.
  • Вы можете связать эту функцию с функцией обзора Fabric , чтобы обнаружить и подключиться к созданной базе данных из другой среды Visual Studio Code.

Устранение неполадок

  • Имя уже существует: выберите уникальное имя базы данных в выбранной рабочей области.
  • Недостаточно разрешений. Убедитесь, что у вас есть права администратора рабочей области или члена для создания баз данных.
  • Ошибки сети или арендатора: выполните повторную проверку подлинности или переключите учетную запись через меню учетной записи.
  • Время ожидания провизирования или сбой: Если мастер не завершает работу, повторите операцию или проверьте работоспособность службы Fabric.

Известные ограничения

  • Базы данных SQL можно подготавливать только в Fabric. Другие типы элементов Fabric не поддерживаются.
  • При явном выборе другого арендатора во время аутентификации можно развертывать ресурсы между арендаторами. Однако Visual Studio Code пока не поддерживает сценарии, связанные с несколькими одновременными клиентами или автоматизированными рабочими процессами между клиентами.
  • При полном исчерпании емкости нельзя запустить процедуру предоставления ресурсов.

Отзывы и поддержка

Если у вас есть идеи, отзывы или хотите взаимодействовать с сообществом, присоединитесь к обсуждению https://aka.ms/vscode-mssql-discussions. Чтобы сообщить об ошибке, посетите сайт https://aka.ms/vscode-mssql-bug. Чтобы запросить новую функцию, перейдите в раздел https://aka.ms/vscode-mssql-feature-request.