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

Ważny

Program Azure Data Studio został wycofanyod 28 lutego 2026 r. Należy przeprowadzić migrację do programu Visual Studio Code. Aby uzyskać więcej informacji, zobacz Co się dzieje z narzędziem 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