Skip to content

Commit bc22bbb

Browse files
SteNicholasclaude
andcommitted
docs(types): mark CHAR/VARCHAR/BINARY/VARBINARY as supported
Update the data type mapping table now that these types are parsed: CHAR/VARCHAR -> Utf8, BINARY/VARBINARY -> Binary. Note that the declared length is not enforced since Arrow has no fixed-length char/binary type. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 88af221 commit bc22bbb

1 file changed

Lines changed: 14 additions & 4 deletions

File tree

docs/source/user_guide/data_types.rst

Lines changed: 14 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -38,48 +38,58 @@ and `Arrow DataTypes <https://arrow.apache.org/docs/format/Columnar.html#data-ty
3838
* - ``CHAR``
3939

4040
``CHAR(n)``
41-
- Not Supported
41+
- Utf8
4242
- Data type of a fixed-length character string.
4343

4444
The type can be declared using ``CHAR(n)`` where n is the number of code
4545
points. n must have a value between 1 and 2,147,483,647 (both inclusive).
4646
If no length is specified, n is equal to 1.
4747

48+
**Note:** Apache Arrow has no fixed-length string type, so the declared
49+
length ``n`` is not enforced; values are mapped to a variable-length ``Utf8``.
50+
4851
* - ``VARCHAR``
4952

5053
``VARCHAR(n)``
5154

52-
- Not Supported
55+
- Utf8
5356
- Data type of a variable-length character string.
5457

5558
The type can be declared using ``VARCHAR(n)`` where n is the maximum
5659
number of code points. n must have a value between 1 and 2,147,483,647
5760
(both inclusive). If no length is specified, n is equal to 1.
5861

62+
**Note:** The declared maximum length ``n`` is not enforced.
63+
5964
* - ``STRING``
6065
- Utf8
6166
- Data type of a variable-length character string. ``STRING`` is a synonym for ``VARCHAR(2147483647)``.
6267

6368
* - ``BINARY``
6469

6570
``BINARY(n)``
66-
- Not Supported
71+
- Binary
6772
- Data type of a fixed-length binary string (=a sequence of bytes).
6873

6974
The type can be declared using ``BINARY(n)`` where n is the number of
7075
bytes. n must have a value between 1 and 2,147,483,647 (both inclusive).
7176
If no length is specified, n is equal to 1.
7277

78+
**Note:** Apache Arrow has no fixed-length binary type here, so the declared
79+
length ``n`` is not enforced; values are mapped to a variable-length ``Binary``.
80+
7381
* - ``VARBINARY``
7482

7583
``VARBINARY(n)``
76-
- Not Supported
84+
- Binary
7785
- Data type of a variable-length binary string (=a sequence of bytes).
7886

7987
The type can be declared using ``VARBINARY(n)`` where n is the maximum
8088
number of bytes. n must have a value between 1 and 2,147,483,647
8189
(both inclusive). If no length is specified, n is equal to 1.
8290

91+
**Note:** The declared maximum length ``n`` is not enforced.
92+
8393
* - ``BYTES``
8494
- Binary
8595
- ``BYTES`` is a synonym for ``VARBINARY(2147483647)``.

0 commit comments

Comments
 (0)