Skip to content

Commit 7e24d84

Browse files
CASSANDRA-21381: Document COPY TO limitation for control characters in text columns
1 parent e6064f1 commit 7e24d84

1 file changed

Lines changed: 11 additions & 0 deletions

File tree

  • doc/modules/cassandra/pages/managing/tools

doc/modules/cassandra/pages/managing/tools/cqlsh.adoc

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -461,6 +461,17 @@ value `STDOUT` (without single quotes) to print the CSV to stdout.
461461
See `shared-copy-options` for options that apply to both `COPY TO` and
462462
`COPY FROM`.
463463

464+
[NOTE]
465+
====
466+
`COPY TO` only supports printable characters in text column values, in
467+
accordance with RFC 4180. Text columns containing control characters
468+
such as newlines (`\n`), carriage returns (`\r`), null bytes (`\x00`),
469+
or other non-printable characters will not round-trip cleanly — values
470+
will be corrupted on re-import via `COPY FROM`. If your data contains
471+
such characters, consider using `sstableloader` for data
472+
migration instead.
473+
====
474+
464475
==== Options for `COPY TO`
465476

466477
`MAXREQUESTS`::

0 commit comments

Comments
 (0)