Trova i file di output delle query in Amazon S3 - Amazon Athena
Identifica i file di output delle query

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Trova i 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 della query specificata dalle impostazioni del gruppo di lavoro o dalle impostazioni lato client. Per ulteriori informazioni, consultare Specificare la posizione dei risultati della 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. Interrogazioni eseguite da AWS CLI o usando l'Athena API vengono salvati direttamente nel QueryResultsLocationInS3.

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

    • yyyy/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.

Identifica i 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 interrogazione vengono denominati utilizzando QueryID, che è un identificatore univoco che Athena assegna a ogni query durante l'esecuzione.

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

DMLi file dei risultati delle query vengono salvati in formato valori separati da virgole (). CSV

DDLi risultati delle interrogazioni vengono salvati come file di testo semplice.

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

File di metadati delle query

QueryID.csv.metadata

QueryID.txt.metadata

DMLe i file di metadati delle DDL query 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 nuovamente il plugin AWS CLI per identificare la posizione di output della query e i file dei risultati, eseguite il aws athena get-query-execution comando, come illustrato nell'esempio seguente. Replace (Sostituisci) abc1234d-5efg-67hi-jklm-89n0op12qr34 con l'ID della query.

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

Il comando restituisce un output simile al seguente: Per le descrizioni di ogni parametro di output, vedere get-query-executionin AWS CLI Riferimento ai comandi.

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