Instala y configura BigQuery Connector para SAP en una VM de Compute Engine

En esta guía, se muestra cómo instalar y configurar la versión 2.7 (más reciente) de BigQuery Connector for SAP en un servidor SAP LT Replication que se ejecuta en una máquina virtual (VM) de Compute Engine en Google Cloud.

En esta guía, se explica cómo preparar BigQuery, Sap Landscape Transformation Replication Server (SAP LT Replication Server) y BigQuery Connector para SAP a fin de replicar los datos de SAP de las aplicaciones SAP directamente y de forma segura a BigQuery en tiempo real.

Esta guía está destinada a los administradores de SAP, los administradores de Google Cloud y otros profesionales de datos y seguridad de SAP y Google Cloud.

Requisitos previos

Antes de instalar BigQuery Connector para SAP, asegúrate de que se cumplan los siguientes requisitos previos:

  • Leíste la Guía de planificación de BigQuery Connector para SAP. En la guía de planificación, se explican las opciones de BigQuery Connector para SAP, las consideraciones de rendimiento, la asignación de campos y otra información que necesitas para la configuración óptima de BigQuery Connector para SAP.
  • Si aún no tienes un proyecto de Google Cloud, crea uno:

    Ir al selector de proyectos

  • La facturación está habilitada en tu proyecto. Descubre cómo confirmar que tienes habilitada la facturación en un proyecto. Se requiere una cuenta de facturación para BigQuery, la API de transmisión de BigQuery y la descarga de BigQuery Connector para SAP.

  • El mantenimiento del software de SAP instalado es el actual y las versiones de todo el software de SAP son compatibles entre sí, como se documenta en la Matriz de disponibilidad de productos de SAP.

  • Las versiones del software de SAP que usas son compatibles con BigQuery Connector para SAP, como se documenta en los Requisitos de software.

  • Tienes las licencias de SAP correctas que son necesarias para replicar datos en cualquier destino mediante el SDK de SAP LT Replication Server. Para obtener más información sobre las licencias de SAP, consulta la Nota 2707835 de SAP.

  • SAP LT Replication Server está instalado. Para obtener información sobre la instalación de SAP LT Replication Server, consulta la documentación de SAP.

  • Se configuró la conexión de base de datos o RFC entre SAP LT Replication Server y el sistema de origen. Si es necesario, prueba las conexiones RFC mediante la transacción SM59 de SAP. Prueba las conexiones de base de datos mediante la transacción DBACOCKPIT de SAP.

Descripción general del proceso de instalación y configuración

En la siguiente tabla, se muestran los procedimientos que se analizan en esta guía y los roles que suelen realizarlas.

Procedimiento Rol
Si es necesario, después de validar todas las licencias adecuadas de SAP, sigue las instrucciones de SAP para instalar un SAP Landscape Transformation Replication Server. Administrador de SAP.
Si es necesario, instala el complemento de interfaz de usuario (IU) para SAP NetWeaver. Para obtener más información, consulta Requisitos de versión de software de SAP. Administrador de SAP.
Habilita las APIs de Google Cloud requeridas. Administrador de Google Cloud.
Si es necesario, instala gcloud CLI en el host de SAP LT Replication Server. Administrador de SAP.
Crea un conjunto de datos de BigQuery. Administrador de Google Cloud o ingeniero de datos.
Configura la autenticación y la autorización de Google Cloud. Administrador de seguridad de Google Cloud.
Descarga el paquete de instalación de BigQuery Connector para SAP. Titular de la cuenta de Facturación de Google Cloud.
Instala BigQuery Connector para SAP. Administrador de SAP.
Crea roles y permisos de SAP para BigQuery Connector para SAP. Administrador de SAP.
Configurar la replicación Administradores o ingenieros de datos.
Replicación de prueba. Administradores o ingenieros de datos.
Valida la replicación. Administradores o ingenieros de datos.

Habilita las APIs de Google Cloud requeridas

Antes de que BigQuery Connector para SAP pueda acceder a BigQuery, debes habilitar las siguientes APIs de Google Cloud:

  • La API de BigQuery
  • La API de Service Account Credentials de IAM

Para obtener información sobre cómo habilitar las APIs de Google Cloud, consulta Habilita las APIs.

Instala gcloud CLI

Para la replicación en BigQuery, la cuenta de usuario sidadm debe tener acceso a Google Cloud CLI (CLI de gcloud) en el host de SAP LT Replication Server.

gcloud CLI está instalada en la mayoría de las VM de Compute Engine de forma predeterminada. Puedes confirmar la instalación si emites gcloud components list. Si no se reconoce el comando, debes instalar gcloud CLI.

Un administrador de SAP puede instalar gcloud CLI.

Para instalar la CLI de gcloud, completa los siguientes pasos:

  1. Sigue las instrucciones de instalación de la CLI de gcloud.

  2. Sigue las instrucciones de configuración de gcloud CLI.

  3. Autoriza a la cuenta de usuario sidadm para que acceda al directorio de instalación de la CLI de gcloud.

  4. De manera opcional, como sidadm, configura el proyecto predeterminado de gcloud CLI:

    gcloud config set project PROJECT_ID

    Reemplaza PROJECT_ID por el ID del proyecto que contiene tu conjunto de datos de BigQuery. Por ejemplo, example-project-123456.

    Si no configuras un proyecto predeterminado para gcloud CLI, la propiedad --project debe especificarse en cada comando gcloud que se emite.

A fin de obtener más información sobre el requisito de BigQuery Connector para SAP para la CLI de gcloud, consulta Requisito de la CLI de gcloud.

Cree un conjunto de datos de BigQuery

Antes de poder probar la autenticación y la autorización de Google Cloud para BigQuery o crear tablas de destino de BigQuery, tú o un administrador o ingeniero de datos o deben crear 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.

  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.

    El diagrama se describe en el texto anterior

  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.

Después de configurar la autenticación y la autorización de Google Cloud, recupera la información sobre este conjunto de datos para probar el acceso a Google Cloud.

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

Configura la autenticación y autorización de Google Cloud

Para la autenticación en Google Cloud y la autorización para acceder a BigQuery, un administrador de seguridad de Google Cloud y un administrador de SAP deben realizar estas acciones:

  • Crear una cuenta de servicio para BigQuery Connector para SAP.
  • Otorgar a la cuenta de servicio los roles de IAM necesarios para acceder a BigQuery.
  • Agregar la cuenta de servicio de BigQuery Connector para SAP como principal en el proyecto de BigQuery.
  • Establecer la configuración de seguridad para Google Cloud en el host de SAP LT Replication Server.
    • Otorgar el permiso de la VM del host para obtener tokens de acceso.
    • Si es necesario, modifica los permisos de acceso a la API de la VM del host.

Cree una cuenta de servicio

BigQuery Connector para SAP necesita una cuenta de servicio de IAM a fin de realizar la autenticación y la autorización para acceder a BigQuery.

Esta cuenta de servicio debe ser una principal en el proyecto de Google Cloud que contiene tu conjunto de datos de BigQuery. Si creas la cuenta de servicio en el mismo proyecto que el conjunto de datos de BigQuery, la cuenta de servicio se agrega como principal al proyecto de forma automática.

Si creas la cuenta de servicio en un proyecto que no sea el que contiene el conjunto de datos de BigQuery, debes agregar la cuenta de servicio al proyecto del conjunto de datos de BigQuery en un paso adicional.

Para crear una cuenta de servicio, completa los siguientes pasos:

  1. En la consola de Google Cloud, ve a la página Cuentas de servicio de IAM y administración.

    Ir a Cuentas de servicio

  2. Si se te solicita, selecciona tu proyecto de Google Cloud.

  3. Haz clic en Crear cuenta de servicio.

  4. Especifica un nombre para la cuenta de servicio y, de forma opcional, una descripción.

  5. Haga clic en Crear y continuar.

  6. Si creas la cuenta de servicio en el mismo proyecto que el conjunto de datos de BigQuery, en el panel Otorgar a esta cuenta de servicio acceso al proyecto, selecciona los siguientes roles:

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

    Si creas la cuenta de servicio en un proyecto diferente que el conjunto de datos de BigQuery, no otorgues ningún rol a la cuenta de servicio.

  7. Haga clic en Continuar.

  8. Según corresponda, otorga otro acceso a los usuarios a la cuenta de servicio.

  9. Haz clic en Listo. La cuenta de servicio aparece en la lista de cuentas de servicio del proyecto.

  10. Si creaste la cuenta de servicio en un proyecto diferente al del proyecto que contiene el conjunto de datos de BigQuery, anota el nombre de la cuenta de servicio. Debes especificar el nombre cuando agregas la cuenta de servicio al proyecto de BigQuery. Para obtener más información, consulta Agrega la cuenta de servicio al proyecto de BigQuery.

La cuenta de servicio ahora aparece como una principal en la página Permisos de IAM del proyecto de Google Cloud en el que se creó la cuenta de servicio.

Agrega la cuenta de servicio al proyecto de BigQuery

Si creaste la cuenta de servicio de BigQuery Connector para SAP en un proyecto que no es el que contiene el conjunto de datos de destino de BigQuery, debes agregar la cuenta de servicio al proyecto de conjunto de datos de BigQuery.

Si creaste la cuenta de servicio en el mismo proyecto que el conjunto de datos de BigQuery, puedes omitir este paso.

Para agregar una cuenta de servicio existente al proyecto del conjunto de datos de BigQuery, completa los siguientes pasos:

  1. En la consola de Google Cloud, ve a la página de permisos de IAM.

    Ir a Permisos de IAM

  2. Confirma que el nombre del proyecto que contiene el conjunto de datos de destino de BigQuery se muestra cerca de la parte superior de la página. Por ejemplo:

    Permisos del proyecto "PROJECT_NAME"

    Si no es así, cambia de proyecto.

  3. En la página IAM, haz clic en Agregar. Se abre el cuadro de diálogo Agregar principales a “PROJECT_NAME.

  4. En el diálogo Agregar principales a “PROJECT_NAME, completa los siguientes pasos:

    1. En el campo Principales nuevas, especifica el nombre de la cuenta de servicio.
    2. En el campo Selecciona un rol, especifica BigQuery Data Editor.
    3. Haz clic en AGREGAR OTRA FUNCIÓN. Vuelve a aparecer el campo Selecciona un rol.
    4. En el campo Seleccionar una función, especifica Usuario de trabajo de BigQuery.
    5. Haz clic en Guardar. La cuenta de servicio aparece en la lista de principales del proyecto en la página IAM.

La cuenta de servicio ahora se puede usar para acceder al conjunto de datos de BigQuery de este proyecto.

Configura la seguridad en la VM host

BigQuery Connector para SAP requiere que la VM de Compute Engine que aloja SAP LT Replication Server esté configurada con las siguientes opciones de seguridad:

  • Los permisos de acceso de la VM host deben configurarse para permitir el acceso completo a las API de Cloud.
  • La cuenta de servicio de la VM host debe incluir el rol de creador de tokens de cuenta de servicio de IAM.

Si estas opciones no están configuradas en la VM host, debes configurarlas.

Para cambiar los permisos de acceso de una VM, debes detenerla.

Verifica los permisos de acceso a la API de la VM host

Comprueba la configuración actual del permiso de acceso de la VM host de SAP LT Replication Server. Si la VM ya tiene acceso completo a todas las API de Cloud, no es necesario que cambies los permisos de acceso.

Para verificar el permiso de acceso de una VM host, completa los siguientes pasos:

Consola de Google Cloud

  1. En la consola de Google Cloud, abre la página Instancias de VM:

    Ir a Instancias de VM

  2. Si es necesario, selecciona el proyecto de Google Cloud que contiene el host de SAP LT Replication Server.

  3. En la página de instancias de VM, haz clic en el nombre de la VM host. Se abrirá la página de detalles de la VM.

  4. En Administración de identidades y API en la página de detalles de la VM host, verifica la configuración actual de los permisos de acceso a la API de Cloud:

    • Si la configuración es Permitir el acceso total a todas las API de Cloud, la configuración es correcta y no es necesario que la modifiques.
    • Si la configuración no es Permitir el acceso total a todas las API de Cloud, debes detener la VM y cambiar la configuración. Para obtener instrucciones, consulta la siguiente sección.

gcloud CLI

  1. Muestra los permisos de acceso actuales de la VM host:

    gcloud compute instances describe VM_NAME --zone=VM_ZONE --format="yaml(serviceAccounts)"

    Si los permisos de acceso no incluyen https://www.googleapis.com/auth/cloud-platform, debes cambiar los permisos de acceso de la VM host. Por ejemplo, si crearas una instancia de VM con una cuenta de servicio predeterminada de Compute Engine, tendrías que cambiar los siguientes permisos de acceso predeterminados:

    serviceAccounts:
    - email: 600915385160-compute@developer.gserviceaccount.com
      scopes:
      - https://www.googleapis.com/auth/devstorage.read_only
      - https://www.googleapis.com/auth/logging.write
      - https://www.googleapis.com/auth/monitoring.write
      - https://www.googleapis.com/auth/servicecontrol
      - https://www.googleapis.com/auth/service.management.readonly
      - https://www.googleapis.com/auth/trace.append

    Si el único alcance enumerado en scopes es https://www.googleapis.com/auth/cloud-platform, como en el siguiente ejemplo, no es necesario que cambies los permisos:

    serviceAccounts:
    - email: 600915385160-compute@developer.gserviceaccount.com
      scopes:
      - https://www.googleapis.com/auth/cloud-platform

Cambia los permisos de acceso a la API de la VM host

Si la VM host de SAP LT Replication Server no tiene acceso completo a las API de Google Cloud, cambia los permisos de acceso para permitir el acceso completo a todas las API de Cloud.

Para cambiar la configuración de los permisos de acceso a la API de Cloud para una VM host, completa los siguientes pasos:

Consola de Google Cloud

  1. Si es necesario, limita los roles que se otorgan a la cuenta de seguridad de la VM host.

    Puedes encontrar el nombre de la cuenta de seguridad en la página de detalles de la VM host en Administración de identidades y API. Puedes cambiar los roles que se otorgan a una cuenta de servicio en la consola de Google Cloud en la sección Principales de la página de IAM.

  2. Si es necesario, detén todas las cargas de trabajo que se ejecutan en la VM host.

  3. En la consola de Google Cloud, abre la página Instancias de VM:

    Ir a Instancias de VM

  4. En la página de instancias de VM, haz clic en el nombre de la VM host para abrir la página de detalles de la VM.

  5. En la parte superior de la página de detalles de la VM host, haz clic en DETENER para detener la VM host.

  6. Después de detener la VM, haz clic en EDITAR.

  7. En Seguridad y acceso > Permiso de acceso, selecciona Permitir acceso completo a todas las API de Cloud.

  8. Haz clic en Guardar.

  9. En la parte superior de la página de detalles de la VM del host, haz clic en INICIAR/REANUDAR para iniciar la VM host.

  10. Según sea necesario, reinicia las cargas de trabajo que se detienen en la VM host.

gcloud CLI

  1. Si es necesario, ajusta los roles de IAM que se otorgan a la cuenta de servicio de VM para garantizar que el acceso a los servicios de Google Cloud desde la VM host esté restringido de forma adecuada.

    Para obtener información sobre cómo cambiar los roles que se otorgan a una cuenta de servicio, consulta Actualiza una cuenta de servicio.

  2. Si es necesario, detén cualquier software de SAP que se ejecute en la VM host.

  3. Detén la VM:

    gcloud compute instances stop VM_NAME --zone=VM_ZONE
  4. Cambia los permisos de acceso de la VM:

    gcloud compute instances set-service-account VM_NAME --scopes=cloud-platform --zone=VM_ZONE
  5. Inicia la VM:

    gcloud compute instances start VM_NAME --zone=VM_ZONE
  6. Si es necesario, inicia el software SAP que se ejecuta en la VM host.

Habilita la VM host para obtener tokens de acceso

Debes otorgar permiso a la cuenta de servicio de la VM host para obtener los tokens de acceso que requiere BigQuery Connector para SAP a fin de acceder a BigQuery.

A fin de otorgar permiso para crear tokens de acceso, completa los siguientes pasos:

  1. En la consola de Google Cloud, abre la página Instancias de VM:

    Ir a Instancias de VM

  2. En la página de instancias de VM, haz clic en el nombre de la VM host para abrir la página de detalles de la VM.

  3. En la página de detalles de la VM, en Administración de identidades y API, toma nota del nombre de la cuenta de servicio. El siguiente nombre de ejemplo es para una cuenta de servicio de Compute Engine predeterminada:

    SVC-ACCT-NUMBER-compute@developer.gserviceaccount.com
  4. En la consola de Google Cloud, ve a la página IAM.

    Ir a Permisos de IAM

  5. En la lista de principales del proyecto, busca el nombre de la cuenta de servicio y haz clic en Editar principal. Se abrirá el cuadro de diálogo Editar permisos.

  6. En el diálogo Editar permisos, haz clic en AGREGAR OTRO ROL. Aparecerá el campo Selecciona un rol.

  7. En el campo Selecciona un rol, especifica Creador de tokens de cuenta de servicio.

  8. Haz clic en Guardar. Volverás a la página de permisos de IAM.

La VM host ahora tiene permiso para crear tokens de acceso.

Configura certificados SSL y HTTPS

La comunicación entre BigQuery Connector para SAP y la API de BigQuery está protegida mediante SSL y HTTPS.

  1. Descarga los siguientes certificados del repositorio de Google Trust Services:

    • GTS Root R1
    • GTS CA 1C3
  2. En la GUI de SAP, usa la transacción STRUST para importar el certificado raíz y el subordinado a la carpeta de PSE SSL client SSL Client (Standard).

    Para obtener más información sobre SAP, consulta la Ayuda de SAP: Mantén la lista de certificaciones de PSE.

  3. En el host de SAP LT Replication Server, confirma que las reglas o los proxies de firewall estén configurados para permitir el tráfico de salida del puerto HTTPS a la API de BigQuery.

    Específicamente, SAP LT Replication Server debe poder acceder a las siguientes APIs de Google Cloud:

    • https://bigquery.googleapis.com
    • https://iamcredentials.googleapis.com

    Si deseas que BigQuery Connector for SAP acceda a las APIs de Google Cloud a través de extremos de Private Service Connect en tu red de VPC, debes hacer configurar destinos de RFC y especificar tus extremos de Private Service Connect en esos destinos de RFC. Para obtener más información, consulta Destinos de RFC.

Para obtener más información de SAP sobre la configuración de SSL, consulta la Nota 510007 de SAP: Consideraciones adicionales sobre la configuración de SSL en Application Server ABAP.

Valida puertos HTTP y HTTPS en Internet Communications Manager (ICM)

Los metadatos de VM se almacenan en un servidor de metadatos, al que solo se puede acceder a través de un puerto HTTP. Por lo tanto, debes asegurarte de que se cree y esté activo un puerto HTTP junto con un puerto HTTPS para acceder a los metadatos de VMs.

  1. En la GUI de SAP, ingresa el código de transacción SMICM.
  2. En la barra de menú, haz clic en Ir a > Servicios. Una marca de verificación verde en la columna Actv indica que los puertos HTTP y HTTPS están activos.

Para obtener información sobre la configuración de los puertos HTTP y HTTPS, consulta Configuración de HTTP(S) en ICM.

Prueba la autenticación y autorización de Google Cloud

Confirma que configuraste la autenticación de Google Cloud de forma correcta mediante la solicitud de un token de acceso y la recuperación de información sobre tu conjunto de datos de BigQuery.

Usa el siguiente procedimiento para probar tu autenticación y autorización de Google Cloud desde la VM host de SAP LT Replication Server:

  1. En la VM host de SAP LT Replication Server, abre una shell de línea de comandos.

  2. Cambia al usuario sidadm.

  3. Solicita el primer token de acceso al servidor de metadatos de la VM host:

    curl "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/token" -H "Metadata-Flavor: Google"

    El servidor de metadatos muestra un token de acceso similar al siguiente ejemplo, en el que ACCESS_TOKEN_STRING_1 es una string de token de acceso que copias en el comando en el siguiente paso:

    {"access_token":"ACCESS_TOKEN_STRING_1",
    "expires_in":3599,"token_type":"Bearer"}
  4. Solicita el segundo token de acceso a la API de IAM mediante la ejecución del siguiente comando después de reemplazar los valores de marcador de posición:

    Linux

    curl --request POST \
    "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/SERVICE_ACCOUNT:generateAccessToken" \
      --header "Authorization: Bearer ACCESS_TOKEN_STRING_1" \
      --header "Accept: application/json" \
      --header "Content-Type: application/json" \
      --data "{"scope":["https://www.googleapis.com/auth/bigquery"],"lifetime":"300s"}" \
      --compressed
    

    Windows

    curl --request POST `
    "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/SERVICE_ACCOUNT:generateAccessToken" `
      --header "Authorization: Bearer ACCESS_TOKEN_STRING_1" `
      --header "Accept: application/json" `
      --header "Content-Type: application/json" `
      --data "{"scope":["https://www.googleapis.com/auth/bigquery"],"lifetime":"300s"}" `
      --compressed
    

    Reemplaza lo siguiente:

    • SERVICE_ACCOUNT: La cuenta de servicio que creaste para BigQuery Connector para SAP en un paso anterior.
    • ACCESS_TOKEN_STRING_1: es la primera string de token de acceso del paso anterior.

    La API de IAM muestra un segundo token de acceso, ACCESS_TOKEN_STRING_2, que es similar al siguiente ejemplo. En el siguiente paso, debes copiar esta segunda string de token en una solicitud a la API de BigQuery.

    {"access_token":"ACCESS_TOKEN_STRING_2","expires_in":3599,"token_type":"Bearer"}
  5. Recupera información sobre tu conjunto de datos de BigQuery desde la API de BigQuery mediante la emisión del siguiente comando después de reemplazar los valores de marcador de posición:

    Linux

    curl "https://bigquery.googleapis.com/bigquery/v2/projects/PROJECT_ID/datasets/DATASET_NAME" \
    -H "Accept: application/json" -H "Authorization: Bearer ACCESS_TOKEN_STRING_2"
    

    Windows

    curl "https://bigquery.googleapis.com/bigquery/v2/projects/PROJECT_ID/datasets/DATASET_NAME" `
    -H "Accept: application/json" -H "Authorization: Bearer ACCESS_TOKEN_STRING_2"
    

    Reemplaza lo siguiente:

    • PROJECT_ID: es el ID del proyecto que contiene tu conjunto de datos de BigQuery.
    • DATASET_NAME: es el nombre del conjunto de datos de destino según lo definido en BigQuery.
    • ACCESS_TOKEN_STRING_2: es la string de token de acceso que muestra la API de IAM en el paso anterior.

    Si la autenticación de Google Cloud está configurada de forma correcta, se mostrará información sobre el conjunto de datos.

    Si no está configurado correctamente, consulta Solución de problemas de BigQuery Connector para SAP.

Descarga el paquete de instalación

Descarga el paquete de instalación de BigQuery Connector para SAP más reciente desde el portal de descarga de BigQuery Connector para SAP.

Necesitas el número de Facturación de Cloud para completar la descarga. Para obtener información sobre las cuentas de facturación, consulta Facturación de Cloud y perfil de pagos.

El paquete de instalación incluye archivos de transporte que copias en el directorio de transporte adecuado para SAP LT Replication Server.

Instala BigQuery Connector para SAP

Después de recibir el paquete de instalación que contiene los archivos de transporte de BigQuery Connector para SAP, tu administrador de SAP puede instalar BigQuery Connector para SAP mediante la importación de archivos de transporte a SAP LT Replication Server.

El transporte SAP de BigQuery Connector para SAP contiene todos los objetos necesarios para BigQuery Connector para SAP, incluidos el espacio de nombres /GOOG/, los objetos DDIC, la implementación y las clases de BADI del SDK de SLT programas de informes y mucho más.

Antes de importar los archivos de transporte a SAP LT Replication Server, verifica que SAP LT Replication Server sea compatible con BigQuery Connector para SAP, como se documenta en Requisitos de software.

A pesar de usar una versión compatible de SAP LT Replication Server, en algunos casos, mientras importas los archivos de transporte, es posible que veas el mensaje de error Requests do not match the component version of the target system. En esos casos, debes volver a importar los archivos de transporte a SAP LT Replication Server y, durante la importación, en la pantalla Solicitud de importación de transporte, ve a la pestaña Opciones y, luego, selecciona la casilla de verificación Ignorar versión de componente no válida.

El siguiente procedimiento es general. Cada sistema SAP es diferente, por lo que debes trabajar con tu administrador de SAP para determinar cualquier cambio en el procedimiento que podría ser necesario en tu sistema SAP:

  1. Copia los archivos de transporte de BigQuery Connector para SAP en los siguientes directorios de importación de transporte de SAP LT Replication Server:

    • /usr/sap/trans/cofiles/KXXXXXX.ED1
    • /usr/sap/trans/data/RXXXXXX.ED1

    En los ejemplos anteriores, XXXXXX representa el nombre del archivo numerado.

  2. En la GUI de SAP, usa el código de transacción STMS_IMPORT o STMS para importar los archivos al sistema SAP.

  3. Asegúrate de que todos los objetos del paquete /GOOG/SLT_SDK estén activos y sean coherentes:

    1. En la interfaz de SAP, ingresa el código de transacción SE80.
    2. En el selector de paquetes, selecciona /GOOG/SLT_SDK.
    3. En el campo Nombre del objeto, haz clic con el botón derecho en el paquete /GOOG/SLT_SDK y, luego, selecciona Verificación > Verificación de paquete > Objetos del paquete.

      Una marca de verificación verde en la columna Resultado indica que todos los objetos pasaron la verificación del paquete.

Confirma que BigQuery Connector para SAP esté listo para configurarse

Para confirmar que los archivos de transporte se importaron de forma correcta y que BigQuery Connector para SAP está listo para configurarse, confirma que la implementación del complemento de negocios (BAdI) de SAP esté activa y que BigQuery Las conexiones de las aplicaciones de replicación de SAP tienen entradas en la tabla IUUC_REPL_APPL.

  1. Verifica la implementación de BAdI:
    1. Usa la transacción SE80 para navegar y seleccionar la carpeta de objetos de mejora /GOOG/EI_IUUC_REPL_RUNTIME_BQ.
    2. Selecciona Elementos de implementación de mejora en el lado derecho de la página.
    3. En Comportamiento del entorno de ejecución, confirma que La implementación está activa esté verificado.
  2. Verifica las aplicaciones de replicación:
    1. Mediante el Navegador de datos de SAP o la transacción SE16, muestra la tabla IUUC_REPL_APPL.
    2. Confirma que las siguientes aplicaciones aparecen en la tabla IUUC_REPL_APPL:
      • /GOOG/SLT_BQ
      • ZGOOG_SLT_BQ, para su uso cuando el espacio de nombres /GOOG/ no está registrado

Crea roles y autorizaciones de SAP para BigQuery Connector para SAP

A fin de trabajar con BigQuery Connector para SAP, además de las autorizaciones estándar de SAP LT Replication Server, los usuarios necesitan acceso a las transacciones personalizadas que se proporcionan con BigQuery Connector para SAP: /GOOG/SLT_SETTINGS y /GOOG/REPLIC_VALID.

Para usar la herramienta de simulación de cargas, los usuarios necesitan acceso a la transacción personalizada /GOOG/LOAD_SIMULATE que se proporciona con BigQuery Connector para SAP.

De forma predeterminada, los usuarios que tienen acceso a las transacciones personalizadas /GOOG/SLT_SETTINGS y /GOOG/REPLIC_VALID pueden modificar la configuración de cualquier configuración, por lo que, si lo necesitas, puedes restringir el acceso a configuraciones específicas. En el caso de los usuarios que solo necesitan ver la configuración de BigQuery Connector para SAP, puedes otorgarles acceso de solo lectura a la transacción personalizada /GOOG/SLT_SETT_DISP.

Los archivos de transporte de BigQuery Connector para SAP incluyen el objeto Google BigQuery Settings Authorization, ZGOOG_MTID, para las autorizaciones específicas de BigQuery Connector para SAP.

Para otorgar acceso a las transacciones personalizadas y restringir el acceso a configuraciones específicas, sigue estos pasos:

  1. Mediante el código de transacción PFCG de SAP, define un rol para BigQuery Connector para SAP.

  2. Otorga al rol acceso a las transacciones personalizadas /GOOG/SLT_SETTINGS, /GOOG/REPLIC_VALID y /GOOG/LOAD_SIMULATE.

  3. Para limitar el acceso de una función, especifica el grupo de autorización de cada configuración a la que puede acceder el rol con el objeto de autorización ZGOOG_MTID. Por ejemplo:

    • Objeto de autorización para BigQuery Connector para SAP (ZGOOG_MTID):
      • Activity 01
      • Authorization Group AUTH_GROUP_1,AUTH_GROUP_N

    AUTH_GROUP_01 y AUTH_GROUP_N son valores que se definen en la configuración de SAP LT Replication Server.

    Los grupos de autorización especificados para ZGOOG_MTID deben coincidir con los grupos de autorización que se especifican para el rol en el objeto de autorización S_DMIS_SLT de SAP.

Crea roles y autorizaciones de SAP para ver la configuración de BigQuery Connector para SAP

Para otorgar acceso de solo lectura a la transacción personalizada /GOOG/SLT_SETT_DISP, sigue estos pasos:

  1. Mediante el código de transacción PFCG de SAP, define un rol para ver la configuración de BigQuery Connector para SAP.

  2. Otorga al rol acceso a la transacción personalizada /GOOG/SLT_SETT_DISP.

  3. Agrega el objeto de autorización para BigQuery Connector para SAP (ZGOOG_MTID) con los siguientes atributos:

    • Activity 03
    • Authorization Group = *
  4. Genera el perfil de rol y asigna usuarios relevantes al rol.

Configurar la replicación

Si deseas configurar la replicación, especifica la configuración de BigQuery Connector para SAP y SAP LT Replication Server.

Especifica la configuración de acceso en /GOOG/CLIENT_KEY

Usa la transacción SM30 para especificar la configuración de acceso a BigQuery. BigQuery Connector para SAP almacena la configuración como un registro en la tabla de configuración personalizada /GOOG/CLIENT_KEY.

Para especificar la configuración de acceso, sigue estos pasos:

  1. En la GUI de SAP, ingresa el código de transacción SM30.

  2. Selecciona la tabla de configuración /GOOG/CLIENT_KEY.

  3. Ingresa los valores para los siguientes campos de tabla:

    Campo Tipo de datos Descripción
    Nombre String Es el nombre de esta configuración de CLIENT_KEY.
    Nombre de la cuenta de servicio String

    El nombre de la cuenta de servicio, en formato de dirección de correo electrónico, que se creó para BigQuery Connector para SAP en el paso Crea una cuenta de servicio. Por ejemplo: sap-example-svc-acct@example-project-123456.iam.gserviceaccount.com.

    Alcance String

    Especifica el permiso de acceso a la API de https://www.googleapis.com/auth/cloud-platform, como lo recomienda Compute Engine. Este permiso de acceso corresponde a la configuración Allow full access to all Cloud APIs en la VM host. Para obtener más información, consulta Configura los permisos de acceso en la VM host.

    ID del proyecto String Es el ID del proyecto que contiene tu conjunto de datos de BigQuery de destino.
    Nombre del comando String

    Deja este campo en blanco.

    Clase de autorización String Es la clase de autorización que se usará para la replicación.

    Especifica /GOOG/CL_GCP_AUTH_GOOGLE.

    Campo de autorización No aplicable Deja este campo en blanco.
    Segundos de actualización de los tokens Número entero

    La cantidad de tiempo en segundos antes de que caduque un token de acceso y se deba actualizar. El valor predeterminado es 3500.

    Especificar un valor de 1 a 3599 anula la fecha y hora de vencimiento predeterminada de 3500 segundos. Si especificas 0, BigQuery Connector para SAP usa el valor predeterminado.

    Almacenamiento en caché de tokens Booleano La marca que determina si los tokens de acceso recuperados de Google Cloud se almacenan en caché.

    Te recomendamos que habilites el almacenamiento en caché de tokens después de que termines de configurar BigQuery Connector para SAP y probar tu conexión a Google Cloud. Para obtener más información sobre el almacenamiento en caché de tokens, consulta Habilita el almacenamiento en caché de tokens.

Configura destinos de RFC

A fin de conectar BigQuery para SAP a Google Cloud, te recomendamos que uses destinos RFC.

Si deseas configurar los destinos de RFC para tu replicación, sigue estos pasos:

  1. En la GUI de SAP, ingresa el código de transacción SM59.

  2. (Recomendado) Crea nuevos destinos de RFC mediante la copia de los destinos de RFC de muestra GOOG_BIGQUERY y GOOG_IAMCREDENTIALS y, luego, toma nota de los nombres de los nuevos destinos de RFC. Los usarás en pasos posteriores.

    BigQuery Connector para SAP usa destinos de RFC a fin de conectarse a las APIs de IAM y BigQuery, respectivamente.

    Si deseas probar la conectividad basada en el destino de RFC, puedes omitir este paso y usar los destinos de RFC de muestra.

  3. Para los destinos de RFC que creaste, completa los siguientes pasos:

    1. Ve a la pestaña Configuración técnica y asegúrate de que el campo Número de servicio esté configurado con el valor 443. Este es el puerto que usa el destino de RFC para una comunicación segura.

    2. Ve al Inicio de sesión y seguridad y asegúrate de que el Certificado SSL se establece el campo con la opción Cliente SSL de CDAULT (estándar).

    3. De manera opcional, puedes configurar el proxy, habilitar la compresión HTTP y especificar los extremos de Private Service Connect.

    4. Guarde los cambios.

    5. Para probar la conexión, haz clic en Prueba de conexión.

      Una respuesta que contiene 404 Not Found es aceptable y esperada porque el extremo especificado en el destino de RFC corresponde a un servicio de Google Cloud y no a un recurso específico que aloja el servicio. Esta respuesta indica que se puede acceder al servicio de destino de Google Cloud y que no se encontró ningún recurso de destino.

  4. En la GUI de SAP, ingresa el código de transacción SM30.

  5. En la tabla /GOOG/CLIENT_KEY que creaste en la sección anterior, ten en cuenta el valor del campo Nombre.

  6. En la tabla /GOOG/SERVIC_MAP, crea entradas con los siguientes valores de campo:

    Nombre de la clave de Google Cloud Nombre del servicio de Google Destino de RFC
    CLIENT_KEY_TABLE_NAME bigquery.googleapis.com Especifica el nombre de tu destino de RFC que se orienta a BigQuery. Si usas el destino de RFC de muestra para fines de prueba, especifica GOOG_BIGQUERY.
    CLIENT_KEY_TABLE_NAME iamcredentials.googleapis.com Especifica el nombre de tu destino de RFC que se orienta a IAM. Si usas el destino de RFC de muestra para realizar pruebas, especifica GOOG_IAMCREDENTIALS.

    Reemplaza CLIENT_KEY_TABLE_NAME por el nombre de la clave del cliente que anotaste en el paso anterior.

Establece la configuración del proxy

Cuando usas destinos de RFC a fin de conectarte a Google Cloud, puedes enrutar la comunicación desde BigQuery Connector para SAP a través del servidor proxy que usas en tu entorno de SAP.

Si no deseas usar un servidor proxy o no tienes uno en tu entorno de SAP, puedes omitir este paso.

Si deseas establecer la configuración del servidor proxy para BigQuery Connector para SAP, completa los siguientes pasos:

  1. En la GUI de SAP, ingresa el código de transacción SM59.

  2. Selecciona tu destino de RFC que se dirija a IAM.

  3. Ve a la pestaña Configuración técnica y, luego, ingresa valores para los campos en la sección Opciones del proxy HTTP.

  4. Repite el paso anterior para tu destino de RFC que se orienta a BigQuery.

Habilita la compresión HTTP

Cuando usas destinos de RFC para conectarte a Google Cloud, puedes habilitar la compresión HTTP.

Si no deseas habilitar esta función, puedes omitir este paso.

Para habilitar la compresión HTTP, sigue estos pasos:

  1. En la GUI de SAP, ingresa el código de transacción SM59.

  2. Selecciona tu destino de RFC que se oriente a BigQuery.

  3. Ve a la pestaña Opciones especiales.

  4. En el campo Versión de HTTP, selecciona HTTP 1.1.

  5. En el campo Compresión, selecciona un valor adecuado.

    Para obtener información sobre las opciones de compresión, consulta la Nota de SAP 1037677: La compresión HTTP solo comprime ciertos documentos.

Especifica extremos de Private Service Connect

Si quieres que BigQuery Connector para SAP use extremos de Private Service Connect a fin de permitir el consumo privado de IAM y BigQuery, debes crear esos extremos en el proyecto de Google Cloud y especificarlos en los destinos RFC correspondientes.

Si deseas que BigQuery Connector para SAP continúe usando los extremos de API pública y predeterminados para conectarse a BigQuery y la IAM, omite este paso.

Si deseas configurar BigQuery Connector para SAP para que use tus extremos de Private Service Connect, completa los siguientes pasos:

  1. En la GUI de SAP, ingresa el código de transacción SM59.

  2. Valida que hayas creado nuevos destinos de RFC para BigQuery y la IAM. Si deseas obtener instrucciones para crear estos destinos de RFC, consulta Configura destinos RFC.

  3. Selecciona el destino de RFC que se orienta a BigQuery y, luego, completa los siguientes pasos:

    1. Ve a la pestaña Configuración técnica.

    2. En el campo Host de destino, ingresa el nombre del extremo de Private Service Connect que creaste para acceder a BigQuery.

    3. Ve a la pestaña Inicio de sesión y seguridad.

    4. En el campo Número de servicio, asegúrate de que se especifique ese valor 443.

    5. En el campo Certificado SSL, asegúrate de que la opción Cliente SSL de DFAULT (estándar) esté seleccionada.

  4. Selecciona el destino de RFC que se orienta a IAM y, luego, completa los siguientes pasos:

    1. Ve a la pestaña Configuración técnica.

    2. En el campo Host de destino, ingresa el nombre del extremo de Private Service Connect que creaste para acceder a IAM.

    3. Ve a la pestaña Inicio de sesión y seguridad.

    4. En el campo Número de servicio, asegúrate de que se especifique ese valor 443.

    5. En el campo Certificado SSL, asegúrate de que la opción Cliente SSL de DFAULT (estándar) esté seleccionada.

Habilita el almacenamiento en caché de tokens

A fin de mejorar el rendimiento de la replicación, te recomendamos que habilites el almacenamiento en caché para el token de acceso que obtiene la cuenta de servicio de tu VM host para acceder a BigQuery.

Habilitar el almacenamiento en caché de tokens garantiza que el token de acceso se vuelva a usar hasta que este venza o se revoque, lo que, a su vez, reduce la cantidad de llamadas HTTP realizadas para recuperar nuevos tokens de acceso.

Para habilitar el almacenamiento en caché de tokens, selecciona la marca Almacenamiento en caché de tokens en la tabla de claves de cliente /GOOG/CLIENT_KEY.

Cuando habilitas el almacenamiento en caché de tokens, el token de acceso se almacena en la memoria compartida de tu servidor de aplicaciones de SAP LT Replication Server durante el tiempo que se configura para el campo Segundos de actualización del token en /GOOG/CLIENT_KEY. Si no se especifica Segundos de actualización dei token o se configura como 0, el token de acceso se almacena en caché para el valor especificado en el parámetro CMD_SECS_DEFLT de la configuración avanzada.

En el caso de las cargas de trabajo de SAP que se ejecutan en Google Cloud y usan una cuenta de servicio administrada por el usuario para acceder a BigQuery, el almacenamiento en caché de tokens puede generar una mejora significativa, ya que la recuperación de un token de acceso en esta situación implica realizar dos llamadas HTTP. Para obtener información sobre la recuperación de tokens, consulta Prueba la autenticación y autorización de Google Cloud.

Borra el token de acceso almacenado en caché

Cuando el almacenamiento en caché del token está habilitado y actualizas los roles asignados a la cuenta de servicio que BigQuery Connector para SAP usa para acceder a BigQuery, el token de acceso nuevo que corresponde a los roles actualizados se recupera solo después de que caduca el token existente. En esos casos, puedes borrar el token de acceso de forma manual.

Para borrar el token de acceso almacenado en caché, ingresa la transacción SE38 y, luego, ejecuta el programa /GOOG/R_CLEAR_TOKEN_CACHE.

Crea una configuración de replicación de SAP LT Replication Server

Usa la transacción LTRC de SAP para crear una configuración de replicación de SAP LT Replication Server.

Si SAP LT Replication Server se ejecuta en un servidor diferente que el sistema SAP de origen, antes de crear una configuración de replicación, confirma que tienes una conexión RFC entre los dos sistemas.

Algunas de las opciones de configuración de la replicación afectan el rendimiento. A fin de determinar los valores de configuración adecuados para tu instalación, consulta la Guía de optimización del rendimiento de tu versión de SAP LT Replication Server en el Portal de ayuda de SAP.

La interfaz y las opciones de configuración para SAP LT Replication Server pueden ser ligeramente diferentes según la versión que uses.

A fin de configurar la replicación, usa el procedimiento para tu versión de SAP LT Replication Server:

Configura la replicación en DMIS 2011 SP17, DMIS 2018 SP02 o versiones posteriores

Con los siguientes pasos, se configura la replicación en versiones posteriores de SAP LT Replication Server. Si usas una versión anterior, consulta Configura la replicación en DMIS 2011 SP16, DMIS 2018 SP01 o versiones anteriores.

  1. En la GUI de SAP, ingresa el código de transacción LTRC.

  2. Haz clic en el ícono Crear configuración. Se abrirá el asistente Crear configuración.

  3. En los campos Nombre de la configuración y Descripción, ingresa un nombre y una descripción para la configuración y, luego, haz clic en Siguiente.

    Puedes especificar el Grupo de autorización para restringir el acceso a un grupo de autorización específico ahora o especificarlo más tarde.

  4. En el panel Detalles de la conexión del sistema de origen, haz lo siguiente:

    • Selecciona el botón de selección Conexión RFC.
    • En el campo Destino RFC, especifica el nombre de la conexión RFC al sistema de origen.
    • Selecciona las casillas de verificación Permitir el uso múltiple y Leer desde un solo cliente según corresponda. Para obtener más información, consulta la documentación de SAP LT Replication Server.
    • Haz clic en Siguiente.

    Estos pasos son para una conexión RFC, pero si el origen es una base de datos, puedes seleccionar Conexión de base de datos si ya definiste una conexión mediante la transacción DBACOCKPIT.

  5. En el panel Target System Connection Details, haz lo siguiente:

    • Selecciona el botón de selección Otro.
    • En el campo Situación, selecciona SDK de SLT en el menú desplegable.
    • Haz clic en Siguiente.
  6. En el panel Especificar la configuración de transferencia:

    1. En el campo Aplicación de la sección Configuración de transferencia de datos, ingresa /GOOG/SLT_BQ o ZGOOG_SLT_BQ.

    2. En la sección Opciones de trabajo, ingresa los valores de inicio en cada uno de los siguientes campos:

      • Cantidad de trabajos de transferencia de datos
      • Cantidad de trabajos de carga iniciales
      • Cantidad de trabajos de cálculo
    3. En la sección Opciones de replicación, selecciona el botón de selección Tiempo real.

    4. Haz clic en Siguiente.

  7. Después de revisar la configuración, haz clic en Guardar.

  8. Toma nota del ID de tres dígitos en la columna Transferencia masiva. Lo usarás en un paso posterior.

Para obtener más información, consulta el PDF adjunto a la Nota de SAP 2652704: Replicating Data Using SLT SDK - DMIS 2011 SP17, DMIS 2018 SP02.pdf.

Configura la replicación en DMIS 2011 SP16, DMIS 2018 SP01 o versiones previas

Con los siguientes pasos, se configura la replicación en versiones anteriores de SAP LT Replication Server. Si usas una versión posterior, consulta Configura la replicación en DMIS 2011 SP17, DMIS 2018 SP02 o una versión posterior.

  1. En la GUI de SAP, ingresa el código de transacción LTRC.
  2. Haz clic en Nuevo. Se abrirá un cuadro de diálogo para especificar una configuración nueva.
  3. En el paso Especifica el sistema de origen, haz lo siguiente:
    • Elige Conexión RFC como el tipo de conexión.
    • Ingresa el nombre de la conexión RFC.
    • Asegúrate de que esté seleccionado el campo Permitir el uso múltiple.
  4. En el paso Especifica el sistema de destino, haz lo siguiente:
    • Ingresa los datos de conexión en el sistema de destino.
    • Elige Conexión RFC como el tipo de conexión.
    • En el campo Situación para la comunicación RFC, selecciona el valor Escribir datos en el destino mediante BAdI de la lista desplegable. La conexión RFC se establece de forma automática como NINGUNA.
  5. En el paso Especificar la configuración de transferencia, presiona F4 Ayuda. La aplicación que definiste antes se muestra en el campo Aplicación.
  6. Toma nota del ID de tres dígitos en la columna Transferencia masiva. Lo usarás en un paso posterior.

Para obtener más información, consulta el PDF adjunto a la Nota de SAP 2652704: Replicating Data Using SLT SDK - DMIS 2011 SP15, SP16, DMIS 2018 SP00, SP01.pdf

Crea una configuración de transferencia masiva para BigQuery

Usa la transacción /GOOG/SLT_SETTINGS personalizada a fin de configurar una transferencia masiva para BigQuery y especificar las asignaciones de campo y tabla.

Selecciona las opciones de transferencia masiva inicial

Cuando ingresas la transacción /GOOG/SLT_SETTINGS por primera vez, selecciona qué parte de la configuración de transferencia masiva de BigQuery necesitas editar.

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

  1. En la GUI de SAP, ingresa la transacción /GOOG/SLT_SETTINGS precedida por /n:

    /n/GOOG/SLT_SETTINGS
  2. En el menú desplegable Tabla de configuración, en la pantalla de lanzamiento de la transacción /GOOG/SLT_SETTINGS, selecciona Transferencias masivas.

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

  3. Haz clic en el ícono Ejecutar. Aparecerá la pantalla Mantenimiento de configuración 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.

SAP LT Replication Server guarda la configuración de la transferencia masiva como un registro en la tabla de configuración personalizada /GOOG/BQ_MASTR.

Los campos que especifiques en los siguientes pasos son obligatorios.

  1. En la pantalla Mantenimiento de configuración 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. En el campo ID de transferencia masiva, ingresa el ID de tres dígitos que se generó cuando creaste la configuración de replicación correspondiente de SAP LT Replication Server.
    3. 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.
    4. 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 de SAP LT Replication Server y la tabla de BigQuery, selecciona la casilla de verificación Marca de campos adicionales.

      Cuando se configura esta marca, BigQuery Connector 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.

    5. 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.

    6. 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.

    7. 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.

    8. En el campo Nombre de la clave de Google Cloud, ingresa el nombre de la configuración /GOOG/CLIENT_KEY correspondiente.

      BigQuery Connector for SAP recupera el identificador de proyecto de Google Cloud de forma automática desde la configuración /GOOG/CLIENT_KEY.

    9. En el campo Conjunto de datos de BigQuery, ingresa el nombre del conjunto de datos de destino de BigQuery que creaste antes en este procedimiento.

    10. 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

    11. Haz clic en Guardar.

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

    12. 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, en la segunda sección de la transacción /GOOG/SLT_SETTINGS.

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

Esta configuración es opcional.

Para especificar atributos de tabla, haz lo siguiente:

  1. Haz clic en el ícono Agregar fila.

  2. En el campo Nombre de la tabla de SAP, ingresa el nombre de la tabla de origen de SAP.

  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 Connector para SAP crea la tabla con este nombre. Para conocer las convenciones de nombres de BigQuery para las tablas, consulta Nombres de tablas.

  4. El campo Enviar marca sin comprimir inhabilita la compresión de registros. Especifica esta marca solo si necesitas que BigQuery Connector para SAP replique los campos vacíos en los registros de origen con los valores con los que se inicializaron los campos en la tabla de origen. Para obtener un mejor rendimiento, no especifiques esta marca. Para obtener más información, 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 Connector 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 Connector 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. Si deseas obtener más información, consulta Tamaño del fragmento en BigQuery Connector para SAP. 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 Connector 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/BQ_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 SAP LT Replication Server.

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 página Mantenimiento de la configuración de BigQuery: Campos de la transacción /GOOG/SLT_SETTINGS, muestra las asignaciones de campo predeterminadas para la transferencia masiva que estás configurando en este momento.

  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 página Mantenimiento de la configuración 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 Connector 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/BQ_FIELD y se propagan automáticamente los campos Modificado por, Se cambió el y Se cambió a las.

Prueba la replicación

Prueba la configuración de la replicación mediante el inicio del aprovisionamiento de datos:

  1. Abre SAP LT Replication Server Cockpit (transacción LTRC) en la GUI de SAP.

  2. Haz clic en la configuración de transferencia masiva para la replicación de tabla que estás probando.

  3. Haz clic en Aprovisionamiento de datos.

  4. En el panel Aprovisionamiento de datos, inicia el aprovisionamiento de datos:

    1. Ingresa el nombre de la tabla de origen.
    2. Haz clic en el botón de selección para el tipo de aprovisionamiento de datos que deseas probar. Por ejemplo, Iniciar carga.
    3. Haz clic en el ícono Ejecutar. La transferencia de datos comienza y el progreso se muestra en la pantalla Objetos participantes.

      Si la tabla no existe en BigQuery, BigQuery Connector para SAP crea la tabla a partir de un esquema que se compile a partir de los atributos de tabla y campo que definiste con anterioridad con la transacción /GOOG/SLT_SETTINGS.

      El tiempo que tarda una carga inicial de una tabla depende del tamaño de la tabla y sus registros.

      Los mensajes se escriben en la sección Registros de aplicaciones de SAP LT Replication Server en la transacción LTRC.

Como alternativa, puedes probar la replicación en BigQuery mediante la herramienta de simulación de cargas. Para obtener más información, consulta la herramienta de simulación de cargas.

Valida la replicación

Puedes validar la replicación mediante los siguientes métodos:

  • En SAP LT Replication Server, haz lo siguiente:
    • Supervisa la replicación en la pantalla Aprovisionamiento de datos.
    • Comprueba si hay mensajes de error en la pantalla Registros de la aplicación.
  • En la pestaña de información de la tabla en BigQuery, haz lo siguiente:
    • Revisa la pestaña Esquema para asegurarte de que el esquema se vea bien.
    • Consulta la pestaña Vista previa para obtener una vista previa de las filas insertadas.
    • Revisa la pestaña Detalles para ver la cantidad de filas insertadas, el tamaño de la tabla y más información.
  • Si se seleccionó la casilla de verificación Marca de campos adicionales cuando se configuró la tabla de BigQuery, ejecuta la herramienta de Validación de replicación. Para ello, ingresa la transacción personalizada /GOOG/REPLIC_VALID.

Comprueba la replicación en SAP LT Replication Server

Usa la transacción LTRC para ver el progreso de los trabajos de replicación o carga inicial después de iniciarlos y verificar los mensajes de error.

Puedes ver el estado de la carga en la pestaña Estadísticas de cargas y el progreso del trabajo en la pestaña Supervisión de transferencias de datos en SAP LT Replication Server.

En la pantalla Registros de la aplicación de la transacción LTRC, puedes ver todos los mensajes que muestra BigQuery, BigQuery Connector para SAP y SAP LT Replication Server.

Los mensajes que emite el código de BigQuery Connector para SAP en SAP LT Replication Server comienzan con el prefijo /GOOG/SLT. Los mensajes que se muestran desde la API de BigQuery comienzan con el prefijo /GOOG/MSG.

Los mensajes que muestra SAP LT Replication Server no comienzan con un prefijo /GOOG/.

Verifica la replicación en BigQuery

En la consola de Google Cloud, confirma que la tabla se haya creado y que BigQuery inserte datos en ella.

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

    Ir a BigQuery

  2. En el campo de búsqueda de la sección Explorador, escribe el nombre de la tabla de BigQuery de destino y, luego, presiona Enter.

    La información de la tabla se muestra en una pestaña en el panel de contenido en el lado derecho de la página.

  3. En la sección de información de tabla, haz clic en los siguientes encabezados para verificar la inserción de tabla y fila:

    • Vista previa, que muestra las filas y los campos que se insertan en la tabla de BigQuery.
    • Esquema, que muestra los nombres de campo y los tipos de datos.
    • Detalles, que muestra el tamaño de la tabla, la cantidad total de filas y otros detalles.

Ejecuta la herramienta de validación de replicación

Si se seleccionó la Marca de campos adicionales cuando se configuró la tabla de BigQuery, puedes usar la herramienta de validación de replicación para generar informes que comparen la cantidad de registros en la tabla de BigQuery con recuentos de registros en las estadísticas de SAP LT Replication Server o la tabla de origen.

Para ejecutar la herramienta de validación de replicación, sigue estos pasos:

  1. En la GUI de SAP, ingresa la transacción /GOOG/REPLIC_VALID precedida por /n:

    /n/GOOG/REPLIC_VALID
  2. En la sección Opciones de procesamiento, haz clic en el botón de selección Ejecutar validación.

  3. En la sección Opciones de selección, ingresa las siguientes especificaciones:

    • En el menú desplegable del campo Identificador de socio de GCP, selecciona BigQuery.
    • En el menú desplegable del campo Tipo de verificación, selecciona el tipo de informe que deseas generar:
      • Recuentos de carga inicial
      • Recuentos de replicación
      • Recuentos actuales
    • Si se muestra el campo Fecha de verificación, especifica la fecha en la que necesitas los recuentos.
    • En el campo Mass Transfer Key, ingresa el nombre de la configuración de la transferencia masiva.
    • De manera opcional, en el campo Nombres de tablas, especifica los nombres de las tablas en la configuración de transferencia masiva para la que necesitas generar el informe.
  4. Haz clic en el ícono Ejecutar para ejecutar la herramienta de validación de replicación.

  5. Una vez finalizada la verificación de la validación, en la sección Opciones de procesamiento, haz clic en el botón de selección Mostrar informe y, luego, haz clic en el ícono Ejecutarpara mostrar el informe.

Para obtener más información, consulta la herramienta de validación de replicación.

Soluciona problemas

Si deseas obtener información sobre el diagnóstico y la resolución de problemas que puedes encontrar cuando configuras y ejecutas cargas o replicaciones entre SAP y BigQuery con BigQuery Connector para SAP, consulta.Guía de solución de problemas de BigQuery Connector para SAP .

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.