Resolución de problemas

Una vez finalizada la carga de datos, compruebe si se han omitido filas. Para ello, navegue hasta el directorio fuente del CSV archivo fuente y busque un archivo con el siguiente nombre.

import_yourcsvfilename.err.timestamp.csv

cqlsh escribe las filas de datos omitidas en un archivo con ese nombre. Si el archivo existe en su directorio de origen y contiene datos, estas filas no se cargaron en Amazon Keyspaces. Para reintentar estas filas, compruebe primero si se ha producido algún error durante la carga y ajuste los datos en consecuencia. Para reintentar estas filas, puede volver a ejecutar el proceso.

Errores comunes

Los motivos más comunes por los que no se cargan las filas son errores de capacidad y errores de análisis sintáctico.

Errores de solicitud no válida al cargar datos en Amazon Keyspaces

En el siguiente ejemplo, la tabla de origen contiene una columna de contador, lo que da lugar a llamadas por lotes registradas con el comando COPY de cqlsh. Amazon Keyspaces no admite llamadas por lotes registradas.

Failed to import 10 rows: InvalidRequest - Error from server: code=2200 [Invalid query] message=“Only UNLOGGED Batches are supported at this time.“,  will retry later, attempt 22 of 25

Para resolver este error, utilice DSBulk para migrar los datos. Para obtener más información, consulte Tutorial: Carga de datos en Amazon Keyspaces mediante DSBulk.

Errores del analizador de sintaxis al cargar datos en Amazon Keyspaces

El siguiente ejemplo muestra una fila omitida debido a un ParseError.

Failed to import 1 rows: ParseError - Invalid ... – 

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.

Errores de capacidad al cargar datos en Amazon Keyspaces

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 WriteThrottleEvents y elabora ReadThrottledEvents métricas en Amazon. CloudWatch Para obtener más información, consulte Supervisión de Amazon Keyspaces con Amazon CloudWatch.

Errores de cqlsh al cargar datos en Amazon Keyspaces

Como ayuda para solucionar los errores de cqlsh, vuelva a ejecutar el comando que falla con la bandera --debug.

En caso de utilizar una versión incompatible de cqlsh, verá el siguiente error.

AttributeError: 'NoneType' object has no attribute 'is_up'
Failed to import 3 rows: AttributeError - 'NoneType' object has no attribute 'is_up',  given up after 1 attempts

Confirme que la versión de cqlsh instalada sea correcta; para ello, ejecute el siguiente comando.

cqlsh --version

Debería ver algo similar a lo siguiente como salida.

cqlsh 5.0.1

Si utiliza Windows, sustituya todas las instancias de cqlsh con cqlsh.bat. Por ejemplo, para comprobar la versión de cqlsh en Windows, ejecute el siguiente comando.

cqlsh.bat --version

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 sola fila de datos mediante una INSERT declaración para aislar el error.

El cliente intentará restablecer la conexión de forma automática.