Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Solución de problemas de Amazon Keyspaces (para Apache Cassandra)
En esta guía se describen pasos de solución de problemas para varios escenarios al trabajar con Amazon Keyspaces (para Apache Cassandra). Incluye información sobre cómo resolver errores generales, problemas de conexión, problemas de administración de la capacidad y errores del lenguaje de definición de datos (DDL).
+ **Errores generales**
+ Solución de problemas de excepciones de alto nivel como `NoNodeAvailableException`, `NoHostAvailableException` y `AllNodesFailedException`.
+ Aislamiento de errores subyacentes de las excepciones del controlador de Java.
+ Implementación de políticas de reintentos y configuración de conexiones correctamente.
+ **Problemas de conectividad**
+ Resolución de errores al conectarse a puntos de conexión de Amazon Keyspaces mediante `cqlsh` o controladores de cliente de Apache Cassandra.
+ Solución de problemas de conexiones a puntos de conexión de VPC, conexiones con Cassandra-stress y errores de configuración de IAM.
+ Administración de las pérdidas de conexión durante la importación de datos.
+ **Errores de administración de capacidad**
+ Reconocimiento y resolución de los errores de capacidad insuficiente relacionados con las tablas, las particiones y las conexiones.
+ Supervisión de las métricas relevantes de Amazon Keyspaces en Amazon CloudWatch Logs.
+ Optimización de las conexiones y el rendimiento para mejorar el desempeño.
+ **Errores de lenguaje de definición de datos (DDL)**
+ Solución de errores de creación, acceso o restauración de tablas y espacios de claves.
+ Administración de errores relacionados con la configuración personalizada del período de vida (TTL), los límites de columnas y las eliminaciones de rangos.
+ Consideraciones para las cargas de trabajo de borrado pesadas.
Para obtener una guía de solución de problemas específica para el acceso a IAM, consulte [Solución de problemas de identidad y acceso a Amazon Keyspaces](security_iam_troubleshoot.md). Para obtener más información sobre prácticas recomendadas de seguridad, consulte [Prácticas recomendadas de seguridad para Amazon Keyspaces](best-practices-security.md).
**Topics**
+ [Errores generales](troubleshooting.general.md)
+ [Errores de conexión](troubleshooting.connecting.md)
+ [Errores de administración de capacidad](troubleshooting.serverless.md)
+ [Errores de lenguaje de definición de datos](troubleshooting.cql.md)
# Solución de errores generales en Amazon Keyspaces
¿Ha recibido errores generales? A continuación se indican algunos problemas comunes y la forma de resolverlos.
## Errores generales
Recibe una de las siguientes excepciones de nivel superior que pueden producirse por muchos motivos diferentes.
+ `NoNodeAvailableException`
+ `NoHostAvailableException`
+ `AllNodesFailedException`
Estas excepciones las genera el controlador del cliente y pueden producirse al establecer la conexión de control o al realizar read/write/prepare/execute/batch solicitudes.
Cuando el error se produce al establecer la conexión de control, es una señal de que no se puede acceder a todos los puntos de contacto especificados en la aplicación. Cuando el error se produce al realizar read/write/prepare/execute las consultas, indica que se han agotado todos los reintentos de esa solicitud. Cada reintento se realiza en un nodo diferente cuando se utiliza la política de reintentos predeterminada.
### Cómo aislar el error subyacente de las excepciones de los controladores Java de nivel superior
Estos errores generales pueden deberse a problemas de conexión o al realizar read/write/prepare/execute operaciones. Cabe esperar que se produzcan errores transitorios en los sistemas distribuidos, y deben solucionarse reintentando la solicitud. El controlador Java no vuelve a intentarlo automáticamente cuando se producen errores de conexión, por lo que se recomienda implementar la política de reintentos al establecer la conexión del controlador en la aplicación. Para obtener una descripción detallada de las prácticas recomendadas para la conexión, consulte [Optimización de las conexiones de los controladores del cliente para el entorno sin servidor](connections.md).
De forma predeterminada, el controlador Java se establece en false `idempotence` para todas las solicitudes, lo que significa que el controlador Java no reintenta automáticamente las read/write/prepare solicitudes fallidas. Para configurar `idempotence` como `true` e indicarle al controlador que vuelva a intentar las solicitudes fallidas, puede hacerlo de diferentes maneras. Este es un ejemplo de cómo se puede configurar la idempotencia mediante programación para una sola solicitud en su aplicación Java.
```
Statement s = new SimpleStatement("SELECT * FROM my_table WHERE id = 1");
s.setIdempotent(true);
```
También puede establecer la idempotencia predeterminada mediante programación para toda la aplicación Java, tal y como se muestra en el siguiente ejemplo.
```
// 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
```
Otra recomendación es crear una política de reintentos en el nivel de la aplicación. En este caso, la aplicación debe detectar la `NoNodeAvailableException` y reintentar la solicitud. Recomendamos realizar 10 reintentos con un retroceso exponencial a partir de 10 ms y continuar hasta los 100 ms con un tiempo total de 1 segundo para todos los reintentos.
Otra opción es aplicar la política de reintentos exponenciales de Amazon Keyspaces al establecer la conexión del controlador Java disponible en [Github](https://github.com/aws-samples/amazon-keyspaces-java-driver-helpers/blob/main/src/main/java/com/aws/ssa/keyspaces/retry/AmazonKeyspacesExponentialRetryPolicy.java).
Confirme que ha establecido conexiones con más de un nodo cuando utilice la política de reintentos predeterminada. Para ello, utilice la siguiente consulta en Amazon Keyspaces.
```
SELECT * FROM system.peers;
```
Si la respuesta de esta consulta está vacía, esto indica que está trabajando con un único nodo para Amazon Keyspaces. Si utiliza la política de reintentos predeterminada, no se producirán reintentos porque el reintento predeterminado siempre se produce en un nodo diferente. Para obtener más información sobre cómo establecer conexiones a través de puntos de conexión de VPC, consulte [Configuración de conexiones sobre puntos de conexión de VPC en Amazon Keyspaces](connections.md#connections.VPCendpoints).
Para ver un step-by-step tutorial que muestra cómo establecer una conexión con Amazon Keyspaces mediante el controlador Cassandra de Datastax 4.x, consulte. [Step-by-step tutorial para conectarse a Amazon Keyspaces mediante el controlador DataStax Java 4.x para Apache Cassandra y el complemento de autenticación SigV4](using_java_driver.md#java_tutorial.SigV4)
# Solución de errores de conexión en Amazon Keyspaces
¿Tiene problemas para conectarse? A continuación se indican algunos problemas comunes y la forma de resolverlos.
## Errores al conectarse a un punto de conexión de Amazon Keyspaces
Las conexiones fallidas y los errores de conexión pueden dar lugar a diferentes mensajes de error. En la siguiente sección se describen los escenarios más comunes.
**Topics**
+ [No puedo conectarme a Amazon Keyspaces con cqlsh](#troubleshooting.connection.cqlsh)
+ [No puedo conectarme a Amazon Keyspaces con un controlador de cliente de Cassandra](#troubleshooting.connection.driver)
### No puedo conectarme a Amazon Keyspaces con cqlsh
**Está intentando conectarse a un punto de conexión de Amazon Keyspaces con cqlsh y la conexión falla con un `Connection error`.**
Si intenta conectarse a una tabla de Amazon Keyspaces y cqlsh no se ha configurado correctamente, la conexión falla. En la siguiente sección se ofrecen ejemplos de los problemas de configuración más comunes que causan errores de conexión al intentar establecer una conexión con cqlsh.
**nota**
Si intenta conectarse a Amazon Keyspaces desde una VPC, se requieren permisos adicionales. Para configurar correctamente una conexión utilizando puntos de conexión de VPC, siga los pasos indicados en el [Tutorial: Conéctese a Amazon Keyspaces mediante un punto de enlace de VPC de interfaz](vpc-endpoints-tutorial.md).
**Está intentando conectarse a Amazon Keyspaces con cqlsh, pero obtiene un error de conexión `timed out`.**
Esto podría deberse a que no ha suministrado el puerto correcto, lo que provoca el siguiente error.
```
# 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")})
```
Para resolver este problema, verifique que esté utilizando el puerto 9142 para la conexión.
**Está intentando conectarse a Amazon Keyspaces con cqlsh, pero obtiene un error `Name or service not known`.**
Esto podría deberse a que ha utilizado un punto de conexión que está mal escrito o que no existe. En el siguiente ejemplo, el nombre del punto de conexión está mal escrito.
```
# 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
```
Para resolver este problema al utilizar puntos de conexión públicos para conectarse, seleccione un punto de conexión disponible en [Puntos de conexión de servicio para Amazon Keyspaces](programmatic.endpoints.md) y compruebe que el nombre del punto de conexión no tenga ningún error. Si utiliza puntos de conexión de VPC para conectarse, compruebe que la información del punto de conexión de VPC sea correcta en la configuración de cqlsh.
**Está intentando conectarse a Amazon Keyspaces con cqlsh, pero recibe un error `OperationTimedOut`.**
Amazon Keyspaces requiere que se habilite SSL para las conexiones a fin de garantizar una seguridad sólida. Es posible que falte el parámetro SSL si recibe el siguiente error.
```
# 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',)})
#
```
Para resolver este problema, añada el siguiente indicador al comando de conexión de cqlsh.
```
--ssl
```
**Está intentando conectarse a Amazon Keyspaces con cqlsh, pero recibe un error `SSL transport factory requires a valid certfile to be specified`.**
En este caso, falta la ruta al SSL/TLS certificado, lo que provoca el siguiente error.
```
# 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.
#
```
Para resolver este problema, añada la ruta al certfile de su ordenador. Para obtener más información, consulte [Configuración manual de conexiones de `cqlsh` para TLS](programmatic.cqlsh.md#encrypt_using_tls).
```
certfile = path_to_file/keyspaces-bundle.pem
```
**Está intentando conectarse a Amazon Keyspaces con cqlsh, pero recibe un error `No such file or directory`.**
Este podría deberse a que la ruta al archivo de certificado en su ordenador es incorrecta, lo que provoca el siguiente error.
```
# 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')})
#
```
Para resolver este problema, compruebe que la ruta al archivo de certificado en su ordenador sea correcta. Para obtener más información, consulte [Configuración manual de conexiones de `cqlsh` para TLS](programmatic.cqlsh.md#encrypt_using_tls).
**Está intentando conectarse a Amazon Keyspaces con cqlsh, pero recibe un error `[X509] PEM lib`.**
Este podría ser el caso si el `pem` archivo de certificado SSL/TLS no es válido y se produce el siguiente error.
```
# 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)")})
#
```
Para resolver este problema, asegúrese de haber descargado los certificados digitales necesarios. Para obtener más información, consulte [Configuración manual de conexiones de `cqlsh` para TLS](programmatic.cqlsh.md#encrypt_using_tls).
**Está intentando conectarse a Amazon Keyspaces con cqlsh, pero recibe un error de SSL `unknown`.**
Este puede ser el caso si el `pem` archivo del certificado SSL/TLS está vacío y se produce el siguiente error.
```
# 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)")})
#
```
Para resolver este problema, asegúrese de haber descargado los certificados digitales necesarios. Puede confirmarlo siguiendo los pasos del tema siguiente[Configuración manual de conexiones de `cqlsh` para TLS](programmatic.cqlsh.md#encrypt_using_tls).
**Está intentando conectarse a Amazon Keyspaces con cqlsh, pero recibe un error `SSL: CERTIFICATE_VERIFY_FAILED`.**
Este podría deberse a que el archivo del certificado SSL/TLS no se pudo verificar, lo que provoca el siguiente error.
```
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)")})
```
Para resolver este problema, asegúrese de haber descargado los certificados digitales necesarios. Puede confirmarlo siguiendo los pasos del tema siguiente[Configuración manual de conexiones de `cqlsh` para TLS](programmatic.cqlsh.md#encrypt_using_tls).
**Está intentando conectarse a Amazon Keyspaces con cqlsh, pero recibe un error `Last error: timed out`.**
Esto podría deberse a que no configuró una regla de salida para Amazon Keyspaces en su grupo de seguridad de Amazon EC2, lo que provoca el siguiente error.
```
# 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")})
#
```
Para confirmar que este problema se debe a la configuración de la instancia Amazon EC2 y no`cqlsh`, puede intentar conectarse a su espacio de claves mediante AWS CLI, por ejemplo, el siguiente comando.
```
aws keyspaces list-tables --keyspace-name 'my_keyspace'
```
Si con este comando también se agota el tiempo de espera, la instancia de Amazon EC2 no está configurada correctamente.
Para confirmar que tienes permisos suficientes para acceder a Amazon Keyspaces, puedes usar AWS CloudShell para conectarte con. `cqlsh` Si se establecen esas conexiones, necesitará configurar la instancia de Amazon EC2.
Para resolver este problema, confirme que su instancia de Amazon EC2 tenga una regla de salida que permita el tráfico a Amazon Keyspaces. De no ser así, debe crear un nuevo grupo de seguridad para la instancia de EC2 y añadir una regla que permita el tráfico saliente a los recursos de Amazon Keyspaces. Para actualizar la regla de salida de modo que permita el tráfico a Amazon Keyspaces, seleccione **CQLSH/CASSANDRA** en el menú desplegable **Tipo**.
Tras crear el nuevo grupo de seguridad con la regla de tráfico saliente, debe añadirlo a la instancia. Seleccione la instancia y, a continuación, elija **Acciones**, **Seguridad**, y finalmente **Cambiar grupos de seguridad**. Agregue el nuevo grupo de seguridad con la regla de salida, pero asegúrese de que el grupo predeterminado también permanezca disponible.
Para obtener más información sobre cómo ver y editar las reglas de salida de EC2, consulte [Adición de reglas a un grupo de seguridad en la Guía del usuario de Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/working-with-security-groups.html#adding-security-group-rule).
**Está intentando conectarse a Amazon Keyspaces con cqlsh, pero recibe un error `Unauthorized`.**
Este podría deberse a que le faltan permisos de Amazon Keyspaces en la política de usuario de IAM, lo que provoca el siguiente error.
```
# 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."',)})
#
```
Para resolver este problema, asegúrese de que el usuario de IAM `testuser-at-12345678910` tenga permisos para acceder a Amazon Keyspaces. Para ver ejemplos de políticas de IAM que concedan acceso a Amazon Keyspaces, consulte [Ejemplos de políticas basadas en identidades de Amazon Keyspaces](security_iam_id-based-policy-examples.md).
Para obtener una guía de solución de problemas específica para el acceso a IAM, consulte [Solución de problemas de identidad y acceso a Amazon Keyspaces](security_iam_troubleshoot.md).
**Está intentando conectarse a Amazon Keyspaces con cqlsh, pero recibe un error `Bad credentials`.**
Este podría deberse a que el nombre de usuario o la contraseña son incorrectos, lo que provoca el siguiente error.
```
# 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"',)})
#
```
Para resolver este problema, compruebe que el *USERNAME* y *PASSWORD* del código coinciden con el nombre de usuario y la contraseña que obtuvo al generar las credenciales específicas del [servicio](programmatic.credentials.ssc.md).
**importante**
Si sigue viendo errores al intentar conectarse con cqlsh, vuelva a ejecutar el comando con la opción `--debug` e incluya la salida detallada al contactar con Soporte.
### No puedo conectarme a Amazon Keyspaces con un controlador de cliente de Cassandra
En las siguientes secciones se muestran los errores más comunes al conectarse con un controlador de cliente de Cassandra.
**Estás intentando conectarte a una tabla de Amazon Keyspaces mediante el controlador DataStax Java, pero aparece un `NodeUnavailableException` error.**
Si se interrumpe la conexión en la que se intenta realizar la solicitud, se produce el siguiente error.
```
[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)]
```
Para resolver este problema, busque el valor de latido y bájelo a 30 segundos si es más alto.
```
advanced.heartbeat.interval = 30 seconds
```
A continuación, busque el tiempo de espera asociado y asegúrese de que el valor esté establecido en al menos 5 segundos.
```
advanced.connection.init-query-timeout = 5 seconds
```
**Está intentando conectarse a una tabla de Amazon Keyspaces con un controlador y el complemento SigV4, pero recibe un error `AttributeError`.**
Si las credenciales no están correctamente configuradas, se produce el siguiente error.
```
cassandra.cluster.NoHostAvailable: (‘Unable to connect to any servers’,
{‘44.234.22.154:9142’: AttributeError(“‘NoneType’ object has no attribute ‘access_key’“)})
```
Para resolver este problema, verifique que esté pasando las credenciales asociadas a su usuario o rol de IAM al utilizar el complemento SigV4. El complemento SigV4 requiere las siguientes credenciales.
+ `AWS_ACCESS_KEY_ID`— Especifica una clave de AWS acceso asociada a un usuario o rol de IAM.
+ `AWS_SECRET_ACCESS_KEY`: especifica la clave secreta asociada a la clave de acceso. Se trata básicamente de la contraseña de la clave de acceso.
Para obtener más información sobre claves de acceso y el complemento SigV4, consulte [Creación y configuración de AWS credenciales para Amazon Keyspaces](access.credentials.md).
**Está intentando conectarse a una tabla de Amazon Keyspaces con un controlador, pero recibe un error `PartialCredentialsError`.**
Si falta la `AWS_SECRET_ACCESS_KEY`, puede producirse el siguiente error.
```
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’)})
```
Para resolver este problema, compruebe que este pasando tanto el `AWS_ACCESS_KEY_ID` como la `AWS_SECRET_ACCESS_KEY` al utilizar el complemento SigV4. Para obtener más información sobre claves de acceso y el complemento SigV4, consulte [Creación y configuración de AWS credenciales para Amazon Keyspaces](access.credentials.md).
**Está intentando conectarse a una tabla de Amazon Keyspaces con un controlador, pero recibe un error `Invalid signature`.**
Esto podría ocurrir si alguno de los componentes necesarios para la firma es incorrecto o no está definido correctamente para la sesión.
+ `AWS_ACCESS_KEY_ID`
+ `AWS_SECRET_ACCESS_KEY`
+ `AWS_DEFAULT_REGION`
El siguiente error es un ejemplo de claves de acceso no válidas.
```
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”’)})
```
Para resolver este problema, compruebe que las claves de acceso y las se Región de AWS hayan configurado correctamente para que el complemento SiGv4 acceda a Amazon Keyspaces. Para obtener más información sobre claves de acceso y el complemento SigV4, consulte [Creación y configuración de AWS credenciales para Amazon Keyspaces](access.credentials.md).
#### Mi punto de conexión de VPC no funciona correctamente
**Está intentando conectarse a Amazon Keyspaces con puntos de conexión de VPC, pero recibe errores de asignación de tokens o experimenta un bajo rendimiento.**
Este podría deberse a que la conexión del punto de conexión de VPC no está configurada correctamente.
Para resolver estos problemas, verifique los siguientes detalles de configuración. Para seguir un step-by-step tutorial sobre cómo configurar una conexión a través de puntos de enlace de la interfaz de VPC para Amazon Keyspaces, consulte. [Tutorial: Conéctese a Amazon Keyspaces mediante un punto de enlace de VPC de interfaz](vpc-endpoints-tutorial.md)
1. Confirme que la entidad de IAM utilizada para conectarse a Amazon Keyspaces read/write tenga acceso a la tabla de usuarios y acceso de lectura a las tablas del sistema, como se muestra en el siguiente ejemplo.
```
{
"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. Confirme que la entidad de IAM utilizada para conectarse a Amazon Keyspaces disponga de los permisos de lectura necesarios para acceder a la información del punto de conexión de VPC en su instancia de Amazon EC2, como se muestra en el siguiente ejemplo.
```
{
"Version":"2012-10-17",
"Statement":[
{
"Sid":"ListVPCEndpoints",
"Effect":"Allow",
"Action":[
"ec2:DescribeNetworkInterfaces",
"ec2:DescribeVpcEndpoints"
],
"Resource":"*"
}
]
}
```
**nota**
Las políticas administradas `AmazonKeyspacesReadOnlyAccess_v2` y `AmazonKeyspacesFullAccess` incluyen los permisos necesarios para permitir que Amazon Keyspaces acceda a la instancia de Amazon EC2 para leer la información sobre los puntos de conexión de VPC de interfaz disponibles.
Para obtener más información sobre los puntos de conexión de VPC, consulte [Uso de puntos de conexión de VPC de interfaz para Amazon Keyspaces](vpc-endpoints.md#using-interface-vpc-endpoints).
1. Confirme que la configuración SSL del controlador Java establezca la validación del nombre de host en false, como se muestra en este ejemplo.
```
hostname-validation = false
```
Para obtener más información sobre la configuración del controlador, consulte [Paso 2: configurar el controlador](using_java_driver.md#java_tutorial.driverconfiguration).
1. Para confirmar que el punto de conexión de VPC se haya configurado correctamente, puede ejecutar la siguiente instrucción desde *dentro* de su VPC.
**nota**
No puede utilizar su entorno de desarrollo local o el editor CQL de Amazon Keyspaces para confirmar esta configuración, dado que utilizan un punto de conexión público.
```
SELECT peer FROM system.peers;
```
El resultado debería tener un aspecto similar al de este ejemplo y devolver entre 2 y 6 nodos con IPv4 direcciones privadas al conectarse desde una IPv4 red, según la configuración de la VPC y AWS la región.
```
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)
```
#### No puedo conectarme utilizando `cassandra-stress`
**Está intentando conectarse a Amazon Keyspaces con el comando `cassandra-stress`, pero recibe un error `SSL context`.**
Esto ocurre al intentar conectarse a Amazon Keyspaces, pero no tiene correctamente configurado trustStore. Amazon Keyspaces requiere el uso de Seguridad de la capa de transporte (TLS) para ayudar a proteger las conexiones con los clientes.
En este caso, aparece el siguiente error.
```
Error creating the initializing the SSL Context
```
Para resolver este problema, siga las instrucciones para configurar un trustStore como se muestra en este tema: [Antes de empezar](using_java_driver.md#using_java_driver.BeforeYouBegin).
Una vez configurado el trustStore, debería poder conectarse con el siguiente 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"
```
#### No puedo conectarme utilizando identidades de IAM
**Está intentando conectarse a una tabla de Amazon Keyspaces utilizando una identidad de IAM, pero recibe un error `Unauthorized`.**
Esto ocurre al intentar conectarse a una tabla de Amazon Keyspaces utilizando una identidad de IAM (por ejemplo, un usuario de IAM) sin antes implementar la política y conceder al usuario los permisos necesarios.
En este caso, aparece el siguiente error.
```
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."',)})
```
Para resolver este problema, verifique los permisos del usuario de IAM. Para conectarse con un controlador estándar, el usuario debe tener al menos `SELECT` acceso a las tablas del sistema, ya que la mayoría de los controladores leen el sistema keyspaces/tables cuando establecen la conexión.
Para ver ejemplos de políticas de IAM que concedan acceso a las tablas del sistema y del usuario de Amazon Keyspaces, consulte [Acceso a las tablas de Amazon Keyspaces](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-access-one-table).
Para revisar la sección de solución de problemas específicos de IAM, consulte [Solución de problemas de identidad y acceso a Amazon Keyspaces](security_iam_troubleshoot.md).
#### Estoy intentando importar datos con cqlsh y se pierde la conexión con mi tabla de Amazon Keyspaces
**Está intentando cargar datos en Amazon Keyspaces con cqlsh, pero recibe errores de conexión.**
La conexión a Amazon Keyspaces falla una vez que el cliente cqlsh recibe tres errores consecutivos de cualquier tipo procedentes del servidor. El cliente cqlsh falla con el siguiente mensaje.
```
Failed to import 1 rows: NoHostAvailable - , will retry later, attempt 3 of 100
```
Para resolver este error, debe asegurarse de que los datos que se vayan a importar coincidan con el esquema de la tabla en Amazon Keyspaces. Revise el archivo de importación en busca de errores de análisis sintáctico. Puede intentar utilizar una única fila de datos mediante una instrucción INSERT para aislar el error.
El cliente intentará restablecer la conexión de forma automática.
# Solución de errores de administración de capacidad en Amazon Keyspaces
¿Tiene problemas con la capacidad sin servidor? A continuación se indican algunos problemas comunes y la forma de resolverlos.
## Errores de capacidad sin servidor
En esta sección se describe la forma de reconocer los errores relacionados con la administración de capacidad sin servidor y cómo resolverlos. Por ejemplo, podría observar eventos de capacidad insuficiente cuando su aplicación excede su capacidad de rendimiento aprovisionada.
Dado que Apache Cassandra es un software basado en clústeres que está diseñado para ejecutarse en una flota de nodos, no dispone de mensajes de excepción relacionados con características sin servidor como la capacidad de rendimiento. La mayoría de los controladores solo entienden los códigos de error que están disponibles en Apache Cassandra, por lo que Amazon Keyspaces utiliza ese mismo conjunto de códigos de error para mantener la compatibilidad.
Para asignar los errores de Cassandra a los eventos de capacidad subyacentes, puede utilizar Amazon CloudWatch para supervisar las métricas relevantes de Amazon Keyspaces. Los eventos de capacidad insuficiente que dan lugar a errores del lado del cliente se pueden clasificar en estos tres grupos en función del recurso que esté causando el evento:
+ **Tabla**: si elige el modo de capacidad **Aprovisionada** para una tabla y su aplicación supera el rendimiento aprovisionado, es posible que observe errores de capacidad insuficiente. Para obtener más información, consulte [Configurar los modos de read/write capacidad en Amazon Keyspaces](ReadWriteCapacityMode.md).
+ **Partición**: es posible que se produzcan eventos de capacidad insuficiente si el tráfico en una partición determinada supera los 3000 o 1000. RCUs WCUs Como práctica recomendada, sugerimos distribuir el tráfico de forma uniforme entre las particiones. Para obtener más información, consulte [Prácticas recomendadas de modelado de datos: recomendaciones para diseñar modelos de datos](data-modeling.md).
+ **Conexión**: es posible que experimente un rendimiento insuficiente si supera la cuota para el número máximo de operaciones por segundo, por conexión. Para aumentar el rendimiento, puede aumentar el número de conexiones predeterminadas al configurar la conexión con el controlador.
Para aprender cómo configurar conexiones para Amazon Keyspaces, consulte [Configuración de conexiones en Amazon Keyspaces](connections.md#connections.howtoconfigure). Para obtener más información sobre cómo optimizar conexiones con puntos de conexión de VPC, consulte [Configuración de conexiones sobre puntos de conexión de VPC en Amazon Keyspaces](connections.md#connections.VPCendpoints).
Para determinar qué recurso está causando el evento de capacidad insuficiente que devuelve el error del lado del cliente, puede consultar el panel de control en la consola de Amazon Keyspaces. De forma predeterminada, la consola proporciona una vista agregada de las CloudWatch métricas más comunes relacionadas con la capacidad y el tráfico en la sección **Capacidad y métricas relacionadas** de la pestaña **Capacidad** de la tabla.
Para crear tu propio panel de control con Amazon CloudWatch, consulta las siguientes métricas de Amazon Keyspaces.
+ `PerConnectionRequestRateExceeded`: solicitudes a Amazon Keyspaces que superan la cuota de tasa de solicitudes por conexión. Cada conexión de cliente a Amazon Keyspaces puede admitir hasta 3000 solicitudes CQL por segundo. Puede realizar más de 3000 solicitudes por segundo creando varias conexiones.
+ `ReadThrottleEvents`: solicitudes a Amazon Keyspaces que superan la capacidad de lectura de una tabla.
+ `StoragePartitionThroughputCapacityExceeded`: solicitudes a una partición de almacenamiento de Amazon Keyspaces que superan la capacidad de rendimiento de la partición. Las particiones de almacenamiento de Amazon Keyspaces pueden admitir hasta 1000 WCU/WRU por segundo y 3000 RCU/RRU por segundo. Para mitigar estas excepciones, le recomendamos que revise su modelo de datos para distribuir el read/write tráfico entre más particiones.
+ `WriteThrottleEvents`: solicitudes a Amazon Keyspaces que superan la capacidad de escritura de una tabla.
Para obtener más información CloudWatch, consulte[Supervisión de Amazon Keyspaces con Amazon CloudWatch](monitoring-cloudwatch.md). Para obtener una lista de todas las CloudWatch métricas disponibles para Amazon Keyspaces, consulte. [Métricas y dimensiones de Amazon Keyspaces](metrics-dimensions.md)
**nota**
[Para empezar con un panel personalizado que muestre todas las métricas observadas habitualmente en Amazon Keyspaces, puede utilizar una CloudWatch plantilla prediseñada disponible GitHub en el AWS repositorio de muestras.](https://github.com/aws-samples/amazon-keyspaces-cloudwatch-cloudformation-templates)
**Topics**
+ [Errores del cliente](#troubleshooting.serverless.clientside)
+ [Errores de tiempo de espera de escritura durante la importación de datos](#troubleshooting.serverless.writetimeout)
+ [Tamaño de almacenamiento de un espacio de claves o una tabla](#troubleshooting.serverless.storagesize)
### Estoy recibiendo errores de capacidad insuficiente `NoHostAvailable` desde mi controlador de cliente
**Está viendo excepciones `Read_Timeout` o `Write_Timeout` para una tabla.**
Intentar escribir o leer repetidamente en una tabla de Amazon Keyspaces con capacidad insuficiente puede dar lugar a errores del lado del cliente específicos del controlador.
Úselo CloudWatch para monitorear las métricas de rendimiento aprovisionadas y reales, así como los eventos de capacidad insuficiente para la tabla. Por ejemplo, una solicitud de lectura que no tenga suficiente capacidad de rendimiento falla con una excepción `Read_Timeout` y se contabiliza en la métrica `ReadThrottleEvents`. Una solicitud de escritura que no tenga suficiente capacidad de rendimiento falla con una excepción `Write_Timeout` y se contabiliza en la métrica `WriteThrottleEvents`. Para obtener más información sobre estas métricas, consulte [Métricas y dimensiones de Amazon Keyspaces](metrics-dimensions.md).
Para resolver estos problemas, considere una de las siguientes opciones.
+ Aumente el *rendimiento aprovisionado* para la tabla, que es la cantidad máxima de capacidad de rendimiento que puede consumir una aplicación. Para obtener más información, consulte [Unidades de capacidad de lectura y de escritura](ReadWriteCapacityMode.Provisioned.md#ReadWriteCapacityMode.Provisioned.Units).
+ Deje que el servicio administre la capacidad de rendimiento en su nombre con escalado automático. Para obtener más información, consulte [Administración automática de la capacidad de rendimiento con el escalado automático de Amazon Keyspaces](autoscaling.md).
+ Elija el modo de capacidad **Bajo demanda** para la tabla. Para obtener más información, consulte [Configuración del modo de capacidad bajo demanda](ReadWriteCapacityMode.OnDemand.md).
Si necesita aumentar la cuota de capacidad predeterminada para su cuenta, consulte [Cuotas para Amazon Keyspaces (para Apache Cassandra)](quotas.md).
**Está viendo errores relacionados con exceso de capacidad de la partición.**
Cuando aparece el error `StoragePartitionThroughputCapacityExceeded`, la capacidad de la partición se ha excedido temporalmente. Esto podría administrarse automáticamente mediante el uso de capacidad adaptativa o de capacidad bajo demanda. Te recomendamos revisar tu modelo de datos para distribuir el read/write tráfico entre más particiones y así mitigar estos errores. Las particiones de almacenamiento de Amazon Keyspaces pueden admitir hasta 1000 WCU/WRU por segundo y 3000 RCU/RRU por segundo. Para obtener más información sobre cómo mejorar su modelo de datos para distribuir read/write el tráfico entre más particiones, consulte[Prácticas recomendadas de modelado de datos: recomendaciones para diseñar modelos de datos](data-modeling.md).
Las excepciones `Write_Timeout` también podrían deberse a una tasa elevada de operaciones de escritura concurrentes que incluyan datos estáticos y no estáticos en la misma partición lógica. Si se espera que el tráfico ejecute varias operaciones de escritura concurrentes que incluyan datos estáticos y no estáticos dentro de la misma partición lógica, recomendamos escribir los datos estáticos y no estáticos por separado. Escribir los datos por separado también ayuda a optimizar los costos de rendimiento.
**Está viendo errores relacionados con una tasa de solicitudes de conexión excedida.**
La aparición de `PerConnectionRequestRateExceeded` se debe a una de las siguientes causas.
+ Es posible que no tenga suficientes conexiones configuradas por sesión.
+ Es posible que esté recibiendo menos conexiones que pares disponibles, dado que no tiene configurados correctamente los permisos del punto de conexión de VPC. Para obtener más información sobre las políticas de punto de conexión de VPC, consulte [Uso de puntos de conexión de VPC de interfaz para Amazon Keyspaces](vpc-endpoints.md#using-interface-vpc-endpoints).
+ Si utiliza un controlador 4.x, compruebe si la validación del nombre de host está habilitada. El controlador habilita la verificación del nombre de host TLS de forma predeterminada. Esta configuración hace que Amazon Keyspaces aparezca como un clúster de nodo único ante el controlador. Le recomendamos que desactive la verificación de nombre de host.
Le recomendamos que siga estas prácticas recomendadas para garantizar la optimización de sus conexiones y su rendimiento:
+ **Configure el ajuste de rendimiento de las consultas CQL.**
Amazon Keyspaces admite hasta 3000 consultas CQL por conexión TCP por segundo, pero no hay límite en el número de conexiones que un controlador puede establecer.
La mayoría de los controladores de código abierto para Cassandra establecen un grupo de conexiones a Cassandra y equilibran la carga de consultas sobre ese grupo de conexiones. Amazon Keyspaces expone 9 direcciones IP homólogas a los conductores. El comportamiento predeterminado de la mayoría de los controladores es establecer una única conexión con cada dirección IP homóloga. Por lo tanto, el rendimiento máximo de consultas CQL de un controlador que utilice la configuración predeterminada será de 27 000 consultas CQL por segundo.
Para aumentar esta cifra, le recomendamos que aumente el número de conexiones por dirección IP que su controlador mantiene en su grupo de conexiones. Por ejemplo, si establece el máximo de conexiones por dirección IP en 2, duplicará el rendimiento máximo de su controlador a 54 000 consultas CQL por segundo.
+ **Optimice sus conexiones de nodo único.**
De forma predeterminada, la mayoría de los controladores de código abierto para Cassandra establecen una o más conexiones con cada dirección IP anunciada en la tabla `system.peers` al establecerse una sesión. Sin embargo, determinadas configuraciones pueden hacer que un controlador se conecte a una única dirección IP de Amazon Keyspaces. Esto puede suceder si el controlador intenta validar el nombre de host SSL de los nodos homólogos (por ejemplo, los controladores DataStax Java) o cuando se conecta a través de un punto final de VPC.
Para obtener la misma disponibilidad y rendimiento que un controlador con conexiones a varias direcciones IP, le recomendamos que haga lo siguiente:
+ Aumente el número de conexiones por IP a 9 o más en función del rendimiento deseado del cliente.
+ Cree una política de reintentos personalizada que garantice que los reintentos se ejecuten en el mismo nodo. Para obtener más información, consulte
[Configuración de la política de reintentos para las conexiones en Amazon Keyspaces](connections.md#connections.retry-policies).
+ Si utiliza puntos de conexión de VPC, conceda a la entidad de IAM que se utilice para conectarse a Amazon Keyspaces permisos de acceso para consultar en su VPC la información sobre el punto de conexión y la interfaz de red. Esto mejora el equilibrio de carga y aumenta read/write el rendimiento. Para obtener más información, consulte [Relleno de entradas de la tabla `system.peers` con información del punto de conexión de VPC de interfaz](vpc-endpoints.md#system_peers).
### Estoy recibiendo errores de tiempo de espera de escritura durante la importación de datos
**Está recibiendo un error de tiempo de espera al cargar datos con el comando de `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 utiliza las excepciones `ReadTimeout` y `WriteTimeout` para indicar cuándo falla una solicitud de escritura debido a una capacidad de rendimiento insuficiente. Para ayudar a diagnosticar las excepciones de capacidad insuficiente, Amazon Keyspaces publica las siguientes métricas en Amazon. CloudWatch
+ `WriteThrottleEvents`
+ `ReadThrottledEvents`
+ `StoragePartitionThroughputCapacityExceeded`
Para resolver los errores de capacidad insuficiente durante una carga de datos, reduzca la tasa de escritura por trabajador o la tasa de ingesta total y, a continuación, vuelva a intentar cargar las filas. Para obtener más información, consulte [Paso 4: Configurar los ajustes de `cqlsh COPY FROM`](bulk-upload-config.md). Si busca una opción de carga de datos más sólida, considere la posibilidad de utilizarla DSBulk, que está disponible en el [GitHub repositorio](https://github.com/datastax/dsbulk). Para step-by-step obtener instrucciones, consulte[Tutorial: Carga de datos en Amazon Keyspaces mediante DSBulk](dsbulk-upload.md).
### No puedo ver el tamaño real de almacenamiento de un espacio de claves o una tabla
**No puede ver el tamaño real de almacenamiento del espacio de claves o de la tabla.**
Para obtener más información sobre el tamaño de almacenamiento de la tabla, consulte [Evaluación de los costos en el nivel de tabla](CostOptimization_TableLevelCostAnalysis.md). También puede estimar el tamaño de almacenamiento a partir del cálculo de tamaño de fila de una tabla. Puede encontrar instrucciones detalladas para calcular el tamaño de fila en [Estimación del tamaño de las filas en Amazon Keyspaces](calculating-row-size.md).
# Solución de errores de lenguaje de definición de datos en Amazon Keyspaces
¿Tiene problemas para crear recursos? A continuación se indican algunos problemas comunes y la forma de resolverlos.
## Errores de lenguaje de definición de datos
Amazon Keyspaces realiza operaciones de lenguaje de definición de datos (DDL) de forma asíncrona, por ejemplo, creando y eliminando espacios de claves y tablas. Si una aplicación intenta utilizar el recurso antes de que esté listo, la operación falla.
Puede supervisar el estado de creación de los nuevos espacios clave y tablas en el Consola de administración de AWS, lo que indica cuándo un espacio clave o una tabla están pendientes o activos. También puede monitorear el estado de creación de un nuevo espacio de claves o tabla mediante programación, consultando la tabla de esquemas del sistema. Un espacio de claves o tabla se hace visible en el esquema del sistema cuando está listo para su uso.
**nota**
Para optimizar la creación de espacios de claves mediante esta utilidad CloudFormation, puede convertir los scripts de CQL en plantillas. CloudFormation [La herramienta está disponible en el GitHub repositorio.](https://github.com/aws/amazon-keyspaces-cql-to-cfn-converter)
**Topics**
+ [Errores de creación de espacios de claves](#troubleshooting.cql.keyspace)
+ [Errores de creación de tablas](#troubleshooting.cql.table)
+ [Estoy intentando restaurar una tabla mediante la point-in-time recuperación de Amazon Keyspaces (PITR), pero la restauración falla](#troubleshooting.cql.pitr)
+ [Estoy intentando editar la configuración personalizada de Time to Live (TTL), pero la operación no funciona INSERT/UPDATE](#troubleshooting.cql.ttl)
+ [Exceso de columnas](#troubleshooting.cql.upload)
+ [Error de rango de eliminación](#troubleshooting.cql.rangedelete)
### He creado un nuevo espacio de claves, pero no puedo verlo ni acceder al mismo
**Está recibiendo errores de su aplicación que intenta acceder a un nuevo espacio de claves.**
Si intenta acceder a un espacio de claves de Amazon Keyspaces recién creado que aún se esté creando de forma asíncrona, recibirá un error. A continuación, se muestra un ejemplo de error.
```
InvalidRequest: Error from server: code=2200 [Invalid query] message="unconfigured keyspace mykeyspace"
```
El patrón de diseño recomendado para comprobar cuándo un nuevo espacio de claves está listo para su uso es sondear las tablas de esquema del sistema de Amazon Keyspaces (system\$1schema\$1mcs.\$1).
Para obtener más información, consulte [Comprobación del estado de creación de los espacios de claves en Amazon Keyspaces](keyspaces-create.md).
### He creado una nueva tabla, pero no puedo verla ni acceder a la misma
**Está recibiendo errores de su aplicación que intenta acceder a una nueva tabla.**
Si intenta acceder a una tabla de Amazon Keyspaces recién creada que aún se esté creando de forma asíncrona, obtendrá un error. Por ejemplo, al intentar consultar una tabla que aún no esté disponible se produce un error `unconfigured table`.
```
InvalidRequest: Error from server: code=2200 [Invalid query] message="unconfigured table mykeyspace.mytable"
```
Al intentar visualizar la tabla con `sync_table()` se produce un error `KeyError`.
```
KeyError: 'mytable'
```
El patrón de diseño recomendado para comprobar cuándo una nueva tabla está lista para su uso es sondear las tablas de esquema del sistema de Amazon Keyspaces (system\$1schema\$1mcs.\$1).
Este es un ejemplo de salida para una tabla que se está creando.
```
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)
```
Este es un ejemplo de salida para una tabla que está activa.
```
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)
```
Para obtener más información, consulte [Comprobación del estado de creación de las tablas en Amazon Keyspaces](tables-create.md).
### Estoy intentando restaurar una tabla mediante la point-in-time recuperación de Amazon Keyspaces (PITR), pero la restauración falla
Si está intentando restaurar una tabla de Amazon Keyspaces con point-in-time recuperación (PITR) y observa que el proceso de restauración comienza pero no se completa correctamente, es posible que no haya configurado todos los permisos necesarios para el proceso de restauración para esta tabla concreta.
Además de los permisos de usuario, Amazon Keyspaces podría requerir permisos para realizar acciones durante el proceso de restauración en nombre de su entidad principal. Este es el caso si la tabla está cifrada con una clave administrada por el cliente, o si está utilizando políticas de IAM que restrinjan el tráfico entrante.
Por ejemplo, si utiliza claves de condición en su política de IAM para restringir el tráfico de origen a puntos de conexión o rangos de IP específicos, la operación de restauración falla. Para permitir que Amazon Keyspaces realice la operación de restauración de tablas en nombre de su entidad principal, debe añadir una clave de condición global `aws:ViaAWSService` en la política de IAM.
Para obtener más información sobre los permisos para restaurar tablas, consulte [Configuración de los permisos de IAM para la restauración de tablas con la PITR de Amazon Keyspaces](howitworks_restore_permissions.md).
### Estoy intentando editar la configuración personalizada de Time to Live (TTL), pero la operación no funciona INSERT/UPDATE
Al intentar insertar o actualizar un valor TTL personalizado, la operación podría fallar con el siguiente error.
```
TTL is not yet supported.
```
Para especificar valores TTL personalizados para filas o columnas mediante las operaciones `INSERT` o `UPDATE`, primero debe habilitar TTL para la tabla. Puede habilitar TTL para una tabla mediante la propiedad personalizada `ttl`.
Para obtener más información sobre cómo habilitar los ajustes de TTL personalizados para tablas, consulte [Actualización de una tabla con un período de vida (TTL) personalizado](TTL-how-to-enable-custom-alter.md).
### Estoy intentando cargar datos en mi tabla de Amazon Keyspaces y obtengo un error de exceso del número de columnas
**Está cargando datos y ha superado el número de columnas que se pueden actualizar simultáneamente.**
Este error se produce cuando el esquema de su tabla supera el tamaño máximo de 350 KB. Para obtener más información, consulte [Cuotas para Amazon Keyspaces (para Apache Cassandra)](quotas.md).
### Estoy intentando eliminar datos en mi tabla Amazon Keyspaces y la eliminación falla para el rango
**Está intentando eliminar datos por clave de partición y recibe un error de eliminación de rango.**
Este error se produce al intentar eliminar más de 1000 filas en una sola operación de eliminación.
```
Range delete requests are limited by the amount of items that can be deleted in a single range.
```
Para obtener más información, consulte [Eliminación de rangos](functional-differences.md#functional-differences.range-delete).
Para eliminar más de 1000 filas en una única partición, considere las siguientes opciones.
+ Eliminar por partición: si la mayoría de las particiones tienen menos de 1000 filas, puede intentar eliminar los datos por partición. Si las particiones contienen más de 1000 filas, intente en cambio eliminar por la columna de agrupación.
+ Eliminar por columna de agrupación: si su modelo contiene varias columnas de agrupación, puede utilizar la jerarquía de columnas para eliminar múltiples filas. Las columnas de agrupación son una estructura anidada y puede eliminar muchas filas operando respecto a la columna de nivel superior.
+ Eliminar por fila individual: puede iterar por las filas y eliminar cada fila por su clave principal completa (columnas de partición y columnas de agrupación).
+ Como práctica recomendada, considere la posibilidad de dividir las filas en particiones. En Amazon Keyspaces, le recomendamos que distribuya el rendimiento entre las particiones de las tablas. De este modo, los datos y el acceso se distribuyen uniformemente entre los recursos físicos, lo que proporciona el mejor rendimiento. Para obtener más información, consulte [Prácticas recomendadas de modelado de datos: recomendaciones para diseñar modelos de datos](data-modeling.md).
Considere también las siguientes recomendaciones al planificar operaciones de eliminación para cargas de trabajo pesadas.
+ Con Amazon Keyspaces, las particiones pueden contener un número prácticamente ilimitado de filas. Esto le permite escalar particiones “más amplias” que la orientación tradicional de Cassandra de 100 MB. No es raro que las series temporales o los registros de transacciones crezcan más de un gigabyte de datos en el tiempo.
+ Con Amazon Keyspaces, no hay estrategias de compactación ni lápidas que tener en cuenta cuando deba realizar operaciones de eliminación para cargas de trabajo pesadas. Puede eliminar todos los datos que desee sin que ello afecte al rendimiento de la lectura.