Athena でクエリ結果を再利用する

Athena による決定に従ってクエリ文字列が一致する。

データベースとカタログ名が一致する。

前の結果の有効期限が切れていない。

クエリ結果設定が前回の実行のクエリ結果設定と一致する。

クエリで参照されているすべてのテーブルにアクセスできる。

前回の結果が保存されている S3 ファイルの場所にアクセスできる。

Athena は同じワークグループ内でのみクエリ結果を再利用します。

クエリ結果の再利用機能は、ワークグループの設定を優先します。クエリの結果の設定をオーバーライドすると、この機能は無効になります。

Amazon S3 で結果セットを生成するクエリのみがサポートされます。SELECT と EXECUTE 以外のステートメントはサポートされません。

AWS Glue で登録された Apache Hive テーブル、Apache Hudi テーブル、Apache Iceberg テーブル、および Linux Foundation Delta Lake テーブルがサポートされています。外部 Hive メタストアはサポートされていません。

フェデレーションカタログ、または外部の Hive メタストアを参照するクエリはサポートされていません。

Lake Formation の管理対象テーブルでは、クエリ結果の再利用はサポートされていません。

テーブルソースの Amazon S3 の場所が Lake Formation のデータの場所として登録されている場合、クエリ結果の再利用はサポートされません。

行と列のアクセス許可を持つテーブルはサポートされていません。

きめ細かいアクセス制御 (列や行のフィルタリングなど) があるテーブルはサポートされていません。

サポートされていないテーブルを参照するクエリでは、クエリ結果の再利用は対象外です。

以前に生成された出力ファイルを再利用するには、Athena では Amazon S3 の読み込みアクセス許可が必要です。

クエリ結果の再利用機能は、以前の結果の内容が変更されていないことを前提としています。Athena では以前の結果を使用する前にその結果の整合性をチェックしません。

前回の実行でのクエリ結果が削除されているか、Amazon S3 の別の場所に移動されている場合、同じクエリを次に実行してもクエリ結果は再利用されません。

古い結果が返される可能性があります。Athena では指定した最大再利用期間に達するまで、ソースデータの変更を確認しません。

複数の結果を再利用できる場合、Athena は最新の結果を使用します。

rand() または shuffle() のような確定的ではない演算子または関数を使用するクエリは、キャッシュされた結果を使用しません。たとえば、ORDER BY を持たない LIMIT は非決定論的でキャッシュされませんが、ORDER BY を持たない LIMIT は決定論的でキャッシュされます。

JDBC でクエリ結果の再利用機能を使用するには、最低限必要なドライバーバージョンは 2.0.34.1000 です。ODBC に最低限必要なドライバー バージョンは 1.1.19.1002 です。ドライバーのダウンロード情報については、「ODBC および JDBC ドライバーを使用して Amazon Athena に接続する」を参照してください。

複数のデータカタログを使用するクエリでは、クエリ結果の再利用はサポートされません。

20 を超えるテーブルが含まれるクエリでは、クエリ結果の再利用はサポートされません。

サイズが 100 KB 未満のクエリ文字列の場合、コメントと空白の違いは無視され、INNER JOIN と JOIN は結果を再利用するために同等として扱われます。100 KB を超えるクエリ文字列は、結果を再利用するために完全に一致している必要があります。

クエリ結果は、指定の最大有効期間を超過した場合、または最大有効期間が指定されていない場合はデフォルトの 60 分を超過した場合に、期限切れと見なされます。クエリの結果を再利用できる最大期間は、分数、時間数、または日数で指定できます。指定可能な最大期間は、使用する時間単位に関係なく、同様に 7 日間です。

マネージドクエリ結果はサポートされていません。