Creación de tablas federadas mediante hiperenlaces de tablas mediante la definición de ámbito

Un ámbito de creación en una base de datos de proveedor determina qué instancias de base de datos de IA autónoma de consumidor tienen permiso para crear de forma remota hipervínculos de tabla en la base de datos de proveedor.

Puede gestionar ámbitos de creación mediante el paquete DBMS_DATA_ACCESS_SCOPE, que proporciona procedimientos para registrar, anular el registro, actualizar y recuperar ámbitos. Consulte DBMS_DATA_ACCESS_SCOPE para obtener más información.

ADMIN (o PDB_DBA) en la base de datos de IA autónoma del proveedor utiliza DBMS_DATA_ACCESS_ADMIN.GRANT_REGISTER para decidir qué usuarios locales pueden gestionar ámbitos de creación.

Solo estos usuarios con privilegios pueden registrar, actualizar o anular el registro de ámbitos, lo que evita la exposición no controlada de las tablas de proveedores.

Ejemplo

BEGIN
DBMS_DATA_ACCESS_ADMIN.GRANT_REGISTER(
username => 'ANALYTICS_ADMIN',
scope => 'MY$COMPARTMENT'
);
END;
/

En el ejemplo anterior se otorga al usuario ANALYTICS_ADMIN permiso para registrar juegos de datos en el ámbito MY$COMPARTMENT.

Consulte GRANT_REGISTER para obtener una referencia de sintaxis.

Un proveedor llama a DBMS_DATA_ACCESS_SCOPE.REGISTER_CREATION_SCOPE para registrar el ámbito permitido para tablas específicas o esquemas completos a fin de crear hipervínculos de tabla en esos objetos.

BEGIN
DBMS_DATA_ACCESS_SCOPE.REGISTER_CREATION_SCOPE(
schema_name => 'ANALYTICS',
schema_object_name => 'NULL',
scope => 'MY$COMPARTMENT'
);
END;
/

En este ejemplo, se registra un ámbito de acceso a datos en el nivel de esquema para el esquema ANALYTICS, asociándolo al compartimento MY$COMPARTMENT.

Ejemplo: registro de ámbito de nivel de objeto

BEGIN
DBMS_DATA_ACCESS_SCOPE.REGISTER_CREATION_SCOPE(
schema_name => 'ANALYTICS',
schema_object_name => 'SALES_DATA',
scope => 'MY$TENANCY'
);
END;
/

En este ejemplo se registra un ámbito de acceso a datos más específico para un objeto específico SALES_DATA dentro del esquema ANALYTICS, enlazándolo al arrendamiento MY$TENANCY. A diferencia de la versión de nivel de esquema, schema_object_name limita la aplicación a esta tabla, lo que permite el control granular sobre los permisos de creación.

BEGIN
DBMS_DATA_ACCESS_SCOPE.REGISTER_CREATION_SCOPE(
schema_name => 'ANALYTICS',
schema_object_list => '["SALES_DATA", "CUSTOMER_DATA", "PRODUCT_DATA"]',
scope => 'MY$COMPARTMENT'
);
END;
/

Este procedimiento asocia los objetos de esquema mostrados: SALES_DATA, CUSTOMER_DATA y PRODUCT_DATA al ámbito MY$COMPARTMENT, restringiendo su creación o acceso a las entidades de ese compartimento.

Consulte Register Creation Scope para obtener una referencia de sintaxis.

Si un proveedor necesita cambiar el acceso, el mismo usuario u otro usuario autorizado llama a UPDATE_CREATION_SCOPE para ampliar, reducir o ajustar de otro modo qué bases de datos de IA autónomas de consumidores pueden crear hiperenlaces para objetos de esquema concretos.

BEGIN
DBMS_DATA_ACCESS_SCOPE.UPDATE_CREATION_SCOPE(
schema_name => 'ANALYTICS',
schema_object_name => 'SALES_DATA',
scope => 'MY$COMPARTMENT'
);
END;
/

En este ejemplo, se actualiza el ámbito de creación de la tabla SALES_DATA en el esquema ANALYTICS a MY$COMPARTMENT.

Consulte Update Creation Scope para obtener más información sobre la sintaxis.

Cuando un proveedor desea revocar completamente la capacidad de creación remota (para una tabla, una lista de tablas o un esquema), el proveedor llama a UNREGISTER_CREATION_SCOPE. Esto elimina el ámbito registrado y evita que las bases de datos de consumidores creen nuevos hipervínculos de tabla para esos objetos.

BEGIN
DBMS_DATA_ACCESS_SCOPE.UNREGISTER_CREATION_SCOPE(
schema_name => 'ANALYTICS',
schema_object_name => 'SALES_DATA'
);
END;
/

Este bloque de ejemplo elimina un ámbito de creación registrado anteriormente para SALES_DATA en el esquema ANALYTICS, de modo que los nuevos objetos creados en ese ámbito ya no se rigen por el acceso a los datos que controla el ámbito aplicado.

Consulte Unregister Creation Scope para obtener una referencia de sintaxis.

En cualquier momento, un usuario autorizado puede llamar a LIST_CREATION_SCOPES para recuperar las definiciones de ámbito actuales.

DECLARE
l_result CLOB;
BEGIN
DBMS_DATA_ACCESS_SCOPE.LIST_CREATION_SCOPES(
schema_name => 'ANALYTICS',
result => l_result
);
DBMS_OUTPUT.PUT_LINE(l_result);
END;
/

Consulte Retrieve Creation Scope para obtener una referencia de sintaxis.

En la base de datos de IA autónoma del consumidor, ADMIN (o PDB_DBA) utiliza DBMS_DATA_ACCESS_ADMIN.GRANT_READ para otorgar a usuarios específicos el derecho de crear tablas federadas en esquemas u objetos de proveedores remotos.

Ejemplo: Otorgamiento de acceso a un objeto remoto específico

BEGIN
DBMS_DATA_ACCESS_ADMIN.GRANT_READ(
username => 'BI_ANALYST',
remote_schema_name => 'ANALYTICS',
remote_schema_object_name => 'SALES_DATA'
);
END;
/

En este ejemplo, se otorga al usuario BI_ANALYST acceso de lectura al objeto SALES_DATA remoto específico en el esquema ANALYTICS de un proveedor de datos externo.

Consulte Otorgar lectura para obtener una referencia de sintaxis.

El procedimiento REVOKE_READ elimina el privilegio de un usuario para crear tablas federadas a través de un esquema remoto u objeto de esquema especificado en la base de datos del proveedor.

Si omite el nombre del objeto remoto, revoca el acceso a la tabla federada de ese usuario para todos los objetos del esquema remoto proporcionado.

Ejemplo

BEGIN
DBMS_DATA_ACCESS_ADMIN.REVOKE_READ(
username => 'BI_ANALYST',
remote_schema_name => 'ANALYTICS',
remote_schema_object_name => 'SALES_DATA'
);
END;
/

Consulte Revoke Read para obtener referencia sobre la sintaxis.

Un usuario consumidor al que se le han otorgado privilegios de lectura llama a DBMS_DATA_ACCESS.CREATE_FEDERATED_TABLE para crear una tabla federada en la tabla o vista dentro del ámbito del proveedor.

El procedimiento utiliza OCID de base de datos e información de región para establecer hipervínculos de tabla para que el consumidor pueda consultar datos remotos como si se tratara de una tabla externa local.

Requisitos

• Se deben otorgar privilegios de lectura al usuario mediante el procedimiento GRANT_READ.
• El usuario debe existir en las bases de datos de consumidor y proveedor con los privilegios necesarios.
• La base de datos de consumidores debe pertenecer al ámbito de creación del proveedor.
• El proveedor debe tener un ámbito de creación registrado para los objetos de destino.
• Conectividad de red establecida entre las bases de datos de consumidores y proveedores.

Ejemplo: proveedor único

BEGIN
DBMS_DATA_ACCESS.CREATE_FEDERATED_TABLE(
table_name => 'SALES_FED',
remote_schema_name => 'ANALYTICS',
remote_schema_object_name => 'SALES_DATA',
db_ocids => '[{"region": "IAD", "db_ocid": "OCID1.AUTONOMOUSDATABASE.OC1.IAD.EXAMPLE123"}]'
);
END;
/

En el ejemplo anterior, un consumidor llama a DBMS_DATA_ACCESS.CREATE_FEDERATED_TABLE para crear una tabla federada local que enlace a la tabla o vista de un proveedor remoto (por ejemplo, SALES_DATA en el esquema ANALYTICS), utilizando JSON db_ocids para especificar la base de datos de proveedor OCIDs y las regiones para realizar consultas sin problemas como si fueran locales.

SELECT
REGION,
PRODUCT_ID,
SUM(SALES_AMOUNT) as total_sales,
COUNT(*) as transaction_count
FROM SALES_FED
GROUP BY REGION, PRODUCT_ID
ORDER BY total_sales DESC;

Consulte Crear tabla federada para obtener una referencia de sintaxis.

Cuando el acceso federado ya no es necesario, el usuario consumidor llama a DBMS_DATA_ACCESS.DROP_FEDERATED_TABLE para eliminar la tabla federada.

Este procedimiento limpia el objeto del lado del consumidor y finaliza efectivamente esa ruta de acceso federada concreta, mientras que los ámbitos y privilegios del proveedor subyacente permanecen bajo control del proveedor.

BEGIN
DBMS_DATA_ACCESS.DROP_FEDERATED_TABLE(
table_name => 'SALES_FED'
);
END;
/

En el ejemplo anterior se borra la tabla SALES_FED.

Consulte Borrar tabla federada para obtener una referencia de sintaxis.