Ir al contenido principal

Conexión en la nube con Google Cloud Storage

Requisito de licencia

Google Cloud Storage es un complemento para la licencia de dab Nexus. Debe estar incluido en la licencia de dab Nexus antes de que pueda configurarse una conexión.

Resumen​

Google Cloud es un conjunto de servicios en la nube proporcionados por Google. Ofrece servicios de infraestructura, plataforma, almacenamiento, datos y aplicaciones que pueden gestionarse mediante la consola de Google Cloud. Google Cloud Storage es un servicio de almacenamiento de objetos gestionado en Google Cloud. Los datos se almacenan como objetos en contenedores llamados buckets. En dab Nexus, una conexión a Google Cloud Storage puede utilizarse como destino para extracciones de datos en formato CSV o Parquet. Para obtener información adicional, consulte la documentación oficial de Google: Google Cloud

Requisitos previos​

Antes de configurar Google Cloud Storage en dab Nexus, asegúrese de que se cumplen los siguientes requisitos:

  • Una cuenta de Google y una cuenta activa de Google Cloud con la facturación habilitada.
  • Un proyecto de Google Cloud. Cuando utiliza Google Cloud por primera vez, es posible que ya exista un proyecto como My First Project. Alternativamente, cree o seleccione un proyecto dedicado para la conexión de dab Nexus.
  • Un bucket de Google Cloud Storage para las extracciones de datos.
  • Una cuenta de servicio de Google Cloud con permisos suficientes para acceder y escribir en el bucket de destino. Para un acceso de privilegios mínimos, conceda solo los permisos necesarios para las operaciones de Cloud Storage realizadas por la conexión. Para consultar los permisos requeridos y los roles IAM disponibles, revise la documentación oficial de Google Cloud:
  • Un archivo de clave de cuenta de servicio para autenticar la conexión en dab Nexus. La cuenta de servicio se identifica mediante un par de claves RSA. Al crear las claves, el usuario recibe de Google un archivo con información sobre la cuenta.
Information

El bucket debe existir antes de crear la conexión en dab Nexus. Ingrese el nombre del bucket exactamente como aparece en Google Cloud Storage.

Crear una conexión a Google Cloud Storage​

Navegue a: Configuración > Destinos de datos > Conexiones en la nube > Nueva conexión > Google Cloud Storage Introduzca un nombre para la conexión en la nube y configure los siguientes campos.

Bucket​

Nombre del bucket de destino. El valor debe coincidir exactamente con el nombre del bucket en Google Cloud Storage.

Estructuras de directorio​

Flat​

Escribe los archivos extraídos directamente en el directorio de destino sin subdirectorios. Seleccione Flat cuando los datos exportados deban usar una estructura de directorios plana. Ejemplo:

<target-directory>/
├── BKPF_S4H_100_Init.csv
└── MARA_S4H_100_Init.csv

Incremental​

Almacena los archivos extraídos en un directorio separado para cada tabla, generando un archivo con marca de tiempo en cada ejecución. Seleccione Incremental cuando los datos exportados deban utilizar la estructura incremental de directorios.

La estructura de directorio seleccionada determina cómo dab Nexus organiza los archivos exportados en el bucket y la carpeta base configurados.

<target-directory>/
└── <table-name>/
    └── <timestamp>_<SID>_<CLIENT>_<type>.<format>
Importante

Con la estructura de directorios Incremental, Merge no combina datos nuevos con archivos existentes. En cambio, cada ejecución crea un nuevo archivo con marca de tiempo en el directorio correspondiente a la tabla, mientras que los archivos existentes se mantienen. La estructura de directorio determina la estrategia de replicación soportada:

  • Flat → Sobrescribir
  • Incremental → Combinar

Estas combinaciones se validan durante la comprobación de la tarea.

Formato de archivo​

Seleccione el formato de archivo para los datos extraídos:

  • CSV
  • Parquet

Carpeta base​

Opcionalmente, especifique la carpeta en el bucket donde deben almacenarse los datos extraídos. Si no se define una carpeta base personalizada, por defecto se utiliza sap-export.

Autenticación​

Las conexiones a Google Cloud Storage utilizan autenticación mediante Service Account Key.

  1. Defina Tipo de autenticación como Service Account Key.
  2. En Service Account Key, seleccione Elegir.
  3. Seleccione el archivo de clave de la cuenta de servicio.

La cuenta de servicio debe contar con los permisos necesarios para el bucket de Google Cloud Storage configurado y las operaciones de exportación requeridas.

Probar y crear la conexión​

Seleccione Probar conexión para validar la configuración y el acceso al bucket de destino. Seleccione Crear para guardar la conexión en la nube.

Si la prueba de la conexión falla, verifique los siguientes valores:

  • El nombre del bucket configurado coincide exactamente con el nombre del bucket de Google Cloud Storage.
  • La clave de cuenta de servicio seleccionada es válida.
  • La cuenta de servicio tiene acceso suficiente al bucket de destino.
  • La carpeta base opcional se ha ingresado como corresponde. Si no se requiere un valor personalizado, se aplica el valor predeterminado sap-export.