Fehlerbehebung bei S3 Metadata
Die folgenden Informationen helfen Ihnen bei der Diagnose und Behebung häufiger Probleme, die bei der Arbeit mit Amazon S3-Metadaten auftreten können.
Ich kann meinen AWS-verwalteten Tabellen-Bucket und meine Metadatentabellen nicht löschen
Bevor Sie eine Metadatentabelle löschen können, müssen Sie zunächst die zugehörige Metadatentabellenkonfiguration in Ihrem Allzweck-Bucket löschen. Weitere Informationen finden Sie unter Löschen von Metadatentabellenkonfigurationen.
Bevor Sie Ihren AWS-verwalteten Tabellen-Bucket löschen können, müssen Sie alle Metadatentabellenkonfigurationen, die diesem Bucket zugeordnet sind, und alle Metadatentabellen im Bucket löschen. Weitere Informationen finden Sie unter Löschen von Metadatentabellenkonfigurationen und Löschen von Metadatentabellen.
Ich kann die Verschlüsselungseinstellungen für meine AWS-verwaltete Metadatentabelle nicht festlegen oder ändern
Bei der Erstellung Ihrer Metadatentabellenkonfiguration haben Sie die Möglichkeit, Ihre AWS-verwalteten Metadatentabellen mit serverseitiger Verschlüsselung unter Verwendung von AWS Key Management Service (AWS KMS)-Schlüsseln (SSE-KMS) zu verschlüsseln. Wenn Sie SSE-KMS verwenden möchten, müssen Sie einen vom Kunden verwalteten KMS-Schlüssel in derselben Region wie Ihr Allzweck-Bucket angeben. Sie können die Verschlüsselungsart für Ihre Metadatentabellen nur bei der Tabellenerstellung festlegen. Nachdem eine AWS-verwaltete Tabelle erstellt wurde, können Sie ihre Verschlüsselungseinstellung nicht mehr ändern. Um SSE-KMS für Ihre Metadatentabellen anzugeben, benötigen Sie bestimmte Berechtigungen. Weitere Informationen finden Sie unter Berechtigungen für SSE-KMS.
Die Verschlüsselungseinstellung für eine Metadatentabelle hat Vorrang vor der standardmäßigen Verschlüsselungseinstellung auf Bucket-Ebene. Wenn Sie keine Verschlüsselung für eine Metadatentabelle angeben, übernimmt sie die Standardverschlüsselungseinstellung von dem Bucket.
Standardmäßig werden AWS-verwaltete Tabellen-Buckets mit serverseitiger Verschlüsselung mithilfe von Amazon S3 verwalteten Schlüsseln (SSE-S3) verschlüsselt. Nachdem Sie Ihre erste Metadatenkonfiguration erstellt haben, können Sie die Standardverschlüsselungseinstellung für den AWS-verwalteten Tabellen-Bucket so anpassen, dass die serverseitige Verschlüsselung mit AWS Key Management Service (AWS KMS)-Schlüsseln (SSE-KMS) verwendet wird. Weitere Informationen finden Sie unter Verschlüsselung für AWS-verwaltete Tabellen-Buckets und Festlegen der serverseitigen Verschlüsselung mit AWS KMS-Schlüsseln (SSE-KMS) in Tabellen-Buckets.
Wenn ich versuche, die Konfiguration meiner Metadatentabelle neu zu erstellen, erhalte ich eine Fehlermeldung
Durch das Löschen einer Metadatentabellenkonfiguration wird nur die Konfiguration gelöscht. Der von AWS verwaltete Tabellen-Bucket und Ihre Metadatentabellen sind weiterhin vorhanden, auch wenn Sie die Metadatentabellenkonfiguration löschen.
Wenn Sie Ihre Metadatentabellenkonfiguration löschen und eine Konfiguration für denselben Allzweck-Bucket neu erstellen möchten, müssen Sie zuerst die alten Journal- und Inventartabellen manuell aus Ihrem AWS-verwalteten Tabellen-Bucket löschen. Andernfalls schlägt das Erstellen der neuen Metadatentabellenkonfiguration fehl, da diese Tabellen bereits existieren.
Informationen zum Löschen Ihrer Metadatentabelle finden Sie unter Löschen von Metadatentabellen.
Ich kann eine Inventartabelle in meiner Konfiguration nicht aktivieren
Wenn Sie Ihre S3-Metadatenkonfiguration vor dem 15. Juli 2025 erstellt haben, können Sie in dieser Konfiguration keine Inventartabelle aktivieren. Wir empfehlen Ihnen, Ihre Konfiguration zu löschen und neu zu erstellen, damit Sie eine Inventartabelle erstellen und Journaltabelleneinträge ablaufen lassen können. Weitere Informationen finden Sie unter Aktivierung von Inventartabellen für Metadatenkonfigurationen, die vor dem 15. Juli 2025 erstellt wurden.
Ich kann den Ablauf von Journaltabellendatensätzen in meiner Konfiguration nicht aktivieren
Wenn Sie Ihre S3-Metadatenkonfiguration vor dem 15. Juli 2025 erstellt haben, können Sie den Ablauf von Journaltabellendatensätzen für diese Konfiguration nicht aktivieren. Wir empfehlen Ihnen, Ihre Konfiguration zu löschen und neu zu erstellen, damit Sie Journaltabelleneinträge ablaufen lassen und eine Inventartabelle erstellen können. Weitere Informationen finden Sie unter Aktivierung von Inventartabellen für Metadatenkonfigurationen, die vor dem 15. Juli 2025 erstellt wurden.
Ich kann meine Metadaten-Tabellen nicht abfragen
Wenn Sie Ihre Metadatentabellen nicht abfragen können, überprüfen Sie Folgendes:
-
Wenn Sie Amazon Athena oder Amazon Redshift verwenden, um Ihre Metadatentabellen abzufragen, müssen Sie die Namespace-Namen Ihrer Metadatentabellen in Anführungszeichen (
") oder Backticks (`) setzen, andernfalls funktioniert die Abfrage möglicherweise nicht. -
Wenn Sie Apache Spark Amazon EMR oder andere Engines von Drittanbietern verwenden, um Ihre Metadatentabellen abzufragen, empfehlen wir Ihnen, den Iceberg REST-Endpunkt Amazon S3 Tables zu verwenden. Ihre Abfrage wird möglicherweise nicht erfolgreich ausgeführt, wenn Sie diesen Endpunkt nicht verwenden. Weitere Informationen finden Sie unter Zugreifen auf Tabellen über den Amazon S3 Tables Iceberg REST-Endpunkt.
-
Stellen Sie sicher, dass Sie über die entsprechenden AWS Identity and Access Management (IAM)-Berechtigungen zur Abfrage von Metadatentabellen verfügen. Weitere Informationen finden Sie unter Berechtigungen für die Abfrage von Metadatentabellen.
-
Wenn Sie Amazon Athena verwenden und beim Versuch, Ihre Abfragen auszuführen, Fehler auftreten, gehen Sie wie folgt vor:
-
Wenn Sie folgende Fehlermeldung erhalten:
„Unzureichende Berechtigungen zum Ausführen der Abfrage. Prinzipal hat keine Rechte für die angegebene Ressource.“wenn Sie versuchen, eine Abfrage in Athena auszuführen, müssen Ihnen die erforderlichen Lake-Formation-Berechtigungen für die Tabelle erteilt werden. Weitere Informationen finden Sie unter Erteilen der Lake Formation-Berechtigung für eine Tabelle oder Datenbank. -
Wenn Sie beim Versuch, die Abfrage auszuführen, die Fehlermeldung
„Iceberg kann nicht auf die angeforderte Ressource zugreifen“erhalten, rufen Sie die AWS Lake Formation-Konsole auf und vergewissern Sie sich, dass Sie sich selbst Berechtigungen für den Tabellen-Bucket-Katalog und die Datenbank (Namespace) erteilt haben, die Sie erstellt haben. Geben Sie bei der Gewährung dieser Berechtigungen keine Tabelle an. Weitere Informationen finden Sie unter Erteilen der Lake Formation-Berechtigung für eine Tabelle oder Datenbank.
-
Ich erhalte 405 Fehler, wenn ich versuche, bestimmte S3-Metadaten AWS CLI-Befehle und API-Vorgänge zu verwenden
Das Aufrufen der GetBucketMetadataTableConfiguration V1-API-Operation oder die Verwendung des Befehls get-bucket-metadata-table-configuration AWS Command Line Interface (AWS CLI) für eine V2-Metadatentabellenkonfiguration führt zu einem HTTP-Fehler 405 Method Not Allowed. Ebenso führt das Aufrufen der V1-API-Operation DeleteBucketMetadataTableConfiguration oder die Verwendung des Befehls delete-bucket-metadata-table-configuration AWS CLI zu einem Fehler 405.
Sie können die V2-API-Operation GetBucketMetadataConfiguration oder den Befehl get-bucket-metadata-configuration AWS CLI für die Konfiguration einer V1- oder V2-Metadatentabelle verwenden. Ebenso können Sie die V2-API-Operation DeleteBucketMetadataConfiguration oder den Befehl delete-bucket-metadata-configuration AWS CLI für eine V1- oder V2-Metadatentabellenkonfiguration verwenden.
Wir empfehlen, Ihre Prozesse so zu aktualisieren, dass sie die neuen V2-API-Operationen (CreateBucketMetadataConfiguration, GetBucketMetadataConfiguraion und DeleteBucketMetadataConfiguration) anstelle der V1-API-Operationen verwenden. Weitere Informationen zur Migration von V1 der S3-Metadaten in V2 finden Sie unter Aktivierung von Inventartabellen für Metadatenkonfigurationen, die vor dem 15. Juli 2025 erstellt wurden.
Um festzustellen, ob es sich bei Ihrer Konfiguration um V1 oder V2 handelt, können Sie sich das folgende Attribut Ihrer GetBucketMetadataConfiguration API-Antwort ansehen. Ein AWS-verwalteter Bucket-Typ ("aws") steht für eine V2-Konfiguration, und ein vom Kunden verwalteter Bucket-Typ ("customer") steht für eine V1-Konfiguration.
"MetadataTableConfigurationResult": { "TableBucketType": ["aws" | "customer"]
Weitere Informationen finden Sie unter Löschen von Metadatentabellenkonfigurationen.
