Sdílet prostřednictvím

TISK (Transact-SQL)

Platí pro:SQL ServerAzure SQL DatabaseSpravovaná instance Azure SQLAzure Synapse AnalyticsAnalytics Platform System (PDW)Koncový bod analýzy SQL v Microsoft FabricSklad v Microsoft FabricDatabáze SQL v Microsoft Fabric

Vrátí uživateli definovanou zprávu klientovi. Například v aplikaci SQL Server Management Studio se PRINT výstupy zobrazí na kartě Zprávy v okně výsledků dotazu.

Transact-SQL konvence syntaxe

Syntax

PRINT msg_str | @local_variable | string_expr

Arguments

msg_str

Řetězec znaků nebo řetězcová konstanta Unicode. Další informace naleznete v tématu Konstanty.

@local_variable

Proměnná libovolného platného datového typu znaku. @local_variable musí být znak, nchar, varchar nebo nvarchar nebo musí být možné implicitně převést na tyto datové typy.

string_expr

Výraz, který vrací řetězec. Může obsahovat zřetězené hodnoty literálů, funkce a proměnné. Další informace naleznete v tématu Výrazy.

Remarks

Řetězec zprávy může mít délku až 8 000 znaků, pokud se jedná o řetězec, který není unicode, a 4 000 znaků dlouhý, pokud se jedná o řetězec Unicode. Delší řetězce jsou zkráceny. Datové typy varchar(max) a nvarchar(max) jsou zkráceny na datové typy, které nejsou větší než varchar(8000) a nvarchar(4000).

Funkce RAISERROR se dá použít také k vrácení zpráv. RAISERRORmá tyto výhody:PRINT

  • RAISERROR podporuje nahrazení argumentů do řetězce chybové zprávy pomocí mechanismu modelovaného ve funkci printf standardní knihovny jazyka C.

  • RAISERROR může kromě textové zprávy zadat jedinečné číslo chyby, závažnost a stavový kód.

  • RAISERRORlze použít k vrácení uživatelem definovaných zpráv vytvořených pomocí systémové uložené procedury sp_addmessage (Transact-SQL).

Examples

A. Podmíněné spouštění tisku (IF EXISTS)

Následující příklad používá příkaz PRINT k podmíněnému vrácení zprávy.

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. Sestavení a zobrazení řetězce

Následující příklad převede výsledky funkce GETDATE na datový typ nvarchar a zřetězí ho s literálovým textem PRINT, který je vrácen .

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

Následující příklad ukazuje vytvoření textu zprávy v proměnné.

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

Příklady: Azure Synapse Analytics a Analytický platformový systém (PDW)

C. Podmíněně spustit tisk

Následující příklad používá příkaz PRINT k podmíněnému vrácení zprávy.

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

Související obsah

  • Last updated on