Aracılığıyla paylaş


Transact-SQL söz dizimi kuralları (Transact-SQL)

Şunlar için geçerlidir:SQL ServerAzure SQL VeritabanıAzure SQL Yönetilen ÖrneğiAzure Synapse AnalyticsAnaliz Platformu Sistemi (PDW)Microsoft Fabric'teki SQL analiz uç noktasıMicrosoft Fabric'teki ambarMicrosoft Fabric'teki SQL veritabanı

Aşağıdaki tabloda, Transact-SQL başvurusundaki söz dizimi diyagramlarında kullanılan kurallar listelenmiştir ve açıklanmaktadır.

Convention Kullanım amacı
BÜYÜK HARF veya UPPERCASE Transact-SQL anahtar kelimeler.
italic Transact-SQL söz diziminin kullanıcı tarafından sağlanan parametreleri.
bold Veritabanı adlarını, tablo adlarını, sütun adlarını, dizin adlarını, saklı yordamları, yardımcı programları, veri türü adlarını ve metni tam olarak gösterildiği gibi yazın.
| (dikey çubuk) Köşeli ayraç veya ayraç içine alınmış söz dizimi öğelerini ayırır. Öğelerden yalnızca birini kullanabilirsiniz.
[ ] (köşeli ayraçlar) İsteğe bağlı söz dizimi öğesi.
{ } (ayraçlar) Gerekli söz dizimi öğeleri. Ayraçları yazma.
[ , ...n ] Önceki öğenin birkaç kez tekrar edilebileceğini gösterir. Oluşumlar virgülle ayrılır.
[ ...n ] Önceki öğenin birkaç kez tekrar edilebileceğini gösterir. Oluşumlar boşluklarla ayrılır.
; Transact-SQL deyimi sonlandırıcısı. SQL Server'ın bu sürümündeki çoğu deyim için noktalı virgül gerekli olmasa da, gelecekteki bir sürümde gerekli olacaktır.
<label> ::= Söz dizimi bloğunun adı. Uzun söz diziminin veya bir deyimin içinde birden fazla konumda kullanabileceğiniz bir söz dizimi biriminin bölümlerini gruplandırmak ve etiketlemek için bu kuralı kullanın. Söz dizimi bloğunun kullanabildiği her konum, köşeli çift ayraç içine alınmış etiketle gösterilir: <etiket>.

Küme, örneğin <gruplandırma kümesi> gibi ifadelerden oluşan bir koleksiyondur ve liste ise bileşik öğe listesi gibi <kümelerden oluşan bir koleksiyondur>.

Çok bölümlü isimler

Aksi belirtilmediği sürece, veritabanı nesnesinin adına yapılan tüm Transact-SQL başvuruları aşağıdaki biçimde dört bölümden oluşan bir ad olabilir:

<server_name>.[<database_name>].[<schema_name>].<object_name>

| <database_name>.[<schema_name>].<object_name>

| <schema_name>.<object_name>

| <object_name>

  • server_name

    Bağlı sunucu adını veya uzak sunucu adını belirtir.

  • database_name

    Nesne, SQL Server'ın yerel bir örneğinde bulunduğunda SQL Server veritabanının adını belirtir. Nesne bağlı bir sunucudayken database_name bir OLE DB kataloğu belirtir.

  • schema_name

    Nesne bir SQL Server veritabanındaysa, nesneyi içeren şemanın adını belirtir. Nesne bağlı bir sunucudayken schema_name bir OLE DB şema adı belirtir.

  • object_name

    Nesnenin adına başvurur.

Belirli bir nesneye başvururken, nesneyi tanımlamak için SQL Server Veritabanı Altyapısı'nın sunucusunu, veritabanını ve şemasını her zaman belirtmeniz gerekmez. Ancak, nesne bulunamazsa bir hata döndürülür.

Ad çözümleme hatalarından kaçınmak için, şema kapsamlı bir nesne belirttiğinizde şema adını belirtmeniz önerilir.

Ara düğümleri atlamak için bu konumları belirtmek için nokta kullanın. Aşağıdaki tabloda nesne adlarının geçerli biçimleri gösterilmektedir.

Nesne başvuru biçimi Description
<server_name>.<database_name>.<schema_name>.<object_name> Dört bölümden oluşan isim.
<server_name>.<database_name>..<object_name> Şema adı atlanır.
<server_name>..<schema_name>.<object_name> Veritabanı adı atlanır.
<server_name>...<object_name> Veritabanı ve şema adı atlanır.
<database_name>.<schema_name>.<object_name> Sunucu adı atlanır.
<database_name>..<object_name> Sunucu ve şema adı atlanır.
<schema_name>.<object_name> Sunucu ve veritabanı adı atlanır.
<object_name> Sunucu, veritabanı ve şema adı atlanır.

Veri türleri

Bir makalede satır içinde kullanıldığında, veri türleri küçük ve kalın olarak işlenir. Örneğin, int, varchar(255)ve bit.

Transact-SQL kod bloklarında kullanıldığında, veri türleri büyük harfle işlenir. Örneğin:

DECLARE @int_example AS INT;
DECLARE @varchar_example AS VARCHAR(255);
DECLARE @bit_example AS BIT;

Kod örneği kuralları

Aksi belirtilmediği sürece, Transact-SQL başvurusunda sağlanan örnekler SQL Server Management Studio ve aşağıdaki seçenekler için varsayılan ayarları kullanılarak test edilmiştir:

  • ANSI_NULLS
  • ANSI_NULL_DFLT_ON
  • ANSI_PADDING
  • ANSI_WARNINGS
  • CONCAT_NULL_YIELDS_NULL
  • QUOTED_IDENTIFIER

Transact-SQL başvurusundaki kod örneklerinin çoğu büyük/küçük harfe duyarlı sıralama düzeni çalıştıran sunucularda test edilmiştir. Test sunucuları genellikle ANSI/ISO 1252 kod sayfasını çalıştırıyordu.

Birçok kod örneği unicode karakter dizesi sabitlerine harfiyle Nön ek ekler. N Ön ek olmadan, dize veritabanının varsayılan kod sayfasına dönüştürülür. Bu varsayılan kod sayfası belirli karakterleri tanımayabilir.

"Şunun için geçerlidir" başvuruları

Transact-SQL başvuru makaleleri, SQL Server 2008 (10.0.x) ile birlikte Azure SQL Veritabanı, Azure SQL Yönetilen Örneği, Azure Synapse Analytics ve Analytics Platform Sistemi (PDW) ile başlayarak SQL Server'ın birden çok sürümünü kapsar.

Her makalenin üst kısmına yakın bir bölüm, makalenin konusunu hangi ürünlerin desteklediğini gösterir. Bir ürün atlanırsa, makale tarafından açıklanan özellik bu üründe kullanılamaz.

Makalenin genel konusu bir üründe kullanılabilir, ancak bazı durumlarda bağımsız değişkenlerin tümü desteklenmez. Örneğin, SQL Server 2012'de (11.x) kapsanan veritabanı kullanıcıları tanıtıldı. Deyimini CREATE USER herhangi bir SQL Server ürününde kullanın; ancak WITH PASSWORD söz dizimi eski sürümlerle kullanılamaz. Ek Bölümler için geçerlidir , makalenin gövdesindeki uygun bağımsız değişken açıklamalarına eklenir.