Öğretici: Transact-SQL düzenleyicisini kullanarak veritabanı nesneleri oluşturma - Azure Data Studio

Önemli

Azure Data Studio 28 Şubat 2026 tarihindekullanımdan kaldırılıyor. Visual Studio Code için MSSQL uzantısını kullanmanızı öneririz. Visual Studio Code'a geçiş hakkında daha fazla bilgi için Azure Data Studio'ya neler oluyor? adresini ziyaret edin.

Sorgu oluşturma ve çalıştırma, saklı yordamlar, betikler vb. veritabanı uzmanlarının temel görevleridir. Bu öğretici, veritabanı nesneleri oluşturmak için T-SQL düzenleyicisindeki temel özellikleri gösterir.

Bu öğreticide, Azure Data Studio'yu kullanarak şunları yapmayı öğreneceksiniz:

• Veritabanı nesnelerini arama
• Tablo verilerini düzenleme
• T-SQL'i hızla yazmak için kod parçacıkları kullanma
• Veritabanı nesnesi ayrıntılarını görüntülemek için Tanımına Göz At ve Tanımına Git özelliklerini kullanın.

Önkoşullar

Bu öğretici SQL Server veya Azure SQL Veritabanı TutorialDB'ni gerektirir. TutorialDB veritabanını oluşturmak için aşağıdaki hızlı başlangıçlardan birini tamamlayın:

• Azure Data Studio kullanarak SQL Server'a bağlanma ve sorgulama
• Azure Data Studio kullanarak Azure SQL Veritabanı bağlanma ve sorgulama

Bir veritabanı nesnesini hızla bulma ve ortak bir görev gerçekleştirme

Azure Data Studio, veritabanı nesnelerini hızla bulmak için bir arama pencere öğesi sağlar. Sonuçlar listesi, seçili nesneyle ilgili ortak görevler için tablo için Verileri Düzenle gibi bir bağlam menüsü sağlar.

1. SUNUCULAR kenar çubuğunu (Ctrl+G) açın, Veritabanları'nı genişletin ve TutorialDB'yi seçin.

2. TutorialDB'ye sağ tıklayıp bağlam menüsünden Yönet'i seçerek TutorialDB Panosu'nu açın:

   

3. Gösterge Tablosunda, dbo.Customers'a sağ tıklayın (arama pencere öğesinde) ve Verileri Düzenle'yi seçin.

   İpucu

   Çok sayıda nesnesi olan veritabanlarında, aradığınız tabloyu, görünümü vb. hızla bulmak için arama pencere öğesini kullanın.

   

4. İlk satırdaki E-posta sütununu düzenleyin, yazın orlando0@adventure-works.comve değişikliği kaydetmek için Enter tuşuna basın.

   

Saklı yordamlar oluşturmak için T-SQL kod parçacıkları kullanma

Azure Data Studio, deyimleri hızla oluşturmak için birçok yerleşik T-SQL kod parçacığı sağlar.

1. Ctrl+N tuşlarına basarak yeni bir sorgu düzenleyicisi açın.

2. Düzenleyicide sql yazın, sqlCreateStoredProcedure üzerine gitmek için aşağı ok tuşuna basın ve saklı yordam oluşturma kodunu yüklemek için Tab tuşuna (veya Enter tuşuna) basın.

   

3. Saklı yordam oluşturma kod parçacığında, hızlı düzenleme için ayarlanmış iki alan vardır: StoredProcedureName ve SchemaName. StoredProcedureName öğesini seçin, sağ tıklayın ve Tüm Oluşumları Değiştir'i seçin. Şimdi getCustomer yazın ve tüm StoredProcedureName girişleri getCustomer olarak değişir.

   

4. "SchemaName" ifadesinin tüm oluşumlarını "dbo" olarak değiştirin.

5. Kod parçacığı, güncelleştirilmesi gereken yer tutucu parametreler ve gövde metni içerir. EXECUTE ifadesi ayrıca, prosedürün kaç parametreye sahip olacağını bilmediğinden yer tutucu metin içerir. Bu öğretici için kod parçacığını aşağıdaki kod gibi görünecek şekilde güncelleştirin:

   -- 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. Saklı yordamı oluşturmak ve bir test çalıştırması yapmak için F5 tuşuna basın.

Saklı yordam şimdi oluşturuldu ve SONUÇLAR bölmesi müşteriyi JSON formatında döndürüyor. Biçimlendirilmiş JSON'ı görmek için döndürülen kayda tıklayın.

Göz Atma Tanımı Kullan

Azure Data Studio, göz atma tanımı özelliğini kullanarak bir nesne tanımını görüntüleme olanağı sağlar. Bu bölüm, ikinci bir saklı yordam oluşturur ve saklı yordamın gövdesini hızla oluşturmak için tabloda hangi sütunların olduğunu görmek amacıyla "peek definition" işlevini kullanır.

1. Ctrl+N tuşlarına basarak yeni bir düzenleyici açın.

2. Düzenleyicide sql yazın, sqlCreateStoredProcedure üzerine gitmek için aşağı ok tuşuna basın ve saklı yordam oluşturma kodunu yüklemek için Tab tuşuna (veya Enter tuşuna) basın.

3. StoredProcedureName için setCustomer ve SchemaName için dbo yazın

4. @param Yer tutucuları aşağıdaki parametre tanımıyla değiştirin:

   @json_val nvarchar(max)
   

5. Saklı yordamın gövdesini aşağıdaki kodla değiştirin:

   INSERT INTO dbo.Customers
   

6. Yeni eklediğiniz INSERT satırında dbo.Customers üzerine sağ tıklayın ve Tanımına Göz At'ı seçin.

   

7. Tabloda hangi sütunların olduğunu hızla görebilmeniz için tablo tanımı görüntülenir. Saklı yordamınızın ifadelerini kolayca tamamlayabilmek için sütun listesine bakın. Saklı yordamın gövdesini tamamlamak için daha önce eklediğiniz INSERT deyimini tamamlayın ve tanım önizleme penceresini kapatın.

   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. Sorgunun en altındaki EXECUTE komutunu silin (veya açıklama satırı ekleyin).

9. Deyimin tamamı aşağıdaki kod gibi görünmelidir:

   -- 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. setCustomer saklı yordamını oluşturmak için F5 tuşuna basın.

SetCustomer saklı yordamını test etmek için sorgu sonuçlarını JSON olarak kaydetmeyi kullanın

Önceki bölümde oluşturulan setCustomer saklı yordamı, JSON verilerinin @json_val parametresine geçirilmesini gerektirir. Bu bölümde, saklı yordamı test edebilmeniz için parametreye geçirilecek şekilde düzgün biçimlendirilmiş bir JSON parçasının nasıl alınabileceği açıklanmaktadır.

1. SUNUCULAR kenar çubuğunda dbo.Customers tablosuna sağ tıklayın ve İLK 1000 Satırı Seç seçeneğine tıklayın.

2. Sonuçlar görünümünde ilk satırı seçin, satırın tamamının seçili olduğundan emin olun (en soldaki sütunda 1 sayısına tıklayın) ve JSON Olarak Kaydet'i seçin.

3. Dosyayı daha sonra silebilmek için klasörü hatırlayacağınız bir konumla değiştirin (örneğin masaüstü) ve Kaydet'e tıklayın. JSON biçimli dosya açılır.

   

4. Düzenleyicide JSON verilerini seçin ve kopyalayın.

5. Ctrl+N tuşlarına basarak yeni bir düzenleyici açın.

6. Önceki adımlarda, setCustomer yordamına yapılan çağrıyı tamamlamak için düzgün biçimlendirilmiş verileri nasıl kolayca alabileceğiniz gösterilmektedir. SetCustomer yordamını test edebilmemiz için aşağıdaki kodun yeni müşteri ayrıntılarıyla aynı JSON biçimini kullandığını görebilirsiniz. Deyim, parametrenin bildirilmesi ve yeni get ve set işlemlerinin çalıştırılması için söz dizimini içerir. Önceki bölümden kopyalanan verileri yapıştırabilir ve aşağıdaki örnekle aynı olacak şekilde düzenleyebilir veya aşağıdaki deyimi sorgu düzenleyicisine yapıştırabilirsiniz.

   -- 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. F5 tuşuna basarak betiği çalıştırın. Betik yeni bir müşteri ekler ve yeni müşterinin bilgilerini JSON biçiminde döndürür. Biçimlendirilmiş bir görünümü açmak için sonuda tıklayın.

   

Sonraki adımlar

Bu öğreticide, şunların nasıl yapıldığını öğrendiniz:

• Hızlı arama şeması nesneleri
• Tablo verilerini düzenleme
• Kod parçacıkları kullanarak T-SQL betiği yazma
• "Peek Definition" ve "Go to Definition" araçlarını kullanarak veritabanı nesnesi ayrıntıları hakkında bilgi edinin.

Sonraki öğreticiyi tamamlayarak en yavaş beş sorgu pencere öğesini etkinleştirmeyi öğrenin.

Yavaş sorguların örnek içgörü pencere öğesini etkinleştir