Datos compartidos de consumidores

Acerca de los perfiles JSON

Delta Sharing Profiles le ayuda a conectarse a un proveedor de recursos compartidos y acceder a un servidor de Delta Sharing. La información del perfil se almacena en un archivo zip que contiene las credenciales del cliente en formato JSON. Para acceder a los datos compartidos, debe registrar los objetos compartidos mediante un perfil JSON autorizado. A continuación, puede utilizar el perfil JSON para autenticarse con un servidor de Delta Sharing y acceder a los recursos compartidos de datos disponibles.

Descargar perfiles de JSON

Cuando la herramienta Compartir crea un objeto de recurso compartido, el destinatario recibe una notificación por correo electrónico con un enlace para descargar los perfiles de uso compartido Delta. También puede descargar los perfiles JSON desde la consola de Database Actions:

1. En la página Proporcionar uso compartido, haga clic en los tres puntos situados junto a un destinatario y seleccione Copiar enlace de activación de perfil al portapapeles.

2. Abra el enlace en un navegador web para acceder a la página Delta Profile Download.

3. Haga clic en Obtener información de perfil para descargar un archivo zip que contiene perfiles JSON de uso compartido delta.

Tipos de perfil JSON

En la imagen se muestran los perfiles JSON y se muestra cómo consumir Delta Share mediante bearerToken y OIDC para Databricks.

Descripción de la ilustración adp-databricks-delta-share-oidc.eps

El uso compartido delta admite los siguientes perfiles:

• Versión de perfil 1 con bearerToken

  Este archivo JSON puede incluir tokenEndpoint, clientID y clientSecret para que el token se pueda refrescar.

• Versión de perfil 2 mediante OIDC (solo PL/SQL) para el recurso compartido de Databricks

  Este archivo JSON contiene credenciales de cliente de OpenID Connect (OIDC) y OAuth, por ejemplo, clientId, clientSecret y tokenEndpoint. Los perfiles OIDC de Databricks utilizan shareCredentialsVersion 2 y type oauth_client_credentials, pero no soportan bearerToken. Autonomous Database utiliza tokenEndpoint para obtener tokens de acceso con una validez más corta y refrescarlos automáticamente.

  Profile versión 2 proporciona una mejor seguridad debido a que no hay tokens portadores de larga vida para distribuir, tiene una rotación más fácil de secretos y proporciona más automatización.

Al suscribirse a un proveedor de Delta Share en Consume Share, puede utilizar la versión 1 o la versión 2 del archivo JSON, o bien cargar el archivo zip directamente en el campo JSON del proveedor de recursos compartidos.

{
        "shareCredentialsVersion": 1, 
        "endpoint": "https://myhost.us.example.com/ords/prov/_delta_sharing/", 
        "tokenEndpoint": "http://myhost.us.example.com:1234/ords/pdbdba/oauth/token", 
        "bearerToken": "-xxxxxxxxxxxxxxxxxxxxx", 
        "expirationTime": "20XX-01-13T07:53:11.073Z", 
        "clientID": "xxxxxxxxxxxxxxxxxxxxxx..", 
        "clientSecret": "xxxxxxxxxxxxxxxxxxxx.."
}

{
        "shareCredentialsVersion": 2, 
        "endpoint": "https://myhost.us.example.com/ords/prov/_delta_sharing/", 
        "tokenEndpoint": "http://myhost.us.example.com:1234/ords/pdbdba/oauth/token", 
        "type": "oauth_client_credentials",
        "clientId": "xxxxxxxxxxxxxxxxxxxxxx..", 
        "clientSecret": "xxxxxxxxxxxxxxxxxxxx..",
        "tokenScope": "xxxxxxxxxx"
}

Observe la diferencia en el caso de los ID de cliente en ambos perfiles. El perfil 1 tiene clientID y el perfil 2 tiene clientId.

Mejoras en la seguridad

Como destinatario de recursos compartidos, debe configurar una lista de control de acceso (ACL) para el equipo del proveedor de recursos compartidos mediante el procedimiento APPEND_HOST_ACE como usuario ADMIN u otro usuario con privilegios. Esto le permite acceder al recurso compartido a través de Internet.

Por ejemplo, si desea permitir que un usuario de base de datos, A_SHARE_USER, acceda a los puntos finales en un host (proveedor de recursos compartidos) con nombre, a continuación se muestra un ejemplo del procedimiento PL/SQL que deberá ejecutar en el editor de hojas de trabajo SQL como administrador. Como requisito, extraiga el nombre de host de la propiedad de punto final en el perfil JSON de uso compartido delta, como se proporciona en el ejemplo anterior. El nombre de host del ejemplo es myhost.us.example.com.

BEGIN 
        dbms_network_acl_admin.append_host_ace(    
        host =>'myhost.us.example.com', 
        lower_port=>443,    
        upper_port=>443,
        ace => xs$ace_type(      
        privilege_list => xs$name_list('http', 'http_proxy'),      
        principal_name =>'A_SHARE_USER',
        principal_type => xs_acl.ptype_db)); 
        COMMIT;
        END;        
/

A continuación se muestran los parámetros con su descripción:

• host: especifica el nombre o la dirección IP del host. El nombre de host o dominio no distingue entre mayúsculas y minúsculas.
• puerto inferior: especifica el puerto inferior de un rango de puertos TCP opcional.
• puerto superior: especifica el puerto superior de un rango de puertos TCP opcional.
• ace: la entrada de control de acceso.
• lista de privilegios: especifica la lista de privilegios de red que se deben otorgar o denegar.
• principal_name: es el principal (usuario o rol de base de datos) al que se otorga o deniega el privilegio. Es sensible a mayúsculas/minúsculas.
• principal_type: especifica el tipo de principal que utiliza.

Consulte el documento Referencia de tipos y paquetes PL/SQL para obtener más información sobre los subprogramas del paquete DBMS_NETWORK_ACL_ADMIN.

PRIV_ORDS_ACL             CONSTANT PLS_INTEGER := 8;

Carga de un perfil JSON para crear una suscripción de proveedor de recursos compartidos

En este proceso, cargará el perfil JSON del proveedor para la configuración y las credenciales a fin de permitir el acceso a los destinatarios.

1. Abra la página Consumir Compartir y haga clic en + Suscribirse a proveedor de recursos compartidos para seleccionar Suscribirse a proveedor de recursos compartidos Delta en la lista desplegable. Se abre la ventana Subscribe to Share Provider.
   Descripción de la ilustración subscribe-share-provider-version-providersettings.png
2. Especifique lo siguiente en Provider Settings:

   • Origen de recurso compartido: seleccione JSON de proveedor de recursos compartidos Delta.

   • JSON de proveedor de recursos compartidos: puede compartir el perfil JSON mediante las siguientes opciones:

     Desde archivo: seleccione esta opción y haga clic en JSON de perfil de Delta Share para examinar y cargar el perfil JSON en el sistema. También puede cargar el archivo zip que contiene los perfiles JSON directamente en el campo JSON de proveedor de recursos compartidos.

     JSON: seleccione esta opción para pegar el contenido de un archivo JSON en el espacio proporcionado. Asegúrese de copiar todo el contenido, incluidos los corchetes de inicio y finalización.

   • En Share Provider Details, introduzca un Nombre del proveedor y, opcionalmente, agregue una Descripción.

   Haga clic en Siguiente para avanzar al separador Agregar recursos compartidos.
3. En la ficha Add Shares (Agregar recursos compartidos) del cuadro de diálogo, verá la lista de recursos compartidos disponibles. Haga clic en el recurso compartido que desea consumir de los recursos compartidos disponibles y seleccione cualquiera de las opciones disponibles:
   Descripción de la ilustración subscribe-share-provider-version-addshares.png
   • >: esta opción permite mover el recurso compartido disponible a los recursos compartidos seleccionados.
   • <: seleccione esta opción para eliminar el recurso compartido seleccionado de los recursos compartidos seleccionados.
   • >>: esta opción permite mover todos los recursos compartidos a los recursos compartidos seleccionados.
   • <<: seleccione esta opción para eliminar todos los recursos compartidos seleccionados de los recursos compartidos seleccionados.

4. Haga clic en Suscribirse para agregar el recurso compartido. Cuando el proveedor se crea correctamente, aparece una petición de confirmación. Después de crear correctamente el proveedor, ahora verá la pantalla Objeto de enlace en la nube de la página Carga de datos.

5. Puede ver el nombre del proveedor en el campo de ubicación de almacenamiento en la nube. El recurso compartido aparece en la ubicación del archivo de origen con los archivos que agrega al recurso compartido.
   Descripción de la ilustración link-cloud-object.png

   Amplíe el carro de la carpeta Compartir, arrastre y suelte el archivo que comparte del origen al carro de enlace de datos.

   Seleccione Iniciar en el carro de enlaces de datos para ejecutar el trabajo de enlace de datos.

6. Visualice las tablas creadas desde Database Actions.
   • Haga clic en Database Actions, en la ruta de navegación, para volver a la pantalla de inicio de Database Actions.
   • Haga clic en el mosaico SQL.
   • Seleccione la tabla externa, arrástrela y suéltela en la hoja de trabajo.

     Aparece la sentencia SQL Select de la tabla. Esta sentencia SQL se puede ejecutar para consumir los datos compartidos.

     
     Descripción de la ilustración xt_sql.png

ORA-29913: error while processing ODCIEXTTABLEFETCH routine

Los proveedores de Databricks pueden compartir tablas Delta cuando Autonomous AI Database es un consumidor de Delta Sharing en los siguientes escenarios:

• Escenario 1: Borrar vectores de supresión de la tabla

• Escenario 2: Crear una vista y compartirla

• Escenario 3: Desactivar vectores de supresión en la configuración del espacio de trabajo para tablas futuras

Escenario 1: Borrar vectores de supresión de la tabla

Utilice esta opción si está listo para dejar de utilizar deletionVectors en una tabla específica.

1. Ejecute esto en Databricks.

   ALTER TABLE table_name 
   DROP FEATURE deletionVectors

2. Agregue la tabla table_name al recurso compartido Delta y configure la base de datos de IA autónoma como consumidor.

Esta opción aplica todas las supresiones pendientes y elimina la función deletionVectors de la tabla. La tabla se comporta como una tabla Delta normal sin deletionVectors.

Escenario 2 - Creación de una vista y uso compartido de la vista

Utilice esta opción cuando desee mantener deletionVectors en la tabla base.

1. Ejecute esto en Databricks.

   CREATE VIEW view_name AS 
   SELECT * FROM table_name;

2. Agregue la vista view_name al recurso compartido Delta en lugar de la tabla.

   Los consumidores de Autonomous AI Database pueden ejecutar la siguiente consulta:

   SELECT * 
   FROM "MY_SHARE"."MY_SCHEMA"."view_name";

En este escenario, la tabla base Databricks sigue utilizando los vectores de supresión. Databricks resuelve los vectores de supresión al ejecutar la vista, por lo que la base de datos de IA autónoma no los ve. Para los destinatarios que no son de Databricks, como Autonomous AI Database, Databricks puede materializar la vista y cobrar al proveedor por los recursos informáticos y el almacenamiento. El proveedor puede configurar un TTL de materialización en Databricks para controlar el equilibrio entre el costo y el refrescamiento de datos, un TTL más corto o más bajo para los datos nuevos o un TTL más largo o más alto para una rentabilidad.

Escenario 3: Desactivación de vectores de supresión en la configuración del espacio de trabajo para tablas futuras

Utilice esta opción para evitar que las nuevas tablas utilicen los vectores de supresión por defecto.

1. Abra Configuración de espacio de trabajo o la consola de administración como usuario administrador del tejido de datos y vaya a Avanzado.

2. Busque Activación automática de vectores de supresión y defínalos en Desactivado.

3. Guarde los cambios y reinicie el cálculo en ejecución.

ALTER TABLE table_name 
SET TBLPROPERTIES ('delta.enableDeletionVectors' = FALSE);

En este escenario, todas las tablas nuevas creadas después de este cambio no tendrán los vectores de supresión activados por defecto. Sin embargo, las tablas existentes que ya utilizan los vectores de supresión requerirían los escenarios explicados anteriormente.

Verificar si los vectores de supresión están activados en Databricks

Para comprobar si los vectores de supresión están activados para una tabla específica en Databricks, ejecute este comando:

SHOW TBLPROPERTIES table_name ('delta.enableDeletionVectors');