Ricerca dei file di output delle query in Amazon S3 - Amazon Athena
Identificazione dei file di output delle query

Ricerca dei file di output delle query in Amazon S3

I file di output delle query vengono archiviati in sottocartelle in Amazon S3 nel seguente schema di percorso, a meno che la query non si verifichi in un gruppo di lavoro la cui configurazione sostituisce le impostazioni lato client. Quando la configurazione del gruppo di lavoro sostituisce le impostazioni lato client, la query utilizza il percorso dei risultati specificato dal gruppo di lavoro.

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

  • QueryResultsLocationInS3 è la posizione dei risultati delle query specificata dalle impostazioni del gruppo di lavoro o dalle impostazioni lato client. Per ulteriori informazioni, consultare Specificare una posizione dei risultati delle query riportata di seguito in questo documento.

  • Le seguenti sottocartelle vengono create solo per le query eseguite dalla console il cui percorso dei risultati non è stato sostituito dalla configurazione del gruppo di lavoro. Le query eseguite da AWS CLI o utilizzando l'API Athena vengono salvate direttamente in QueryResultsLocationInS3.

    • QueryName è il nome della query per la quale vengono salvati i risultati. Se la query è stata eseguita ma non è stata salvata, viene utilizzato Unsaved.

    • yyy/mm/dd è la data di esecuzione della query.

I file associati a una query CREATE TABLE AS SELECT vengono archiviati in una sottocartella tables del modello precedente.

Identificazione dei file di output delle query

I file vengono salvati nella posizione dei risultati delle query in Amazon S3 in base al nome, all'ID e alla data di esecuzione della query. I file per ogni query vengono denominati utilizzando il QueryID, ovvero un identificatore univoco che Athena assegna a ogni query quando viene eseguita.

Vengono salvati i seguenti tipi di file:

Tipo di file ModellI di denominazione dei file Descrizione

File dei risultati delle query

QueryID.csv

QueryID.txt

I file dei risultati delle query DML vengono salvati in formato CSV (valori separati da virgola).

I risultati delle query DDL vengono salvati come file di testo normale.

Puoi scaricare i file dei risultati dalla console dal riquadro Risultati quando utilizzi la console o dalla Cronologia della query. Per ulteriori informazioni, consulta Download dei file dei risultati delle query mediante la console Athena.

File di metadati delle query

QueryID.csv.metadata

QueryID.txt.metadata

I file di metadati delle query DML e DDL vengono salvati in formato binario e non sono leggibili dall'uomo. L'estensione del file corrisponde al file dei risultati della query. Athena utilizza i metadati durante la lettura dei risultati delle query utilizzando l'operazione GetQueryResults. Anche se questi file possono essere eliminati, è sconsigliato perché informazioni importanti sulla query andrebbero perse.

File manifest di dati

QueryID-manifest.csv

I file manifest di dati vengono generati per tenere traccia dei file Athena creati da nelle posizioni dell'origine dati Amazon S3 quando viene eseguita una query INSERT INTO. Se una query ha esito negativo, il manifest tiene traccia anche dei file che la query intendeva scrivere. Il manifest è utile per identificare i file orfani risultanti da una query non riuscita.

Per utilizzare AWS CLI per identificare la posizione di output della query e i file dei risultati, eseguire il comando aws athena get-query-execution come nell'esempio seguente. Sostituisci abc1234d-5efg-67hi-jklm-89n0op12qr34 con l'ID query.

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

Il comando restituisce un risultato simile al seguente. Per le descrizioni di ciascun parametro di output, consulta get-query-execution in Riferimento dei comandi di AWS CLI.

{
    "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"
    }
}