Aracılığıyla paylaş


BASKI (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ı

İstemciye kullanıcı tanımlı bir ileti döndürür. Örneğin, SQL Server Management Studio'da, PRINT sorgu sonuçları penceresinin İletiler sekmesine çıkışlar.

Transact-SQL söz dizimi kuralları

Syntax

PRINT msg_str | @local_variable | string_expr

Arguments

msg_str

Karakter dizesi veya Unicode dize sabiti. Daha fazla bilgi için bkz. Sabitler.

@local_variable

Herhangi bir geçerli karakter veri türünün değişkeni. @local_variablechar, nchar, varchar veya nvarchar olmalıdır veya örtük olarak bu veri türlerine dönüştürülebilmelidir.

string_expr

Dize döndüren ifade. Birleştirilmiş değişmez değerleri, işlevleri ve değişkenleri içerebilir. Daha fazla bilgi için bkz. İfadeler.

Remarks

İleti dizesi Unicode olmayan bir dizeyse en çok 8.000 karakter uzunluğunda ve Unicode dizeyse 4.000 karakter uzunluğunda olabilir. Daha uzun dizeler kısaltılır. Varchar(max) ve nvarchar(max) veri türleri, varchar(8000) ve nvarchar(4000) değerinden büyük olmayan veri türlerine kesilir.

RAISERROR , iletileri döndürmek için de kullanılabilir. RAISERROR şu avantajlara PRINTsahiptir:

  • RAISERROR , C dili standart kitaplığının printf işlevinde modellenen bir mekanizma kullanarak bağımsız değişkenleri bir hata iletisi dizesine dönüştürmeyi destekler.

  • RAISERROR metin iletisine ek olarak benzersiz bir hata numarası, önem derecesi ve durum kodu belirtebilir.

  • RAISERROR sp_addmessage (Transact-SQL) sistem saklı yordamı kullanılarak oluşturulan kullanıcı tanımlı iletileri döndürmek için kullanılabilir.

Examples

A. Yazdırmayı koşullu olarak yürütme (VARSA)

Aşağıdaki örnek, koşullu olarak bir ileti döndürmek için deyimini PRINT kullanır.

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. Dize oluşturma ve görüntüleme

Aşağıdaki örnek , GETDATE işlevinin sonuçlarını nvarchar veri türüne dönüştürür ve tarafından PRINTdöndürülen değişmez metinle birleştirir.

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

Aşağıdaki örnekte, ileti metninin bir değişkende oluşturulması gösterilmektedir.

DECLARE @PrintMessage NVARCHAR(50);
SET @PrintMessage = N'This message was printed on ' + RTRIM(CAST(GETDATE() AS NVARCHAR(30))) + N'.';
PRINT @PrintMessage;
GO

Örnekler: Azure Synapse Analytics ve Analytics Platform Sistemi (PDW)

C. Yazdırmayı koşullu olarak yürütme

Aşağıdaki örnek, koşullu olarak bir ileti döndürmek için deyimini PRINT kullanır.

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