Replicación de datos de SAP en BigQuery con el kit de herramientas de BigQuery para SAP

Para replicar datos de SAP en BigQuery, usa la clase de carga de datos /GOOG/CL_BQTR_DATA_LOAD en tus aplicaciones SAP, como programas ABAP personalizados, salidas de usuario, complementos empresariales (BAdI) y mejoras. Tu aplicación de SAP debe pasar los datos que se replicarán como entrada a la clase.

Llama al método de replicación de datos

Para crear una instancia de la clase de carga de datos de BigQuery /GOOG/CL_BQTR_DATA_LOAD, debes pasar la clave de transferencia masiva y el nombre del objeto de diccionario configurado en la configuración de la transferencia de datos de BigQuery.

Para enviar los datos a BigQuery, llama al método REPLICATE_DATA de la clase /GOOG/CL_BQTR_DATA_LOAD.

DATA(lo_bq_data_load) =
  NEW /GOOG/CL_BQTR_DATA_LOAD( IV_MASS_TR_KEY = 'MASS_TRANSFER_KEY'
                               IV_DATA_SOURCE = 'DATA_SOURCE'
                               IV_CDC_FRAMEWORK = 'CDC_FRAMEWORK'
                               IV_FLDNM_MANDT = 'MANDT_FIELDNAME'
                               IV_MANDT_VALUE = 'MANDT_VALUE'
 ).
"Write Logic to populate ITAB_DATA, WA_HEADER

"Replicate Data to BigQuery
lo_bq_data_load->replicate_data(
  EXPORTING
    it_content       = ITAB_DATA
    IS_HEADER_INFO   = WA_HEADER
  IMPORTING
    ev_error_code    = data(lv_error_code)
    et_return        = data(lt_return) ).

Reemplaza lo siguiente:

  • MASS_TRANSFER_KEY: Es la clave de transferencia masiva configurada en la configuración de transferencia de datos de BigQuery.
  • DATA_SOURCE: Es el nombre del objeto del diccionario de SAP, como una tabla, una vista del diccionario o una vista de CDS.

  • CDC_FRAMEWORK: Opcional Es el framework de captura de datos modificados (CDC) que usa el programa que realiza la llamada. Los valores admitidos son ODQ y SLT.

    El kit de herramientas de BigQuery para SAP tiene lógica integrada para determinar la marca de operación (insertar, actualizar y borrar) según el framework de CDC. Si deseas obtener más información, consulta Campos adicionales para los cambios de registro y las consultas de recuento.

    Cuando CDC_FRAMEWORK se pasa como ODQ, el kit de herramientas de BigQuery para SAP obtiene el valor de la columna ODQ_CHANGEMODE en la carga útil que se pasa en la entrada:

    • Si el valor es igual a C, operation_flag se establece en I.
    • Si el valor es igual a U, el valor de operation_flag se establece en U.
    • Si el valor es igual a D, el valor de operation_flag se establece en D.
    • Para todos los demás valores, operation_flag se establece en L.

    Cuando CDC_FRAMEWORK se pasa como SLT, BigQuery Toolkit para SAP obtiene el valor de la columna "OPERATION" de WA_HEADER:

    • Si el valor es igual a I, el valor de operation_flag se establece en I.
    • Si el valor es igual a U, el valor de operation_flag se establece en U.
    • Si el valor es igual a D, el valor de operation_flag se establece en D.
    • Para todos los demás valores, operation_flag se establece en L.

    Si no se pasa CDC_FRAMEWORK o se pasa como cualquier otro valor, operation_flag se establece en L.

  • MANDT_FIELDNAME: Opcional Es el nombre del campo del cliente de SAP que se debe agregar a la definición de la tabla de BigQuery. Esto se puede usar para objetos de diccionario de SAP, como entidades de CDS, que no tienen el campo de cliente en su definición, pero quieres que se agregue el campo a BigQuery.

  • MANDT_VALUE: Opcional Es el valor del campo de cliente de SAP que se debe completar en BigQuery. Solo se puede usar cuando también se propaga IV_FLDNM_MANDT.

  • ITAB_DATA: Es una tabla interna de tipo DATA_SOURCE. Debes propagar ITAB_DATA con los datos que se deben replicar en la tabla de BigQuery.

  • WA_HEADER: Es una estructura plana que contiene información del encabezado sobre la replicación. Se usa para determinar el operation_flag cuando CDC_FRAMEWORK es SLT.

Cuando llamas a este método, el módulo de transferencia de datos de BigQuery realiza las siguientes acciones:

  • Sincroniza la definición de la tabla de BigQuery con la definición del objeto del diccionario de SAP según la configuración de la tabla y el campo que se mantienen en la configuración de la transferencia de datos de BigQuery.
  • Los datos del mapa se propagan en ITAB_DATA desde el formato de SAP al formato de BigQuery según la configuración a nivel del campo que se mantiene en la configuración de la transferencia de datos de BigQuery. Si no se mantienen los parámetros de configuración a nivel del campo, se usarán las reglas de asignación de datos predeterminadas.
  • Llama al método InsertAllTabledata de la API de BigQuery para cargar datos en la tabla de destino de BigQuery.

Si todos los pasos se completan correctamente, el parámetro de exportación ev_error_code devuelve el valor 0. Si hubo un error en algún paso, ev_error_code devuelve un valor distinto de cero y el mensaje de error correspondiente se completa en et_return.

Como desarrollador de aplicaciones, puedes controlar los errores, lo que incluye guardarlos para su análisis posterior y volver a intentar cargar los registros que no se replicaron.

Obtenga asistencia

Google Cloud ofrece asistencia para problemas y preguntas relacionados con la instalación, la configuración, el funcionamiento y el mantenimiento de BigQuery Toolkit para SAP.

En el caso de los problemas que se originan en componentes administrados por SAP, como el aprovisionamiento de datos operativos (ODP), el servidor de migración de datos (DMIS), los servicios de datos principales (CDS), el administrador de comunicaciones por Internet (ICM) o el software de terceros, Google Cloud Atención al cliente hace todo lo posible para identificar la causa raíz. Para resolver estos problemas, comunícate con el proveedor o el proveedor de asistencia correspondiente.

Si deseas solucionar problemas con BigQuery Toolkit para SAP, consulta Solución de problemas de BigQuery Toolkit para SAP.

Si necesitas ayuda para resolver problemas con el SDK de ABAP para Google Cloud, haz lo siguiente: