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

Редактор запросов на портале Azure для Azure SQL Database

  • Статья

Применимо к: База данных SQL Azure

Редактор запросов (предварительный просмотр) — это средство для выполнения запросов T-SQL в Azure SQL Database через портал Azure в браузере.

Выполните запрос к базе данных Azure SQL из портала Azure

Редактор запросов предназначен для легковесного запроса и исследования объектов в вашей базе данных Azure SQL, все это из браузера в портале Azure. Вы можете выполнять запросы T-SQL к базе данных, а также изменять данные во встроенном редакторе табличных данных.

Аналогично интерфейсу запросов в SQL Server Management Studio, используйте редактор запросов как для простых запросов, так и для более крупных запросов T-SQL. Вы можете выполнять запросы языка обработки данных (DML) и языка определения данных (DDL).

Совет

Вы новичок в базе данных Azure SQL? Ознакомьтесь с подробным бесплатным учебным контентом: основы SQL Azure.

Подключение через редактор запросов

Существует два варианта проверки подлинности для редактора запросов: проверка подлинности SQL или проверка подлинности с помощью идентификатора Microsoft Entra (ранее — Azure Active Directory).

Проверка подлинности для База данных SQL Azure

Примеры см. в руководстве быстрого старта: использование редактора запросов портала Azure (предварительная версия) для выполнения запросов к базе данных Azure SQL.

  • Чтобы использовать проверку подлинности SQL для подключения к базе данных SQL Azure с помощью редактора запросов, необходимо иметь имя входа в базу данных логического сервера master или автономного пользователя SQL в нужной пользовательской базе данных. Дополнительные сведения см. Логины.
    • Введите имя пользователя и пароль, а затем нажмите кнопку "ОК".
  • Чтобы использовать проверку подлинности Microsoft Entra для подключения к базе данных SQL Azure с помощью редактора запросов, необходимо настроить базу данных с проверкой подлинности Microsoft Entra, и у вас должен быть пользователь Microsoft Entra, созданный в базе данных.
    • Нажмите кнопку "Продолжить" как <user@domain>.

Разрешения, необходимые для доступа к редактору запросов

Пользователям требуется по крайней мере разрешение управления доступом на основе ролей Azure (RBAC) для чтения к серверу и базе данных для использования редактора запросов.

Существует четыре основных раздела редактора запросов:

  • Панель навигации

  • Обозреватель объектов

  • Окно запроса

  • Copilot для базы данных Azure SQL

    Снимок экрана: портал Azure с красными прямоугольниками, выделенными редактором запросов в главном меню и строке навигации, обозреватель объектов и окне запроса.

В панели навигации можно выполнить четыре задачи.

  • Для изменения контекста проверки подлинности можно использовать имя входа .
  • Чтобы открыть пустое окно запроса, можно использовать новый запрос .
  • С помощью открытого запроса можно выбрать до 10 .sql или .txt файлов на локальном компьютере и открыть их в окне запроса.
  • Вы можете предоставить отзывы в редакторе запросов База данных SQL Azure.

Обозреватель объектов

Обозреватель объектов позволяет просматривать и выполнять задачи в таблицах, представлениях и хранимых процедурах базы данных.

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

Окно запроса

Это окно позволяет ввести или вставить запрос, а затем запустить его. Результаты запроса отображаются на панели результатов .

Вы можете отменить запрос. Как отмечалось в разделе "Рекомендации и ограничения", существует пятиминутный период времени ожидания.

Кнопка "Сохранить запрос" позволяет сохранить текст запроса на компьютер в виде файла .sql .

Кнопка "Экспорт данных как" позволяет экспортировать результаты запроса на компьютер в виде файла .json, .csv или .xml .

Время выполнения запроса или ошибки отображаются в строке состояния.

Навыки Microsoft Copilot в базе данных Azure SQL (предварительный выпуск)

Microsoft Copilot — это помощник по искусственному интеллекту, предназначенный для упрощения проектирования, эксплуатации, оптимизации и работоспособности приложений, управляемых База данных SQL Azure. Это повышает производительность в портале Azure, предлагая преобразование с естественного языка в SQL и возможность самообслуживания для администрирования базы данных.

Опыт работы с естественным языком для SQL в редакторе запросов портала Azure для базы данных SQL Azure преобразует запросы на естественном языке в SQL, что делает взаимодействие с базой данных более интуитивным.

Руководство с примерами естественного языка и возможностей SQL Copilot см. в разделе "Естественный язык для SQL" в редакторе запросов в портале Azure (предварительная версия). Дополнительные сведения см. в статье Часто задаваемые вопросы о навыках Microsoft Copilot в базе данных Azure SQL (предварительная версия).

Редактор данных

Редактор данных позволяет изменять данные в существующей строке, добавлять новую строку данных в таблицу или удалять строку данных. Это аналогично интерфейсу SQL Server Management Studio (SSMS).

Чтобы получить доступ к редактору данных, в обозревателе объектов разверните таблицы, а затем щелкните многоточие справа от имени таблицы и выберите "Изменить данные (предварительная версия)".

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

  • Если столбец является столбцом идентификаторов, изменить это значение нельзя. Появится сообщение об ошибке: Save failed: Failed to execute query. Error: Cannot update identity column *column_name*

Чтобы добавить новую строку, нажмите кнопку "Создать строку " и введите значения, которые нужно добавить. Существуют определенные типы данных, с которыми вы не можете добавлять или работать в этом контексте.

  • Если столбец является идентификационным столбцом, в это поле нельзя добавлять значение. Появится сообщение об ошибке: Save failed: Cannot set value in identity columns *column_name*
  • Столбцы с ограничениями по умолчанию не учитываются. Редактор данных не создаст значение по умолчанию, оно ожидает, что вы введете значение. Не рекомендуется использовать редактор данных для таблиц с ограничениями столбцов по умолчанию.
  • Вычисляемые столбцы не подсчитываются. Вы увидите сообщение Save failed: Failed to execute query. Error: The column *column_name* cannot be modified because it is either a computed column or is the result of a UNION operator. об ошибке Не рекомендуется использовать редактор данных для таблиц с вычисляющими столбцами.

Чтобы удалить строку данных, выберите строку и нажмите кнопку "Удалить строку".

  • Если строка имеет первичный ключ, а первичный ключ имеет отношение внешнего ключа к другой таблице, при удалении строки связанные строки в другой таблице также будут удалены.

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

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

Ограничения редактора запросов

  • Если запрос содержит несколько инструкций, на вкладке "Результаты" отображаются только результаты последней инструкции.
  • Редактор запросов не поддерживает подключение к базе данных логического сервера master . Чтобы подключиться к master базе данных, используйте другие средства для выполнения запросов к базе данных SQL в Azure.
  • Редактор запросов не может подключиться к базе данных-реплике ApplicationIntent=ReadOnly. Чтобы подключиться таким образом, используйте SSMS и укажите ApplicationIntent=ReadOnly на вкладке "Дополнительные параметры подключения" в параметрах подключения. Подробности см. в разделе «Подключение к реплике только для чтения».
  • Редактор запросов имеет 5-минутное время ожидания для выполнения запроса. Чтобы выполнять более длительные запросы, используйте другие средства для запроса База данных SQL Azure.
  • Редактор запросов поддерживает только цилиндрическую проекцию для типов данных geography.
  • Редактор запросов не поддерживает IntelliSense для таблиц и представлений базы данных, но поддерживает автоматическое заполнение имен, которые уже были введены. Для поддержки IntelliSense используйте другие средства для запроса базы данных Azure SQL.
  • Нажатие клавиши F5 обновляет страницу редактора запросов, и любой запрос в данный момент в редакторе не сохраняется.

Другие способы выполнения запросов к базе данных Azure SQL

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

Рекомендации по подключению

  • Для общедоступных подключений к редактору запросов необходимо добавить исходящий IP-адрес в разрешенные правила брандмауэра сервера для доступа к базам данных.
    • Вам не нужно добавлять IP-адрес в правила брандмауэра SQL Server, если на сервере настроено подключение с использованием Private Link, и вы подключаетесь к серверу из частной виртуальной сети.

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

  • Если появится сообщение The X-CSRF-Signature header could not be validatedоб ошибке, выполните следующие действия, чтобы устранить проблему:

    • Проверьте, правильно ли настроены время и часовой пояс на вашем компьютере. Вы можете попытаться сопоставить часовой пояс компьютера с Azure, выполнив поиск часового пояса для расположения базы данных, например восточная часть США.
    • Если вы находитесь в сети прокси-сервера, убедитесь, что заголовок X-CSRF-Signature запроса не изменяется или не удаляется.

  • Если база данных бессерверна и отображается сообщение об ошибке: Database *name* on server *name.database.windows.net* is not currently available. Please retry the connection later. If the problem persists, contact customer support, and provide them the session tracing ID *ID* Это означает, что бессерверная база данных в настоящее время приостановлена. Если это происходит, выбор Continue as <user@domain> отправляет запрос в базу данных для возобновления. Подождите примерно одну минуту, обновите страницу и повторите попытку.

  • Если отображается сообщение об ошибке "Ошибка входа для пользователя <token-identified principal>. Сервер в настоящее время не настроен на принятие этого маркера". При попытке использовать проверку подлинности AD пользователь не имеет доступа к базе данных.

Подключение через порт 443 и 1443

В редакторе запросов может возникнуть одна из следующих ошибок:

  • Your local network settings might be preventing the Query Editor from issuing queries. Please click here for instructions on how to configure your network settings.
  • A connection to the server could not be established. This might indicate an issue with your local firewall configuration or your network proxy settings.

Эти ошибки возникают, так как редактор запросов не может взаимодействовать через порты 443 и 1443. Необходимо включить исходящий трафик HTTPS на этих портах. В следующих инструкциях описан этот процесс в зависимости от операционной системы. Возможно, корпоративному ИТ-отделу потребуется дать разрешение, чтобы открыть это подключение в локальной сети.

Разрешить 443 и 1443 в брандмауэре Защитника Windows

  1. Откройте брандмауэр Защитника Windows.
  2. В меню слева выберите дополнительные параметры.
  3. В брандмауэре Защитника Windows с расширенной безопасностью выберите правила исходящего трафика в меню слева.
  4. Выберите новое правило в правом меню.
  5. В мастере создания исходящего правила выполните следующие действия.
    1. Выберите порт в качестве типа правила, которое вы хотите создать, и нажмите кнопку "Далее".
    2. Выберите TCP.
    3. Выберите определенные удаленные порты, введите 443, 1443и нажмите кнопку "Далее".
    4. Нажмите кнопку "Разрешить подключение", если это безопасно, нажмите кнопку "Далее", а затем нажмите кнопку "Далее ".
    5. Сохраните домен, частный и общедоступный выбранными.
    6. Присвойте правилу имя, например редактор запросов SQL Access Azure, и при необходимости укажите описание. Выберите Готово.

Разрешить 443 и 1443 в macOS

  1. В меню Apple откройте системные настройки.
  2. Выберите "Безопасность и конфиденциальность" и выберите "Брандмауэр".
  3. Если брандмауэр отключен, щелкните блокировку, чтобы внести изменения, и нажмите кнопку "Включить брандмауэр".
  4. Выберите Параметры брандмауэра.
  5. В окне "Безопасность и конфиденциальность" выберите автоматически разрешать подписанное программное обеспечение получать входящие подключения.

Разрешить 443 и 1443 в Linux

Выполните следующие команды, чтобы обновить iptables:

sudo iptables -A OUTPUT -p tcp --dport 443 -j ACCEPT
sudo iptables -A OUTPUT -p tcp --dport 1443 -j ACCEPT

Разрешить 443 и 1443 на виртуальной машине Azure

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

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

Краткое руководство: Использование редактора запросов портала Azure для запроса базы данных SQL Azure

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