TEXT
This page is part of MariaDB's Documentation.
The parent of this page is: Data Types for MariaDB Xpand
Topics on this page:
Overview
String for variable-length text data up to 65,535 bytes.
USAGE
TEXT[(<number_of_bytes_per_value>)]
[{CHARACTER SET | CHARSET} <charset_name>]
[COLLATE <collation_name>]
DETAILS
Data Type | Minimum Number of Bytes | Maximum Number of Bytes |
|---|---|---|
|
|
|
EXAMPLES
TEXT
Example of TEXT:
CREATE TABLE text_example (
description VARCHAR(20),
example TEXT CHARACTER SET latin1
) DEFAULT CHARSET=latin1; -- One byte per char makes the examples clearer
INSERT INTO text_example VALUES
('Normal foo', 'foo'),
('Trailing spaces foo', 'foo '),
('NULLed', NULL),
('Empty', ''),
('Maximum', RPAD('', 65535, 'x'));
SELECT description, LENGTH(example) AS length
FROM text_example;
+---------------------+--------+
| description | length |
+---------------------+--------+
| Normal foo | 3 |
| Trailing spaces foo | 9 |
| NULLed | NULL |
| Empty | 0 |
| Maximum | 65535 |
+---------------------+--------+
Data Too Long
When a value exceeds the size of one of the TEXT data type, the value is silently truncated.
Example of data too long behavior for TEXT:
TRUNCATE text_example;
INSERT INTO text_example VALUES
('Overflow', RPAD('', 65536, 'x'));
SELECT description, LENGTH(example) AS length
FROM text_example;
+-------------+--------+
| description | length |
+-------------+--------+
| Overflow | 65535 |
+-------------+--------+