Versión 2.0: Guía de solución de problemas de BigQuery Connector para SAP

Puedes solucionar problemas con las versiones 2.0 y 2.1 de BigQuery Connector para SAP mediante el uso de los registros de aplicaciones de SAP LT Replication Server y de Google Cloud a fin de revisar mensajes de error y registro.

BigQuery Connector para SAP envía todos los errores a los registros de la aplicación estándar SAP LT Replication Server.

También puedes usar la depuración de SAP LT Replication Server para aislar problemas.

Descripción general de la solución de problemas

Cuando solucionas problemas con BigQuery Connector para SAP, existen varias áreas diferentes en las que es posible que debas enfocar tu atención, según el área o el alcance del problema que investigas:

La infraestructura, como la red, el hardware o el sistema operativo
El software SAP, incluidos el servidor de origen y SAP LT Replication Server
BigQuery Connector para SAP
BigQuery, incluida la API de BigQuery y la tabla de destino

Involucra a los equipos correctos

Lo primero que debes hacer cuando solucionas un problema es determinar en cuál de las áreas antes mencionadas se produce y cuál es su alcance.

Para resolver un problema, es posible que debas trabajar con varios equipos, como los administradores de Basis, los administradores de SAP LT Replication Server, los DBA o los administradores de seguridad de Google Cloud.

Obtener los equipos y las habilidades adecuados desde el principio puede ayudarte a resolver los problemas con más rapidez.

Determina la causa raíz

Debes determinar la causa raíz de tu problema y asegurarte de que lo que crees que sea la causa no sea solo un síntoma de una causa raíz que se encuentra en otro lugar.

Los sistemas SAP están muy integrados, pero pueden escribir registros y seguimientos en archivos de varias ubicaciones. Cuando solucionas los problemas, debes determinar los registros y los archivos de seguimiento correctos que debes observar.

Verifica los requisitos de software y los requisitos previos

Asegúrate de que todo el software del sistema se ejecute en las versiones mínimas requeridas y que se cumplan todos los requisitos de BigQuery Connector para SAP.

Si deseas obtener información sobre los requisitos de instalación de BigQuery Connector para SAP, consulta Requisitos previos.

Si SAP LT Replication Server se ejecuta en una VM de Compute Engine, consulta Requisitos.
Si SAP LT Replication Server se ejecuta en un host externo a Google Cloud, consulta Requisitos.

Si deseas conocer los requisitos de software de BigQuery Connector para SAP, consulta Requisitos de software.

Si usas un software de ECC anterior, asegúrate de que la versión de SAP LT Replication Server sea compatible con la versión de ECC. Para obtener más información, consulta la Nota de SAP 2577774: Compatibilidad de versiones para sistemas fuente y de destino, SLT.

Lee la documentación de asistencia de SAP

Si tienes una cuenta de usuario de SAP, puedes encontrar la resolución para muchos problemas de software de SAP si lees las notas de SAP y los artículos de la base de conocimiento de SAP disponibles en SAP ONE Support Launchpad (Launchpad de asistencia de SAP ONE).

Logging

BigQuery Connector para SAP envía sus mensajes de registro a SAP LT Replication Server, en el que puedes verlos en los registros de aplicaciones de SAP LT Replication Server.

Estos mensajes incluyen los mensajes que BigQuery Connector para SAP recibe de la API de BigQuery.

Los mensajes generales del registro de BigQuery se pueden ver en la consola de Google Cloud.

Registros de aplicaciones de SAP LT Replication Server

Todos los mensajes de error se guardan en los registros estándar de la aplicación SAP LT Replication Server. Revisa los registros de la aplicación para analizar y solucionar la causa raíz de los problemas.

Puedes mostrar los registros de la aplicación que son específicos de la configuración de SAP LT Replication Server si ejecutas la transacción LTRC, abres la configuración y seleccionas Application Logs.

Cuando se muestren los registros, selecciona una fila de la tabla y puedes hacer clic en un botón para mostrar los mensajes de error. Si haces clic en la pestaña Registros de la aplicación de una replicación, puedes filtrar los mensajes de registro relevantes del entorno de ejecución de la replicación.

Mensajes generados por BigQuery Connector para SAP

Cualquier error que ocurra en BigQuery Connector para SAP antes de que los registros se envíen a BigQuery tienen el prefijo /GOOG/SLT.

/GOOG/MSG tiene cualquier prefijo que muestra los errores que se muestran desde la API de BigQuery. Esto incluye cualquier error HTTP.

Si ninguno de estos valores tiene un prefijo de error, el error fue emitido por SAP LT Replication Server.

Registros de BigQuery

BigQuery escribe varias entradas de registro en Cloud Logging en la consola de Google Cloud.

Para ver las entradas de registro de BigQuery, haz lo siguiente:

En la consola de Google Cloud, abre Logging:

Ir al Explorador de registros
En el editor de consultas, especifica un recurso de BigQuery. Por ejemplo:
```
resource.type="bigquery_dataset"
```

Para obtener más información sobre los registros de BigQuery, consulta Registros.

HTTP trace

Cuando solucionas errores, puedes habilitar HTTP trace en la transacción SMICM o ST05.

Para limitar el impacto en el rendimiento, inhabilita HTTP trace en cuanto termines.

Depuración

Si tienes la autorización requerida, puedes depurar el código del complemento empresarial (BAdI) de BigQuery Connector para SAP.

Para depurar el código de BAdI, haz lo siguiente:

Si aún no tienes las autorizaciones de SAP necesarias para depurar el código de BAdI, pásalas a tu administrador de SAP.
Para escribir la depuración, escribe /h en el campo de entrada de la transacción en la GUI de SAP y, luego, presiona Enter.
En el menú Settings, selecciona Change Debugger Profile/ Settings.
En Debug Modes, asegúrate de que la opción Depuración del sistema esté seleccionada.
Establece puntos de interrupción externos en el código según sea necesario.

Monitoring

Puedes supervisar varios puntos diferentes en la ruta de acceso de los datos desde la fuente de datos de SAP hasta la tabla de BigQuery de destino, incluidos los siguientes:

Infraestructura: red, hardware y sistema operativo
Capa de la base de datos de SAP
Capa de la aplicación de SAP
BigQuery Connector para SAP
BigQuery

Para obtener más información sobre la supervisión en cada uno de estos puntos, consulta la guía de operaciones de BigQuery Connector para SAP.

Conciliación de datos

Existen tres puntos en los que puedes verificar los recuentos de registros:

La tabla de origen
Las estadísticas de carga o replicación de SAP LT Replication Server en la transacción LTRC
La tabla de destino de BigQuery

Puedes usar la herramienta de validación de replicación para verificar y comparar los recuentos de registros, o puedes recuperar los registros tú mismo si ejecutas consultas en SQL.

Si deseas obtener más información sobre la conciliación de datos, consulta la guía de operaciones de BigQuery Connector para SAP.

Problemas comunes de configuración

En esta sección, se encuentran las soluciones a problemas habituales que pueden ocurrir durante la configuración inicial de BigQuery Connector para SAP.

SAP LT Replication Server para tipos de datos de base de datos

Según tus versiones de software de SAP, es posible que SAP LT Replication Server no admita algunos tipos de datos en una base de datos de origen. Para obtener más información, consulta la sección Consideraciones importantes de la Nota de SAP 1605140: SAP Landscape Transformation Replication Server (SLT) (SAP Landscape Transformation Replication Server).

Problema: El comando del SO para el token de acceso no funciona en SAP LT Replication Server

Problema: Creaste un comando del sistema operativo (SO) para imprimir el token de acceso, pero no funciona en SAP LT Replication Server.

Causa: Este problema puede deberse a varios problemas, pero lo más probable es que no se hayan configurado correctamente las variables de entorno necesarias para el comando del SO.

Solución: Confirma que el comando del SO se configuró correctamente. Si deseas conocer los pasos de configuración, consulta Crea un comando de SO para imprimir el token de acceso.

Intenta ejecutar el comando printenv desde el SO como sidadm y la transacción SM69 de SAP y compara el resultado.

Si las variables que se muestran en la transacción SM69 están incompletas, intenta reiniciar SAP LT Replication Server para registrar las variables.

Problema: `/GOOG/MSG: 413 - Request Entity Too Large`

Problema: La transferencia de datos falló con el mensaje de error /GOOG/MSG: 413 - Request Entity Too Large.

Causa: Este problema puede deberse a que el tamaño de bytes del fragmento que envió BigQuery Connector para SAP superó el tamaño máximo de bytes para las solicitudes HTTP que BigQuery acepta. Esto puede ocurrir cuando el tamaño de los registros de la tabla o la cantidad de datos que contienen los registros hacen que el tamaño de bytes de un fragmento supere el límite de BigQuery.

Resolución: Reduce el tamaño de los fragmentos que envía BigQuery Connector para SAP para tu tabla. Puedes ajustar el tamaño del fragmento mediante la ejecución de la transacción /GOOG/SLT_SETTINGS.

Si deseas obtener información sobre el dimensionamiento de los fragmentos, consulta Tamaño de fragmento en BigQuery Connector para SAP.

Problema: `/GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the request sending`

Problema: La transferencia de datos falló con un mensaje de error /GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the request sending.

Causa: Este problema puede deberse a problemas de conexión o de red.

Resolución: Valida tu conexión y asegúrate de que tu red esté configurada correctamente, se ejecute sin errores y no esté congestionada.

Problema: `/GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the response receiving`

Problema: La transferencia de datos falló con un mensaje de error /GOOG/MSG: 503 - HTTP Communication Failure exception occurred during the response receiving.

Este problema puede deberse a las siguientes circunstancias:

Error en el protocolo de enlace SSL
El tamaño en bytes de los fragmentos superó el tamaño máximo de bytes para las solicitudes HTTP que BigQuery acepta

Error en el protocolo de enlace SSL

Causa: Cuando el protocolo de enlace SSL falló entre el host de SAP LT Replication Server y el extremo de la API de BigQuery. Esto ocurre cuando el certificado que presenta el servidor de TLS no es válido para el nombre de host de destino que proporciona SAP LT Replication Server, posiblemente porque el envío del cliente de la extensión opcional de TLS SNI no se implementa en tu kernel de NetWeaver.

Resolución: En la transacción SMICM, busca el código de retorno, SSLERR_SERVER_CERT_MISMATCH. Si encuentras el código de retorno SSLERR_SERVER_CERT_MISMATCH, debes habilitar el envío de la SNI de la extensión TLS. Además, asegúrate de que el kernel de NetWeaver implemente el envío del cliente de la SNI de la extensión TLS opcional.

Para habilitar el envío de la SNI de la extensión TLS, establece el parámetro de perfil icm/HTTPS/client_sni_enabled o ssl/client_sni_enabled en TRUE, según la versión de kernel de NetWeaver. Para obtener más información sobre SAP, consulta los siguientes vínculos:

El tamaño en bytes de los fragmentos superó el tamaño máximo de bytes para las solicitudes HTTP que BigQuery acepta

Causa: Cuando el tamaño de bytes del fragmento que envía BigQuery Connector para SAP superó el tamaño máximo de bytes para las solicitudes HTTP que acepta BigQuery. Esto puede ocurrir cuando el tamaño de los registros de la tabla o la cantidad de datos que contienen los registros hacen que el tamaño de bytes de un fragmento supere el límite de BigQuery.

Resolución: Reduce el tamaño de los fragmentos que envía BigQuery Connector para SAP para esta tabla. Puedes ajustar el tamaño del fragmento mediante la ejecución de la transacción /GOOG/SLT_SETTINGS. Si deseas obtener más información, consulta Tamaño de fragmento en BigQuery Connector para SAP.

Problema: `/GOOG/MSG: 404 - Not found: Dataset DATASET_NAME`

Problema: Cuando intentas validar la seguridad de Google Cloud o cargar datos en una tabla de BigQuery, recibes el mensaje /GOOG/MSG: 404 - Not found: Dataset DATASET_NAME.

Causa: Este problema puede deberse a las siguientes circunstancias:

El conjunto de datos de BigQuery aún no se creó.
El nombre del conjunto de datos no se especificó correctamente en la configuración de transferencia masiva.
Se debe activar la configuración de replicación en SAP LT Replication Server.

Solución: Prueba las siguientes soluciones:

Confirma que el conjunto de datos se creó en BigQuery.
Verifica que el nombre del conjunto de datos en la configuración de transferencia masiva sea el mismo que el nombre del conjunto de datos en BigQuery.
Ejecuta la transacción LTRC y desactiva y vuelve a activar la configuración de la replicación.

Problema: `Mass Transfer Key can not be found for Mass Transfer ID XXX`

Problema: Ves el error /GOOG/SLT: Mass Transfer Key can not be found for Mass Transfer ID XXX.

Causa: Este problema puede deberse a las siguientes circunstancias:

No existe una configuración de transferencia masiva para el ID de transferencia masiva especificado.
La configuración de replicación correspondiente no está activa.

Solución: Para resolver el problema, realiza una de las siguientes acciones:

Ejecuta la transacción /GOOG/SLT_SETTINGS y confirma que el ID de transferencia masiva se haya especificado de forma correcta.
Ejecuta la transacción LTRC y desactiva y vuelve a activar la configuración de la replicación.

Problema: `/GOOG/SLT : Unable to interpret VALUE as a BOOLEAN`

Problema: La carga o la replicación de un registro falla con el mensaje /GOOG/SLT : Unable to interpret VALUE as a BOOLEAN.

Causa: Este problema se debe a la asignación de un campo en la tabla de origen al tipo de datos de BigQuery BOOLEAN, pero los datos en el campo de origen no se resuelven en un booleano.

Resolución: Para resolver el problema, usa la transacción /GOOG/SLT_SETTINGS para cambiar el tipo de datos al que se asigna el campo de origen o quitar la asignación de tipo de datos y aceptar los datos predeterminados tipo.

Problema: `/GOOG/SLT: Failed to convert field SAP_FIELD_NAME value to field BIGQUERY_FIELD_NAME: ERROR_DETAILS`

Problema: La carga o la replicación de un registro falla con el mensaje /GOOG/SLT: Failed to convert field SAP_FIELD_NAME value to field BIGQUERY_FIELD_NAME: ERROR_DETAILS.

Causa: El campo de origen contiene un valor no válido o el campo de origen se asigna a un tipo de datos de BigQuery que no es una asignación válida para los datos que contiene el campo de origen.

Solución: Para resolver el problema, usa la transacción /GOOG/SLT_SETTINGS a fin de cambiar el tipo de datos al que se asigna el campo de origen o quitar la asignación de tipo de datos y aceptar la asignación predeterminada.

Problema: `/GOOG/MSG : Client key is not found in /GOOG/CLIENT_KEY table`

Problema: Una carga o replicación no comienza con el mensaje /GOOG/MSG: Client key is not found in /GOOG/CLIENT_KEY table.

Causa: La clave de cliente no existe o se especificó de forma incorrecta en la configuración de transferencia masiva de la transacción /GOOG/SLT_SETTINGS.

Solución: A fin de resolver el problema, usa la transacción SM30 para crear la clave del cliente o usa la transacción /GOOG/SLT_SETTINGS si deseas corregir la especificación del valor de la clave del cliente en el configuración de transferencia masiva.

Problemas operativos comunes

En esta sección, se encuentran las soluciones a problemas habituales que pueden ocurrir después de la configuración inicial de BigQuery Connector para SAP.

Problema: Cantidad incorrecta de escrituras en BigQuery

Problema: La cantidad de registros que se escriben en BigQuery es mayor que la cantidad de registros que se muestran en los registros de SAP LT Replication Server.

Causa: Puede tener más de una causa, incluidos los problemas de conexión transitorios que hacen que SAP LT Replication Server envíe registros más de una vez o el hecho de que la tabla de BigQuery solo acepta inserciones y cada cambio en un solo registro en la fuente se inserta como una entrada separada en la tabla de destino.

Solución: Si la diferencia en los recuentos de registros no es extrema y no hay menos registros en BigQuery que en la tabla de origen, este es el comportamiento esperado y no un problema.

Para conciliar de forma precisa la cantidad de registros en BigQuery con la cantidad de registros en la tabla de origen, consulta la tabla de BigQuery como se describe en Consultas de SQL para recuentos de registros.

Para obtener más información sobre las posibles causas de este problema, consulta Consideraciones especiales para orígenes y destinos de ABAP en HANA.

Problema: `/GOOG/MSG : 400 - Schema mismatch for table TABLE_NAME`

Problema: Recibes el mensaje de error /GOOG/MSG : 400 - Schema mismatch for table TABLE_NAME. Please delete the table from BigQuery and try again.

Causa: Se ingresó uno de los siguientes cambios para una tabla de BigQuery existente:

Eliminación de un campo
Cambio de nombre de un campo
Cambio en el tipo de datos de un campo
Cambio en el tipo de partición de una tabla

Los cambios anteriores no se pueden aplicar a una tabla de BigQuery existente.

Resolución: Si necesitas cambiar cualquiera de estos atributos de campo en una tabla existente, debes borrar la tabla existente y volver a cargar los registros en una tabla nueva.

Si el cambio fue un error, revísala en SAP LT Replication Server.

Para obtener más información sobre la configuración de campos y particiones en una tabla de BigQuery de destino, consulta Configuraciones de replicación de BigQuery.

Problema: Mensajes de error relacionados con datos no válidos

Problema: En los registros de la aplicación, recibes un mensaje de error: /GOOG/MSG/: DESCRIPTION_OF_INVALID_DATA error occurred in FIELD_NAME in record RECORD_KEYS.

Causa: Este mensaje de error es emitido por BigQuery cuando se insertan los registros con datos no válidos en la tabla de destino. Los datos pueden no ser válidos debido a uno de los siguientes motivos:

Los datos en el campo de un registro en particular no son compatibles con el tipo de datos en BigQuery. Por ejemplo, BigQuery genera mensajes de error cuando ocurre lo siguiente:
- Una string se mantiene en un campo de tipo DATE, INTEGER o BOOLEAN.
- Se mantiene una fecha no válida (00/00/0000) en un campo de tipo DATE.
Se mantiene un tipo de datos de destino incorrecto en las asignaciones de campos en la transacción /GOOG/SLT_SETTINGS.

BigQuery emite un mensaje de error por cada registro que contiene un campo con datos no válidos.

Resolución: Analiza el mensaje de error, DESCRIPTION_OF_INVALID_DATA, para comprender la causa posible de los datos no válidos. Para identificar el registro con el campo que contiene los datos no válidos, usa RECORD_KEYS, que incluye el contenido de los primeros cinco campos del registro. Si la tabla tiene cinco campos o menos, el contenido de todos los campos se incluye en el RECORD_KEYS.

Si los datos en el campo no son compatibles con el tipo de datos en BigQuery, corrige los datos en la tabla de origen.
Si el error se produjo por una discrepancia entre los datos y el tipo de datos, usa la transacción /GOOG/SLT_SETTINGS para especificar el tipo de datos adecuado. Para obtener más información sobre la asignación de tipos de datos, consulta Asignación de tipos de datos.

Obtenga asistencia

Si necesitas ayuda para resolver problemas de replicación y BigQuery Connector para SAP, recopila toda la información de diagnóstico disponible y comunícate con el servicio de atención al cliente de Cloud.

Si deseas obtener más información para comunicarte con el equipo de Atención al cliente de Cloud, consulta Obtén asistencia para SAP en Google Cloud.