Samouczek: tworzenie obiektów bazy danych za pomocą edytora Transact-SQL — Azure Data Studio

Ważny

Usługa Azure Data Studio zostanie wycofana 28 lutego 2026 r.. Zalecamy użycie rozszerzenia MSSQL dla programu Visual Studio Code. Aby uzyskać więcej informacji na temat migracji do programu Visual Studio Code, odwiedź Co się dzieje z usługą Azure Data Studio?

Tworzenie i uruchamianie zapytań, procedur składowanych, skryptów itp. to podstawowe zadania specjalistów ds. baz danych. W tym samouczku przedstawiono kluczowe funkcje w edytorze języka T-SQL w celu utworzenia obiektów bazy danych.

Z tego samouczka dowiesz się, jak za pomocą narzędzia Azure Data Studio wykonywać następujące działania:

• Wyszukiwanie obiektów bazy danych
• Edytowanie danych tabeli
• Używanie fragmentów kodu do szybkiego pisania kodu T-SQL
• Wyświetlanie szczegółów obiektu bazy danych przy użyciu funkcji Zobacz definicję i Przejdź do definicji

Prerequisites

Ten samouczek wymaga bazy danych TutorialDB programu SQL Server lub usługi Azure SQL Database. Aby utworzyć bazę danych TutorialDB, wykonaj jeden z następujących szybki start:

• Nawiązywanie połączenia z programem SQL Server i wykonywanie zapytań względem programu SQL Server przy użyciu narzędzia Azure Data Studio
• Nawiązywanie połączenia z usługą Azure SQL Database i wykonywanie zapytań względem usługi Azure SQL Database przy użyciu narzędzia Azure Data Studio

Szybkie lokalizowanie obiektu bazy danych i wykonywanie typowego zadania

Usługa Azure Data Studio udostępnia widżet wyszukiwania umożliwiający szybkie znajdowanie obiektów bazy danych. Lista wyników zawiera menu kontekstowe dla typowych zadań związanych z wybranym obiektem, takich jak Edytowanie danych dla tabeli.

1. Otwórz pasek boczny SERWERY (Ctrl+G), rozwiń węzeł Bazy danych i wybierz pozycję TutorialDB.

2. Otwórz pulpit nawigacyjny TutorialDB , klikając prawym przyciskiem myszy pozycję TutorialDB i wybierając polecenie Zarządzaj z menu kontekstowego:

   

3. Na pulpicie nawigacyjnym kliknij prawym przyciskiem myszy pozycję dbo. Klienci (w widżecie wyszukiwania) i wybierz pozycję Edytuj dane.

   Tip

   W przypadku baz danych z wieloma obiektami użyj widżetu wyszukiwania, aby szybko zlokalizować tabelę, widok itp., którego szukasz.

   

4. Edytuj kolumnę Email w pierwszym wierszu, wpisz orlando0@adventure-works.com, a następnie naciśnij Enter , aby zapisać zmianę.

   

Tworzenie procedur składowanych przy użyciu fragmentów kodu T-SQL

Narzędzie Azure Data Studio udostępnia wiele wbudowanych fragmentów kodu T-SQL na potrzeby szybkiego tworzenia instrukcji.

1. Otwórz nowy edytor zapytań, naciskając Ctrl+N.

2. Wpisz sql w edytorze, strzałkę w dół do sqlCreateStoredProcedure, a następnie naciśnij Tab (lub Enter), aby załadować fragment procedury składowanej.

   

3. Fragment tworzenia procedury składowanej ma dwa skonfigurowane pola do szybkiej edycji, StoredProcedureName i SchemaName. Wybierz pozycję StoredProcedureName, kliknij prawym przyciskiem myszy i wybierz pozycję Zmień wszystkie wystąpienia. Teraz wpisz getCustomer i wszystkie wpisy StoredProcedureName zmieniają się na getCustomer.

   

4. Zmień wszystkie wystąpienia elementu SchemaName na dbo.

5. Fragment zawiera parametry zastępcze i tekst, który wymaga aktualizacji. Instrukcja EXECUTE zawiera również tekst zastępczy, ponieważ nie wie, ile parametrów będzie zawierać procedura. Na potrzeby tego samouczka zaktualizuj fragment kodu, tak aby wyglądał on następująco:

   -- 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. Aby utworzyć procedurę składowaną i wykonać ją testowo, naciśnij F5.

Procedura składowana została utworzona, a w okienku RESULTS jest wyświetlany zwrócony klient w formacie JSON. Aby wyświetlić sformatowany kod JSON, kliknij zwrócony rekord.

Korzystanie z definicji podglądu

Narzędzie Azure Data Studio umożliwia wyświetlanie definicji obiektów przy użyciu funkcji podglądu definicji. Ta sekcja tworzy drugą procedurę składowaną i używa definicji podglądu, aby zobaczyć, jakie kolumny znajdują się w tabeli, aby szybko utworzyć treść procedury składowanej.

1. Otwórz nowy edytor, naciskając Ctrl+N.

2. Wpisz sql w edytorze, strzałkę w dół do sqlCreateStoredProcedure, a następnie naciśnij Tab (lub Enter), aby załadować fragment procedury składowanej.

3. Wpisz setCustomer dla StoredProcedureName i dbo dla SchemaName

4. @param Zastąp symbole zastępcze następującą definicją parametru:

   @json_val nvarchar(max)
   

5. Zastąp treść procedury składowanej następującym kodem:

   INSERT INTO dbo.Customers
   

6. W dodanym wierszu INSERT kliknij prawym przyciskiem myszy dbo.Customers i wybierz pozycję Podgląd definicji.

   

7. Zostanie wyświetlona definicja tabeli, aby szybko zobaczyć, jakie kolumny znajdują się w tabeli. Zapoznaj się z listą kolumn, aby łatwo ukończyć deklaracje procedury składowanej. Zakończ tworzenie instrukcji INSERT, która została wcześniej dodana, aby ukończyć treść procedury składowanej, a następnie zamknij okno podglądu definicji:

   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. Usuń (lub oznacz jako komentarz) polecenie EXECUTE w dolnej części zapytania.

9. Cała instrukcja powinna wyglądać podobnie do następującego kodu:

   -- 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. Aby utworzyć procedurę składowaną setCustomer, naciśnij F5.

Użyj funkcji zapisywania wyników zapytania jako kodu JSON, aby przetestować procedurę składowaną setCustomer

Procedura składowana setCustomer utworzona w poprzedniej sekcji wymaga przekazania danych JSON do parametru @json_val . W tej sekcji pokazano, jak uzyskać poprawnie sformatowany fragment JSON do podania w parametrze, aby można było przetestować procedurę składowaną.

1. Na pasku bocznym SERWERY kliknij prawym przyciskiem myszy tabelę dbo.Customers i wybierz opcję SELECT TOP 1000 Rows.

2. Wybierz pierwszy wiersz w widoku wyników, upewnij się, że cały wiersz jest zaznaczony (kliknij liczbę 1 w lewej kolumnie) i wybierz pozycję Zapisz jako kod JSON.

3. Zmień folder na lokalizację, którą zapamiętasz, aby później można było usunąć plik (na przykład pulpit) i kliknąć przycisk Zapisz. Zostanie otwarty plik sformatowany w formacie JSON.

   

4. Wybierz dane JSON w edytorze i skopiuj je.

5. Otwórz nowy edytor, naciskając Ctrl+N.

6. W poprzednich krokach pokazano, jak można łatwo pobrać prawidłowo sformatowane dane, aby wykonać wywołanie procedury setCustomer . Poniższy kod używa tego samego formatu JSON z nowymi szczegółami klienta, dzięki czemu możemy przetestować procedurę setCustomer . Instrukcja zawiera składnię służącą do deklarowania parametru i uruchamiania nowych procedur pobierania i ustawiania. Skopiowane dane można wkleić z poprzedniej sekcji i edytować tak, aby były takie same jak w poniższym przykładzie lub po prostu wklejać następującą instrukcję do edytora zapytań.

   -- 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. Wykonaj skrypt, naciskając F5. Skrypt wstawia nowego klienta i zwraca informacje nowego klienta w formacie JSON. Kliknij wynik, aby otworzyć sformatowany widok.

   

Dalsze kroki

W tym samouczku nauczyłeś się następujących rzeczy:

• Obiekty schematu szybkiego wyszukiwania
• Edytowanie danych tabeli
• Pisanie skryptu języka T-SQL przy użyciu fragmentów kodu
• Dowiedz się więcej o szczegółach obiektu bazy danych przy użyciu funkcji Zobacz definicję i Przejdź do definicji

Aby dowiedzieć się, jak włączyć widżet pięciu najwolniejszych zapytań , wykonaj następny samouczek:

Włącz widżet przykładowych informacji o wolnych zapytaniach