Skip to content

Commit f345463

Browse files
authored
Merge pull request #33635 from rwestMSFT/rw-0327-fix-405531
Refresh ntext, text, and image article (UUF 405531)
2 parents 568f95c + db72ac6 commit f345463

File tree

1 file changed

+20
-24
lines changed

1 file changed

+20
-24
lines changed

docs/t-sql/data-types/ntext-text-and-image-transact-sql.md

Lines changed: 20 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: "The ntext, text, and image data types are deprecated data types fo
44
author: MikeRayMSFT
55
ms.author: mikeray
66
ms.reviewer: randolphwest
7-
ms.date: 09/22/2022
7+
ms.date: 03/27/2025
88
ms.service: sql
99
ms.subservice: t-sql
1010
ms.topic: "reference"
@@ -19,7 +19,7 @@ helpviewer_keywords:
1919
- "image data type, about image data type"
2020
dev_langs:
2121
- "TSQL"
22-
monikerRange: "=azuresqldb-current || >=sql-server-2016 || >=sql-server-linux-2017 || =azuresqldb-mi-current ||=fabric"
22+
monikerRange: "=azuresqldb-current || >=sql-server-2016 || >=sql-server-linux-2017 || =azuresqldb-mi-current || =fabric"
2323
---
2424
# ntext, text, and image (Transact-SQL)
2525

@@ -28,17 +28,17 @@ monikerRange: "=azuresqldb-current || >=sql-server-2016 || >=sql-server-linux-20
2828
Fixed and variable-length data types for storing large non-Unicode and Unicode character and binary data. Unicode data uses the Unicode UCS-2 character set.
2929

3030
> [!IMPORTANT]
31-
> The **ntext**, **text**, and **image** data types will be removed in a future version of SQL Server. Avoid using these data types in new development work, and plan to modify applications that currently use them. Use [nvarchar(max)](../../t-sql/data-types/nchar-and-nvarchar-transact-sql.md), [varchar(max)](../../t-sql/data-types/char-and-varchar-transact-sql.md), and [varbinary(max)](../../t-sql/data-types/binary-and-varbinary-transact-sql.md) instead.
31+
> The **ntext**, **text**, and **image** data types will be removed in a future version of SQL Server. Avoid using these data types in new development work, and plan to modify applications that currently use them. Use [**nvarchar(max)**](nchar-and-nvarchar-transact-sql.md), [**varchar(max)**](char-and-varchar-transact-sql.md), and [**varbinary(max)**](binary-and-varbinary-transact-sql.md) instead.
3232
3333
## Arguments
3434

3535
#### ntext
3636

37-
Variable-length Unicode data with a maximum string length of 2^30 - 1 (1,073,741,823) bytes. Storage size, in bytes, is two times the string length that is entered. The ISO synonym for **ntext** is **national text**.
37+
Variable-length Unicode data with a maximum string length of 2^30 - 1 (1,073,741,823). Storage size, in bytes, is two times the string length that is entered. The ISO synonym for **ntext** is **national text**.
3838

3939
#### text
4040

41-
Variable-length non-Unicode data in the code page of the server and with a maximum string length of 2^31-1 (2,147,483,647). When the server code page uses double-byte characters, the storage is still 2,147,483,647 bytes. Depending on the character string, the storage size may be less than 2,147,483,647 bytes.
41+
Variable-length non-Unicode data in the code page of the server and with a maximum string length of 2^31 - 1 (2,147,483,647). When the server code page uses double-byte characters, the storage is still 2,147,483,647 bytes. Depending on the character string, the storage size might be less than 2,147,483,647 bytes.
4242

4343
#### image
4444

@@ -48,26 +48,22 @@ Variable-length binary data from 0 through 2^31-1 (2,147,483,647) bytes.
4848

4949
The following functions and statements can be used with **ntext**, **text**, or **image** data.
5050

51-
|Functions|Statements|
52-
|---|---|
53-
|[DATALENGTH](../../t-sql/functions/datalength-transact-sql.md)|[READTEXT](../../t-sql/queries/readtext-transact-sql.md)|
54-
|[PATINDEX](../../t-sql/functions/patindex-transact-sql.md)|[SET TEXTSIZE](../../t-sql/statements/set-textsize-transact-sql.md)|
55-
|[SUBSTRING](../../t-sql/functions/substring-transact-sql.md)|[UPDATETEXT](../../t-sql/queries/updatetext-transact-sql.md)|
56-
|[TEXTPTR](../../t-sql/functions/text-and-image-functions-textptr-transact-sql.md)|[WRITETEXT](../../t-sql/queries/writetext-transact-sql.md)|
57-
|[TEXTVALID](../../t-sql/functions/text-and-image-functions-textvalid-transact-sql.md)||
51+
| Functions | Statements |
52+
| --- | --- |
53+
| [DATALENGTH](../functions/datalength-transact-sql.md) | [READTEXT](../queries/readtext-transact-sql.md) |
54+
| [PATINDEX](../functions/patindex-transact-sql.md) | [SET TEXTSIZE](../statements/set-textsize-transact-sql.md) |
55+
| [SUBSTRING](../functions/substring-transact-sql.md) | [UPDATETEXT](../queries/updatetext-transact-sql.md) |
56+
| [Text and Image Functions - TEXTPTR](../functions/text-and-image-functions-textptr-transact-sql.md) | [WRITETEXT](../queries/writetext-transact-sql.md) |
57+
| [Text and Image Functions - TEXTVALID](../functions/text-and-image-functions-textvalid-transact-sql.md) | |
5858

59-
> [!CAUTION]
60-
> When dropping columns using the deprecated **ntext** data type, the cleanup of the deleted data occurs as a serialized operation on all rows. The cleanup can require a large amount of time. When dropping an **ntext** column in a table with lots of rows, update the **ntext** column to NULL value first, then drop the column. You can run this option with parallel operations and make it much faster.
59+
When you drop columns using the deprecated **ntext** data type, the cleanup of the deleted data occurs as a serialized operation on all rows. The cleanup can require a large amount of time. When you drop an **ntext** column in a table with lots of rows, update the **ntext** column to `NULL` value first, then drop the column. You can run this option with parallel operations and make it much faster.
6160

62-
## See also
61+
## Related content
6362

64-
- [Data Types (Transact-SQL)](../../t-sql/data-types/data-types-transact-sql.md)
65-
- [LIKE (Transact-SQL)](../../t-sql/language-elements/like-transact-sql.md)
66-
- [SET @local_variable (Transact-SQL)](../../t-sql/language-elements/set-local-variable-transact-sql.md)
67-
- [Collation and Unicode Support](../../relational-databases/collations/collation-and-unicode-support.md)
68-
69-
## Next steps
70-
71-
- [CAST and CONVERT (Transact-SQL)](../../t-sql/functions/cast-and-convert-transact-sql.md)
72-
- [Data Type Conversion (Database Engine)](../../t-sql/data-types/data-type-conversion-database-engine.md)
63+
- [Data types (Transact-SQL)](data-types-transact-sql.md)
64+
- [LIKE (Transact-SQL)](../language-elements/like-transact-sql.md)
65+
- [SET @local_variable (Transact-SQL)](../language-elements/set-local-variable-transact-sql.md)
66+
- [Collation and Unicode support](../../relational-databases/collations/collation-and-unicode-support.md)
67+
- [CAST and CONVERT (Transact-SQL)](../functions/cast-and-convert-transact-sql.md)
68+
- [Data type conversion (Database Engine)](data-type-conversion-database-engine.md)
7369
- [ALTER TABLE (Transact-SQL)](../statements/alter-table-transact-sql.md)

0 commit comments

Comments
 (0)