TEXT

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

TEXT

0

65,535

SYNONYMS

SCHEMA

PARAMETERS

SKYSQL

PRIVILEGES

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 |
+-------------+--------+

ERROR HANDLING

FEATURE INTERACTION

RESPONSES

DIAGNOSIS

ISO 9075:2016

CHANGE HISTORY

Release Series

History

23.09

  • Present starting in MariaDB Xpand 23.09.1.

6.1

  • Present starting in MariaDB Xpand 6.1.0.

6.0

  • Present starting in MariaDB Xpand 6.0.3.

5.3

  • Present starting in MariaDB Xpand 5.3.13.

Release Series

History

6.0

  • Present starting in MariaDB Xpand 6.0.3.

5.3

  • Present starting in MariaDB Xpand 5.3.13.

Release Series

History

6.1

  • Present starting in MariaDB Xpand 6.1.0.

EXTERNAL REFERENCES