Tutorial: Menggunakan editor Transact-SQL untuk membuat objek database - Azure Data Studio

Artikel
10/18/2023

Membuat dan menjalankan kueri, prosedur tersimpan, skrip, dll. adalah tugas inti profesional database. Tutorial ini menunjukkan fitur utama di editor T-SQL untuk membuat objek database.

Dalam tutorial ini, Anda mempelajari cara menggunakan Azure Data Studio untuk:

Mencari objek database
Mengedit data tabel
Gunakan cuplikan untuk menulis T-SQL dengan cepat
Menampilkan detail objek database menggunakan Definisi Intip dan Buka Definisi

Prasyarat

Tutorial ini memerlukan SQL Server atau TutorialDB Azure SQL Database. Untuk membuat database TutorialDB , selesaikan salah satu mulai cepat berikut:

Menemukan objek database dengan cepat dan melakukan tugas umum

Azure Data Studio menyediakan widget pencarian untuk menemukan objek database dengan cepat. Daftar hasil menyediakan menu konteks untuk tugas umum yang relevan dengan objek yang dipilih, seperti Edit Data untuk tabel.

Buka bilah sisi SERVERS (Ctrl+G), perluas Database, dan pilih TutorialDB.
Buka Dasbor TutorialDB dengan mengklik kanan TutorialDB dan pilih Kelola dari menu konteks:
Di dasbor, klik kanan dbo. Pelanggan (di widget pencarian) dan pilih Edit Data.

Tip

Untuk database dengan banyak objek, gunakan widget pencarian untuk menemukan tabel, tampilan, dll. yang Anda cari dengan cepat.
Edit kolom Email di baris pertama, ketik orlando0@adventure-works.com, dan tekan Enter untuk menyimpan perubahan.

Gunakan cuplikan T-SQL untuk membuat prosedur tersimpan

Azure Data Studio menyediakan banyak cuplikan T-SQL bawaan untuk membuat pernyataan dengan cepat.

Buka editor kueri baru dengan menekan Ctrl+N.
Ketik sql di editor, panah ke bawah ke sqlCreateStoredProcedure, dan tekan tombol Tab (atau Enter) untuk memuat cuplikan buat prosedur tersimpan.
Cuplikan buat prosedur tersimpan memiliki dua bidang yang disiapkan untuk pengeditan cepat, StoredProcedureName dan SchemaName. Pilih StoredProcedureName, klik kanan, dan pilih Ubah Semua Kemunculan. Sekarang ketik getCustomer dan semua entri StoredProcedureName berubah menjadi getCustomer.
Ubah semua kemunculan SchemaName menjadi dbo.

Cuplikan berisi parameter tempat penampung dan teks isi yang perlu diperbarui. Pernyataan EXECUTE juga berisi teks tempat penampung karena tidak tahu berapa banyak parameter yang akan dimiliki prosedur. Untuk tutorial ini, perbarui cuplikan sehingga terlihat seperti kode berikut:

-- 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

Untuk membuat prosedur tersimpan dan memberinya uji coba, tekan F5.

Prosedur tersimpan sekarang dibuat, dan panel HASIL menampilkan pelanggan yang dikembalikan di JSON. Untuk melihat JSON yang diformat, klik rekaman yang dikembalikan.

Gunakan Definisi Intip

Azure Data Studio menyediakan kemampuan untuk melihat definisi objek menggunakan fitur definisi intip. Bagian ini membuat prosedur tersimpan kedua dan menggunakan definisi intip untuk melihat kolom apa yang ada dalam tabel untuk membuat isi prosedur tersimpan dengan cepat.

Buka editor baru dengan menekan Ctrl+N.
Ketik sql di editor, panah ke bawah ke sqlCreateStoredProcedure, dan tekan tombol Tab (atau Enter) untuk memuat cuplikan buat prosedur tersimpan.
Ketik setCustomer untuk StoredProcedureName dan dbo untuk SchemaName
@param Ganti tempat penampung dengan definisi parameter berikut:
```
@json_val nvarchar(max)
```
Ganti isi prosedur tersimpan dengan kode berikut:
```
INSERT INTO dbo.Customers
```
Di baris INSERT yang baru saja Anda tambahkan, klik kanan dbo. Pelanggan dan pilih Intip Definisi.
Definisi tabel muncul sehingga Anda dapat dengan cepat melihat kolom apa yang ada dalam tabel. Lihat daftar kolom untuk menyelesaikan pernyataan dengan mudah untuk prosedur tersimpan Anda. Selesaikan pembuatan pernyataan INSERT yang Anda tambahkan sebelumnya untuk menyelesaikan isi prosedur tersimpan, dan tutup jendela definisi intip:
```
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)
 )
```
Hapus (atau komentari) perintah JALANKAN di bagian bawah kueri.

Seluruh pernyataan akan terlihat seperti kode berikut:

-- 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

Untuk membuat prosedur tersimpan setCustomer , tekan F5.

Gunakan simpan hasil kueri sebagai JSON untuk menguji prosedur tersimpan setCustomer

Prosedur tersimpan setCustomer yang dibuat di bagian sebelumnya mengharuskan data JSON diteruskan ke parameter @json_val . Bagian ini menunjukkan cara mendapatkan bit JSON yang diformat dengan benar untuk diteruskan ke parameter sehingga Anda dapat menguji prosedur tersimpan.

Di bilah sisi SERVER, klik kanan dbo. Tabel pelanggan dan klik PILIH 1000 Baris TERATAS.
Pilih baris pertama dalam tampilan hasil, pastikan seluruh baris dipilih (klik angka 1 di kolom paling kiri), dan pilih Simpan sebagai JSON.
Ubah folder ke lokasi yang akan Anda ingat sehingga Anda dapat menghapus file nanti (misalnya desktop) dan klik Simpan. File berformat JSON terbuka.
Pilih data JSON di editor dan salin.
Buka editor baru dengan menekan Ctrl+N.
Langkah-langkah sebelumnya menunjukkan bagaimana Anda bisa dengan mudah mendapatkan data yang diformat dengan benar untuk menyelesaikan panggilan ke prosedur setCustomer . Anda dapat melihat kode berikut menggunakan format JSON yang sama dengan detail pelanggan baru sehingga kami dapat menguji prosedur setCustomer . Pernyataan ini mencakup sintaksis untuk mendeklarasikan parameter dan menjalankan prosedur get dan set baru. Anda dapat menempelkan data yang disalin dari bagian sebelumnya dan mengeditnya sehingga sama dengan contoh berikut, atau cukup tempelkan pernyataan berikut ke editor kueri.
```
-- 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
```
Jalankan skrip dengan menekan F5. Skrip menyisipkan pelanggan baru dan mengembalikan informasi pelanggan baru dalam format JSON. Klik hasil untuk membuka tampilan berformat.

Langkah berikutnya

Dalam tutorial ini, Anda mempelajari cara:

Objek skema pencarian cepat
Mengedit data tabel
Menulis skrip T-SQL menggunakan cuplikan
Pelajari tentang detail objek database menggunakan Definisi Intip dan Buka Definisi

Untuk mempelajari cara mengaktifkan lima widget kueri paling lambat, selesaikan tutorial berikutnya:

Mengaktifkan widget wawasan sampel kueri lambat

Share via