Use CTAS and INSERT INTO to create Amazon Ion tables - Amazon Athena
Amazon Ion properties for the CTAS WITH clause
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Use CTAS and INSERT INTO to create Amazon Ion tables

You can use the CREATE TABLE AS SELECT (CTAS) and INSERT INTO statements to copy or insert data from a table into a new table in Amazon Ion format in Athena.

In a CTAS query, specify format='ION' in the WITH clause, as in the following example.

CREATE TABLE new_table
WITH (format='ION')
AS SELECT * from existing_table

By default, Athena serializes Amazon Ion results in Ion binary format, but you can also use text format. To use text format, specify ion_encoding = 'TEXT' in the CTAS WITH clause, as in the following example.

CREATE TABLE new_table
WITH (format='ION', ion_encoding = 'TEXT')
AS SELECT * from existing_table

For more information about Amazon Ion specific properties in the CTAS WITH clause, see Amazon Ion properties for the CTAS WITH clause.

Amazon Ion properties for the CTAS WITH clause

In a CTAS query, you can use the WITH clause to specify the Amazon Ion format and optionally specify the Amazon Ion encoding and/or write compression algorithm to use.

format

You can specify the ION keyword as the format option in the WITH clause of a CTAS query. When you do so, the table that you create uses the format that you specify for IonInputFormat for reads, and it serializes data in the format that you specify for IonOutputFormat.

The following example specifies that the CTAS query use Amazon Ion format.

WITH (format='ION')
ion_encoding

Optional

Default: BINARY

Values: BINARY, TEXT

Specifies whether data is serialized in Amazon Ion binary format or Amazon Ion text format. The following example specifies Amazon Ion text format.

WITH (format='ION', ion_encoding='TEXT')
write_compression

Optional

Default: GZIP

Values: GZIP, ZSTD, BZIP2, SNAPPY, NONE

Specifies the compression algorithm to use to compress output files.

The following example specifies that the CTAS query write its output in Amazon Ion format using the Zstandard compression algorithm.

WITH (format='ION', write_compression = 'ZSTD')

For information about using compression in Athena, see Use compression in Athena.

For information about other CTAS properties in Athena, see CTAS table properties.