PRINT (SQL Bertransaksi)

Berlaku untuk: SQL Server (semua versi yang didukung) Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Mengembalikan pesan yang ditentukan pengguna ke klien.

Konvensi Sintaksis T-SQL

Sintaks

PRINT msg_str | @local_variable | string_expr  

Catatan

Untuk melihat sintaks transact-SQL untuk SQL Server 2014 dan yang lebih lama, lihat Dokumentasi versi sebelumnya.

Argumen

msg_str
Adalah string karakter atau konstanta string Unicode. Untuk informasi selengkapnya, lihat Konstanta (Transact-SQL).

@local_variable
Adalah variabel dari jenis data karakter yang valid. @local_variable harus char, nchar, varchar, atau nvarchar, atau harus dapat dikonversi secara implisit ke jenis data tersebut.

string_expr
Adalah ekspresi yang mengembalikan string. Dapat mencakup nilai literal, fungsi, dan variabel yang digabungkan. Untuk informasi selengkapnya, lihat Ekspresi (transact-SQL).

Keterangan

String pesan dapat memiliki panjang hingga 8.000 karakter jika merupakan string non-Unicode, dan panjangnya 4.000 karakter jika merupakan string Unicode. Untai (karakter) yang lebih panjang dipotok. Jenis data varchar(max) dan nvarchar(max) dipotong menjadi jenis data yang tidak lebih besar dari varchar(8000) dan nvarchar(4000).

RAISERROR juga dapat digunakan untuk mengembalikan pesan. RAISERROR memiliki keunggulan ini dibandingkan PRINT:

• RAISERROR mendukung penggantian argumen ke dalam string pesan kesalahan menggunakan mekanisme yang dimodelkan pada fungsi printf pustaka standar bahasa C.

• RAISERROR dapat menentukan nomor kesalahan unik, tingkat keparahan, dan kode status selain pesan teks.

• RAISERROR dapat digunakan untuk mengembalikan pesan yang ditentukan pengguna yang dibuat menggunakan prosedur tersimpan sistem sp_addmessage.

Contoh

A. Cetak yang dijalankan secara kondisional (IF EXISTS)

Contoh berikut menggunakan PRINT pernyataan untuk mengembalikan pesan secara kondisional.

IF @@OPTIONS & 512 <> 0  
    PRINT N'This user has SET NOCOUNT turned ON.';  
ELSE  
    PRINT N'This user has SET NOCOUNT turned OFF.';  
GO  

B. Membangun dan menampilkan string

Contoh berikut mengonversi hasil GETDATE fungsi menjadi nvarchar jenis data dan menggabungkannya dengan teks harfiah untuk dikembalikan oleh PRINT.

-- Build the message text by concatenating  
-- strings and expressions.  
PRINT N'This message was printed on '  
    + RTRIM(CAST(GETDATE() AS NVARCHAR(30)))  
    + N'.';  
GO  
-- This example shows building the message text  
-- in a variable and then passing it to PRINT.  
-- This was required in SQL Server 7.0 or earlier.  
DECLARE @PrintMessage NVARCHAR(50);  
SET @PrintMessage = N'This message was printed on '  
    + RTRIM(CAST(GETDATE() AS NVARCHAR(30)))  
    + N'.';  
PRINT @PrintMessage;  
GO  

Contoh: Azure Synapse Analytics and Analytics Platform System (PDW)

C. Cetak eksekusi bersyarat

Contoh berikut menggunakan PRINT pernyataan untuk mengembalikan pesan secara kondisional.

IF DB_ID() = 1  
    PRINT N'The current database is master.';  
ELSE  
    PRINT N'The current database is not master.';  
GO  

Lihat juga

Tipe Data (Transact-SQL)
DECLARE @local_variable (Transact-SQL)
RAISERROR (SQL Bertransaksi)