Oktatóanyag: Adatbázis-objektumok létrehozása a Transact-SQL-szerkesztő használatával – Azure Data Studio

A lekérdezések, tárolt eljárások, szkriptek stb. létrehozása és futtatása az adatbázis-szakemberek alapvető feladatai. Ez az oktatóanyag bemutatja a T-SQL-szerkesztő legfontosabb funkcióit az adatbázis-objektumok létrehozásához.

Ebben az oktatóanyagban megtudhatja, hogyan használhatja az Azure Data Studiót a következőkre:

Előfeltételek

Ehhez az oktatóanyaghoz az SQL Server vagy az Azure SQL Database TutorialDB szükséges. A TutorialDB-adatbázis létrehozásához végezze el az alábbi rövid útmutatók egyikét:

• SQL Server csatlakoztatása és lekérdezése az Azure Data Studióval
• Az Azure SQL Database csatlakoztatása és lekérdezése az Azure Data Studióval

Adatbázis-objektum gyors megkeresése és gyakori feladat végrehajtása

Az Azure Data Studio keresési widgetet biztosít az adatbázis-objektumok gyors kereséséhez. Az eredménylista helyi menüt biztosít a kijelölt objektummal kapcsolatos gyakori feladatokhoz, például egy tábla adatainak szerkesztése.

1. Nyissa meg a SERVERS oldalsávot (Ctrl+G), bontsa ki az Adatbázisok elemet, és válassza a TutorialDB lehetőséget.

2. A TutorialDB irányítópult megnyitásához kattintson a jobb gombbal a TutorialDB elemre, és válassza a Kezelés lehetőséget a helyi menüből:

   

3. Az irányítópulton kattintson a jobb gombbal a dbo elemre. Ügyfelek (a keresési widgetben) és válassza az Adatok szerkesztése lehetőséget.

   Tipp.

   A sok objektumot tartalmazó adatbázisok esetén a keresési vezérlővel gyorsan megtalálhatja a keresett táblát, nézetet stb.

   

4. Szerkessze az E-mail oszlopot az első sorban, írja be orlando0@adventure-works.com, majd nyomja le az Enter billentyűt a módosítás mentéséhez.

   

Tárolt eljárások létrehozása T-SQL-kódrészletek használatával

Az Azure Data Studio számos beépített T-SQL-kódrészletet biztosít az utasítások gyors létrehozásához.

1. Nyisson meg egy új lekérdezésszerkesztőt a Ctrl+N billentyűkombináció lenyomásával.

2. Írja be az sql-t a szerkesztőbe, nyíllal lépjen az sqlCreateStoredProcedure lapra, és nyomja le a Tab billentyűt (vagy az Entert) a tárolt eljárás kódrészletének betöltéséhez.

   

3. A tárolt eljárás kódrészletének két mezője van beállítva a gyors szerkesztéshez, a StoredProcedureName és a SchemaName. Válassza a StoredProcedureName lehetőséget, kattintson a jobb gombbal, és válassza az Összes előfordulás módosítása lehetőséget. Most írja be a getCustomer parancsot, és az összes StoredProcedureName bejegyzés módosul a getCustomer értékre.

   

4. Módosítsa a SchemaName összes előfordulását dbo-ra.

5. A kódrészlet helyőrző paramétereket és szövegtörzset tartalmaz, amelyeket frissíteni kell. Az EXECUTE utasítás helyőrző szöveget is tartalmaz, mert nem tudja, hány paramétert tartalmaz majd az eljárás. Ebben az oktatóanyagban frissítse a kódrészletet, hogy az a következő kódhoz hasonlóan nézzen ki:

   -- 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. A tárolt eljárás létrehozásához és a teszt futtatásához nyomja le az F5 billentyűt.

Ekkor létrejön a tárolt eljárás, és a TALÁLATok panel megjeleníti a visszaadott ügyfelet a JSON-ban. A formázott JSON megjelenítéséhez kattintson a visszaadott rekordra.

Betekintő definíció használata

Az Azure Data Studio lehetővé teszi egy objektumdefiníció megtekintését a betekintő definíció funkcióval. Ez a szakasz létrehoz egy második tárolt eljárást, és betekintődefinícióval látja, hogy milyen oszlopok találhatók a táblában a tárolt eljárás törzsének gyors létrehozásához.

1. Nyisson meg egy új szerkesztőt a Ctrl+N billentyűkombináció lenyomásával.

2. Írja be az sql-t a szerkesztőbe, nyíllal lépjen az sqlCreateStoredProcedure lapra, és nyomja le a Tab billentyűt (vagy az Entert) a tárolt eljárás kódrészletének betöltéséhez.

3. Írja be a setCustomer for StoredProcedureName és a dbo for SchemaName értékét

4. Cserélje le a @param helyőrzőket a következő paraméterdefinícióra:

   @json_val nvarchar(max)
   

5. Cserélje le a tárolt eljárás törzsét a következő kódra:

   INSERT INTO dbo.Customers
   

6. Az imént hozzáadott INSERT sorban kattintson a jobb gombbal a dbo elemre. Ügyfelek, és válassza a Betekintő definíció lehetőséget.

   

7. Megjelenik a tábladefiníció, így gyorsan láthatja, hogy mely oszlopok találhatók a táblában. A tárolt eljáráshoz tartozó utasítások egyszerű kitöltéséhez tekintse meg az oszloplistát. Fejezze be a korábban hozzáadott INSERT utasítás létrehozását a tárolt eljárás törzsének befejezéséhez, és zárja be a betekintő definíciós ablakot:

   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. Törölje (vagy fűzzön megjegyzést) az EXECUTE parancshoz a lekérdezés alján.

9. A teljes utasításnak a következő kódhoz hasonlóan kell kinéznie:

   -- 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. A setCustomer tárolt eljárás létrehozásához nyomja le az F5 billentyűt.

Lekérdezési eredmények mentése JSON-ként a setCustomer tárolt eljárásának teszteléséhez

Az előző szakaszban létrehozott setCustomer tárolt eljáráshoz JSON-adatokat kell átadni a @json_val paraméternek. Ez a szakasz bemutatja, hogyan lehet megfelelően formázott JSON-bitet beolvasni a paraméterbe, hogy tesztelhesse a tárolt eljárást.

1. A SERVERS oldalsávon kattintson a jobb gombbal a dbo-ra. Ügyfelek tábla, és kattintson a SELECT TOP 1000 Sorok elemre.

2. Jelölje ki az első sort az eredmények nézetben, győződjön meg arról, hogy a teljes sor ki van jelölve (kattintson a bal oldali oszlopban az 1. számra), és válassza a Mentés JSON-ként lehetőséget.

3. Módosítsa a mappát olyan helyre, ahová emlékezni fog, így később törölheti a fájlt (például asztali gépen), és kattintson a Mentés gombra. Megnyílik a JSON formátumú fájl.

   

4. Jelölje ki a JSON-adatokat a szerkesztőben, és másolja ki.

5. Nyisson meg egy új szerkesztőt a Ctrl+N billentyűkombináció lenyomásával.

6. Az előző lépések azt mutatják be, hogyan lehet könnyen lekérni a megfelelően formázott adatokat a setCustomer eljárás hívásának befejezéséhez. Az alábbi kód ugyanazt a JSON-formátumot használja az új ügyféladatokkal, hogy tesztelhessük a setCustomer eljárást. Az utasítás szintaxist tartalmaz a paraméter deklarálásához és az új lekérési és beállítási eljárások futtatásához. Beillesztheti a másolt adatokat az előző szakaszból, és szerkesztheti úgy, hogy az megegyezzen az alábbi példával, vagy egyszerűen illessze be a következő utasítást a lekérdezésszerkesztőbe.

   -- 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. Hajtsa végre a szkriptet az F5 billentyű lenyomásával. A szkript beszúr egy új ügyfelet, és JSON formátumban adja vissza az új ügyfél adatait. Az eredményre kattintva megnyithat egy formázott nézetet.

   

Következő lépések

Ez az oktatóanyag bemutatta, hogyan végezheti el az alábbi műveleteket:

Az öt leglassabb lekérdezési widget engedélyezéséhez végezze el a következő oktatóanyagot: