Risoluzione dei problemi relativi a S3 Metadata
Le seguenti informazioni ti consentono di diagnosticare e risolvere i problemi comuni che potresti incontrare quando utilizzi Amazon S3 Metadata.
Non riesco a eliminare il bucket di tabelle gestito da AWS e le tabelle dei metadati
Prima di poter eliminare una tabella di metadati, è necessario eliminare la configurazione della tabella di metadati associata sul bucket per uso generico. Per ulteriori informazioni, consulta Cancellazione di configurazioni delle tabelle di metadati.
Prima di poter eliminare il bucket di tabelle gestito da AWS, è necessario eliminare tutte le configurazioni delle tabelle dei metadati associate al bucket e tutte le tabelle dei metadati presenti nel bucket. Per ulteriori informazioni, consulta Cancellazione di configurazioni delle tabelle di metadati e Cancellazione di tabelle di metadati.
Non riesco a configurare o modificare le impostazioni di crittografia per la tabella dei metadati gestita da AWS
Durante la creazione della configurazione della tabella dei metadati, è possibile scegliere di crittografare le tabelle dei metadati gestite da AWS con la crittografia lato server utilizzando le chiavi AWS Key Management Service (AWS KMS) (SSE-KMS). Se scegli di utilizzare SSE-KMS, è necessario fornire una chiave KMS gestita dal cliente nella stessa Regione del bucket per uso generico. È possibile impostare il tipo di crittografia per le tabelle solo durante la creazione della tabella. Dopo aver creato una tabella gestita da AWS, non è possibile modificarne le impostazioni di crittografia. Per specificare SSE-KMS per le tabelle dei metadati, è necessario disporre di determinate autorizzazioni. Per ulteriori informazioni, consulta Autorizzazioni per SSE-KMS.
L’impostazione di crittografia per una tabella dei metadati ha la precedenza sull’impostazione di crittografia predefinita a livello di bucket. Se non specifichi la crittografia, la tabella erediterà l’impostazione di crittografia predefinita del bucket.
Per impostazione predefinita, i bucket di tabelle gestiti da AWS sono crittografati con crittografia lato server utilizzando chiavi gestite da Amazon S3 (SSE-S3). Dopo aver creato la prima configurazione dei metadati, è possibile modificare l’impostazione di crittografia predefinita per il bucket di tabelle gestito da AWS, in modo da utilizzare la crittografia lato server con chiavi AWS Key Management Service (AWS KMS) (SSE-KMS). Per ulteriori informazioni, consulta Crittografia per i bucket di tabelle gestiti da AWS e Specifica della crittografia lato server con chiavi AWS KMS (SSE-KMS) in bucket di tabelle.
Quando provo a ricreare la configurazione della tabella dei metadati, ricevo un errore
L’eliminazione della configurazione della tabella dei metadati elimina solo la configurazione. Il bucket di tabelle gestito da AWS e le tabelle dei metadati continuano ad esistere, anche se si elimina la configurazione della tabella dei metadati.
Se elimini la configurazione della tabella dei metadati e desideri ricreare una configurazione per lo stesso bucket per uso generico, è necessario prima eliminare manualmente le vecchie tabelle del diario e di inventario dal bucket di tabelle gestito da AWS. In caso contrario, la creazione della nuova configurazione della tabella dei metadati non riesce perché tali tabelle esistono già.
Per eliminare le tabelle dei metadati, consulta Cancellazione di tabelle di metadati.
Non riesco ad abilitare una tabella di inventario nella configurazione
Se la configurazione di S3 Metadata è stata creata prima del 15 luglio 2025, non puoi abilitare una tabella di inventario su quella configurazione. È consigliabile eliminare e ricreare la configurazione in modo da poter creare una tabella di inventario e impostare la scadenza dei record della tabella del diario. Per ulteriori informazioni, consulta Abilitazione delle tabelle di inventario sulle configurazioni dei metadati create prima del 15 luglio 2025.
Non riesco ad abilitare la scadenza dei record della tabella del diario nella configurazione
Se la configurazione di S3 Metadata è stata creata prima del 15 luglio 2025, non puoi abilitare la scadenza dei record della tabella del diario su quella configurazione. È consigliabile eliminare e ricreare la configurazione in modo da poter impostare la scadenza dei record della tabella del diario e creare una tabella di inventario. Per ulteriori informazioni, consulta Abilitazione delle tabelle di inventario sulle configurazioni dei metadati create prima del 15 luglio 2025.
Non riesco a eseguire query sulle tabelle dei metadati
Se non riesci a eseguire query sulle tabelle dei metadati, verifica quanto segue:
-
Quando si utilizza Amazon Athena o Amazon Redshift per eseguire query sulle tabelle dei metadati, è necessario racchiudere i nomi dei namespace di tabelle dei metadati tra virgolette (
") o apici inversi (`), altrimenti la query potrebbe non funzionare. -
Quando si utilizza Apache Spark su Amazon EMR o altri motori di terze parti per eseguire query sulle tabelle dei metadati, è consigliabile utilizzare l’endpoint REST Iceberg di Tabelle Amazon S3. La query potrebbe non funzionare correttamente se non utilizzi questo endpoint. Per ulteriori informazioni, consulta Accesso alle tabelle utilizzando l’endpoint Iceberg REST di Tabelle Amazon S3.
-
È necessario disporre delle autorizzazioni AWS Identity and Access Management (IAM) appropriate per eseguire query sulle tabelle dei metadati. Per ulteriori informazioni, consulta Autorizzazioni per le query sulle tabelle dei metadati.
-
Se utilizzi Amazon Athena e ricevi errori quando provi a eseguire le query, procedi come segue:
-
Se ricevi l’errore
“Insufficient permissions to execute the query. Principal does not have any privilege on specified resource”quando provi a eseguire una query in Athena, assicurati di disporre delle necessarie autorizzazioni Lake Formation sulla tabella. Per ulteriori informazioni, consulta Concessione dell’autorizzazione Lake Formation per una tabella o un database. -
Se ricevi l’errore
“Iceberg cannot access the requested resource”quando provi a eseguire la query, accedi alla console AWS Lake Formation e assicurati di disporre delle autorizzazioni per il catalogo del bucket di tabelle e per il database (namespace) che hai creato. Non specificare una tabella quando fornisci queste autorizzazioni. Per ulteriori informazioni, consulta Concessione dell’autorizzazione Lake Formation per una tabella o un database.
-
Ricevo errori 405 quando cerco di utilizzare determinati comandi AWS CLI e operazioni API di S3 Metadata
La chiamata all’operazione API GetBucketMetadataTableConfiguration V1 o l’utilizzo del comando get-bucket-metadata-table-configuration AWS Command Line Interface (AWS CLI) su una configurazione della tabella dei metadati V2 genera un errore HTTP 405 Method Not Allowed. Allo stesso modo, anche la chiamata all’operazione API DeleteBucketMetadataTableConfiguration V1 o l’utilizzo del comando delete-bucket-metadata-table-configuration AWS CLI causa un errore 405.
È possibile utilizzare l’operazione API GetBucketMetadataConfiguration V2 o il comando get-bucket-metadata-configuration AWS CLI su una configurazione della tabella dei metadati V1 o V2. Analogamente, è possibile utilizzare l’operazione API DeleteBucketMetadataConfiguration V2 o il comando delete-bucket-metadata-configuration AWS CLI su una configurazione della tabella dei metadati V1 o V2.
È consigliabile aggiornare i processi per utilizzare le nuove operazioni API V2 (CreateBucketMetadataConfiguration, GetBucketMetadataConfiguraion e DeleteBucketMetadataConfiguration) anziché le operazioni API V1. Per ulteriori informazioni sulla migrazione dalla V1 di S3 Metadata alla V2, consulta Abilitazione delle tabelle di inventario sulle configurazioni dei metadati create prima del 15 luglio 2025.
Per determinare se la configurazione è V1 o V2, puoi esaminare il seguente attributo della risposta dell’API GetBucketMetadataConfiguration. Un tipo di bucket gestito da AWS ("aws") indica una configurazione V2 e un tipo di bucket gestito dal cliente ("customer") indica una configurazione V1.
"MetadataTableConfigurationResult": { "TableBucketType": ["aws" | "customer"]
Per ulteriori informazioni, consulta Visualizzazione delle configurazioni delle tabelle dei metadati.
