BINARY Type
This page is part of MariaDB's Documentation.
The parent of this page is: Data Types for MariaDB Enterprise Server
Topics on this page:
Overview
Fixed-length string for binary data with limit up to 255 bytes.
DETAILS
SYNONYMS
The following are synonyms for BINARY:
CHAR BYTE
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): Data too long for column 'example' at row 1
CHANGE HISTORY
EXTERNAL REFERENCES
Additional information on this topic may be found in the MariaDB Public Knowledge Base.