Konvensi sintaks Transact-SQL (Transact-SQL)
Berlaku untuk: Titik akhir analitik SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Platform System (PDW) SQL di Microsoft Fabric Warehouse di Microsoft Fabric
Tabel berikut ini mencantumkan dan menjelaskan konvensi yang digunakan dalam diagram sintaks dalam referensi Transact-SQL.
Konvensi | Digunakan untuk |
---|---|
HURUF BESAR atau UPPERCASE |
Kata kunci T-SQL. |
Miring | Parameter sintaks Transact-SQL yang disediakan pengguna. |
berani | Ketik nama database, nama tabel, nama kolom, nama indeks, prosedur tersimpan, utilitas, nama jenis data, dan teks persis seperti yang ditunjukkan. |
| (bilah vertikal) |
Memisahkan item sintaks yang diapit dalam tanda kurung atau kurung kurawal. Anda hanya dapat menggunakan salah satu item. |
[ ] (Tanda kurung) |
Item sintaks opsional. |
{ } (Kurung kurawal) |
Item sintaks yang diperlukan. Jangan ketik kurung kurawalnya. |
[ , ...n ] |
Menunjukkan item sebelumnya dapat diulang n berapa kali. Kejadian dipisahkan oleh koma. |
[ ...n ] |
Menunjukkan item sebelumnya dapat diulang n berapa kali. Kemunculan dipisahkan oleh kosong. |
; |
Terminator pernyataan Transact-SQL. Meskipun titik koma tidak diperlukan untuk sebagian besar pernyataan dalam versi SQL Server ini, titik koma akan diperlukan dalam versi mendatang. |
<label> ::= |
Nama untuk blok sintaksis. Gunakan konvensi ini untuk mengelompokkan dan melabeli bagian sintaksis panjang atau satuan sintaks yang dapat Anda gunakan di lebih dari satu lokasi dalam pernyataan. Setiap lokasi di mana blok sintaksis dapat digunakan, ditunjukkan dengan label yang diapit dalam chevron: <label>. Set adalah kumpulan ekspresi, misalnya <kumpulan> pengelompokan; dan daftar adalah kumpulan set, misalnya <daftar> elemen komposit. |
Nama multipihak
Kecuali ditentukan sebaliknya, semua referensi Transact-SQL ke nama objek database dapat menjadi nama empat bagian dalam formulir berikut:
<server_name>.[<database_name>].[<schema_name>].<object_name>
| <database_name>.[<schema_name>].<object_name>
| <schema_name>.<object_name>
| <object_name>
server_name
Menentukan nama server tertaut atau nama server jarak jauh.
database_name
Menentukan nama database SQL Server saat objek berada dalam instans lokal SQL Server. Saat objek berada di server tertaut, database_name menentukan katalog OLE DB.
schema_name
Menentukan nama skema yang berisi objek jika objek berada dalam database SQL Server. Saat objek berada di server tertaut, schema_name menentukan nama skema OLE DB.
object_name
Mengacu pada nama objek.
Saat mereferensikan objek tertentu, Anda tidak selalu harus menentukan server, database, dan skema untuk Mesin Database SQL Server untuk mengidentifikasi objek. Namun, jika objek tidak dapat ditemukan, kesalahan akan dikembalikan.
Untuk menghindari kesalahan resolusi nama, sebaiknya tentukan nama skema setiap kali Anda menentukan objek dengan cakupan skema.
Untuk menghilangkan simpul perantara, gunakan titik untuk menunjukkan posisi ini. Tabel berikut ini memperlihatkan format nama objek yang valid.
Format referensi objek | Deskripsi |
---|---|
<server_name>.<database_name>.<schema_name>.<object_name> |
Nama empat bagian. |
<server_name>.<database_name>..<object_name> |
Nama skema dihilangkan. |
<server_name>..<schema_name>.<object_name> |
Nama database dihilangkan. |
<server_name>...<object_name> |
Database dan nama skema dihilangkan. |
<database_name>.<schema_name>.<object_name> |
Nama server dihilangkan. |
<database_name>..<object_name> |
Nama server dan skema dihilangkan. |
<schema_name>.<object_name> |
Nama server dan database dihilangkan. |
<object_name> |
Nama server, database, dan skema dihilangkan. |
Jenis data
Saat digunakan sebaris dalam artikel, jenis data dirender dalam huruf kecil dan tebal. Misalnya, int, varchar(255), dan bit.
Saat digunakan dalam blok kode Transact-SQL, jenis data dirender dalam huruf besar. Contohnya:
DECLARE @int_example AS INT;
DECLARE @varchar_example AS VARCHAR(255);
DECLARE @bit_example AS BIT;
Contoh kode konvensi
Kecuali dinyatakan sebaliknya, contoh yang disediakan dalam referensi Transact-SQL diuji dengan menggunakan SQL Server Management Studio dan pengaturan defaultnya untuk opsi berikut:
ANSI_NULLS
ANSI_NULL_DFLT_ON
ANSI_PADDING
ANSI_WARNINGS
CONCAT_NULL_YIELDS_NULL
QUOTED_IDENTIFIER
Sebagian besar contoh kode dalam referensi Transact-SQL diuji pada server yang menjalankan urutan pengurutan peka huruf besar/kecil. Server pengujian biasanya menjalankan halaman kode ANSI/ISO 1252.
Banyak contoh kode awalan konstanta string karakter Unicode dengan huruf N
. Tanpa awalan N
, string dikonversi ke halaman kode default database. Halaman kode default ini mungkin tidak mengenali karakter tertentu.
Referensi "Berlaku untuk"
Artikel referensi Transact-SQL mencakup beberapa versi SQL Server, dimulai dengan SQL Server 2008 (10.0.x), serta Azure SQL Database, Azure SQL Managed Instance, Azure Synapse Analytics, dan Analytics Platform System (PDW).
Bagian di dekat bagian atas setiap artikel menunjukkan produk mana yang mendukung subjek artikel. Jika produk dihilangkan, maka fitur yang dijelaskan oleh artikel tidak tersedia dalam produk tersebut.
Subjek umum artikel mungkin digunakan dalam produk, tetapi semua argumen tidak didukung dalam beberapa kasus. Misalnya, pengguna database mandiri diperkenalkan di SQL Server 2012 (11.x). CREATE USER
Gunakan pernyataan dalam produk SQL Server apa pun; namun WITH PASSWORD
sintaks tidak dapat digunakan dengan versi yang lebih lama. Berlaku Ekstra untuk bagian disisipkan ke dalam deskripsi argumen yang sesuai dalam isi artikel.