Instala y configura BigQuery Toolkit para SAP

En este documento, se describe cómo instalar y configurar BigQuery Toolkit para SAP.

Instala BigQuery Toolkit para SAP

Cuando instalas la versión 1.9 de la edición local o cualquier edición en la nube del SDK de ABAP para Google Cloud, se instala BigQuery Toolkit para SAP de forma predeterminada. Para obtener información sobre los pasos de instalación, consulta Instala y configura las ediciones locales o cualquier edición en la nube del SDK de ABAP para Google Cloud.

Si ya usas la versión 1.8 o una anterior de la edición local o en la nube del SDK de ABAP para Google Cloud, debes actualizar el SDK a la versión más reciente para obtener el kit de herramientas de BigQuery para SAP. Para obtener más información, consulta Actualiza el SDK de ABAP para Google Cloud.

Habilite la API de BigQuery

Debes habilitar la API de BigQuery en tu proyecto de Google Cloud. Para obtener información sobre cómo habilitar las Google Cloud APIs, consulta Habilita las APIs.

Configura la autenticación

Una vez que configures la autenticación para acceder a las APIs de Google Cloud en tu edición local o en cualquier edición en la nube del SDK de ABAP para Google Cloud, BigQuery Toolkit para SAP usará el mismo método de autenticación para acceder a la API de BigQuery. Si deseas obtener información para configurar la autenticación en las ediciones locales o en la nube del SDK de ABAP para Google Cloud, consulta Descripción general de la autenticación.

Asegúrate de que la cuenta de servicio configurada en la configuración de la clave del cliente del SDK de ABAP para Google Cloud tenga los siguientes roles:

  • Editor de datos de BigQuery
  • Usuario de trabajo de BigQuery

Anota la clave de cliente que creaste como parte de la configuración de autenticación. Usas esta clave de cliente cuando configuras el módulo de configuración de la transferencia de datos de BigQuery del kit de herramientas de BigQuery para SAP en tu sistema SAP.

Crea un conjunto de datos de BigQuery

A fin de crear un conjunto de datos de BigQuery, tu cuenta de usuario debe tener los permisos de IAM adecuados para BigQuery. Para obtener más información, consulta Permisos necesarios.

Para crear un conjunto de datos de BigQuery, debes seguir estos pasos:

  1. En la consola de Google Cloud, ve a la página de BigQuery:

    Ir a BigQuery

  2. Junto al ID del proyecto, haz clic en el ícono Ver acciones, , y, luego, en Crear conjunto de datos.

    Crear conjunto de datos

  3. En el campo ID de conjunto de datos, ingresa un nombre único. Para obtener más información, consulta Nombre de los conjuntos de datos.

Para obtener más información sobre la creación de conjuntos de datos de BigQuery, consulta Crea conjuntos de datos.

Configura el módulo de transferencia de datos de BigQuery

El módulo de transferencia de datos de BigQuery del kit de herramientas de BigQuery para SAP te permite crear un canal de datos desde tu sistema SAP a BigQuery. En este proceso, creas una configuración de transferencia masiva en la que puedes especificar qué fuentes de datos de SAP replicar, asignar campos entre tus tablas de SAP y BigQuery, y optimizar el rendimiento configurando la configuración de replicación de datos.

Selecciona las opciones de transferencia masiva inicial

Selecciona la parte de la configuración de la transferencia masiva que necesitas editar.

Para seleccionar la parte de la configuración de la transferencia masiva, haz lo siguiente:

  1. En la GUI de SAP, ejecuta el código de transacción /GOOG/SDK_IMG.

    Como alternativa, ejecuta el código de transacción SPRO y, luego, haz clic en IMG de referencia de SAP.

  2. Haz clic en SDK de ABAP para Google Cloud > Configuración básica > BigQuery Data Transfer: Settings Maintenance.

  3. En el menú desplegable Tabla de configuración, selecciona Transferencias masivas.

    Para una nueva configuración de transferencia masiva, deja el campo Mass Transfer Key en blanco.

  4. Haz clic en el ícono Ejecutar. Aparecerá la pantalla Mantenimiento de la configuración de transferencia de datos de BigQuery: Transferencias masivas.

Especifica la creación de tablas y otros atributos generales

En la sección inicial de una configuración de transferencia masiva de BigQuery, identificas la configuración de transferencia masiva y especificas la clave de cliente asociada, así como ciertas propiedades relacionadas con la creación de la tabla de BigQuery de destino.

Tu servidor de SAP guarda la configuración de la transferencia masiva como un registro en la tabla de configuración personalizada /GOOG/BQTR_MASTR.

Los campos que especifiques en los siguientes pasos son obligatorios para una configuración de transferencia masiva.

Para especificar atributos de tabla, haz lo siguiente:

  1. En la pantalla Mantenimiento de configuración de transferencia de datos de BigQuery - Transferencias masivas, haz clic en el ícono Agregar fila.

  2. En la fila que se muestra, especifica la siguiente configuración:

    1. En el campo Clave de transferencia masiva, especifica un nombre para esta transferencia. Este nombre se convierte en la clave primaria de la transferencia masiva.
    2. Para usar las etiquetas o descripciones cortas de los campos de origen como los nombres de los campos de destino en BigQuery, haz clic en la casilla de verificación Usar marcas de nombres personalizadas. Si deseas obtener más información sobre los nombres de campos, consulta Opciones de nombres predeterminados para los campos.

    3. Para almacenar el tipo de cambio que activó una inserción y habilitar la validación de los recuentos de registros entre la tabla de origen, las estadísticas del servidor de SAP y la tabla de BigQuery, selecciona la casilla de verificación Marca de campos adicionales.

      Cuando se configura esta marca, BigQuery Toolkit para SAP agrega columnas al esquema de tabla de BigQuery. Si deseas obtener más información, consulta Campos adicionales para los cambios de registro y las consultas de recuento.

    4. Para dejar de enviar datos cuando se encuentra un registro con un error de datos, la casilla de verificación Marca de pausa en el primer error está marcada de forma predeterminada. Te recomendamos que la dejes marcada. Para obtener más información, consulta La marca BREAK.

    5. De manera opcional, para reducir de forma automática el tamaño del fragmento cuando el tamaño del byte de un fragmento excede el tamaño máximo de bytes para las solicitudes HTTP que acepta BigQuery, haz clic en la casilla de verificación Marca de tamaño fragmento dinámico. Para obtener más información sobre el tamaño de fragmento dinámico, consulta Tamaño de fragmento dinámico.

    6. Cuando se encuentre un registro con un error de datos, para omitir el registro y continuar insertando registros en la tabla de BigQuery, haz clic en la casilla de verificación Marca de omisión de registros no válidos. Te recomendamos que la dejes sin marcar. Para obtener más información, consulta La marca SKIP.

    7. En el campo Nombre de la clave de Google Cloud, ingresa el nombre de la configuración de la clave del cliente correspondiente.

      BigQuery Toolkit para SAP recupera el identificador de proyecto Google Cloud de la configuración de la clave del cliente.

    8. En el campo Conjunto de datos de BigQuery, ingresa el nombre del conjunto de datos de BigQuery de destino que creaste en la sección Crea un conjunto de datos de BigQuery.

    9. En el campo Marca de que la configuración está activa, haz clic en la casilla de verificación para habilitar la configuración de transferencia masiva

    10. Haz clic en Guardar.

      Se agrega un registro de transferencia masiva en la tabla /GOOG/BQTR_MASTR y se propagan automáticamente los campos Modificado por, Se cambió el y Se cambió a las.

    11. Haz clic en Mostrar tabla.

      Se muestra el registro de transferencia masiva nuevo seguido del panel de entrada del atributo de tabla.

Especifica atributos de tabla

Puedes especificar atributos de tabla, como el nombre y la partición de la tabla, así como la cantidad de registros que se incluirán en cada transmisión o fragmento que se envía a BigQuery.

La configuración que especificas se almacena como un registro en la tabla de configuración /GOOG/BQTR_TABLE.

Esta configuración es opcional para una configuración de transferencia masiva.

Para especificar atributos de tabla, haz lo siguiente:

  1. Haz clic en el ícono Agregar fila.

  2. En el campo Nombre de la fuente de datos de SAP, ingresa el nombre de los objetos del diccionario de SAP de origen, como tablas, vistas de diccionario, vistas de CDS o entidades de CDS.

  3. En el campo Nombre de tabla externa, ingresa el nombre de la tabla de BigQuery de destino. Si la tabla de destino aún no existe, BigQuery Toolkit para SAP crea la tabla con este nombre. Para conocer las convenciones de nombres de BigQuery para las tablas, consulta Nombres de tablas.

  4. Para enviar datos sin comprimir para todos los campos de una tabla, selecciona Enviar marca sin comprimir. Con este parámetro de configuración habilitado, BigQuery Toolkit para SAP replica los campos vacíos en los registros de origen con los valores con los que se inicializan los campos en la tabla de origen. Para obtener un mejor rendimiento, no selecciones esta marca.

    Si necesitas enviar datos sin comprimir solo para campos específicos, no selecciones Enviar marca sin comprimir a nivel de la tabla. En su lugar, selecciona Enviar marca sin comprimir para esos campos específicos a nivel del campo. Esta opción te permite conservar los valores iniciales de campos específicos cuando reproduces datos en BigQuery, incluso si comprimes el resto de los datos de la tabla. Para obtener información sobre cómo modificar la compresión de registros a nivel del campo, consulta Cómo cambiar la compresión de registros a nivel del campo.

    Para obtener más información sobre el comportamiento de la compresión de registros, consulta Compresión de registros.

  5. De manera opcional, en el campo Tamaño del fragmento, especifica la cantidad máxima de registros que se incluirán en cada fragmento que se envía a BigQuery. Te recomendamos que uses el tamaño de fragmento predeterminado con BigQuery Toolkit para SAP, que es de 10,000 registros. Si es necesario, puedes aumentar el tamaño de fragmento a 50,000 registros, que es el tamaño máximo de fragmento que permite BigQuery Toolkit para SAP.

    Si los registros de origen tienen una gran cantidad de campos, la cantidad de campos puede aumentar el tamaño general de bytes de los fragmentos, lo que puede causar errores en los fragmentos. Si esto ocurre, intenta reducir el tamaño del fragmento para reducir el tamaño de los bytes. Para obtener más información, consulta Tamaño de fragmento de transferencia de datos. De manera alternativa, para ajustar automáticamente el tamaño de fragmento, habilita el tamaño dinámico del fragmento. Para obtener más información, consulta Tamaño de fragmento dinámico.

  6. De forma opcional, en el campo Tipo de partición, especifica un incremento de tiempo para usar en la partición. Los valores válidos son HOUR, DAY, MONTH o YEAR. Para obtener más información, consulta Partición de tablas.

  7. De forma opcional, en el campo Campo de partición, especifica el nombre de un campo en la tabla de BigQuery de destino que contenga una marca de tiempo para usar en la partición. Cuando especificas el Campo de partición, también debes especificar el Tipo de partición. Para obtener más información, consulta Partición de tablas.

  8. En el campo Marca de que la configuración está activa, haz clic en la casilla de verificación para habilitar los atributos de tabla. Si el cuadro Marca de que la configuración está activa no está marcado, BigQuery Toolkit para SAP crea la tabla de BigQuery con el nombre de la tabla de SAP de origen, el tamaño de fragmento predeterminado y sin partición.

  9. Haz clic en Guardar.

    Tus atributos se almacenan como un registro en la tabla de configuración /GOOG/BQTR_TABLE y automáticamente se propagan los campos Modificado por, Se cambió el y Se cambió a las.

  10. Haz clic en Mostrar campos.

    Se muestra el nuevo registro de atributos de la tabla, seguido del panel de entrada de asignación de campos.

Personaliza la asignación de campos predeterminada

Si la tabla de SAP de origen contiene campos de marca de tiempo o booleanos, cambia la asignación de tipo de datos predeterminada para reflejar con precisión el tipo de datos en la tabla de BigQuery de destino.

También puedes cambiar otros tipos de datos, así como los nombres que se usan para los campos de destino.

Puedes editar la asignación predeterminada directamente en la GUI de SAP o puedes exportar la asignación predeterminada a una hoja de cálculo o un archivo de texto para que otros puedan editar los valores sin requerir acceso a tu servidor de SAP.

Para obtener más información sobre la asignación de campos predeterminada y los cambios que puedes realizar, consulta Asignación de campos.

Para personalizar la asignación predeterminada de los campos de BigQuery de destino, haz lo siguiente:

  1. En la pantalla Mantenimiento de la configuración de transferencia de datos de BigQuery: Campos, muestra las asignaciones de campo predeterminadas para la transferencia masiva que estás configurando.

  2. Edita los tipos de datos de destino predeterminados en la columna Elemento de datos externo según sea necesario. En particular, cambia el tipo de datos de destino por los siguientes tipos de datos:

    • Marcas de tiempo. Cambia el tipo de datos de destino predeterminado de NUMERIC a TIMESTAMP o TIMESTAMP (LONG).
    • Booleanos. Cambia el tipo de datos de destino predeterminado de STRING a BOOLEAN.
    • Hexadecimales. Cambia el tipo de datos de destino predeterminado de STRING a BYTES.

    Para editar la asignación de tipo de datos predeterminada, haz lo siguiente:

    1. En la fila del campo que necesitas editar, haz clic en el campo Elemento de datos externo.
    2. En el cuadro de diálogo para los tipos de datos, selecciona el tipo de datos de BigQuery que necesitas.
    3. Confirma los cambios y, luego, haz clic en Guardar.

  3. Si especificaste la marca Nombres personalizados en la pantalla Mantenimiento de la configuración de transferencia de datos de BigQuery, edita los nombres de los campos de destino predeterminados en la columna Nombre de campo temporal según sea necesario.

    Los valores que especifiques anulan los nombres predeterminados que se muestran en la columna Nombre de campo externo.

  4. Edita las descripciones predeterminadas de los campos de destino en la columna Descripción del campo según sea necesario.

  5. De forma opcional, exporta el mapa de campos para la edición externa. Para obtener instrucciones, consulta Edita el mapa de campos de BigQuery en un archivo CSV.

  6. Una vez que se hayan completado todos los cambios y se hayan subido los valores editados externamente, confirma que la casilla de verificación Marca de que la configuración está activa esté seleccionada. Si no está seleccionada la opción Marca de que la configuración está activa, BigQuery Toolkit para SAP crea tablas de destino con los valores predeterminados.

  7. Haz clic en Guardar.

    Los cambios se almacenan en la tabla de configuración /GOOG/BQTR_FIELD y se propagan automáticamente los campos Modificado por, Se cambió el y Se cambió a las.

Cambia la compresión de registros a nivel del campo

Para mejorar el rendimiento de la replicación, BigQuery Toolkit para SAP comprime los registros omitiendo todos los campos vacíos en el registro de origen, que luego se inicializan con null en la tabla de destino de BigQuery. Sin embargo, si necesitas replicar algunos campos vacíos con sus valores iniciales en BigQuery y, al mismo tiempo, seguir usando la compresión de registros, puedes seleccionar Enviar marca sin comprimir para esos campos específicos.

Para obtener más información sobre el comportamiento de la compresión de registros, consulta Compresión de registros.

Para cambiar la compresión de registros a nivel del campo, haz lo siguiente:

  1. En la pantalla Mantenimiento de la configuración de transferencia de datos de BigQuery: Campos, muestra la lista de campos de la tabla cuya transferencia masiva estás configurando.

  2. Para enviar datos sin comprimir de un campo, selecciona la marca de enviar sin comprimir correspondiente al campo.

  3. Haz clic en Guardar.

Obtenga asistencia

Google Cloud ofrece asistencia para problemas y preguntas relacionados con la instalación, configuración, operación y mantenimiento de BigQuery Toolkit para SAP. Sin embargo, la asistencia se limita al kit de herramientas en sí.

Google Cloud no admite otros componentes del entorno, como la infraestructura de red, las bases de datos, los sistemas operativos ni el software de terceros. Si tienes problemas relacionados con componentes del entorno que no sean de BigQuery Toolkit para SAP, comunícate con el proveedor o proveedor de asistencia adecuado.

Para las funciones que ofrece SAP, como el aprovisionamiento de datos operativos (ODP) y SAP Landscape Transformation (SLT), comunícate con el equipo de asistencia de SAP para obtener ayuda.

Para solucionar problemas con BigQuery Toolkit para SAP, consulta Cómo solucionar problemas de BigQuery Toolkit para SAP.

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