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à. # Risoluzione dei problemi di Amazon Keyspaces (per Apache Cassandra) Questa guida illustra i passaggi per la risoluzione dei problemi in vari scenari quando si lavora con Amazon Keyspaces (per Apache Cassandra). Include informazioni sulla risoluzione di errori generali, problemi di connessione, problemi di gestione della capacità ed errori del Data Definition Language (DDL). + **Errori generali** + Risoluzione dei problemi relativi a eccezioni di primo livello come `NoNodeAvailableException``NoHostAvailableException`, e. `AllNodesFailedException` + Isolamento degli errori sottostanti dalle eccezioni dei driver Java. + Implementazione di politiche di ripetizione dei tentativi e configurazione corretta delle connessioni. + **Problemi di connessione** + Risoluzione degli errori durante la connessione agli endpoint Amazon Keyspaces `cqlsh` utilizzando i driver client Apache Cassandra. + Risoluzione dei problemi delle connessioni degli endpoint VPC, delle connessioni Cassandra-stress e degli errori di configurazione IAM. + Gestione delle perdite di connessione durante l'importazione dei dati. + **Errori di gestione della capacità** + Riconoscimento e risoluzione degli errori di capacità insufficiente relativi a tabelle, partizioni e connessioni. + Monitoraggio dei parametri pertinenti di Amazon Keyspaces in Amazon Logs. CloudWatch + Ottimizzazione delle connessioni e della velocità effettiva per migliorare le prestazioni. + **Errori DDL (Data Definition Language)** + Risoluzione degli errori durante la creazione, l'accesso o il ripristino di keyspace e tabelle. + Gestione degli errori relativi alle impostazioni Time to Live (TTL) personalizzate, ai limiti delle colonne e alle eliminazioni degli intervalli. + Considerazioni relative ai carichi di lavoro di eliminazione intensivi. Per una guida alla risoluzione dei problemi specifica per l'accesso IAM, consulta. [Risoluzione dei problemi relativi all'identità e all'accesso ad Amazon Keyspaces](security_iam_troubleshoot.md) Per ulteriori informazioni sulle best practice di sicurezza, consulta[Best practice di sicurezza per Amazon Keyspaces](best-practices-security.md). **Topics** + [Errori generali](troubleshooting.general.md) + [Errori di connessione](troubleshooting.connecting.md) + [Errori di gestione della capacità](troubleshooting.serverless.md) + [Errori del linguaggio di definizione dei dati](troubleshooting.cql.md) # Risoluzione degli errori generali in Amazon Keyspaces Stai riscontrando errori generali? Ecco alcuni problemi comuni e come risolverli. ## Errori generali Stai riscontrando una delle seguenti eccezioni di primo livello che possono verificarsi per molte ragioni diverse. + `NoNodeAvailableException` + `NoHostAvailableException` + `AllNodesFailedException` Queste eccezioni sono generate dal driver del client e possono verificarsi quando si stabilisce la connessione di controllo o quando si eseguono richieste. read/write/prepare/execute/batch Quando l'errore si verifica durante la creazione della connessione di controllo, è segno che tutti i punti di contatto specificati nell'applicazione non sono raggiungibili. Quando l'errore si verifica durante l'esecuzione read/write/prepare/execute delle interrogazioni, indica che tutti i tentativi per quella richiesta sono stati esauriti. Ogni nuovo tentativo viene tentato su un nodo diverso quando si utilizza la politica di ripetizione dei tentativi predefinita. ### Come isolare l'errore sottostante dalle eccezioni dei driver Java di primo livello Questi errori generali possono essere causati da problemi di connessione o durante l'esecuzione di operazioni. read/write/prepare/execute Nei sistemi distribuiti è necessario prevedere errori temporanei e devono essere risolti riprovando la richiesta. Il driver Java non riprova automaticamente quando si verificano errori di connessione, quindi si consiglia di implementare la politica dei nuovi tentativi quando si stabilisce la connessione del driver nell'applicazione. Per una panoramica dettagliata delle migliori pratiche di connessione, vedere. [Ottimizza le connessioni dei driver client per l'ambiente serverless](connections.md) Per impostazione predefinita, il driver Java è impostato su false `idempotence` per tutte le richieste, il che significa che il driver Java non riprova automaticamente la read/write/prepare richiesta non riuscita. Per impostare `true` e indicare `idempotence` al driver di riprovare le richieste non riuscite, puoi farlo in diversi modi. Ecco un esempio di come è possibile impostare l'idempotenza a livello di codice per una singola richiesta nell'applicazione Java. ``` Statement s = new SimpleStatement("SELECT * FROM my_table WHERE id = 1"); s.setIdempotent(true); ``` Oppure potete impostare l'idempotenza predefinita per l'intera applicazione Java a livello di codice, come mostrato nell'esempio seguente. ``` // Make all statements idempotent by default: cluster.getConfiguration().getQueryOptions().setDefaultIdempotence(true); //Set the default idempotency to true in your Cassandra configuration basic.request.default-idempotence = true ``` Un'altra raccomandazione è quella di creare una politica di riprova a livello di applicazione. In questo caso, l'applicazione deve catturare `NoNodeAvailableException` e riprovare la richiesta. Si consigliano 10 nuovi tentativi con backoff esponenziale a partire da 10 ms e fino a 100 ms con un tempo totale di 1 secondo per tutti i tentativi. [Un'altra opzione consiste nell'applicare la politica di riprova esponenziale di Amazon Keyspaces quando si stabilisce la connessione al driver Java disponibile su Github.](https://github.com/aws-samples/amazon-keyspaces-java-driver-helpers/blob/main/src/main/java/com/aws/ssa/keyspaces/retry/AmazonKeyspacesExponentialRetryPolicy.java) Verifica di aver stabilito connessioni a più di un nodo quando utilizzi la politica di riprova predefinita. Puoi farlo utilizzando la seguente query in Amazon Keyspaces. ``` SELECT * FROM system.peers; ``` Se la risposta a questa query è vuota, significa che stai lavorando con un singolo nodo per Amazon Keyspaces. Se utilizzi la politica di riprova predefinita, non ci saranno nuovi tentativi perché il nuovo tentativo predefinito si verifica sempre su un nodo diverso. Per ulteriori informazioni su come stabilire connessioni tramite endpoint VPC, consulta. [Come configurare le connessioni tramite endpoint VPC in Amazon Keyspaces](connections.md#connections.VPCendpoints) Per un step-by-step tutorial che mostra come stabilire una connessione ad Amazon Keyspaces utilizzando il driver Datastax 4.x Cassandra, consulta. [Step-by-step tutorial per connettersi ad Amazon Keyspaces utilizzando il driver DataStax Java 4.x per Apache Cassandra e il plug-in di autenticazione SigV4](using_java_driver.md#java_tutorial.SigV4) # Risoluzione degli errori di connessione in Amazon Keyspaces Problemi di connessione? Ecco alcuni problemi comuni e come risolverli. ## Errori di connessione a un endpoint Amazon Keyspaces Le connessioni non riuscite e gli errori di connessione possono generare messaggi di errore diversi. La sezione seguente illustra gli scenari più comuni. **Topics** + [Non riesco a connettermi ad Amazon Keyspaces con cqlsh](#troubleshooting.connection.cqlsh) + [Non riesco a connettermi ad Amazon Keyspaces utilizzando un driver client Cassandra](#troubleshooting.connection.driver) ### Non riesco a connettermi ad Amazon Keyspaces con cqlsh **Stai tentando di connetterti a un endpoint Amazon Keyspaces utilizzando cqlsh e la connessione fallisce con un. `Connection error`** Se tenti di connetterti a una tabella Amazon Keyspaces e cqlsh non è stato configurato correttamente, la connessione non riesce. La sezione seguente fornisce esempi dei problemi di configurazione più comuni che provocano errori di connessione quando si tenta di stabilire una connessione utilizzando cqlsh. **Nota** Se stai tentando di connetterti ad Amazon Keyspaces da un VPC, sono necessarie autorizzazioni aggiuntive. Per configurare correttamente una connessione utilizzando gli endpoint VPC, segui i passaggi indicati in. [Tutorial: Connettiti ad Amazon Keyspaces utilizzando un endpoint VPC di interfaccia](vpc-endpoints-tutorial.md) **Stai tentando di connetterti ad Amazon Keyspaces usando cqlsh, ma ricevi un errore di connessione. `timed out`** Questo potrebbe accadere se non hai fornito la porta corretta, con il risultato del seguente errore. ``` # cqlsh cassandra.us-east-1.amazonaws.com 9140 -u "USERNAME" -p "PASSWORD" --ssl Connection error: ('Unable to connect to any servers', {'3.234.248.199': error(None, "Tried connecting to [('3.234.248.199', 9140)]. Last error: timed out")}) ``` Per risolvere il problema, verifica di utilizzare la porta 9142 per la connessione. **Stai tentando di connetterti ad Amazon Keyspaces usando cqlsh, ma ricevi un errore. `Name or service not known`** Questo potrebbe accadere se hai utilizzato un endpoint con errori di ortografia o inesistente. Nell'esempio seguente, il nome dell'endpoint è scritto in modo errato. ``` # cqlsh cassandra.us-east-1.amazon.com 9142 -u "USERNAME" -p "PASSWORD" --ssl Traceback (most recent call last): File "/usr/bin/cqlsh.py", line 2458, in >module> main(*read_options(sys.argv[1:], os.environ)) File "/usr/bin/cqlsh.py", line 2436, in main encoding=options.encoding) File "/usr/bin/cqlsh.py", line 484, in __init__ load_balancing_policy=WhiteListRoundRobinPolicy([self.hostname]), File "/usr/share/cassandra/lib/cassandra-driver-internal-only-3.11.0-bb96859b.zip/cassandra-driver-3.11.0-bb96859b/cassandra/policies.py", line 417, in __init__ socket.gaierror: [Errno -2] Name or service not known ``` Per risolvere questo problema quando utilizzi endpoint pubblici per connetterti, seleziona un endpoint disponibile e verifica che il nome dell'endpoint non contenga errori. [Endpoint di servizio per Amazon Keyspaces](programmatic.endpoints.md) Se utilizzi gli endpoint VPC per la connessione, verifica che le informazioni sull'endpoint VPC siano corrette nella configurazione cqlsh. **Stai tentando di connetterti ad Amazon Keyspaces usando cqlsh, ma ricevi un errore. `OperationTimedOut`** Amazon Keyspaces richiede che SSL sia abilitato per le connessioni per garantire una maggiore sicurezza. Il parametro SSL potrebbe mancare se ricevi il seguente errore. ``` # cqlsh cassandra.us-east-1.amazonaws.com -u "USERNAME" -p "PASSWORD" Connection error: ('Unable to connect to any servers', {'3.234.248.192': OperationTimedOut('errors=Timed out creating connection (5 seconds), last_host=None',)}) # ``` Per risolvere questo problema, aggiungi il seguente flag al comando cqlsh connection. ``` --ssl ``` **Stai tentando di connetterti ad Amazon Keyspaces usando cqlsh e ricevi un errore. `SSL transport factory requires a valid certfile to be specified`** In questo caso, manca il percorso del SSL/TLS certificato, il che genera il seguente errore. ``` # cat .cassandra/cqlshrc [connection] port = 9142 factory = cqlshlib.ssl.ssl_transport_factory # # cqlsh cassandra.us-east-1.amazonaws.com -u "USERNAME" -p "PASSWORD" --ssl Validation is enabled; SSL transport factory requires a valid certfile to be specified. Please provide path to the certfile in [ssl] section as 'certfile' option in /root/.cassandra/cqlshrc (or use [certfiles] section) or set SSL_CERTFILE environment variable. # ``` Per risolvere questo problema, aggiungi il percorso al certfile sul tuo computer. Per ulteriori informazioni, consulta [Come configurare manualmente le `cqlsh` connessioni per TLS](programmatic.cqlsh.md#encrypt_using_tls). ``` certfile = path_to_file/keyspaces-bundle.pem ``` **Stai tentando di connetterti ad Amazon Keyspaces usando cqlsh, ma ricevi un errore. `No such file or directory`** Questo potrebbe accadere se il percorso del file del certificato sul tuo computer è errato, il che genera il seguente errore. ``` # cat .cassandra/cqlshrc [connection] port = 9142 factory = cqlshlib.ssl.ssl_transport_factory [ssl] validate = true certfile = /root/wrong_path/keyspaces-bundle.pem # # cqlsh cassandra.us-east-1.amazonaws.com -u "USERNAME" -p "PASSWORD" --ssl Connection error: ('Unable to connect to any servers', {'3.234.248.192': IOError(2, 'No such file or directory')}) # ``` Per risolvere questo problema, verifica che il percorso del certfile sul tuo computer sia corretto. Per ulteriori informazioni, consulta [Come configurare manualmente le `cqlsh` connessioni per TLS](programmatic.cqlsh.md#encrypt_using_tls). **Stai tentando di connetterti ad Amazon Keyspaces usando cqlsh, ma ricevi un errore. `[X509] PEM lib`** Questo potrebbe accadere se il `pem` file del certificato SSL/TLS non è valido, con il risultato del seguente errore. ``` # cqlsh cassandra.us-east-1.amazonaws.com -u "USERNAME" -p "PASSWORD" --ssl Connection error: ('Unable to connect to any servers', {'3.234.248.241': error(185090057, u"Tried connecting to [('3.234.248.241', 9142)]. Last error: [X509] PEM lib (_ssl.c:3063)")}) # ``` Per risolvere questo problema, assicurati di aver scaricato i certificati digitali richiesti. Per ulteriori informazioni, consulta [Come configurare manualmente le `cqlsh` connessioni per TLS](programmatic.cqlsh.md#encrypt_using_tls). **Stai tentando di connetterti ad Amazon Keyspaces usando cqlsh, ma ricevi un errore SSL. `unknown`** Questo potrebbe accadere se il `pem` file del certificato SSL/TLS è vuoto, il che genera il seguente errore. ``` # cqlsh cassandra.us-east-1.amazonaws.com -u "USERNAME" -p "PASSWORD" --ssl Connection error: ('Unable to connect to any servers', {'3.234.248.220': error(0, u"Tried connecting to [('3.234.248.220', 9142)]. Last error: unknown error (_ssl.c:3063)")}) # ``` Per risolvere questo problema, assicurati di aver scaricato i certificati digitali richiesti. Puoi confermarlo utilizzando i passaggi descritti nell'argomento seguente[Come configurare manualmente le `cqlsh` connessioni per TLS](programmatic.cqlsh.md#encrypt_using_tls). **Stai tentando di connetterti ad Amazon Keyspaces usando cqlsh, ma ricevi un errore. `SSL: CERTIFICATE_VERIFY_FAILED`** Questo potrebbe accadere se non è possibile verificare il file del certificato SSL/TLS, con il risultato del seguente errore. ``` Connection error: ('Unable to connect to any servers', {'3.234.248.223': error(1, u"Tried connecting to [('3.234.248.223', 9142)]. Last error: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed (_ssl.c:727)")}) ``` Per risolvere questo problema, assicurati di aver scaricato i certificati digitali richiesti. Puoi confermarlo utilizzando i passaggi descritti nell'argomento seguente[Come configurare manualmente le `cqlsh` connessioni per TLS](programmatic.cqlsh.md#encrypt_using_tls). **Stai tentando di connetterti ad Amazon Keyspaces usando cqlsh, ma ricevi un errore. `Last error: timed out`** Questo potrebbe verificarsi se non hai configurato una regola in uscita per Amazon Keyspaces nel tuo gruppo di sicurezza Amazon EC2, con il risultato del seguente errore. ``` # cqlsh cassandra.us-east-1.amazonaws.com 9142 -u "USERNAME" -p "PASSWORD" --ssl Connection error: ('Unable to connect to any servers', {'3.234.248.206': error(None, "Tried connecting to [('3.234.248.206', 9142)]. Last error: timed out")}) # ``` Per confermare che questo problema è causato dalla configurazione dell'istanza Amazon EC2 e non`cqlsh`, puoi provare a connetterti al tuo keyspace utilizzando, ad esempio AWS CLI, il seguente comando. ``` aws keyspaces list-tables --keyspace-name 'my_keyspace' ``` Se anche questo comando scade, l'istanza Amazon EC2 non è configurata correttamente. Per confermare di disporre di autorizzazioni sufficienti per accedere ad Amazon Keyspaces, puoi utilizzare AWS CloudShell il comando per connetterti con. `cqlsh` Se tali connessioni vengono stabilite, è necessario configurare l'istanza Amazon EC2. Per risolvere questo problema, verifica che la tua istanza Amazon EC2 disponga di una regola in uscita che consenta il traffico verso Amazon Keyspaces. In caso contrario, devi creare un nuovo gruppo di sicurezza per l'istanza EC2 e aggiungere una regola che consenta il traffico in uscita verso le risorse di Amazon Keyspaces. **Per aggiornare la regola in uscita per consentire il traffico verso Amazon Keyspaces, **scegli** CQLSH/CASSANDRA dal menu a discesa Tipo.** Dopo aver creato il nuovo gruppo di sicurezza con la regola del traffico in uscita, devi aggiungerlo all'istanza. Seleziona l'istanza, quindi scegli **Azioni**, **Sicurezza** e quindi **Modifica gruppi di sicurezza**. Aggiungi il nuovo gruppo di sicurezza con la regola in uscita, ma assicurati che rimanga disponibile anche il gruppo predefinito. Per ulteriori informazioni su come visualizzare e modificare le regole in uscita EC2, consulta [Add rules to a security group nella Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/working-with-security-groups.html#adding-security-group-rule) User Guide. **Stai tentando di connetterti ad Amazon Keyspaces usando cqlsh, ma ricevi un errore. `Unauthorized`** Questo potrebbe verificarsi se non disponi delle autorizzazioni Amazon Keyspaces nella policy utente di IAM, il che genera il seguente errore. ``` # cqlsh cassandra.us-east-1.amazonaws.com 9142 -u "testuser-at-12345678910" -p "PASSWORD" --ssl Connection error: ('Unable to connect to any servers', {'3.234.248.241': AuthenticationFailed('Failed to authenticate to 3.234.248.241: Error from server: code=2100 [Unauthorized] message="User arn:aws:iam::12345678910:user/testuser has no permissions."',)}) # ``` Per risolvere questo problema, assicurati che l'utente IAM `testuser-at-12345678910` disponga delle autorizzazioni per accedere ad Amazon Keyspaces. Per esempi di policy IAM che concedono l'accesso ad Amazon Keyspaces, consulta. [Esempi di policy basate sull'identità di Amazon Keyspaces](security_iam_id-based-policy-examples.md) Per una guida alla risoluzione dei problemi specifica per l'accesso IAM, consulta[Risoluzione dei problemi relativi all'identità e all'accesso ad Amazon Keyspaces](security_iam_troubleshoot.md). **Stai tentando di connetterti ad Amazon Keyspaces usando cqlsh, ma ricevi un errore. `Bad credentials`** Questo potrebbe accadere se il nome utente o la password sono errati, con il risultato del seguente errore. ``` # cqlsh cassandra.us-east-1.amazonaws.com 9142 -u "USERNAME" -p "PASSWORD" --ssl Connection error: ('Unable to connect to any servers', {'3.234.248.248': AuthenticationFailed('Failed to authenticate to 3.234.248.248: Error from server: code=0100 [Bad credentials] message="Provided username USERNAME and/or password are incorrect"',)}) # ``` Per risolvere il problema, verifica che l'*USERNAME*and *PASSWORD* nel codice corrisponda al nome utente e alla password ottenuti quando hai generato le credenziali [specifiche del servizio](programmatic.credentials.ssc.md). **Importante** Se continui a riscontrare errori durante il tentativo di connessione con cqlsh, esegui nuovamente il comando con l'`--debug`opzione e includi l'output dettagliato al momento del contatto. Supporto ### Non riesco a connettermi ad Amazon Keyspaces utilizzando un driver client Cassandra Le sezioni seguenti mostrano gli errori più comuni durante la connessione con un driver client Cassandra. **Stai tentando di connetterti a una tabella Amazon Keyspaces utilizzando il driver DataStax Java, ma ricevi un `NodeUnavailableException` errore.** Se la connessione su cui viene tentata la richiesta viene interrotta, si verifica il seguente errore. ``` [com.datastax.oss.driver.api.core.NodeUnavailableException: No connection was available to Node(endPoint=vpce-22ff22f2f22222fff-aa1bb234.cassandra.us-west-2.vpce.amazonaws.com/11.1.1111.222:9142, hostId=1a23456b-c77d-8888-9d99-146cb22d6ef6, hashCode=123ca4567)] ``` Per risolvere il problema, individuate il valore del battito cardiaco e abbassatelo a 30 secondi se è più alto. ``` advanced.heartbeat.interval = 30 seconds ``` Quindi cerca il timeout associato e assicurati che il valore sia impostato su almeno 5 secondi. ``` advanced.connection.init-query-timeout = 5 seconds ``` **Stai tentando di connetterti a una tabella Amazon Keyspaces utilizzando un driver e il plug-in SigV4, ma ricevi un errore. `AttributeError`** Se le credenziali non sono configurate correttamente, si verifica il seguente errore. ``` cassandra.cluster.NoHostAvailable: (‘Unable to connect to any servers’, {‘44.234.22.154:9142’: AttributeError(“‘NoneType’ object has no attribute ‘access_key’“)}) ``` Per risolvere questo problema, verifica di passare le credenziali associate al tuo utente o ruolo IAM quando usi il plug-in SigV4. Il plugin SigV4 richiede le seguenti credenziali. + `AWS_ACCESS_KEY_ID`— Specifica una chiave di AWS accesso associata a un utente o ruolo IAM. + `AWS_SECRET_ACCESS_KEY`— Speciifica la chiave segreta associata alla chiave di accesso. Si tratta essenzialmente della "password" per la chiave di accesso. Per ulteriori informazioni sulle chiavi di accesso e sul plug-in SigV4, consulta. [Crea e configura AWS credenziali per Amazon Keyspaces](access.credentials.md) **Stai tentando di connetterti a una tabella Amazon Keyspaces utilizzando un driver, ma ricevi un `PartialCredentialsError` errore.** Se `AWS_SECRET_ACCESS_KEY` manca, può verificarsi il seguente errore. ``` cassandra.cluster.NoHostAvailable: (‘Unable to connect to any servers’, {‘44.234.22.153:9142’: PartialCredentialsError(‘Partial credentials found in config-file, missing: aws_secret_access_key’)}) ``` Per risolvere questo problema, verifica di aver passato sia il `AWS_ACCESS_KEY_ID` plugin SigV4 che il `AWS_SECRET_ACCESS_KEY` quando usi il plugin SigV4. Per ulteriori informazioni sulle chiavi di accesso e sul plug-in SigV4, consulta. [Crea e configura AWS credenziali per Amazon Keyspaces](access.credentials.md) **Stai tentando di connetterti a una tabella Amazon Keyspaces utilizzando un driver, ma ricevi un `Invalid signature` errore.** Questo potrebbe verificarsi se uno qualsiasi dei componenti richiesti per la firma è errato o non è definito correttamente per la sessione. + `AWS_ACCESS_KEY_ID` + `AWS_SECRET_ACCESS_KEY` + `AWS_DEFAULT_REGION` L'errore seguente è un esempio di chiavi di accesso non valide. ``` cassandra.cluster.NoHostAvailable: (‘Unable to connect to any servers’, {‘11.234.11.234:9142’: AuthenticationFailed(‘Failed to authenticate to 11.234.11.234:9142: Error from server: code=0100 [Bad credentials] message=“Authentication failure: Invalid signature”’)}) ``` Per risolvere questo problema, verifica che le chiavi di accesso e le chiavi di accesso siano Regione AWS state configurate correttamente per consentire al plug-in SigV4 di accedere ad Amazon Keyspaces. Per ulteriori informazioni sulle chiavi di accesso e sul plug-in SigV4, consulta. [Crea e configura AWS credenziali per Amazon Keyspaces](access.credentials.md) #### La mia connessione endpoint VPC non funziona correttamente **Stai tentando di connetterti ad Amazon Keyspaces utilizzando endpoint VPC, ma ricevi errori nella mappa dei token o stai riscontrando una bassa velocità di trasmissione.** Questo potrebbe accadere se la connessione dell'endpoint VPC non è configurata correttamente. Per risolvere questi problemi, verifica i seguenti dettagli di configurazione. Per seguire un step-by-step tutorial su come configurare una connessione tramite endpoint VPC di interfaccia per Amazon Keyspaces, consulta. [Tutorial: Connettiti ad Amazon Keyspaces utilizzando un endpoint VPC di interfaccia](vpc-endpoints-tutorial.md) 1. Verifica che l'entità IAM utilizzata per connettersi ad Amazon Keyspaces abbia read/write accesso alla tabella utente e all'accesso in lettura alle tabelle di sistema, come mostrato nell'esempio seguente. ``` { "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "cassandra:Select", "cassandra:Modify" ], "Resource":[ "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable", "arn:aws:cassandra:us-east-1:111122223333:/keyspace/system*" ] } ] } ``` 1. Verifica che l'entità IAM utilizzata per connettersi ad Amazon Keyspaces disponga delle autorizzazioni di lettura necessarie per accedere alle informazioni sugli endpoint VPC sulla tua istanza Amazon EC2, come mostrato nell'esempio seguente. ``` { "Version":"2012-10-17", "Statement":[ { "Sid":"ListVPCEndpoints", "Effect":"Allow", "Action":[ "ec2:DescribeNetworkInterfaces", "ec2:DescribeVpcEndpoints" ], "Resource":"*" } ] } ``` **Nota** Le policy gestite `AmazonKeyspacesFullAccess` includono `AmazonKeyspacesReadOnlyAccess_v2` le autorizzazioni necessarie per consentire ad Amazon Keyspaces di accedere all'istanza Amazon EC2 per leggere informazioni sugli endpoint VPC di interfaccia disponibili. Per ulteriori informazioni sugli endpoint VPC, consulta [Utilizzo degli endpoint VPC dell'interfaccia per Amazon Keyspaces](vpc-endpoints.md#using-interface-vpc-endpoints) 1. Verificate che la configurazione SSL del driver Java imposti la convalida del nome host su false, come mostrato in questo esempio. ``` hostname-validation = false ``` Per ulteriori informazioni sulla configurazione dei driver, vedere. [Fase 2: Configurare il driver](using_java_driver.md#java_tutorial.driverconfiguration) 1. Per confermare che l'endpoint VPC è stato configurato correttamente, puoi eseguire la seguente istruzione dall'interno del *tuo* VPC. **Nota** Non puoi utilizzare l'ambiente di sviluppo locale o l'editor CQL di Amazon Keyspaces per confermare questa configurazione, perché utilizzano l'endpoint pubblico. ``` SELECT peer FROM system.peers; ``` L'output dovrebbe essere simile a questo esempio e restituire da 2 a 6 nodi con IPv4 indirizzi privati quando ci si connette da una IPv4 rete, a seconda della configurazione del VPC e AWS della regione. ``` peer --------------- 192.0.2.0.15 192.0.2.0.24 192.0.2.0.13 192.0.2.0.7 192.0.2.0.8 (5 rows) ``` #### Non riesco a connettermi tramite `cassandra-stress` **Stai tentando di connetterti ad Amazon Keyspaces usando il `cassandra-stress` comando, ma ricevi un `SSL context` errore.** Ciò accade se provi a connetterti ad Amazon Keyspaces, ma non hai configurato correttamente il TrustStore. Amazon Keyspaces richiede l'uso di Transport Layer Security (TLS) per proteggere le connessioni con i client. In questo caso, viene visualizzato il seguente errore. ``` Error creating the initializing the SSL Context ``` Per risolvere questo problema, segui le istruzioni per configurare un TrustStore, come illustrato in questo argomento[Prima di iniziare](using_java_driver.md#using_java_driver.BeforeYouBegin). Una volta configurato il TrustStore, dovresti essere in grado di connetterti con il seguente comando. ``` ./cassandra-stress user profile=./profile.yaml n=100 "ops(insert=1,select=1)" cl=LOCAL_QUORUM -node "cassandra.eu-north-1.amazonaws.com" -port native=9142 -transport ssl-alg="PKIX" truststore="./cassandra_truststore.jks" truststore-password="trustStore_pw" -mode native cql3 user="user_name" password="password" ``` #### Non riesco a connettermi utilizzando le identità IAM **Stai tentando di connetterti a una tabella Amazon Keyspaces utilizzando un'identità IAM, ma ricevi un `Unauthorized` errore.** Ciò accade se tenti di connetterti a una tabella Amazon Keyspaces utilizzando un'identità IAM (ad esempio, un utente IAM) senza implementare la policy e fornire prima all'utente le autorizzazioni richieste. In questo caso, viene visualizzato il seguente errore. ``` Connection error: ('Unable to connect to any servers', {'3.234.248.202': AuthenticationFailed('Failed to authenticate to 3.234.248.202: Error from server: code=2100 [Unauthorized] message="User arn:aws:iam::1234567890123:user/testuser has no permissions."',)}) ``` Per risolvere questo problema, verifica le autorizzazioni dell'utente IAM. Per connettersi con un driver standard, un utente deve avere almeno `SELECT` accesso alle tabelle di sistema, poiché la maggior parte dei driver legge il sistema keyspaces/tables quando stabilisce la connessione. Ad esempio, le politiche IAM che concedono l'accesso al sistema Amazon Keyspaces e alle tabelle utente, vedi. [Accesso alle tabelle Amazon Keyspaces](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-access-one-table) Per consultare la sezione sulla risoluzione dei problemi specifica di IAM, consulta[Risoluzione dei problemi relativi all'identità e all'accesso ad Amazon Keyspaces](security_iam_troubleshoot.md). #### Sto cercando di importare dati con cqlsh e la connessione alla mia tabella Amazon Keyspaces si interrompe **Stai cercando di caricare dati su Amazon Keyspaces con cqlsh, ma ricevi errori di connessione.** La connessione ad Amazon Keyspaces fallisce dopo che il client cqlsh riceve tre errori consecutivi di qualsiasi tipo dal server. Il client cqlsh ha esito negativo e viene visualizzato il seguente messaggio. ``` Failed to import 1 rows: NoHostAvailable - , will retry later, attempt 3 of 100 ``` Per risolvere questo errore, devi assicurarti che i dati da importare corrispondano allo schema della tabella in Amazon Keyspaces. Controlla il file di importazione per verificare eventuali errori di analisi. Puoi provare a utilizzare una singola riga di dati utilizzando un'istruzione INSERT per isolare l'errore. Il client tenta automaticamente di ristabilire la connessione. # Risoluzione degli errori di gestione della capacità in Amazon Keyspaces Problemi con la capacità serverless? Ecco alcuni problemi comuni e come risolverli. ## Errori di capacità serverless Questa sezione descrive come riconoscere gli errori relativi alla gestione della capacità serverless e come risolverli. Ad esempio, è possibile che si verifichino eventi di capacità insufficiente quando l'applicazione supera la capacità di throughput assegnata. Poiché Apache Cassandra è un software basato su cluster progettato per funzionare su una flotta di nodi, non presenta eccezioni relative a funzionalità serverless come la capacità di trasmissione. La maggior parte dei driver comprende solo i codici di errore disponibili in Apache Cassandra, quindi Amazon Keyspaces utilizza lo stesso set di codici di errore per mantenere la compatibilità. Per mappare gli errori di Cassandra agli eventi di capacità sottostanti, puoi utilizzare Amazon CloudWatch per monitorare i parametri pertinenti di Amazon Keyspaces. Gli eventi di capacità insufficiente che provocano errori sul lato client possono essere classificati in questi tre gruppi in base alla risorsa che causa l'evento: + **Tabella**: se si sceglie la modalità **Provisioned** capacity per una tabella e l'applicazione supera il throughput assegnato, è possibile che si verifichino errori di capacità insufficiente. Per ulteriori informazioni, consulta [Configura le modalità di read/write capacità in Amazon Keyspaces](ReadWriteCapacityMode.md). + **Partizione**: potrebbero verificarsi eventi di capacità insufficiente se il traffico verso una determinata partizione supera 3.000 o 1.000. RCUs WCUs Come best practice, consigliamo di distribuire il traffico in modo uniforme tra le partizioni. Per ulteriori informazioni, consulta [Migliori pratiche di modellazione dei dati: consigli per la progettazione di modelli di dati](data-modeling.md). + **Connessione**: la velocità effettiva potrebbe essere insufficiente se si supera la quota per il numero massimo di operazioni al secondo, per connessione. Per aumentare la velocità effettiva, è possibile aumentare il numero di connessioni predefinite durante la configurazione della connessione con il driver. Per informazioni su come configurare le connessioni per Amazon Keyspaces, consulta. [Come configurare le connessioni in Amazon Keyspaces](connections.md#connections.howtoconfigure) Per ulteriori informazioni sull'ottimizzazione delle connessioni sugli endpoint VPC, consulta. [Come configurare le connessioni tramite endpoint VPC in Amazon Keyspaces](connections.md#connections.VPCendpoints) Per determinare quale risorsa sta causando l'evento di capacità insufficiente che restituisce l'errore lato client, puoi controllare la dashboard nella console Amazon Keyspaces. **Per impostazione predefinita, la console fornisce una visualizzazione aggregata delle metriche più comuni relative alla capacità e al traffico nella sezione Capacità **e CloudWatch metriche correlate della scheda Capacità relativa alla tabella**.** Per creare la tua dashboard con Amazon CloudWatch, controlla le seguenti metriche di Amazon Keyspaces. + `PerConnectionRequestRateExceeded`— Richieste ad Amazon Keyspaces che superano la quota per la frequenza di richieste per connessione. Ogni connessione client ad Amazon Keyspaces può supportare fino a 3000 richieste CQL al secondo. È possibile eseguire più di 3000 richieste al secondo creando più connessioni. + `ReadThrottleEvents`— Richieste ad Amazon Keyspaces che superano la capacità di lettura di una tabella. + `StoragePartitionThroughputCapacityExceeded`— Richieste a una partizione di storage Amazon Keyspaces che superano la capacità di throughput della partizione. Le partizioni di storage Amazon Keyspaces possono supportare fino a 1000 WCU/WRU al secondo e 3000 RCU/RRU al secondo. Per mitigare queste eccezioni, ti consigliamo di rivedere il tuo modello di dati per distribuire il read/write traffico su più partizioni. + `WriteThrottleEvents`— Richieste ad Amazon Keyspaces che superano la capacità di scrittura di una tabella. Per ulteriori informazioni CloudWatch, consulta[Monitoraggio di Amazon Keyspaces con Amazon CloudWatch](monitoring-cloudwatch.md). Per un elenco di tutte le CloudWatch metriche disponibili per Amazon Keyspaces, consulta. [Metriche e dimensioni di Amazon Keyspaces](metrics-dimensions.md) **Nota** [Per iniziare con una dashboard personalizzata che mostri tutte le metriche comunemente osservate per Amazon Keyspaces, puoi utilizzare un modello CloudWatch predefinito disponibile nell'AWS archivio degli GitHub esempi.](https://github.com/aws-samples/amazon-keyspaces-cloudwatch-cloudformation-templates) **Topics** + [Errori lato client](#troubleshooting.serverless.clientside) + [Errori di timeout di scrittura durante l'importazione dei dati](#troubleshooting.serverless.writetimeout) + [Dimensioni dello spazio chiave o della tabella](#troubleshooting.serverless.storagesize) ### Ricevo errori di capacità `NoHostAvailable` insufficiente dal driver del mio client **Stai visualizzando le nostre eccezioni per una tabella`Read_Timeout`. `Write_Timeout`** Il tentativo ripetuto di scrivere o leggere da una tabella Amazon Keyspaces con capacità insufficiente può causare errori lato client specifici del driver. Utilizzalo CloudWatch per monitorare i parametri di throughput assegnati ed effettivi e gli eventi di capacità insufficiente per la tabella. Ad esempio, una richiesta di lettura che non ha una capacità di throughput sufficiente ha esito negativo con un'`Read_Timeout`eccezione e viene registrata nella metrica. `ReadThrottleEvents` Una richiesta di scrittura che non ha una capacità di throughput sufficiente ha esito negativo con un'`Write_Timeout`eccezione e viene registrata nella metrica. `WriteThrottleEvents` Per ulteriori informazioni su questi parametri, consulta [Metriche e dimensioni di Amazon Keyspaces](metrics-dimensions.md). Per risolvere questi problemi, prendi in considerazione una delle seguenti opzioni. + Aumentate il *throughput assegnato* per la tabella, ovvero la quantità massima di capacità di throughput che un'applicazione può consumare. Per ulteriori informazioni, consulta [Unità di capacità in lettura e unità di capacità in scrittura](ReadWriteCapacityMode.Provisioned.md#ReadWriteCapacityMode.Provisioned.Units). + Consenti al servizio di gestire la capacità di throughput per tuo conto con la scalabilità automatica. Per ulteriori informazioni, consulta [Gestisci automaticamente la capacità di throughput con la scalabilità automatica di Amazon Keyspaces](autoscaling.md). + Scegli la modalità di capacità **su richiesta** per la tabella. Per ulteriori informazioni, consulta [Configura la modalità di capacità su richiesta](ReadWriteCapacityMode.OnDemand.md). Se devi aumentare la quota di capacità predefinita per il tuo account, consulta[Quote per Amazon Keyspaces (per Apache Cassandra)](quotas.md). **Stai riscontrando errori relativi al superamento della capacità di partizione.** Quando viene visualizzato l'errore, la capacità `StoragePartitionThroughputCapacityExceeded` della partizione viene temporaneamente superata. Ciò potrebbe essere gestito automaticamente dalla capacità adattiva o dalla capacità su richiesta. Ti consigliamo di rivedere il tuo modello di dati per distribuire il read/write traffico su più partizioni per mitigare questi errori. Le partizioni di storage Amazon Keyspaces possono supportare fino a 1000 WCU/WRU al secondo e 3000 RCU/RRU al secondo. Per ulteriori informazioni su come migliorare il modello di dati per distribuire il read/write traffico su più partizioni, consulta. [Migliori pratiche di modellazione dei dati: consigli per la progettazione di modelli di dati](data-modeling.md) `Write_Timeout`le eccezioni possono anche essere causate da una velocità elevata di operazioni di scrittura simultanee che includono dati statici e non statici nella stessa partizione logica. Se si prevede che il traffico esegua più operazioni di scrittura simultanee che includono dati statici e non statici all'interno della stessa partizione logica, si consiglia di scrivere i dati statici e non statici separatamente. La scrittura dei dati separatamente aiuta anche a ottimizzare i costi di throughput. **Stai riscontrando errori relativi al superamento della frequenza di richiesta di connessione.** Stai vedendo qualcosa a `PerConnectionRequestRateExceeded` causa di una delle seguenti cause. + Potresti non avere un numero sufficiente di connessioni configurate per sessione. + Potresti ricevere meno connessioni rispetto ai peer disponibili, perché le autorizzazioni degli endpoint VPC non sono configurate correttamente. Per ulteriori informazioni sulle policy degli endpoint VPC, consulta. [Utilizzo degli endpoint VPC dell'interfaccia per Amazon Keyspaces](vpc-endpoints.md#using-interface-vpc-endpoints) + Se utilizzi un driver 4.x, controlla se la convalida del nome host è abilitata. Il driver abilita la verifica del nome host TLS per impostazione predefinita. Questa configurazione fa sì che Amazon Keyspaces appaia come un cluster a nodo singolo per il driver. Ti consigliamo di disattivare la verifica del nome host. Ti consigliamo di seguire queste best practice per assicurarti che le connessioni e il throughput siano ottimizzati: + **Configura l'ottimizzazione del throughput delle query CQL.** Amazon Keyspaces supporta fino a 3.000 query CQL per connessione TCP al secondo, ma non c'è limite al numero di connessioni che un driver può stabilire. La maggior parte dei driver Cassandra open source stabilisce un pool di connessioni con Cassandra e bilancia il carico delle query su quel pool di connessioni. Amazon Keyspaces espone 9 indirizzi IP peer ai driver. Il comportamento predefinito della maggior parte dei driver consiste nello stabilire una singola connessione a ciascun indirizzo IP peer. Pertanto, la velocità massima di trasmissione delle query CQL di un driver che utilizza le impostazioni predefinite sarà di 27.000 query CQL al secondo. Per aumentare questo numero, si consiglia di aumentare il numero di connessioni per indirizzo IP che il driver mantiene nel proprio pool di connessioni. Ad esempio, impostando il numero massimo di connessioni per indirizzo IP su 2, la velocità effettiva massima del driver raddoppierà fino a 54.000 query CQL al secondo. + **Ottimizza le connessioni a nodo singolo.** Per impostazione predefinita, la maggior parte dei driver Cassandra open source stabilisce una o più connessioni a ogni indirizzo IP pubblicizzato nella `system.peers` tabella quando si stabilisce una sessione. Tuttavia, alcune configurazioni possono comportare la connessione di un driver a un singolo indirizzo IP di Amazon Keyspaces. Ciò può accadere se il driver sta tentando la convalida del nome host SSL dei nodi peer (ad esempio, i driver DataStax Java) o quando si connette tramite un endpoint VPC. Per ottenere la stessa disponibilità e le stesse prestazioni di un driver con connessioni a più indirizzi IP, ti consigliamo di fare quanto segue: + Aumentate il numero di connessioni per IP a 9 o più, a seconda della velocità effettiva del client desiderata. + Crea una politica di nuovi tentativi personalizzata che garantisca che i nuovi tentativi vengano eseguiti sullo stesso nodo. Per ulteriori informazioni, consultare la pagina [Come configurare la politica di riprova per le connessioni in Amazon Keyspaces](connections.md#connections.retry-policies). + Se utilizzi endpoint VPC, concedi all'entità IAM utilizzata per la connessione ad Amazon Keyspaces le autorizzazioni di accesso per interrogare il tuo VPC per le informazioni sull'endpoint e sull'interfaccia di rete. Ciò migliora il bilanciamento del carico e aumenta il throughput. read/write Per ulteriori informazioni, consulta [Inserimento delle voci della `system.peers` tabella con informazioni sugli endpoint VPC dell'interfaccia](vpc-endpoints.md#system_peers). ### Ricevo errori di timeout di scrittura durante l'importazione dei dati **Stai ricevendo un errore di timeout durante il caricamento dei dati utilizzando il comando. `cqlsh` `COPY`** ``` Failed to import 1 rows: WriteTimeout - Error from server: code=1100 [Coordinator node timed out waiting for replica nodes' responses] message="Operation timed out - received only 0 responses." info={'received_responses': 0, 'required_responses': 2, 'write_type': 'SIMPLE', 'consistency': 'LOCAL_QUORUM'}, will retry later, attempt 1 of 100 ``` Amazon Keyspaces utilizza le `WriteTimeout` eccezioni `ReadTimeout` e per indicare quando una richiesta di scrittura non riesce a causa di una capacità di throughput insufficiente. Per aiutare a diagnosticare eccezioni di capacità insufficienti, Amazon Keyspaces pubblica le seguenti metriche su Amazon. CloudWatch + `WriteThrottleEvents` + `ReadThrottledEvents` + `StoragePartitionThroughputCapacityExceeded` Per risolvere gli errori di capacità insufficiente durante il caricamento dei dati, riduci la velocità di scrittura per lavoratore o la velocità di acquisizione totale, quindi riprova a caricare le righe. Per ulteriori informazioni, consulta [Fase 4: Configurare `cqlsh COPY FROM` le impostazioni](bulk-upload-config.md). [Per un'opzione di caricamento dei dati più solida, prendi in considerazione l'utilizzo DSBulk, disponibile nel repository. GitHub ](https://github.com/datastax/dsbulk) Per step-by-step istruzioni, vedere[Tutorial: caricamento di dati in Amazon Keyspaces utilizzando DSBulk](dsbulk-upload.md). ### Non riesco a vedere le dimensioni effettive di archiviazione di un keyspace o di una tabella **Non è possibile visualizzare la dimensione di archiviazione effettiva del keyspace o della tabella.** Per ulteriori informazioni sulle dimensioni di archiviazione della tabella, consulta[Valutazione dei costi a livello di tabella](CostOptimization_TableLevelCostAnalysis.md). Puoi anche stimare le dimensioni dello spazio di archiviazione iniziando a calcolare la dimensione delle righe in una tabella. Istruzioni dettagliate per il calcolo della dimensione delle righe sono disponibili all'indirizzo[Stima della dimensione delle righe in Amazon Keyspaces](calculating-row-size.md). # Risoluzione degli errori del linguaggio di definizione dei dati in Amazon Keyspaces Hai problemi a creare risorse? Ecco alcuni problemi comuni e come risolverli. ## Errori del linguaggio di definizione dei dati Amazon Keyspaces esegue operazioni DDL (Data Definition Language) in modo asincrono, ad esempio creando ed eliminando keyspace e tabelle. Se un'applicazione tenta di utilizzare la risorsa prima che sia pronta, l'operazione non riesce. È possibile monitorare lo stato di creazione di nuovi spazi chiave e tabelle in Console di gestione AWS, che indica quando uno spazio chiave o una tabella è in sospeso o attivo. È inoltre possibile monitorare lo stato di creazione di un nuovo keyspace o di una nuova tabella a livello di codice interrogando la tabella dello schema di sistema. Uno spazio chiave o una tabella diventano visibili nello schema di sistema quando sono pronti per l'uso. **Nota** Per ottimizzare la creazione di keyspace utilizzando CloudFormation, è possibile utilizzare questa utilità per convertire gli script CQL in modelli. CloudFormation [Lo strumento è disponibile nel repository. GitHub ](https://github.com/aws/amazon-keyspaces-cql-to-cfn-converter) **Topics** + [Errori di creazione del keyspace](#troubleshooting.cql.keyspace) + [Errori di creazione della tabella](#troubleshooting.cql.table) + [Sto cercando di ripristinare una tabella utilizzando Amazon Keyspaces point-in-time recovery (PITR), ma il ripristino non riesce](#troubleshooting.cql.pitr) + [Sto cercando di modificare le impostazioni Time INSERT/UPDATE to Live (TTL) personalizzate, ma l'operazione non riesce](#troubleshooting.cql.ttl) + [Colonne superate](#troubleshooting.cql.upload) + [Errore di eliminazione dell'intervallo](#troubleshooting.cql.rangedelete) ### Ho creato un nuovo keyspace, ma non riesco a visualizzarlo o accedervi **Stai ricevendo errori dalla tua applicazione che sta tentando di accedere a un nuovo keyspace.** Se tenti di accedere a uno spazio di chiavi Amazon Keyspaces appena creato che viene ancora creato in modo asincrono, riceverai un errore. L'errore seguente è un esempio. ``` InvalidRequest: Error from server: code=2200 [Invalid query] message="unconfigured keyspace mykeyspace" ``` Il modello di progettazione consigliato per verificare quando un nuovo keyspace è pronto per l'uso consiste nell'eseguire il polling delle tabelle dello schema di sistema Amazon Keyspaces (system\$1schema\$1mcs.\$1). Per ulteriori informazioni, consulta [Verifica lo stato di creazione del keyspace in Amazon Keyspaces](keyspaces-create.md). ### Ho creato una nuova tabella, ma non riesco a visualizzarla o accedervi **Stai ricevendo errori dalla tua applicazione che sta tentando di accedere a una nuova tabella.** Se tenti di accedere a una tabella Amazon Keyspaces appena creata che viene ancora creata in modo asincrono, riceverai un errore. Ad esempio, il tentativo di interrogare una tabella che non è ancora disponibile non riesce e genera un errore. `unconfigured table` ``` InvalidRequest: Error from server: code=2200 [Invalid query] message="unconfigured table mykeyspace.mytable" ``` Il tentativo di visualizzare la tabella `sync_table()` non riesce con un`KeyError`. ``` KeyError: 'mytable' ``` Il modello di progettazione consigliato per verificare quando una nuova tabella è pronta per l'uso consiste nel polling delle tabelle dello schema del sistema Amazon Keyspaces (system\$1schema\$1mcs.\$1). Questo è l'output di esempio per una tabella in fase di creazione. ``` user-at-123@cqlsh:system_schema_mcs> select table_name,status from system_schema_mcs.tables where keyspace_name='example_keyspace' and table_name='example_table'; table_name | status ------------+---------- example_table | CREATING (1 rows) ``` Questo è l'output di esempio per una tabella attiva. ``` user-at-123@cqlsh:system_schema_mcs> select table_name,status from system_schema_mcs.tables where keyspace_name='example_keyspace' and table_name='example_table'; table_name | status ------------+---------- example_table | ACTIVE (1 rows) ``` Per ulteriori informazioni, consulta [Verifica lo stato di creazione della tabella in Amazon Keyspaces](tables-create.md). ### Sto cercando di ripristinare una tabella utilizzando Amazon Keyspaces point-in-time recovery (PITR), ma il ripristino non riesce Se stai cercando di ripristinare una tabella Amazon Keyspaces con point-in-time ripristino (PITR) e vedi che il processo di ripristino inizia ma non viene completato correttamente, potresti non aver configurato tutte le autorizzazioni richieste necessarie al processo di ripristino per questa particolare tabella. Oltre alle autorizzazioni utente, Amazon Keyspaces potrebbe richiedere le autorizzazioni per eseguire azioni durante il processo di ripristino per conto del tuo principale. Questo è il caso se la tabella è crittografata con una chiave gestita dal cliente o se utilizzi politiche IAM che limitano il traffico in entrata. Ad esempio, se utilizzi le chiavi di condizione nella tua policy IAM per limitare il traffico di origine a endpoint o intervalli IP specifici, l'operazione di ripristino non riesce. Per consentire ad Amazon Keyspaces di eseguire l'operazione di ripristino della tabella per conto del tuo principale, devi aggiungere una chiave di condizione `aws:ViaAWSService` globale nella policy IAM. Per ulteriori informazioni sulle autorizzazioni per ripristinare le tabelle, consulta. [Configura le autorizzazioni IAM della tabella di ripristino per Amazon Keyspaces PITR](howitworks_restore_permissions.md) ### Sto cercando di modificare le impostazioni Time INSERT/UPDATE to Live (TTL) personalizzate, ma l'operazione non riesce Se stai tentando di inserire o aggiornare un valore TTL personalizzato, l'operazione potrebbe non riuscire con il seguente errore. ``` TTL is not yet supported. ``` Per specificare valori TTL personalizzati per righe o colonne utilizzando `INSERT` le nostre `UPDATE` operazioni, devi prima abilitare TTL per la tabella. È possibile abilitare il TTL per una tabella utilizzando la `ttl` proprietà personalizzata. Per ulteriori informazioni sull'attivazione delle impostazioni TTL personalizzate per le tabelle, vedere. [Aggiorna la tabella con Time to Live (TTL) personalizzato](TTL-how-to-enable-custom-alter.md) ### Sto cercando di caricare dati sulla mia tabella Amazon Keyspaces e ricevo un errore sul superamento del numero di colonne **Stai caricando dati e hai superato il numero di colonne che possono essere aggiornate contemporaneamente.** Questo errore si verifica quando lo schema della tabella supera la dimensione massima di 350 KB. Per ulteriori informazioni, consulta [Quote per Amazon Keyspaces (per Apache Cassandra)](quotas.md). ### Sto cercando di eliminare i dati nella mia tabella Amazon Keyspaces e l'eliminazione non riesce per l'intervallo **Stai tentando di eliminare i dati tramite chiave di partizione e ricevi un errore di eliminazione dell'intervallo.** Questo errore si verifica quando si tenta di eliminare più di 1.000 righe in un'unica operazione di eliminazione. ``` Range delete requests are limited by the amount of items that can be deleted in a single range. ``` Per ulteriori informazioni, consulta [Eliminazione dell'intervallo](functional-differences.md#functional-differences.range-delete). Per eliminare più di 1.000 righe all'interno di una singola partizione, considera le seguenti opzioni. + Elimina per partizione: se la maggior parte delle partizioni è inferiore a 1.000 righe, puoi provare a eliminare i dati per partizione. Se le partizioni contengono più di 1.000 righe, prova invece a eliminarli tramite la colonna di clustering. + Elimina per colonna di raggruppamento: se il modello contiene più colonne di clustering, puoi utilizzare la gerarchia di colonne per eliminare più righe. Le colonne di clustering sono una struttura annidata ed è possibile eliminare molte righe agendo sulla colonna di primo livello. + Elimina per singola riga: è possibile scorrere le righe ed eliminare ogni riga utilizzando la relativa chiave primaria completa (colonne di partizione e colonne di raggruppamento). + Come best practice, valuta la possibilità di suddividere le righe tra le partizioni: in Amazon Keyspaces, ti consigliamo di distribuire la velocità effettiva tra le partizioni delle tabelle. Ciò distribuisce i dati e l'accesso in modo uniforme tra le risorse fisiche, garantendo la migliore velocità di trasmissione. Per ulteriori informazioni, consulta [Migliori pratiche di modellazione dei dati: consigli per la progettazione di modelli di dati](data-modeling.md). Prendi in considerazione anche i seguenti consigli quando pianifichi operazioni di eliminazione per carichi di lavoro pesanti. + Con Amazon Keyspaces, le partizioni possono contenere un numero praticamente illimitato di righe. Ciò consente di scalare le partizioni in modo «più ampio» rispetto alla tradizionale guida di Cassandra di 100 MB. Non è raro che le serie temporali o i registri crescano nel tempo oltre un gigabyte di dati. + Con Amazon Keyspaces, non ci sono strategie di compattazione o lapidi da prendere in considerazione quando è necessario eseguire operazioni di eliminazione per carichi di lavoro pesanti. Puoi eliminare tutti i dati che desideri senza influire sulle prestazioni di lettura.