INSERT INTO - Amazon Athena
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

如果我们为英文版本指南提供翻译,那么如果存在任何冲突,将以英文版本指南为准。在提供翻译时使用机器翻译。

INSERT INTO

基于在源表上运行的 SELECT 查询语句或作为语句一部分提供的一组 VALUES,将新行插入到目标表中。如果源表以一种格式的基础数据为基础,例如CSV或JSON,目标表格基于另一格式,例如Parquet或ORC,您可以使用 INSERT INTO 将选定数据转换为目标表格格式的查询。

注意事项和限制

在 Athena 中使用 INSERT 查询时注意以下事项。

重要

当运行 INSERT 在表格中查询已加密的基础数据 Amazon S3,输出文件, INSERT 默认情况下,查询写入不加密。如果要插入具有加密数据的表中,建议您对 INSERT 查询结果进行加密。

有关使用控制台加密查询结果的更多信息,请参阅 加密存储在 Amazon S3 中的查询结果。要使用 AWS CLI 或 Athena API 启用加密,请根据需要使用 StartQueryExecution 操作的 EncryptionConfiguration 属性来指定 Amazon S3 加密选项。

支持的格式和 SerDes

针对使用以下格式和 SerDes 从数据创建的表,您可以运行 INSERT 查询。

数据格式 SerDe

Avro

org.apache.hadoop.hive.serde2.avro.AvroSerDe

:JSON

org.apache.hive.hcatalog.data.JsonSerDe

ORC

org.apache.hadoop.hive.ql.io.orc.OrcSerde

Parquet

org.apache.hadoop.hive.ql.io.parquet.serde.ParquetHiveSerDe

文本文件

org.apache.hadoop.hive.serde2.lazy.LazySimpleSerDe

注意

支持 CSV、TSV 和自定义分隔文件。

不支持分桶表

分桶表上不支持 INSERT INTO。有关更多信息,请参阅 分桶与分区。)

Partitioning

在使用分析图像时 INSERT INTOCREATE TABLE AS SELECT 查询。

Limits

INSERT INTO 语句支持向目标表写入最多 100 个分区。如果您在包含超过 100 个分区的表上运行 SELECT 子句,则查询将失败,除非 SELECT 查询限制为 100 个或更少的分区。

有关绕过此限制的信息,请参阅使用 CTAS 和 INSERT INTO 创建带 100 多个分区的表

列订购

INSERT INTOCREATE TABLE AS SELECT 声明期望已分区列成为 SELECT 声明。

如果源表未分区或与目标表格的不同列分区,则查询类似 INSERT INTO destination_table SELECT * FROM source_table 将源表的最后一列中的值视为目标表中分区列的值。在尝试从非分区表创建分区表时,请记住这一点。

Resources

有关使用 INSERT INTO 如需分区,请参阅以下资源。

写入到 Amazon S3 的文件

作为 INSERT 命令的结果,Athena 将文件写入 Amazon S3 中的源数据位置。每个 INSERT 操作都会创建一个新文件,而不是附加到现有文件。文件位置取决于表和 SELECT 查询的结构(如果存在)。Athena 为每个 INSERT 查询生成一个数据清单文件。清单跟踪查询写入的文件。它在 Amazon S3 中保存到 Athena 查询结果位置。有关更多信息,请参阅 识别查询输出文件。)

查找孤立文件

如果 CTASINSERT INTO 语句失败,则可能会在数据位置留下孤立数据。由于 Athena 不会从存储桶中删除任何数据(甚至是部分数据),您也许能够在后续查询中读取此部分数据。若要查找孤立文件以执行检查或删除操作,您可以使用 Athena 提供的数据清单文件跟踪要写入的文件列表。有关更多信息,请参阅识别查询输出文件DataManifestLocation

INSERT INTO...SELECT

指定要在一个表中运行的查询, source_table,确定要插入第二个表的行, destination_table。如果 SELECT 查询指定 source_table,列必须精确匹配 destination_table.

有关 SELECT 查询的更多信息,请参阅 SELECT

Synopsis

INSERT INTO destination_table SELECT select_query FROM source_table_or_view

Examples

选择 vancouver_pageviews 表中的所有行并将其插入 canada_pageviews 表中:

INSERT INTO canada_pageviews SELECT * FROM vancouver_pageviews;

只选择 vancouver_pageviews 表中 date 列的值介于 2019-07-012019-07-31 之间的那些行,然后将它们插入 canada_july_pageviews

INSERT INTO canada_july_pageviews SELECT * FROM vancouver_pageviews WHERE date BETWEEN date '2019-07-01' AND '2019-07-31';

仅从 country 列中值为 usa 的那些行中选择 cities_world 表中 citystate 列中的值,然后将它们插入 cities_usa 表中的 citystate 列中:

INSERT INTO cities_usa (city,state) SELECT city,state FROM cities_world WHERE country='usa'

INSERT INTO...VALUES

通过指定列和值将行插入到现有表中。指定的列和关联的数据类型必须与目标表中的列和数据类型精确匹配。

重要

我们不建议使用 VALUES 插入行,因为 Athena 会为每个 INSERT 操作生成文件。这会导致创建许多小文件并降低表的查询性能。要标识 INSERT 查询创建的文件,请检查数据清单文件。有关更多信息,请参阅 使用查询结果、输出文件和查询历史记录。)

Synopsis

INSERT INTO destination_table [(col1,col2,...)] VALUES (col1value,col2value,...)[, (col1value,col2value,...)][, ...]

Examples

在以下示例中,城市表包含三个列:、、、。idcitystatestate_motto。TheThethe id 列为类型 INT 所有其他列均为类型 VARCHAR.

cities 表中插入一行,并指定所有列值:

INSERT INTO cities VALUES (1,'Lansing','MI','Si quaeris peninsulam amoenam circumspice')

cities 表中插入两行:

INSERT INTO cities VALUES (1,'Lansing','MI','Si quaeris peninsulam amoenam circumspice'), (3,'Boise','ID','Esto perpetua')