BINARY Type
This page is part of MariaDB's Documentation.
The parent of this page is: Data Types for MariaDB Xpand
Topics on this page:
Overview
Fixed-length string for binary data with limit up to 255 bytes.
USAGE
BINARY[(<number_of_bytes_per_value>)]
DETAILS
Data Type | Minimum Number of Bytes | Maximum Number of Bytes |
|---|---|---|
|
|
|
EXAMPLES
BINARY
Example of BINARY:
CREATE TABLE binary_example (
description VARCHAR(20),
example BINARY(255)
) DEFAULT CHARSET=latin1; -- One byte per char makes the examples clearer
INSERT INTO binary_example VALUES
('Normal foo', 'foo'),
('Trailing spaces foo', 'foo '),
('NULLed', NULL),
('Empty', ''),
('Maximum', RPAD('', 255, CHAR(7)));
SELECT description, LENGTH(example) AS length
FROM binary_example;
+---------------------+--------+
| description | length |
+---------------------+--------+
| Normal foo | 255 |
| Trailing spaces foo | 255 |
| NULLed | NULL |
| Empty | 255 |
| Maximum | 255 |
+---------------------+--------+
Data Too Long
When SQL_MODE is strict (the default) a value is considered "too long" when its length exceeds the size of the data type, and an error is generated.
Example of data too long behavior for BINARY:
TRUNCATE binary_example;
INSERT INTO binary_example VALUES
('Overflow', RPAD('', 256, CHAR(7)));
ERROR 1406 (22001): [7177] Data truncation: Data too long for column "example"