Datos compartidos de consumidores

Una vez que los proveedores comparten los objetos, hay algunos pasos que los destinatarios deben seguir para consumir el recurso compartido.

Utilice la página Consumir Compartir para realizar las siguientes operaciones:

Visión general del uso compartido de consumo:
Para consumir recursos compartidos de datos, debe suscribirse a ellos y crear vistas de las tablas incluidas en el recurso compartido.
Consumir uso compartido con versiones:
Como destinatario, deberá descargar su perfil de recursos compartidos, suscribirse al proveedor de recursos compartidos de datos, registrar los recursos compartidos y crear tablas externas sobre sus recursos compartidos. La herramienta Data Share autoriza el acceso mediante el perfil JSON enviado al destinatario mediante el correo de activación. Una vez otorgado el acceso, la herramienta de uso compartido de datos enlaza los objetos compartidos con la herramienta de enlace de datos donde el consumidor puede ejecutar el trabajo de enlace de datos y acceder a los objetos compartidos por el proveedor.
Consuma Live Share:
Esto le permite, como destinatario, consumir datos activos de la base de datos.
Ver detalles de entidad de proveedor de recursos compartidos:
Utilice el icono Acciones situado a la derecha de la entrada de entidad de proveedor de recursos compartidos activos o delta share para ver detalles sobre la entidad de proveedor de recursos compartidos activos o delta share que crea.

Visión general de consumo compartido
La página Consumir uso compartido proporciona una visión general de la lista de proveedores de recursos compartidos, con opciones para buscar y agregar proveedores de recursos compartidos.
Uso compartido con versiones
Debe seguir estos pasos para que los datos con versiones compartidas estén disponibles en Oracle Autonomous Database. Los datos compartidos con usted a través de Delta Sharing no están disponibles automáticamente y se pueden detectar en Autonomous Database.
Activación del acceso a fuentes de datos de cambio a nivel de archivo para recursos compartidos con versiones
Autonomous AI Database soporta recursos compartidos con versiones, donde los datos se publican como una secuencia de distintas versiones. Cada versión publicada hace referencia a un juego específico de archivos Parquet.
Consume Live Share
Los datos en directo compartidos con usted mediante el uso compartido de datos no están disponibles automáticamente para su consumo.
Visualización de detalles de entidad de proveedor de recursos compartidos
Para ver detalles sobre la entidad de proveedor de recursos compartidos, haga clic en el icono Acciones situado a la derecha de la entrada de entidad de proveedor de recursos compartidos y, a continuación, haga clic en Ver detalles.
Uso compartido de tablas del tejido de datos con vectores de supresión
Describe cómo compartir tablas delta del tejido de datos cuando Autonomous AI Database es un consumidor de Delta Sharing.

Tema principal: Herramienta para compartir datos

Visión general de uso compartido de consumos

La página Consumir Compartir proporciona una visión general de la lista de proveedores de recursos compartidos, con opciones para buscar y agregar proveedores de recursos compartidos.

Para navegar a la página Consumir Compartir, realice una de las siguientes acciones:

En el menú Data Studio, seleccione Consume Share en el menú Data Share.
En la página Uso compartido de datos, haga clic en el widget Consumir recurso compartido presente en la sección Proveedor y consumidor.

La página Consumir Compartir contiene:
Descripción de la ilustración consume-share-new.png

Proveedores de recursos compartidos en directo disponibles en los últimos 7 días
Esta área muestra la lista de proveedores de recursos compartidos en directo disponibles que ha creado en los últimos 7 días. Puede actualizar cualquiera de los campos según lo desee. También puede suscribirse a Live Share con el signo + a la derecha de los recursos compartidos que aparecen en los recursos compartidos disponibles en los últimos 7 días.
Campo Buscar Proveedor de Recursos Compartidos Suscrito

Puede buscar el destinatario de recursos compartidos que ha creado introduciendo el nombre del proveedor de recursos compartidos suscrito. Introduzca el nombre del proveedor de recursos compartidos suscrito, por ejemplo, REVIEW_PROVIDER y haga clic en el icono de lupa para completar la búsqueda. La herramienta Compartir muestra los resultados de búsqueda en el área de visualización.
Seleccione + Suscribirse a un proveedor de recursos compartidos para suscribirse a un nuevo proveedor de recursos compartidos. Consulte Suscribirse al proveedor de recursos compartidos para explorar este icono.
Mi ID de uso compartido
Un ID de uso compartido es un proveedor único para Autonomous Database. Copie este ID en el portapapeles y péguelo en el campo ID de uso compartido del asistente Crear destinatario de uso compartido. Esto permite que un recurso compartido activo se comparta con un proveedor de recursos compartidos.
Barra de herramientas
La barra de herramientas consta de las opciones de ordenación, tamaño de página, refrescamiento y vista de entidad.
Ordenar por ajustes
Al establecer los valores de ordenación mediante el control Ordenar por de la barra de herramientas, la configuración se muestra en pequeños cuadros debajo de la barra de herramientas. Puede suprimir una configuración haciendo clic en el icono X del cuadro. O puede cambiar la configuración volviendo al control Ordenar por de la barra de herramientas.
Área de visualización
El área debajo del campo Buscar proveedores de recursos compartidos de consumidores muestra las entidades devueltas por una búsqueda y que coinciden con los criterios de filtro definidos en el panel Filtros. Puede ordenar las entidades haciendo clic en el botón Ordenar por y, a continuación, definiendo valores de ordenación.

Tema principal: Uso compartido

Consumir versión compartida

Debe seguir estos pasos para que los datos con versiones compartidas estén disponibles en Oracle Autonomous Database. Los datos compartidos con usted a través de Delta Sharing no están disponibles automáticamente y se pueden detectar en Autonomous Database.

Realice estos pasos para suscribirse y acceder a los recursos compartidos de datos proporcionados:

Descargar perfiles JSON
Suscribirse al proveedor de uso compartido de datos
Registrar las acciones a su disposición
Crear tablas externas para sus recursos compartidos

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:

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.
Abra el enlace en un navegador web para acceder a la página Delta Profile Download.
Haga clic en Obtener información de perfil para descargar un archivo zip que contenga perfiles JSON de uso compartido delta.

Note:

Por motivos de seguridad, sólo puede descargar la información de perfil una vez. Al hacer clic dos veces en el botón, se produce un error al descargar el perfil. Para obtener más información, consulte Guía de inicio rápido.

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 adp-databricks-delta-share-oidc.eps a continuación

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 del tejido de datos

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 duración para distribuir, tiene una rotación más fácil de secretos y proporciona más automatización.

Note:

Para OIDC, debe permitir el acceso saliente a Databricks endpoint y IdP tokenEndpoint.

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

Ejemplo: JSON Profile versión 1.

{
        "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.."
}

Parámetros:

shareCredentialsVersion: muestra la versión 1 del formato de perfil.
endpoint: especifica la URL HTTPS base del servidor de Delta Sharing alojado en Autonomous Database. Puede llamar a este punto final de REST para detectar recursos compartidos, esquemas, tablas y recuperar direcciones URL firmadas para archivos Parquet.
tokenEndpoint: especifica el punto final del token. El cliente de la herramienta Compartir utiliza el punto final del token para refrescar el timeout en el token de portador si consume el recurso compartido mediante Oracle.
bearerToken: cadena críptica que genera el servidor de autenticación en respuesta a una solicitud de conexión. Por lo general tiene una validez más larga.
expirationTime: es el tiempo que tarda la autenticación en caducar.
clientID: especifica el identificador público que genera el servidor de autenticación al registrar la instancia para la autenticación.
clientSecret: especifica un identificador secreto que el servidor de autenticación genera para la autorización.

Ejemplo: JSON Profile versión 2.

{
        "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"
}

Parámetros:

shareCredentialsVersion: muestra la versión 2 del formato de perfil.
endpoint: especifica la URL HTTPS base del servidor de Delta Sharing alojado en Autonomous Database. Puede llamar a este punto final de REST para detectar recursos compartidos, esquemas, tablas y recuperar direcciones URL firmadas para archivos Parquet.
tokenEndpoint: especifica el punto final del token.
type: flujo de autenticación que se utilizará. Aquí se otorga el permiso Credenciales de cliente OAuth 2.0.
clientId: especifica el identificador público que genera el servidor de autenticación al registrar la instancia para la autenticación.
clientSecret: especifica un identificador secreto que el servidor de autenticación genera para la autorización.
tokenScope: ámbitos de OAuth que se deben solicitar al adquirir el token (a menudo delimitados por espacio). Determina el nivel de acceso otorgado para la detección de recursos compartidos y la recuperación de datos.

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.

Note:

Esto se debe hacer antes de utilizar el Asistente para agregar un proveedor de recursos compartidos para agregar una entrada de control de acceso (ACE) a la lista de control de acceso (ACL) del host (es decir, proveedor de recursos compartidos). Puede encontrar el nombre de host del perfil JSON que ha descargado en el paso anterior.

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.
lower port: especifica el puerto inferior de un rango de puertos TCP opcional.
upper port: especifica el puerto superior de un rango de puertos TCP opcional.
ace: la entrada de control de acceso.
privilege list (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.

Otorgue una ACL al usuario en el punto final de ORDS local. Necesitará esto para generar tokens de portador en acciones creadas localmente.

PRIV_ORDS_ACL             CONSTANT PLS_INTEGER := 8;

Permitir acceso de salida para uso compartido delta en un punto final privado

Si la base de datos de IA autónoma del consumidor utiliza un punto final privado, configure el acceso de salida antes de suscribirse al proveedor de uso compartido delta y crear tablas externas para los datos compartidos.

Delta Sharing utiliza el proveedor endpoint y, si está presente, tokenEndpoint para detectar recursos compartidos y obtener tokens de acceso. A continuación, la base de datos de consumidores lee los archivos Parquet compartidos directamente desde el almacenamiento de objetos mediante las URL firmadas devueltas por el servidor de Delta Sharing. Por lo tanto, configure la conectividad de salida tanto para los puntos finales del proveedor de uso compartido delta como para los hosts de almacenamiento de objetos a los que hacen referencia las URL firmadas.

Requisitos

La base de datos de IA autónoma del consumidor utiliza el acceso de punto final privado.
Puede conectarse a la base de datos como ADMIN.
Tiene el perfil JSON de Delta Sharing del proveedor.
Usted sabe si los archivos compartidos se almacenan detrás de un punto final de almacenamiento público protegido por reglas de firewall o IP, o detrás de un punto final de almacenamiento privado.

Configuración del acceso de salida

Conéctese a la base de datos de consumidores como ADMIN.
Compruebe el modo de enrutamiento de salida actual.
```
SELECT property_name, property_value
FROM database_properties
WHERE property_name = 'ROUTE_OUTBOUND_CONNECTIONS';
```
Si la consulta no devuelve ninguna fila, la propiedad no se define. En este caso, las conexiones salientes a los puntos finales públicos utilizan el gateway de NAT de VCN de servicio.
Si no se define ROUTE_OUTBOUND_CONNECTIONS, determine la dirección IP de salida que utiliza la base de datos de consumidores para los puntos finales públicos.
```
SELECT cloud_identity
FROM v$pdbs;
```
Localice el campo OUTBOUND_IP_ADDRESS en la salida de JSON.
- Si las URL firmadas hacen referencia a un punto final de almacenamiento público protegido por reglas de IP o firewall, agregue la base de datos de consumidor OUTBOUND_IP_ADDRESS a la lista de permitidos del servicio de almacenamiento.
- Si los archivos compartidos utilizan un punto final de almacenamiento privado, configure la conectividad privada y el DNS en lugar de la lista de IP permitidas pública. Esto permite a la base de datos de consumidores acceder a la cuenta de almacenamiento a través de la ruta de red privada.
Enrute el tráfico de Delta Sharing a través del punto final privado.
```
ALTER DATABASE PROPERTY
SET ROUTE_OUTBOUND_CONNECTIONS = 'ENFORCE_PRIVATE_ENDPOINT';
```
Note:

Oracle recomienda utilizar ENFORCE_PRIVATE_ENDPOINT porque incluye las restricciones de PRIVATE_ENDPOINT y también las aplica a las conexiones salientes realizadas por los paquetes DBMS_CLOUD y las tablas externas.

Cuando se define esta propiedad, las conexiones salientes deben cumplir las reglas de salida de punto final privado configuradas en la lista de seguridad de la VCN o en el grupo de seguridad de red (NSG) asociado al punto final privado.

Para restaurar el comportamiento predeterminado, ejecute:
```
ALTER DATABASE PROPERTY
SET ROUTE_OUTBOUND_CONNECTIONS = '';
```
Asegúrese de que la base de datos de consumidor puede resolver y acceder a todos los hosts necesarios, es decir:
- el punto final de Delta Sharing
- tokenEndpoint, si está presente
- los hosts de almacenamiento de objetos a los que hacen referencia las URL firmadas devueltas en el momento de la consulta

Antes de suscribirse al proveedor de recursos compartidos, cree la entrada de ACL necesaria para el host del proveedor en el esquema de consumidor.

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.

Abra la página Consumir uso compartido 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
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 Provider Name (Nombre del proveedor) y, opcionalmente, agregue una Description (Descripción).
Haga clic en Next (Siguiente) para avanzar al separador Add Shares (Agregar recursos compartidos).
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.
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.
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 enlace de datos para ejecutar el trabajo de enlace de datos.
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

Tema principal: Uso compartido

Activar acceso a fuente de datos de cambio en el nivel de archivo para recursos compartidos versionados

La base de datos de IA autónoma soporta recursos compartidos con versiones, donde los datos se publican como una secuencia de distintas versiones. Cada versión publicada hace referencia a un juego específico de archivos Parquet.

Funcionamiento de las fuentes de datos de cambio a nivel de archivo

Cambiar fuente de datos permite a los consumidores procesar solo los archivos que cambiaron entre dos versiones publicadas en lugar de leer la última instantánea completa cada vez.

Por ejemplo, un proveedor publica un recurso compartido de 1 TB como versión 3, modifica los datos y publica la versión 4. En lugar de volver a leer la instantánea completa de 1 TB, un consumidor puede solicitar las diferencias entre las versiones 3 y 4 y procesar solo los archivos incrementales devueltos.

Para utilizar esta capacidad, active el acceso basado en versiones.

Activar acceso basado en versiones

Para permitir el acceso a versiones históricas y cambios en el nivel de archivo para un recurso compartido con versiones, configure el acceso a la versión tanto para el destinatario como para el recurso compartido.

VERSION_ACCESS_CURRENT solo permite el acceso a la versión actual.
VERSION_ACCESS_ANY permite el acceso a las versiones actuales y retiradas.

Utilice el siguiente ejemplo de PL/SQL:

BEGIN
  DBMS_SHARE.UPDATE_RECIPIENT_PROPERTY(
    recipient_name     => 'my_recipient',
    recipient_property => DBMS_SHARE.PROP_RECIPIENT_VERSION_ACCESS,
    new_value          => DBMS_SHARE.VERSION_ACCESS_ANY);

  DBMS_SHARE.UPDATE_SHARE_PROPERTY(
    share_name     => 'my_versioned_share',
    share_property => DBMS_SHARE.PROP_SHARE_VERSION_ACCESS,
    new_value      => DBMS_SHARE.VERSION_ACCESS_ANY);
END;
/

Note:

Debe actualizar ambas propiedades para activar el acceso basado en versiones.

Solicitud de datos de cambio mediante la API de REST de uso compartido delta

Utilice el punto final de cambios de Delta Sharing para solicitar datos de cambio para una tabla.

Ejemplo de solicitud:

GET {prefix}/shares/my_share/schemas/my_schema/tables/my_table/changes?startingVersion=3&endingVersion=4
Authorization: Bearer <token>

La respuesta es un JSON delimitado por líneas nuevas e incluye objetos de acción de protocolo, metadatos y archivo de cambio para el rango de versiones solicitado.

Ejemplo de fragmento de respuesta:

{"protocol":{"minReaderVersion":1}}
{"metaData":{"format":{"provider":"parquet"}}}
{"add":{"url":"https://.../part-0001.snappy.parquet","id":"file-a","size":573,"version":4}}
{"remove":{"url":"https://.../part-0000.snappy.parquet","id":"file-c","size":573,"version":4}}

Esto permite al consumidor procesar solo los archivos devueltos para el rango de versiones solicitado.

Para ver un ejemplo de Databricks específico de Oracle que lee archivos modificados para un rango de versiones e informa recuentos de filas, consulte Oracle Delta Sharing CDF.

Tema principal: Uso compartido

Consumir Live Share

Los datos en directo que se comparten con usted mediante el uso compartido de datos no están disponibles automáticamente para su consumo.

Para consumir recursos compartidos de datos activos, debe suscribirse a ellos y crear vistas de las tablas incluidas en el recurso compartido activo. Las vistas se pueden consultar mediante scripts SQL.

Abra la página Consumir Compartir y haga clic en + Suscribirse al proveedor de recursos compartidos para seleccionar Suscribirse al proveedor de recursos compartidos activos en la lista desplegable. Se abre el cuadro de diálogo Suscribirse a proveedor compartido.
En el panel Provider Settings del cuadro de diálogo Subscribe to Share Provider, especifique los siguientes detalles:
Descripción de la ilustración subscribe-live-share-provider.png
En la sección Compartir origen, seleccione Seleccionar de proveedores de recursos compartidos activos y seleccione el proveedor en la lista desplegable.
En el campo Compartir detalles de profesional asistencial, introduzca lo siguiente:
- Nombre del Proveedor: Especifique el nombre del proveedor.
- Descripción: introduzca una descripción del proveedor.
Haga clic en Next (Siguiente) para avanzar al separador Add Shares (Agregar recursos compartidos).
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 add-shares.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.
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.
Puede ver el nombre del proveedor de recursos compartidos 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 enlace de datos para ejecutar el trabajo de enlace de datos.

Tema principal: Uso compartido

Ver detalles de entidad de proveedor de recursos compartidos

Para ver detalles sobre la entidad Proveedor de recursos compartidos, haga clic en el icono Acciones situado a la derecha de la entrada de entidad Proveedor de recursos compartidos y, a continuación, haga clic en Ver detalles.

Para todas las entidades, los detalles incluyen las secciones Linaje e Impacto.

Para una entidad de proveedor de recursos compartidos específica, puede realizar las siguientes acciones mediante el menú contextual Acciones.

Ver detalles: consulte Ver detalles de entidad de proveedor de recursos compartidos.
Gestionar recursos compartidos: abre el cuadro de diálogo Gestionar recursos compartidos para proveedor de recursos compartidos. Esto muestra los recursos compartidos que selecciona para compartir con el destinatario. Puede editar la lista de recursos compartidos que desea compartir con el destinatario. Haga clic en Aceptar para guardar los cambios o seleccione Cancelar para desechar el proceso de edición.
Cargar en tabla: se le dirige a la página Cargar datos con el separador Compartir seleccionado.
Enlazar a tabla: se le dirige a la página Enlazar datos con el separador Compartir seleccionado para ver y ejecutar el objeto de enlace relacionado. Arrastre y suelte los datos compartidos para agregarlos al trabajo de enlace de datos.
Cambiar nombre: cambia el nombre del proveedor. Seleccione Sí para realizar cambios; de lo contrario, haga clic en No.
Copiar punto final: copia el punto final.
Suprimir: elimina la entidad de proveedor de recursos compartidos.

Tema principal: Uso compartido

Uso compartido de tablas de Databricks con vectores de supresión

Describe cómo compartir tablas Delta de Databricks cuando Autonomous AI Database es un consumidor de Delta Sharing.

La base de datos de IA autónoma no soporta tablas delta de Databricks con vectores de supresión. Si una tabla Delta compartida utiliza los vectores de supresión, Autonomous AI Database devuelve el siguiente error al crear una tabla.

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.

Ejecute esto en Databricks.

ALTER TABLE table_name 
DROP FEATURE deletionVectors

Agregue la tabla table_name al recurso compartido Delta y configure Autonomous AI Database 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.

Ventajas:

Sin costo continuo para la materialización de vistas.
Implementación sencilla en Autonomous AI Database.

Desventajas:

Una reescritura única para tablas grandes.
Afecta a todas las cargas de trabajo que leen esta tabla, no solo a la base de datos de IA autónoma.
Perder los beneficios del vector de supresión para futuras supresiones en esta tabla.

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.

Ejecute esto en Databricks.

CREATE VIEW view_name AS 
SELECT * FROM table_name;

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

Los consumidores de Autonomous AI Database pueden ejecutar esta 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 Autonomous AI Database 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.

Ventajas:

No hay cambios en la tabla base.
Otras cargas de trabajo de Databricks pueden continuar utilizando vectores de supresión.
Puede agregar filtros, enmascaramiento o proyecciones de columnas a la vista.

Desventajas:

El proveedor asume el costo de la materialización y el almacenamiento de vistas en Databricks.
Gestión de la configuración de TTL para el control de costos y la actualización de datos.
Más complejo que compartir una mesa.

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.

Abra Configuración de espacio de trabajo o la consola de administración como usuario administrador de Databricks y vaya a Avanzado.
Busque Vectores de supresión de activación automática y defínalos en Desactivado.
Guarde los cambios y reinicie el cálculo en ejecución.

Opcionalmente, ejecute esta operación para tablas específicas:

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.

Ventajas:

Impide que las nuevas tablas utilicen los vectores de supresión automáticamente.
No hay mantenimiento adicional para tablas futuras compartidas con Autonomous AI Database.

Desventajas:

No corrige las tablas existentes que ya utilizan vectores de supresión.
Mantenimiento de la configuración de todo el espacio de trabajo. Algunas cargas de trabajo internas pueden seguir utilizando vectores de supresión por defecto.

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');

Tema principal: Uso compartido