Samouczek: tworzenie obiektów bazy danych za pomocą edytora Transact-SQL — 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

Wymagania wstępne

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 przewodników 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.

   Napiwek

   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 procedury składowanej tworzy dwa pola skonfigurowane 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ę, aby uzyskaćCustomer.

   

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

5. Fragment kodu zawiera parametry symbolu zastępczego i tekst treści, 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 nadać mu przebieg testu, naciśnij F5.

Procedura składowana jest teraz tworzona, a w okienku RESULTS zostanie wyświetlony 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 polecenie setCustomer dla wartości StoredProcedureName i dbo dla parametru 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 pozycję dbo. Klienci i wybierz pozycję Zobacz definicję.

   

7. Zostanie wyświetlona definicja tabeli, aby szybko zobaczyć, jakie kolumny znajdują się w tabeli. Zapoznaj się z listą kolumn, aby łatwo ukończyć instrukcje 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 bit JSON w celu przekazania do parametru, aby można było przetestować procedurę składowaną.

1. Na pasku bocznym SERWERY kliknij prawym przyciskiem myszy dbo. Tabela Customers (Klienci ) i kliknij pozycję SELECT TOP 1000 Rows (WYBIERZ 1000 pierwszych wierszy).

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.

   

Następne kroki

W tym samouczku zawarto informacje na temat wykonywania następujących czynności:

• 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łączanie widżetu przykładowych szczegółowych informacji wolnych zapytań