PRINT (Transact-SQL)

  • Artikel

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)Titik akhir analitik SQL di Microsoft FabricWarehouse di Microsoft Fabric

Mengembalikan pesan yang ditentukan pengguna ke klien.

Konvensi sintaks transact-SQL

Sintaksis

PRINT msg_str | @local_variable | string_expr

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi 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 berupa 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 yang digabungkan, fungsi, dan variabel. Untuk informasi selengkapnya, lihat Ekspresi (Transact-SQL).

Keterangan

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

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

  • RAISERROR mendukung penggantian argumen ke dalam string pesan kesalahan menggunakan mekanisme yang dimodelkan pada fungsi cetak 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

J. Cetak yang dijalankan secara kondisional (JIKA ADA)

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 (Transact-SQL)