Руководство. Создание объектов базы данных в Azure Data Studio с помощью редактора Transact-SQL

Important

Azure Data Studio прекратит работу 28 февраля 2026 г.. Мы рекомендуем использовать расширение MSSQL для Visual Studio Code. Дополнительные сведения о миграции в Visual Studio Code см. в Что происходит с Azure Data Studio?

Создание и выполнение запросов, хранимых процедур, скриптов и т. д. являются основными задачами специалистов по базам данных. В этом руководстве показаны основные функции редактора T-SQL для создания объектов базы данных.

В этом руководстве описано, как использовать Azure Data Studio для:

• Поиск объектов базы данных
• Изменение данных таблицы
• Использование фрагментов кода для быстрой записи T-SQL
• Просмотр сведений об объекте базы данных с помощью Просмотр определения и Перейти к определению

Prerequisites

Для работы с этим руководством требуется SQL Server или База данных SQL Azure TutorialDB. Чтобы создать базу данных TutorialDB , выполните одно из следующих кратких руководств.

• Подключение и запрос SQL Server с помощью Azure Data Studio
• Подключение и запрос базы данных SQL Azure с помощью Azure Data Studio

Быстро найти объект базы данных и выполнить общую задачу

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

1. Откройте боковую панель SERVERS (CTRL+G), разверните базы данных и выберите TutorialDB.

2. Откройте панель мониторинга TutorialDB , щелкнув правой кнопкой мыши TutorialDB и выбрав пункт "Управление " в контекстном меню:

   

3. На панели мониторинга щелкните правой кнопкой мыши dbo. Клиенты (в мини-приложении поиска) и выберите "Изменить данные".

   Tip

   Для баз данных с большим количеством объектов используйте мини-приложение поиска для быстрого поиска таблицы, представления и т. д.

   

4. Измените столбец "Электронная почта" в первой строке, введите orlando0@adventure-works.comи нажмите клавишу ВВОД , чтобы сохранить изменение.

   

Использование фрагментов кода T-SQL для создания хранимых процедур

Azure Data Studio предоставляет множество встроенных фрагментов кода T-SQL для быстрого создания инструкций.

1. Откройте новый редактор запросов, нажав клавиши CTRL+N.

2. Введите sql в редакторе, со стрелкой вниз до sqlCreateStoredProcedure и нажмите клавишу TAB (или ВВОД), чтобы загрузить фрагмент хранимой процедуры.

   

3. В шаблоне создания хранимой процедуры есть два поля, настроенные для быстрого редактирования: StoredProcedureName и SchemaName. Выберите StoredProcedureName, щелкните правой кнопкой мыши и выберите "Изменить все вхождения". Теперь введите getCustomer, и все записи StoredProcedureName изменятся на getCustomer.

   

4. Измените все вхождения SchemaName на dbo.

5. Фрагмент кода содержит параметры-заполнители и основной текст, который необходимо обновить. Инструкция EXECUTE также содержит текст-заполнитель, так как она не знает, сколько параметров будет иметь процедура. В этом руководстве обновите фрагмент кода, чтобы он выглядел следующим образом:

   -- Create a new stored procedure called 'getCustomer' in schema 'dbo'
   -- Drop the stored procedure if it already exists
   IF EXISTS (
   SELECT *
   FROM INFORMATION_SCHEMA.ROUTINES
   WHERE SPECIFIC_SCHEMA = N'dbo'
   AND SPECIFIC_NAME = N'getCustomer'
   )
   DROP PROCEDURE dbo.getCustomer
   GO
   -- Create the stored procedure in the specified schema
   CREATE PROCEDURE dbo.getCustomer
   @ID int
   -- add more stored procedure parameters here
   AS
   -- body of the stored procedure
   SELECT  c.CustomerId, 
   c.Name, 
   c.Location, 
   c.Email
   FROM dbo.Customers c
   WHERE c.CustomerId = @ID
   FOR JSON PATH
   
   GO
   -- example to execute the stored procedure we just created
   EXECUTE dbo.getCustomer 1
   GO
   

6. Чтобы создать хранимую процедуру и дать ей тестовый запуск, нажмите клавишу F5.

Теперь создается хранимая процедура, а в области РЕЗУЛЬТАТОВ отображается возвращенный клиент в ФОРМАТЕ JSON. Чтобы просмотреть форматированный JSON, щелкните возвращенную запись.

Использование определения "Просмотр"

Azure Data Studio предоставляет возможность просматривать определение объектов с помощью функции просмотра определений. В этом разделе создается вторая хранимая процедура и используется определение просмотра, чтобы узнать, какие столбцы находятся в таблице, чтобы быстро создать текст хранимой процедуры.

1. Откройте новый редактор, нажав клавиши CTRL+N.

2. Введите sql в редакторе, со стрелкой вниз до sqlCreateStoredProcedure и нажмите клавишу TAB (или ВВОД), чтобы загрузить фрагмент хранимой процедуры.

3. Введите setCustomer для StoredProcedureName и dbo для SchemaName

4. Замените @param заполнители следующим определением параметра:

   @json_val nvarchar(max)
   

5. Замените текст хранимой процедуры следующим кодом:

   INSERT INTO dbo.Customers
   

6. В строке INSERT, которую вы только что добавили, щелкните правой кнопкой мыши dbo.Customers и выберите Просмотреть определение.

   

7. Отображается определение таблицы, чтобы быстро увидеть, какие столбцы находятся в таблице. Ознакомьтесь со списком столбцов, чтобы легко завершить инструкции для хранимой процедуры. Завершите создание оператора INSERT, добавленного ранее, чтобы завершить текст хранимой процедуры, и закройте окно быстрого просмотра определения.

   INSERT INTO dbo.Customers (CustomerId, Name, Location, Email)
       SELECT CustomerId, Name, Location, Email
       FROM OPENJSON (@json_val)
       WITH(   CustomerId int, 
               Name nvarchar(50), 
               Location nvarchar(50), 
               Email nvarchar(50)
    )
   

8. Удалите (или закомментируйте) команду EXECUTE в нижней части запроса.

9. Всё заявление должно выглядеть как следующий код:

   -- Create a new stored procedure called 'setCustomer' in schema 'dbo'
   -- Drop the stored procedure if it already exists
   IF EXISTS (
   SELECT *
       FROM INFORMATION_SCHEMA.ROUTINES
       WHERE SPECIFIC_SCHEMA = N'dbo'
       AND SPECIFIC_NAME = N'setCustomer'
   )
   DROP PROCEDURE dbo.setCustomer
   GO
   -- Create the stored procedure in the specified schema
   CREATE PROCEDURE dbo.setCustomer
       @json_val nvarchar(max) 
   AS
       -- body of the stored procedure
       INSERT INTO dbo.Customers (CustomerId, Name, Location, Email)
       SELECT CustomerId, Name, Location, Email
       FROM OPENJSON (@json_val)
       WITH(   CustomerId int, 
               Name nvarchar(50), 
               Location nvarchar(50), 
               Email nvarchar(50)
       )
   GO
   

10. Чтобы создать хранимую процедуру setCustomer , нажмите клавишу F5.

Использование результатов запроса в формате JSON для проверки хранимой процедуры setCustomer

Хранимая процедура setCustomer , созданная в предыдущем разделе, требует, чтобы данные JSON были переданы в параметр @json_val . В этом разделе показано, как правильно отформатировать бит JSON для передачи в параметр, чтобы проверить хранимую процедуру.

1. На боковой панели SERVERS правый клик по таблице dbo.Customers и выберите SELECT TOP 1000 Rows.

2. Выберите первую строку в представлении результатов, убедитесь, что выбрана вся строка (щелкните номер 1 в левом столбце) и нажмите кнопку "Сохранить как JSON".

3. Измените папку на расположение, в который вы запомните, чтобы можно было удалить файл позже (например, на рабочем столе) и нажмите кнопку "Сохранить". Откроется форматированный файл JSON.

   

4. Выберите данные JSON в редакторе и скопируйте его.

5. Откройте новый редактор, нажав клавиши CTRL+N.

6. На предыдущих шагах показано, как легко получить правильно отформатированные данные для выполнения вызова процедуры setCustomer . Следующий код использует тот же формат JSON с новыми сведениями о клиенте, чтобы проверить процедуру setCustomer . Инструкция включает синтаксис для объявления параметра и запуска новых процедур получения и задания. Вы можете вставить скопированные данные из предыдущего раздела и изменить его так же, как в следующем примере, или просто вставить следующую инструкцию в редактор запросов.

   -- example to execute the stored procedure we just created
   declare @json nvarchar(max) =
   N'[
       {
           "CustomerId": 5,
           "Name": "Lucy",
           "Location": "Canada",
           "Email": "lucy0@adventure-works.com"
       }
   ]'
   
   EXECUTE dbo.setCustomer @json_val = @json
   GO
   
   EXECUTE dbo.getCustomer @ID = 5
   

7. Выполните скрипт, нажав клавишу F5. Скрипт вставляет нового клиента и возвращает сведения о новом клиенте в формате JSON. Щелкните результат, чтобы открыть форматируемое представление.

   

Дальнейшие шаги

Из этого руководства вы узнали, как:

• Объекты схемы быстрого поиска
• Изменение данных таблицы
• Написание скрипта T-SQL с помощью фрагментов
• Узнайте о деталях объектов базы данных с помощью Peek Definition и Перейти к определению

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

Включите виджет анализа примеров медленных запросов