Arbeiten mit Abfrageergebnissen, letzten Abfragen und Ausgabedateien

Amazon Athena speichert automatisch Abfrageergebnisse und Metadateninformationen für jede Abfrage, die an einem Speicherort des Abfrageergebnisses ausgeführt wird, den Sie in Amazon S3 angeben können. Falls erforderlich, können Sie auf die Dateien an diesem Speicherort zugreifen, um mit ihnen zu arbeiten. Sie können Abfrageergebnisdateien auch direkt von der Athena-Konsole herunterladen.

Informationen zum erstmaligen Einrichten eines Amazon S3 Abfrageergebnisses finden Sie unter Angeben eines Speicherorts des Abfrageergebnisses mithilfe der Athena-Konsole.

Ausgabedateien werden automatisch für jede Abfrage gespeichert, die ausgeführt wird. Um mit der Athena-Konsole auf Abfrageausgabedateien zugreifen und diese anzeigen zu können, benötigen IAM-Prinzipale (Benutzer und Rollen) eine Genehmigung für die Amazon S3 GetObjectS3-Aktion für den Speicherort der Abfrageergebnisse sowie eine Genehmigung für die Athena-Aktion. GetQueryResults Der Speicherort des Abfrageergebnisses kann verschlüsselt werden. Wenn der Speicherort verschlüsselt ist, müssen Benutzer über die entsprechenden Schlüsselberechtigungen zum Ver- und Entschlüsseln des Speicherorts des Abfrageergebnisses verfügen.

Wichtig

IAM-Prinzipale mit Berechtigung für die GetObject-Amazon-S3-Aktion für den Speicherort des Abfrageergebnisses können Abfrageergebnisse auch dann von Amazon S3 abrufen, wenn die Berechtigung für die Athena GetQueryResults-Aktion verweigert wird.

Angeben eines Speicherorts des Abfrageergebnisses

Der Speicherort des Abfrageergebnisses, den Athena verwendet, wird durch eine Kombination aus Arbeitsgruppeneinstellungen und clientseitigen Einstellungen bestimmt. Die clientseitigen Einstellungen basieren darauf, wie Sie die Abfrage ausführen.

• Wenn Sie die Abfrage über die Athena-Konsole ausführen, bestimmt der Speicherort des Abfrageergebnisses, der unter Settings (Einstellungen) in der Navigationsleiste eingegeben wurde, die clientseitige Einstellung.

• Wenn Sie die Abfrage mit der Athena-API ausführen, bestimmt der OutputLocation Parameter der StartQueryExecutionAktion die clientseitige Einstellung.

• Wenn Sie die ODBC- oder JDBC-Treiber zum Ausführen von Abfragen verwenden, bestimmt die in der Verbindungs-URL angegebene S3OutputLocation-Eigenschaft die clientseitige Einstellung.

Wichtig

Wenn Sie eine Abfrage mit der API oder mit dem ODBC- oder JDBC-Treiber ausführen, gilt die Konsoleneinstellung nicht.

Jede Arbeitsgruppenkonfiguration verfügt über eine Option Override client-side settings (Clientseitige Einstellungen überschreiben), die aktiviert werden kann. Wenn diese Option aktiviert ist, haben die Arbeitsgruppeneinstellungen Vorrang vor den anwendbaren clientseitigen Einstellungen, wenn ein IAM-Prinzipal, der dieser Arbeitsgruppe zugeordnet ist, die Abfrage ausführt.

Angeben eines Speicherorts des Abfrageergebnisses mithilfe der Athena-Konsole

Bevor Sie eine Abfrage ausführen können, muss in Amazon S3 ein Speicherort für das Abfrageergebnis angegeben werden, oder Sie müssen eine Arbeitsgruppe verwenden, für die ein Bucket angegeben wurde und deren Konfiguration die Client-Einstellungen überschreibt.

So geben Sie einen clientseitigen Speicherort für das Abfrageergebnis mit der Athena-Konsole an

1. Wechseln Sie zu der Arbeitsgruppe, für die Sie einen Speicherort für Abfrageergebnisse angeben möchten. Der Name der Standardarbeitsgruppe ist primär.

2. Wählen Sie in der Navigationsleiste Settings (Einstellungen) aus.

3. Wählen Sie auf der Navigationsleiste Manage (Verwalten).

4. Führen Sie für Manage settings (Einstellungen verwalten) einen der folgenden Schritte aus:

   • Geben Sie im Feld Speicherort der Abfrageergebnisse den Pfad zu dem Bucket ein, den Sie in Amazon S3 für Ihre Abfrageergebnisse erstellt haben. Stellen Sie dem Pfad einen Präfix mit s3:// aus.

   • Wählen Sie das Symbol S3 durchsuchen, wählen Sie den Amazon-S3-Bucket aus, den Sie in Ihrer aktuellen Region erstellt haben und wählen Sie dann Auswählen.

   Anmerkung

   Wenn Sie eine Arbeitsgruppe verwenden, in der ein Speicherort für das Abfrageergebnis für alle Benutzer der Arbeitsgruppe angegeben wird, steht die Option zum Ändern des Speicherorts für das Abfrageergebnis nicht zur Verfügung.

5. (Optional) Wählen Sie View lifecycle configuration (Lebenszykluskonfiguration anzeigen) aus, um die Amazon S3 lifecycle rules (Amazon-S3-Lebenszyklusregeln) für Ihren Abfrageergebnis-Bucket anzuzeigen und zu konfigurieren. Die Amazon-S3-Lebenszyklusregeln, die Sie erstellen, können entweder Ablaufregeln oder Übergangsregeln sein. Ablaufregeln löschen Abfrageergebnisse automatisch nach einer bestimmten Zeit. Übergangsregeln verschieben sie auf eine andere Amazon-S3-Speicherebene. Weitere Informationen finden Sie unter Festlegen der Lebenszykluskonfiguration für einen Bucket im Benutzerhandbuch zu Amazon Simple Storage Service.

6. (Optional) Geben Sie unter Expected Bucket Owner die ID des Buckets ein, von dem Sie erwarten AWS-Konto , dass er der Besitzer des Buckets für den Ausgabeort sein wird. Dies ist eine zusätzliche Sicherheitsmaßnahme. Wenn die Konto-ID des Bucket-Eigentümers nicht mit der ID übereinstimmt, die Sie hier angeben, schlagen Versuche, in den Bucket auszugeben, fehl. Ausführliche Informationen finden Sie unter Überprüfen der Bucket-Eigentümerschaft mit Bucket-Eigentümer-Bedingung im Amazon-S3-Benutzerhandbuch.

   Anmerkung

   Die erwartete Bucket-Eigentümereinstellung gilt nur für den Amazon-S3-Ausgabespeicherort, den Sie für Athena-Abfrageergebnisse angeben. Sie gilt nicht für andere Amazon-S3-Speicherorte wie Datenquellenspeicherorte in externen Amazon-S3-Buckets, CTAS- und INSERT INTO-Speicherorte der Zieltabelle, UNLOAD-Speicherorte der Anweisungsangaben, Vorgänge zum Verschütten von Buckets für Verbundabfragen oder SELECT-Abfragen, die für eine Tabelle in einem anderen Konto ausgeführt werden.

7. (Optional) Wählen Sie Encrypt query results (Abfrageergebnisse verschlüsseln) aus, wenn Sie die in Amazon S3 gespeicherten Abfrageergebnisse verschlüsseln möchten. Weitere Informationen zur Verschlüsselung in Athena finden Sie unter Verschlüsselung im Ruhezustand.

8. (Optional) Wählen Sie Assign bucket owner full control over query results (Bucket-Eigetümer die volle Kontrolle über Abfrage zuweisen) aus, um dem Bucket-Eigentümer die volle Kontrolle über Abfrageergebnisse zu gewähren, wenn für den Abfrageergebnis-Bucket ACLs aktiviert sind. Wenn der Standort Ihres Abfrageergebnisses beispielsweise einem anderen Konto gehört, können Sie dem anderen Konto das Eigentum und die volle Kontrolle über Ihre Abfrageergebnisse gewähren. Weitere Informationen finden Sie unter Steuern des Eigentums an Objekten und Deaktivieren von ACLs für Ihren Bucket im Amazon-S3-Benutzerhandbuch.

9. Wählen Sie Speichern.

Zuvor erstellte Standardspeicherorte

Wenn Sie früher eine Abfrage in Athena ausgeführt haben, ohne einen Wert für den Speicherort für das Abfrageergebnis anzugeben und wenn die Speicherort-Einstellung für das Abfrageergebnis nicht von einer Arbeitsgruppe überschrieben wurde, wurde früher von Athena ein Standardspeicherort angelegt. Der Standardspeicherort waraws-athena-query-results-MyAcctID-MyRegion, wobei MyAcctID die Amazon Web Services Services-Konto-ID des IAM-Prinzipals war, der die Abfrage ausgeführt hat, und die Region MyRegionwar, in der die Abfrage ausgeführt wurde (z. B.us-west-1.)

Bevor Sie nun eine Athena-Abfrage in einer Region ausführen können, in der Ihr Konto bisher nicht Athena verwendete, müssen Sie einen Speicherort für das Abfrageergebnis angeben oder eine Arbeitsgruppe verwenden, die die Speicherort-Einstellung für das Abfrageergebnis überschreibt. Auch wenn Athena keinen Standardspeicherort für das Abfrageergebnis mehr für Sie erstellt, bleiben zuvor angelegte Standard-aws-athena-query-results-MyAcctID-MyRegion-Speicherorte gültig und Sie können sie weiterhin verwenden.

Angeben eines Speicherorts des Abfrageergebnisses mithilfe einer Arbeitsgruppe

Sie geben den Speicherort des Abfrageergebnisses in einer Arbeitsgruppenkonfiguration mithilfe der AWS Management Console, der AWS CLI oder der Athena-API an.

Wenn Sie den Befehl oder verwenden AWS CLI, geben Sie den Speicherort der Abfrageergebnisse mithilfe des OutputLocation --configuration Optionsparameters an, wenn Sie den aws athena update-work-groupBefehl aws athena create-work-groupor ausführen.

So geben Sie den Speicherort des Abfrageergebnisses für eine Arbeitsgruppe mithilfe der Athena-Konsole an

1. Wenn der Navigationsbereich in der Konsole nicht sichtbar ist, wählen Sie das Erweiterungsmenü auf der linken Seite.

   

2. Wählen Sie im Navigationsbereich die Option Workgroups (Arbeitsgruppen) aus.

3. Wählen Sie in der Liste der Arbeitsgruppen den Link der Arbeitsgruppe aus, die Sie bearbeiten möchten.

4. Wählen Sie Edit (Bearbeiten).

5. Führen Sie für Speicherort und Verschlüsselung des Abfrageergebnisses einen der folgenden Schritte aus:

   • Geben Sie im Feld Speicherort des Abfrageergebnisses den Pfad zu einem Bucket in Amazon S3 für Ihre Abfrageergebnisse ein. Stellen Sie dem Pfad einen Präfix mit s3:// aus.

   • Wählen Sie das Symbol S3 durchsuchen, wählen Sie den Amazon-S3-Bucket aus, den Sie in Ihrer aktuellen Region verwenden möchten und wählen Sie dann Auswählen.

6. (Optional) Geben Sie unter Expected Bucket Owner die ID des Buckets ein, von dem Sie erwarten AWS-Konto , dass er der Besitzer des Buckets für den Ausgabeort sein wird. Dies ist eine zusätzliche Sicherheitsmaßnahme. Wenn die Konto-ID des Bucket-Eigentümers nicht mit der ID übereinstimmt, die Sie hier angeben, schlagen Versuche, in den Bucket auszugeben, fehl. Ausführliche Informationen finden Sie unter Überprüfen der Bucket-Eigentümerschaft mit Bucket-Eigentümer-Bedingung im Amazon-S3-Benutzerhandbuch.

   Anmerkung

   Die erwartete Bucket-Eigentümereinstellung gilt nur für den Amazon-S3-Ausgabespeicherort, den Sie für Athena-Abfrageergebnisse angeben. Sie gilt nicht für andere Amazon-S3-Speicherorte wie Datenquellenspeicherorte in externen Amazon-S3-Buckets, CTAS- und INSERT INTO-Speicherorte der Zieltabelle, UNLOAD-Speicherorte der Anweisungsangaben, Vorgänge zum Verschütten von Buckets für Verbundabfragen oder SELECT-Abfragen, die für eine Tabelle in einem anderen Konto ausgeführt werden.

7. (Optional) Wählen Sie Encrypt query results (Abfrageergebnisse verschlüsseln) aus, wenn Sie die in Amazon S3 gespeicherten Abfrageergebnisse verschlüsseln möchten. Weitere Informationen zur Verschlüsselung in Athena finden Sie unter Verschlüsselung im Ruhezustand.

8. (Optional) Wählen Sie Assign bucket owner full control over query results (Bucket-Eigetümer die volle Kontrolle über Abfrage zuweisen) aus, um dem Bucket-Eigentümer die volle Kontrolle über Abfrageergebnisse zu gewähren, wenn für den Abfrageergebnis-Bucket ACLs aktiviert sind. Wenn der Standort Ihres Abfrageergebnisses beispielsweise einem anderen Konto gehört, können Sie dem anderen Konto das Eigentum und die volle Kontrolle über Ihre Abfrageergebnisse gewähren.

   Wenn die Einstellung zur S3-Objekteigentümerschaft des Bucket Bucket owner preferred (Bucket-Eigentümer bevorzugt) lautet, besitzt der Bucket-Eigentümer auch alle Abfrageergebnisobjekte, die aus dieser Arbeitsgruppe geschrieben wurden. Wenn beispielsweise die Arbeitsgruppe eines externen Kontos diese Option aktiviert und den Speicherort des Abfrageergebnisses auf den Amazon-S3-Bucket Ihres Kontos festlegt, der eine Einstellung zur S3-Objekteigentümerschaft von Bucket owner preferred (Bucket-Eigentümer bevorzugt) hat, sind Sie Eigetümer der Abfrageergebnisse der externen Arbeitsgruppe und haben die volle Kontrolle über sie.

   Wenn Sie diese Option auswählen, wenn die Einstellung zur S3-Objekteigentümerschaft des Bucket Bucket owner enforced (Bucket-Eigentümer durchgesetzt) ist, hat dies keine Auswirkungen. Weitere Informationen finden Sie unter Steuern des Eigentums an Objekten und Deaktivieren von ACLs für Ihren Bucket im Amazon-S3-Benutzerhandbuch.

9. Wenn Sie möchten, dass alle Benutzer der Arbeitsgruppe den von Ihnen angegebenen Speicherort für Abfrageergebnisse verwenden, scrollen Sie nach unten zum Abschnitt Settings (Einstellungen) und wählen Sie Override client-side settings (Clientseitige Einstellungen überschreiben).

10. Wählen Sie Save Changes (Änderungen speichern).

Herunterladen von Abfrageergebnisdateien mithilfe der Athena-Konsole

Sie können die CSV-Datei mit den Abfrageergebnissen direkt nach dem Ausführen einer Abfrage aus dem Abfragebereich herunterladen. Sie können auch Abfrageergebnisse aus den kürzlichen Abfragen von der Registerkarte Kürzliche Abfragen herunterladen.

Anmerkung

Athena-Abfrageergebnisdateien sind Dateien, die Informationen enthalten, die von den einzelnen Benutzern konfiguriert werden können. Einige Programme, die diese Daten lesen und analysieren, können möglicherweise einige der Daten als Befehle interpretieren (CSV-Injektion). Wenn Sie CSV-Daten von Abfrageergebnissen in eine Kalkulationstabelle importieren, warnt Sie dieses Programm möglicherweise vor Sicherheitsrisiken. Um Ihr System sicher zu halten, sollten Sie immer Links oder Makros aus heruntergeladenen Abfrageergebnissen deaktivieren.

So führen Sie eine Abfrage aus und laden die Abfrageergebnisse herunter

1. Geben Sie Ihre Abfrage in den Abfrage-Editor ein und wählen Sie dann Run (Ausführen) aus.

   Wenn die Ausführung der Abfrage abgeschlossen ist, zeigt der Bereich Results (Ergebnisse) die Abfrageergebnisse an.

2. Um eine CSV-Datei mit den Abfrageergebnissen herunterzuladen, wählen Sie Herunterladen von Ergebnissen über dem Bereich „Abfrageergebnisse“. Je nach Browser- und Browserkonfiguration müssen Sie möglicherweise den Download bestätigen.

   

So laden Sie eine Abfrageergebnisdatei für eine frühere Abfrage herunter

1. Wählen Sie Recent queries (Kürzliche Abfragen).

   

2. Verwenden Sie das Suchfeld, um die Abfrage zu finden, wählen Sie die Abfrage aus und dann Herunterladen von Ergebnissen.

   Anmerkung

   Sie können die Option Download results (Ergebnisse herunterladen) nicht verwenden, um Abfrageergebnisse abzurufen, die manuell gelöscht wurden, oder um Abfrageergebnisse abzurufen, die gelöscht oder durch Amazon-S3-Lebenszyklusregeln an einen anderen Speicherort verschoben wurden.

   

Anzeige kürzlicher Abfragen

Sie können die Athena-Konsole verwenden, um zu sehen, welche Abfragen erfolgreich waren oder fehlgeschlagen sind und Fehlerdetails für die fehlgeschlagenen Abfragen anzeigen. Athena hält den Abfrageverlauf 45 Tage lang vor.

Anzeigen von aktuellen Abfragen in der Athena-Konsole

1. Öffnen Sie die Athena-Konsole unter https://console.aws.amazon.com/athena/.

2. Wählen Sie Recent queries (Kürzliche Abfragen). Auf der Registerkarte Kürzliche Abfragen werden Informationen zu jeder ausgeführten Abfrage angezeigt.

3. Um eine Abfrageanweisung im Abfrage-Editor zu öffnen, wählen Sie die Ausführungs-ID der Abfrage aus.

   

4. Um die Details zu einer fehlgeschlagenen Abfrage anzuzeigen, wählen Sie den Link Fehlgeschlagen für die Abfrage.

   

Herunterladen mehrerer aktueller Abfragen in eine CSV-Datei

Sie können die Registerkarte Recent queries (Neueste Abfragen) der Athena-Konsole verwenden, um eine oder mehrere aktuelle Abfragen in eine CSV-Datei zu exportieren, um sie im Tabellenformat anzuzeigen. Die heruntergeladene Datei enthält nicht die Abfrageergebnisse, sondern die SQL-Abfragezeichenfolge selbst und andere Informationen zur Abfrage. Zu den exportierten Feldern gehören die Ausführungs-ID, der Inhalt der Abfragezeichenfolge, die Startzeit der Abfrage, der Status, die Laufzeit, die Menge der gescannten Dateien, die verwendete Version der Abfrage-Engine und die Verschlüsselungsmethode. Sie können maximal 500 kürzlich durchgeführte Abfragen oder maximal 500 gefilterte Abfragen anhand von Kriterien exportieren, die Sie in das Suchfeld eingeben.

So exportieren Sie eine oder mehrere aktuelle Abfragen in eine CSV-Datei

1. Öffnen Sie die Athena-Konsole unter https://console.aws.amazon.com/athena/.

2. Wählen Sie Recent queries (Kürzliche Abfragen).

3. (Optional) Verwenden Sie das Suchfeld, um nach den neuesten Abfragen zu filtern, die Sie herunterladen möchten.

4. Wählen Sie CSV herunterladen aus.

   

5. Wählen Sie bei der Aufforderung zum Speichern der Datei Save (Speichern). Der Standarddateiname ist Recent Queries, gefolgt von einem Zeitstempel (z. B. Recent Queries 2022-12-05T16 04 27.352-08 00.csv)

Konfigurieren der Anzeigeoptionen für aktuelle Abfragen

Sie können Optionen für die Registerkarte Recent queries (Aktuelle Abfragen) konfigurieren, z. B. anzuzeigende Spalten und Textumbruch.

So konfigurieren Sie Optionen für die Registerkarte Recent queries (Aktuelle Abfragen)

1. Öffnen Sie die Athena-Konsole unter https://console.aws.amazon.com/athena/.

2. Wählen Sie Recent queries (Kürzliche Abfragen).

3. Wählen Sie die Optionsschaltfläche (Zahnradsymbol).

   

4. In den Präferenzen wählen Sie die Anzahl der Zeilen pro Seite, das Zeilenumbruchverhalten und die anzuzeigenden Spalten aus.

   

5. Wählen Sie Confirm (Bestätigen).

Abfrageverlauf länger als 45 Tage beibehalten

Wenn Sie den Abfrageverlauf länger als 45 Tage beibehalten möchten, können Sie den Abfrageverlauf abrufen und in einem Datenspeicher wie z. B. Amazon S3 speichern. Um diesen Prozess zu automatisieren, können Sie Athena- und Amazon-S3-API-Aktionen und -CLI-Befehle verwenden. Im folgenden Verfahren werden diese Schritte zusammengefasst.

So rufen Sie den Abfrageverlauf programmgesteuert ab und speichern ihn

1. Verwenden Sie die ListQueryExecutionsAthena-API-Aktion oder den list-query-executionsCLI-Befehl, um die Abfrage-IDs abzurufen.

2. Verwenden Sie die GetQueryExecutionAthena-API-Aktion oder den get-query-executionCLI-Befehl, um Informationen zu jeder Abfrage anhand ihrer ID abzurufen.

3. Verwenden Sie die Amazon PutObjectS3-API-Aktion oder den Befehl put-object CLI, um die Informationen in Amazon S3 zu speichern.

Suchen von Abfrageausgabedateien in Amazon S3

Abfrageausgabedateien werden in Unterordnern in Amazon S3 im folgenden Pfadmuster gespeichert, es sei denn, die Abfrage erfolgt in einer Arbeitsgruppe, deren Konfiguration clientseitige Einstellungen außer Kraft setzt. Wenn die Arbeitsgruppenkonfiguration clientseitige Einstellungen außer Kraft setzt, verwendet die Abfrage den von der Arbeitsgruppe angegebenen Ergebnispfad.

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

• QueryResultsLocationInS3 ist der Speicherort der Abfrageergebnisse, der entweder durch Arbeitsgruppeneinstellungen oder clientseitige Einstellungen angegeben wird. Weitere Informationen finden Sie unter Angeben eines Speicherorts des Abfrageergebnisses an späterer Stelle in diesem Dokument.

• Die folgenden Unterordner werden nur für Abfragen erstellt, die von der Konsole ausgeführt werden, deren Ergebnispfad nicht durch die Arbeitsgruppenkonfiguration außer Kraft gesetzt wurde. Abfragen, die von der Athena-API AWS CLI oder mithilfe der Athena-API ausgeführt werden, werden direkt auf dem QueryResultsLocationInS3 gespeichert.

  • QueryNameist der Name der Abfrage, für die die Ergebnisse gespeichert werden. Wenn die Abfrage ausgeführt, aber nicht gespeichert wurde, wird Unsaved verwendet.

  • yyyy/mm/dd (jjjj/mm/tt) ist das Datum, an dem die Abfrage ausgeführt wurde.

Dateien, die einer CREATE TABLE AS SELECT-Abfrage zugeordnet sind, werden in einem tables-Unterordner des obigen Musters gespeichert.

Identifizieren von Abfrageausgabedateien

Dateien werden basierend auf dem Namen der Abfrage, der Abfrage-ID und dem Datum, an dem die Abfrage ausgeführt wurde, am Speicherort des Abfrageergebnisses in Amazon S3 gespeichert. Die Dateien für jede Abfrage werden mit der QueryID benannt. Dabei handelt es sich um eine eindeutige Kennung, die Athena jeder Abfrage zuweist, wenn sie ausgeführt wird.

Die folgenden Dateitypen werden gespeichert:

Dateityp	Dateibenennungsmuster	Beschreibung
Abfrageergebnisdateien	QueryID.csv QueryID.txt	DML-Abfrageergebnisdateien werden im CSV-Format (durch Komma getrennte Werte) gespeichert. DDL-Abfrageergebnisse werden als reine Textdateien gespeichert. Sie können Ergebnisdateien über die Konsole im Bereich Results (Ergebnisse) herunterladen, wenn Sie die Konsole verwenden oder über den Verlauf der Abfrage. Weitere Informationen finden Sie unter Herunterladen von Abfrageergebnisdateien mithilfe der Athena-Konsole.
Abfragemetadatendateien	QueryID.csv.metadata QueryID.txt.metadata	DML- und DDL-Abfragemetadateien werden im Binärformat gespeichert und sind nicht lesbar. Die Dateierweiterung entspricht der zugehörigen Abfrageergebnisdatei. Athena verwendet die Metadaten beim Lesen von Abfrageergebnissen mithilfe der GetQueryResults-Aktion Obwohl diese Dateien gelöscht werden können, empfehlen wir dies nicht, da wichtige Informationen über die Abfrage verloren gehen.
Daten-Manifest-Dateien	QueryID-manifest.csv	Daten-Manifest-Dateien werden generiert, um Dateien nachzuverfolgen, die Athena in Amazon-S3-Datenquellenspeicherorten erstellt, wenn eine INSERT INTO-Abfrage ausgeführt wird. Wenn eine Abfrage fehlschlägt, verfolgt das Manifest auch Dateien, die die Abfrage schreiben wollte. Das Manifest ist nützlich für die Identifizierung verwaister Dateien, die aus einer fehlgeschlagenen Abfrage resultieren.

Wird verwendet AWS CLI , um den Speicherort und die Dateien der Abfrage zu identifizieren

AWS CLI Um den Speicherort und die Ergebnisdateien der Abfrage zu identifizieren, führen Sie den aws athena get-query-execution Befehl wie im folgenden Beispiel aus. Ersetzen Sie abc1234d-5efg-67hi-jklm-89n0op12qr34 durch die Abfrage-ID.

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

Daraufhin erhalten Sie ein Ergebnis, das dem hier dargestellten entspricht. Eine Beschreibung der einzelnen Ausgabeparameter finden Sie get-query-executionin der AWS CLI Befehlsreferenz.

{
    "QueryExecution": {
        "Status": {
            "SubmissionDateTime": 1565649050.175,
            "State": "SUCCEEDED",
            "CompletionDateTime": 1565649056.6229999
        },
        "Statistics": {
            "DataScannedInBytes": 5944497,
            "DataManifestLocation": "s3://DOC-EXAMPLE-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://DOC-EXAMPLE-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"
    }
}