Megosztás a következőn keresztül:

NYOMTATÁS (Transact-SQL)

A következőkre vonatkozik:SQL ServerAzure SQL DatabaseFelügyelt Azure SQL-példányAzure Synapse AnalyticsElemzési platformrendszer (PDW)SQL Analytics-végpont a Microsoft FabricbenRaktár a Microsoft FabricbenSQL-adatbázis a Microsoft Fabricben

Felhasználó által megadott üzenetet ad vissza az ügyfélnek. Az SQL Server Management Studióban PRINT például a lekérdezési eredmények ablak Üzenetek lapjára adhatja ki a kimeneteket.

Transact-SQL szintaxis konvenciók

Syntax

PRINT msg_str | @local_variable | string_expr

Arguments

msg_str

Karaktersztring vagy Unicode-sztringállandó. További információért lásd: Állandók.

@local_variable

Bármely érvényes karakter adattípusú változó. @local_variablekarakternek, ncharnak, varcharnak vagy nvarcharnak kell lennie, vagy implicit módon konvertálhatónak kell lennie ezekre az adattípusokra.

string_expr

Sztringet visszaadó kifejezés. Tartalmazhat összefűzött literális értékeket, függvényeket és változókat. További információ: Kifejezések.

Remarks

Az üzenetsztring legfeljebb 8000 karakter hosszú lehet, ha nem Unicode-sztring, és 4000 karakter hosszú, ha Unicode-sztring. Hosszabb sztringek csonkolódnak. A varchar(max) és nvarchar(max) adattípusok a varchar(8000) és az nvarchar(4000) értéknél nem nagyobb adattípusokra csonkulnak.

A RAISERROR az üzenetek visszaküldésére is használható. RAISERROR a következő előnyökkel rendelkezik PRINT:

  • RAISERROR Támogatja az argumentumok hibaüzenet-sztringbe való helyettesítését a C nyelvi standard kódtár printf függvényére modellezett mechanizmussal.

  • RAISERROR a szöveges üzenet mellett egyedi hibaszámot, súlyosságot és állapotkódot is megadhat.

  • RAISERROR a sp_addmessage (Transact-SQL) rendszer által tárolt eljárással létrehozott, felhasználó által definiált üzenetek visszaadására használható.

Examples

A. Nyomtatás feltételes végrehajtása (HA LÉTEZIK)

Az alábbi példa egy üzenet feltételes visszaadására használja az PRINT utasítást.

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. Sztring létrehozása és megjelenítése

Az alábbi példa a GETDATE függvény eredményeit nvarchar adattípussá alakítja, és konstans szöveggel fűzi össze, amelyet a függvény visszaad PRINT.

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

Az alábbi példa az üzenet szövegének változóban való felépítését mutatja be.

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

Példák: Azure Synapse Analytics and Analytics Platform System (PDW)

C. Nyomtatás feltételes végrehajtása

Az alábbi példa egy üzenet feltételes visszaadására használja az PRINT utasítást.

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

Kapcsolódó tartalom

  • Last updated on