Temukan file keluaran kueri di Amazon S3 - Amazon Athena
Identifikasi file keluaran kueri

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Temukan file keluaran kueri di Amazon S3

File output permintaan disimpan dalam sub-folder di Amazon S3 dalam pola jalur berikut kecuali permintaan terjadi dalam kelompok kerja yang konfigurasi menimpa pengaturan sisi klien. Saat konfigurasi grup kerja menimpa pengaturan sisi klien, permintaan menggunakan jalur hasil yang ditentukan oleh kelompok kerja.

QueryResultsLocationInS3/[QueryName|Unsaved/yyyy/mm/dd/]

  • QueryResultsLocationInS3 adalah lokasi hasil kueri yang ditentukan baik oleh pengaturan grup kerja atau pengaturan sisi klien. Untuk informasi selengkapnya, lihat Tentukan lokasi hasil kueri nanti dalam dokumen ini.

  • Sub-folder berikut dibuat hanya untuk permintaan menjalankan dari konsol jalur hasil yang belum ditimpa oleh konfigurasi grup kerja. Kueri yang dijalankan dari AWS CLI atau menggunakan API Athena disimpan langsung ke QueryResultsLocationInS3.

    • QueryName adalah nama kueri yang hasilnya disimpan. Jika permintaan berjalan tetapi tidak disimpan,Unsaveddigunakan.

    • yyyy/mm/dd adalah tanggal kueri dijalankan.

File yang diasosiasikan denganCREATE TABLE AS SELECTpermintaan disimpan dalamtablessub-folder dari pola di atas.

Identifikasi file keluaran kueri

File disimpan ke lokasi hasil kueri di Amazon S3 berdasarkan nama kueri, ID kueri, dan tanggal permintaan berlari. File untuk setiap kueri diberi nama menggunakan QueryID, yang merupakan pengidentifikasi unik yang Athena tetapkan untuk setiap kueri saat dijalankan.

Tipe fail berikut disimpan:

Tipe file Pola penamaan file Deskripsi

File hasil kueri

QueryID.csv

QueryID.txt

DMLfile hasil kueri disimpan dalam format nilai (CSV) yang dipisahkan koma.

DDLhasil kueri disimpan sebagai file teks biasa.

Anda dapat mengunduh berkas hasil dari konsol dariHasilsaat menggunakan konsol atau dari queryriwayat. Untuk informasi selengkapnya, lihat Unduh file hasil kueri menggunakan konsol Athena.

Kueri file metadata

QueryID.csv.metadata

QueryID.txt.metadata

DMLdan file metadata DDL kueri disimpan dalam format biner dan tidak dapat dibaca manusia. Ekstensi file sesuai dengan file hasil kueri terkait. Athena menggunakan metadata saat membaca hasil kueri menggunakanGetQueryResultsTindakan. Meski file-file ini dapat dihapus, kami tidak merekomendasikannya karena informasi penting tentang kueri hilang.

File manifes data

QueryID-manifest.csv

File manifest data dibuat untuk melacak file yang dibuat Athena di lokasi sumber data Amazon S3 saatINSERT INTOberjalan kueri. Jika permintaan gagal, manifest juga melacak file yang permintaan dimaksudkan untuk menulis. Manifest berguna untuk mengidentifikasi file yatim piatu yang dihasilkan dari permintaan gagal.

Untuk menggunakan AWS CLI untuk mengidentifikasi lokasi output query dan file hasil, jalankan aws athena get-query-execution perintah, seperti pada contoh berikut. Ganti abc1234d-5efg-67hi-jklm-89n0op12qr34 dengan ID kueri.

aws athena get-query-execution --query-execution-id abc1234d-5efg-67hi-jklm-89n0op12qr34

Perintah ini menghasilkan output serupa dengan berikut: Untuk deskripsi dari setiap parameter output, lihat get-query-executiondi AWS CLI Command Reference.

{
    "QueryExecution": {
        "Status": {
            "SubmissionDateTime": 1565649050.175,
            "State": "SUCCEEDED",
            "CompletionDateTime": 1565649056.6229999
        },
        "Statistics": {
            "DataScannedInBytes": 5944497,
            "DataManifestLocation": "s3://amzn-s3-demo-bucket/athena-query-results-123456789012-us-west-1/MyInsertQuery/2019/08/12/abc1234d-5efg-67hi-jklm-89n0op12qr34-manifest.csv",
            "EngineExecutionTimeInMillis": 5209
        },
        "ResultConfiguration": {
            "EncryptionConfiguration": {
                "EncryptionOption": "SSE_S3"
            },
            "OutputLocation": "s3://amzn-s3-demo-bucket/athena-query-results-123456789012-us-west-1/MyInsertQuery/2019/08/12/abc1234d-5efg-67hi-jklm-89n0op12qr34"
        },
        "QueryExecutionId": "abc1234d-5efg-67hi-jklm-89n0op12qr34",
        "QueryExecutionContext": {},
        "Query": "INSERT INTO mydb.elb_log_backup SELECT * FROM mydb.elb_logs LIMIT 100",
        "StatementType": "DML",
        "WorkGroup": "primary"
    }
}