Créer des tables fédérées à l'aide d'hyperliens de table en définissant l'étendue

Une portée de création dans une base de données de fournisseur détermine quelles instances de base de données d'IA autonome de consommateur sont autorisées à créer à distance des hyperliens de table dans la base de données de fournisseur.

Vous pouvez gérer les portées de création à l'aide de l'ensemble DBMS_DATA_ACCESS_SCOPE, qui fournit des procédures pour enregistrer, annuler l'enregistrement, mettre à jour et extraire les portées. Pour plus d'informations, voir DBMS_DATA_ACCESS_SCOPE.

ADMIN (ou PDB_DBA) dans la base de données d'intelligence artificielle autonome du fournisseur utilise DBMS_DATA_ACCESS_ADMIN.GRANT_REGISTER pour décider quels utilisateurs locaux sont autorisés à gérer les portées de création.

Seuls ces utilisateurs privilégiés peuvent enregistrer, mettre à jour ou annuler l'enregistrement des portées, empêchant ainsi une exposition non contrôlée des tables de fournisseurs.

Exemple

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

L'exemple ci-dessus accorde à l'utilisateur ANALYTICS_ADMIN l'autorisation d'enregistrer des jeux de données dans l'étendue MY$COMPARTMENT.

Pour plus d'informations sur la syntaxe, voir GRANT_REGISTER.

Un fournisseur appelle DBMS_DATA_ACCESS_SCOPE.REGISTER_CREATION_SCOPE pour enregistrer la portée autorisée pour des tables spécifiques ou des schémas entiers afin de créer des hyperliens de table dans ces objets.

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

Cet exemple enregistre une portée d'accès aux données au niveau du schéma pour le schéma ANALYTICS, en l'associant au compartiment MY$COMPARTMENT.

Exemple : Enregistrer la portée au niveau de l'objet

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

Cet exemple enregistre une portée d'accès aux données plus ciblée pour un objet spécifique SALES_DATA dans le schéma ANALYTICS, en le liant à la location MY$TENANCY. Contrairement à la version au niveau du schéma, schema_object_name limite l'application à cette table, ce qui permet un contrôle granulaire des autorisations de création.

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

Cette procédure associe les objets de schéma répertoriés (SALES_DATA, CUSTOMER_DATA et PRODUCT_DATA) à la portée MY$COMPARTMENT, ce qui limite leur création ou leur accès aux entités de ce compartiment.

Voir Enregistrer la portée de création pour des informations de référence sur la syntaxe.

Si un fournisseur doit modifier l'accès, le même utilisateur autorisé ou un autre appelle UPDATE_CREATION_SCOPE pour élargir, restreindre ou ajuster autrement les bases de données d'IA autonomes consommateurs qui peuvent créer des hyperliens pour des objets de schéma particuliers.

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

Cet exemple met à jour la portée de création de la table SALES_DATA dans le schéma ANALYTICS à MY$COMPARTMENT.

Voir Mettre à jour la portée de création pour des informations de référence sur la syntaxe.

Lorsqu'un fournisseur souhaite révoquer entièrement la fonction de création à distance (pour une table, une liste de tables ou un schéma), il appelle UNREGISTER_CREATION_SCOPE. Cela supprime la portée enregistrée et empêche la création de nouveaux hyperliens de table pour ces objets par les bases de données de consommateurs.

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

Cet exemple de bloc supprime une étendue de création précédemment enregistrée pour SALES_DATA dans le schéma ANALYTICS, de sorte que les nouveaux objets créés sous cette étendue ne sont plus régis par les contrôles d'accès aux données de la portée appliquée.

Voir Annuler l'enregistrement de la portée de création pour des informations de référence sur la syntaxe.

À tout moment, un utilisateur autorisé peut appeler LIST_CREATION_SCOPES pour extraire les définitions de portée courantes.

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;
/

Voir Extraire la portée de création pour des informations de référence sur la syntaxe.

Dans la base de données d'IA autonome du consommateur, ADMIN (ou PDB_DBA) utilise DBMS_DATA_ACCESS_ADMIN.GRANT_READ pour accorder à des utilisateurs spécifiques le droit de créer des tables fédérées contre des schémas ou des objets de fournisseur distant.

Exemple : Accorder l'accès à un objet distant spécifique

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

Cet exemple accorde à l'utilisateur BI_ANALYST l'accès en lecture à l'objet SALES_DATA distant spécifique dans le schéma ANALYTICS d'un fournisseur de données externe.

Pour plus d'informations sur la syntaxe, voir Accorder la lecture.

La procédure REVOKE_READ supprime le privilège d'un utilisateur pour créer des tables fédérées sur un schéma distant ou un objet de schéma spécifié dans la base de données du fournisseur.

Si vous omettez le nom de l'objet distant, il révoque l'accès à la table fédérée de cet utilisateur pour tous les objets du schéma distant indiqué.

Exemple

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

Voir Révoquer la lecture pour des informations de référence sur la syntaxe.

Un utilisateur consommateur disposant de privilèges de lecture appelle DBMS_DATA_ACCESS.CREATE_FEDERATED_TABLE pour créer une table fédérée sur la table ou la vue incluse du fournisseur.

La procédure utilise les OCID de base de données et les informations de région pour établir des hyperliens de table afin que le consommateur puisse interroger les données distantes comme s'il s'agissait d'une table externe locale.

Conditions requises

• Les privilèges de lecture doivent être accordés à l'utilisateur au moyen de la procédure GRANT_READ.
• L'utilisateur doit exister dans les bases de données de consommateur et de fournisseur avec les privilèges requis.
• La base de données du consommateur doit appartenir à l'étendue de création du fournisseur.
• Le fournisseur doit avoir une étendue de création enregistrée pour les objets cibles.
• Connectivité réseau établie entre les bases de données consommateur et fournisseur.

Exemple : Fournisseur unique

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;
/

Dans l'exemple ci-dessus, un consommateur appelle DBMS_DATA_ACCESS.CREATE_FEDERATED_TABLE pour créer une table fédérée locale qui est liée à la table ou à la vue d'un fournisseur distant (par exemple, SALES_DATA dans le schéma ANALYTICS), à l'aide de JSON db_ocids pour spécifier la base de données du fournisseur OCIDs et les régions pour une interrogation transparente comme si elle était locale.

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;

Voir Créer une table fédérée pour des informations de référence sur la syntaxe.

Lorsque l'accès fédéré n'est plus requis, l'utilisateur consommateur appelle DBMS_DATA_ACCESS.DROP_FEDERATED_TABLE pour supprimer la table fédérée.

Cette procédure nettoie l'objet côté consommateur et met fin efficacement à ce chemin d'accès fédéré particulier, tandis que les étendues et les privilèges sous-jacents du fournisseur restent sous le contrôle du fournisseur.

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

L'exemple ci-dessus supprime la table SALES_FED.

Voir Supprimer la table fédérée pour des informations de référence sur la syntaxe.