Creación de un acceso directo de Google Cloud Storage (GCS)

En este artículo, aprenderá a crear un acceso rápido de Google Cloud Storage (GCS) dentro de un entorno de Fabric Lakehouse. Se pueden crear accesos directos a Google Cloud Storage (GCS) mediante la API XML para GCS. Al crear accesos directos a Google Cloud Storage, la ruta de acceso de destino debe contener un nombre de cubo como mínimo. También puede restringir el ámbito del acceso directo si especifica el prefijo o la carpeta a la que quiere apuntar dentro de la jerarquía de almacenamiento.

Los métodos abreviados de GCS son de solo lectura. No admiten operaciones de escritura independientemente de los permisos del usuario.

Para obtener información general sobre los accesos directos, consulte Accesos directos de OneLake. Para crear combinaciones de teclas mediante programación, consulte API de REST para combinaciones de teclas de OneLake.

Los accesos directos de GCS pueden aprovechar el almacenamiento en caché de archivos para reducir los costos de salida asociados con el acceso a datos entre nubes. Para obtener más información, consulte Accesos directos de OneLake > almacenamiento en caché.

Requisitos previos

• Si no tiene un almacén de lago, cree uno siguiendo estos pasos: Creación de un almacén de lago con OneLake.

• Asegúrese de que el bucket y el usuario de GCS elegidos cumplen los requisitos de acceso y autorización para los accesos directos de GCS.

Crear un acceso directo

1. Abra un lago de datos.

2. Haga clic con el botón derecho del ratón en un directorio dentro de la Vista de lago del almacén de lago.

3. Seleccione Nuevo acceso directo.

   

Seleccione un origen

1. En Orígenes externos, seleccione Google Cloud Storage.

   

2. Escriba la configuración de conexión según la tabla siguiente:

   

   Campo	Descripción	Valor
   URL	Cadena de conexión para el cubo de GCS. El nombre del cubo es opcional.	https:// BucketName.storage.googleapis.comhttps://storage.googleapis.com
   Connection	Las conexiones definidas previamente para la ubicación de almacenamiento especificada aparecen en la lista desplegable. Si no existe ninguna conexión, crea una nueva.	Crear una nueva conexión
   Nombre de la conexión	El nombre definido por el usuario para la conexión.	Nombre de la conexión.
   Tipo de autenticación	Fabric utiliza claves de código de autenticación de mensajes basado en hash (HMAC) para acceder a Google Cloud Storage. Estas claves están asociadas a una cuenta de servicio o usuario. La cuenta debe tener permiso para acceder a los datos dentro del cubo de GCS. Si se ha usado el punto de conexión específico en la URL de conexión, la cuenta debe tener los permisos storage.objects.get y storage.objects.list. Si se ha usado el punto de conexión global en la URL de conexión, la cuenta también debe tener el permiso storage.buckets.list.	Clave HMAC
   Id. de acceso	La clave de acceso asociada a una cuenta de servicio o usuario. Para obtener más información sobre cómo crear claves HMAC, consulte Administración de claves HMAC.	La clave de acceso.
   Secreto	El secreto para la clave de acceso.	Tu llave secreta.

3. Seleccione Siguiente.

4. Ve a la ubicación de destino del acceso directo.

   

   Si usaste el punto de conexión global en la dirección URL de conexión, todos los buckets disponibles aparecerán en la vista de navegación izquierda. Si usaste un punto de conexión específico del bucket en la dirección URL de conexión, aparecerán en la vista de navegación únicamente el bucket especificado y su contenido.

   Seleccione una carpeta o haga clic en la flecha de expansión junto a una carpeta para navegar por la cuenta de almacenamiento.

   En esta vista, puedes seleccionar una o varias ubicaciones de destino de acceso directo. Para elegir ubicaciones de destino, haz clic en la casilla situada junto a una carpeta en la vista de navegación izquierda.

5. Seleccione Siguiente.

   

   La página de revisión te permite comprobar todas las selecciones. Aquí puedes ver todos los accesos directos que se crearán. En la columna de acción, puedes hacer clic en el icono de lápiz para editar el nombre del acceso directo. Puedes hacer clic en el icono de la papelera para eliminar el acceso directo.

6. Seleccione Crear.

El almacén de lago se actualiza automáticamente. El acceso directo aparece en panel Explorador situado a la izquierda.

Acceso

Al configurar la conexión para un acceso directo a GCS, puede especificar el endpoint global para el servicio de almacenamiento, o bien usar un endpoint específico del bucket.

• Ejemplo de punto de conexión global: https://storage.googleapis.com
• Ejemplo de punto de conexión específico de un cubo: https://<BucketName>.storage.googleapis.com

Authorization

Los accesos directos de GCS usan un modelo de autorización delegado. En este modelo, el creador del acceso directo especifica una credencial para el acceso directo de GCS y todo el acceso a ese acceso directo se autoriza con esa credencial. La credencial delegada admitida es una clave y un secreto de HMAC para una cuenta de servicio o una cuenta de usuario.

La cuenta debe tener permiso para acceder a los datos dentro del cubo de GCS. Si se ha usado el "endpoint" específico del bucket en la conexión para el acceso directo, la cuenta debe tener los siguientes permisos:

• storage.objects.get
• stoage.objects.list

Si se ha usado el punto de conexión global en la conexión para el acceso directo, la cuenta también debe tener el permiso siguiente:

• storage.buckets.list

Limitaciones

Las limitaciones siguientes se aplican a los accesos directos de Google Cloud Storage:

• Los métodos abreviados de GCS son de solo lectura. No admiten operaciones de escritura independientemente de los permisos del usuario.

Contenido relacionado

• Creación de un acceso directo de OneLake
• Crear un acceso directo de Azure Data Lake Storage Gen2
• Uso de las API de REST para las combinaciones de teclas de OneLake