Bagikan melalui

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. Misalnya, di SQL Server Management Studio, PRINT output ke tab Pesan dari jendela hasil kueri.

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

String karakter atau konstanta string Unicode. Liihat Konstanta untuk informasi selengkapnya.

@local_variable

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

Ekspresi yang mengembalikan string. Dapat mencakup nilai literal yang digabungkan, fungsi, dan variabel. Untuk informasi selengkapnya, lihat Ekspresi.

Keterangan

String pesan dapat memiliki panjang hingga 8.000 karakter jika string non-Unicode, dan panjangnya 4.000 karakter jika 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 dibandingkan 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 (Transact-SQL ).

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. Membuat dan menampilkan string

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

PRINT N'This message was printed on ' + RTRIM(CAST(GETDATE() AS NVARCHAR(30))) + N'.';
GO

Contoh berikut menunjukkan pembuatan teks pesan dalam variabel.

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 secara kondisional

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

Konten terkait