Föderierte Tabellen mit Tabellen-Hyperlinks durch Definieren des Geltungsbereichs erstellen

Ein Erstellungsgeltungsbereich in einer Providerdatenbank bestimmt, welche autonomen KI-Consumer-Datenbankinstanzen Tabellen-Hyperlinks remote in der Providerdatenbank erstellen dürfen.

Sie können Erstellungsbereiche mit dem Package DBMS_DATA_ACCESS_SCOPE verwalten, das Prozeduren zum Registrieren, Aufheben der Registrierung, Aktualisieren und Abrufen von Geltungsbereichen bereitstellt. Weitere Informationen finden Sie unter DBMS_DATA_ACCESS_SCOPE.

Die ADMIN (oder PDB_DBA) in der autonomen KI-Providerdatenbank verwendet die DBMS_DATA_ACCESS_ADMIN.GRANT_REGISTER, um zu entscheiden, welche lokalen Benutzer Erstellungsbereiche verwalten dürfen.

Nur diese privilegierten Benutzer können Geltungsbereiche registrieren, aktualisieren oder die Registrierung aufheben, um eine unkontrollierte Anzeige von Providertabellen zu verhindern.

Beispiel

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

Im obigen Beispiel wird dem ANALYTICS_ADMIN-Benutzer die Berechtigung erteilt, Datasets im Geltungsbereich MY$COMPARTMENT zu registrieren.

Syntaxreferenz finden Sie unter GRANT_REGISTER.

Ein Provider ruft DBMS_DATA_ACCESS_SCOPE.REGISTER_CREATION_SCOPE auf, um den zulässigen Geltungsbereich für bestimmte Tabellen oder ganze Schemas zu registrieren, um Tabellen-Hyperlinks in diese Objekte zu erstellen.

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

In diesem Beispiel wird ein Datenzugriffsgeltungsbereich auf Schemaebene für das Schema ANALYTICS registriert und mit dem Compartment MY$COMPARTMENT verknüpft.

Beispiel: Geltungsbereich auf Objektebene registrieren

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

In diesem Beispiel wird ein gezielterer Datenzugriffsgeltungsbereich für ein bestimmtes Objekt SALES_DATA innerhalb des Schemas ANALYTICS registriert und mit dem Mandanten MY$TENANCY verknüpft. Im Gegensatz zur Version auf Schemaebene begrenzt schema_object_name die Durchsetzung nur auf diese Tabelle, wodurch eine granulare Kontrolle über die Erstellungsberechtigungen ermöglicht wird.

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

Diese Prozedur verknüpft die aufgelisteten Schemaobjekte SALES_DATA, CUSTOMER_DATA und PRODUCT_DATA mit dem Geltungsbereich MY$COMPARTMENT und schränkt die Erstellung oder den Zugriff auf Entitys in diesem Compartment ein.

Syntaxreferenz finden Sie unter Erstellungsgeltungsbereich registrieren.

Wenn ein Provider den Zugriff ändern muss, ruft derselbe oder ein anderer autorisierter Benutzer UPDATE_CREATION_SCOPE auf, um zu erweitern, einzuschränken oder anderweitig anzupassen, welche autonomen KI-Verbraucherdatenbanken Hyperlinks für bestimmte Schemaobjekte erstellen können.

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

In diesem Beispiel wird der Erstellungsgeltungsbereich für die Tabelle SALES_DATA im Schema ANALYTICS in MY$COMPARTMENT aktualisiert.

Syntaxreferenz finden Sie unter Erstellungsgeltungsbereich aktualisieren.

Wenn ein Provider die Remote-Erstellungsfunktion vollständig entziehen möchte (für eine Tabelle, eine Tabellenliste oder ein Schema), ruft der Provider UNREGISTER_CREATION_SCOPE auf. Dadurch wird der registrierte Geltungsbereich entfernt und verhindert, dass neue Tabellen-Hyperlinks für diese Objekte von Consumer-Datenbanken erstellt werden.

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

Dieser Beispielblock entfernt einen zuvor registrierten Erstellungsgeltungsbereich für SALES_DATA im Schema ANALYTICS, sodass neue Objekte, die unter diesem Geltungsbereich erstellt wurden, nicht mehr von den Datenzugriffskontrollen des erzwungenen Geltungsbereichs gesteuert werden.

Syntaxreferenz finden Sie unter Erstellungsgeltungsbereich für Registrierung aufheben.

Ein autorisierter Benutzer kann jederzeit LIST_CREATION_SCOPES aufrufen, um aktuelle Geltungsbereichsdefinitionen abzurufen.

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

Syntaxreferenz finden Sie unter Erstellungsgeltungsbereich abrufen.

In der autonomen KI-Datenbank des Verbrauchers verwendet ADMIN (oder PDB_DBA) DBMS_DATA_ACCESS_ADMIN.GRANT_READ, um bestimmten Benutzern das Recht zu erteilen, föderierte Tabellen für Remoteproviderschemas oder -objekte zu erstellen.

Beispiel: Zugriff auf ein bestimmtes Remoteobjekt erteilen

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

In diesem Beispiel wird dem Benutzer BI_ANALYST Lesezugriff auf das spezifische Remoteobjekt SALES_DATA im Schema ANALYTICS eines externen Datenproviders erteilt.

Syntaxreferenz finden Sie unter Lesezugriff erteilen.

Mit der Prozedur REVOKE_READ wird die Berechtigung eines Benutzers zum Erstellen föderierter Tabellen über ein angegebenes Remoteschema oder Schemaobjekt in der Providerdatenbank entfernt.

Wenn Sie den Remote-Objektnamen auslassen, entzieht er dem föderierten Tabellenzugriff dieses Benutzers für alle Objekte im angegebenen Remoteschema.

Beispiel

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

Syntaxreferenz finden Sie unter Lesevorgang widerrufen.

Ein Consumer-Benutzer, dem Leseberechtigungen erteilt wurden, ruft DBMS_DATA_ACCESS.CREATE_FEDERATED_TABLE auf, um eine föderierte Tabelle über die In-Scope-Tabelle oder -View des Providers zu erstellen.

Die Prozedur verwendet Datenbank-OCIDs und Regionsinformationen, um Tabellen-Hyperlinks einzurichten, damit der Consumer Remote-Daten abfragen kann, als wäre es eine lokale externe Tabelle.

Voraussetzungen

• Dem Benutzer müssen Leseberechtigungen über die Prozedur GRANT_READ erteilt werden.
• Benutzer muss sowohl in Consumer- als auch in Providerdatenbanken mit erforderlichen Berechtigungen vorhanden sein.
• Consumer-Datenbank muss zum Erstellungsbereich des Providers gehören.
• Der Provider muss einen registrierten Erstellungsgeltungsbereich für Zielobjekte haben.
• Netzwerkkonnektivität zwischen Consumer- und Providerdatenbanken hergestellt.

Beispiel: Einzelner Provider

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

Im obigen Beispiel ruft ein Consumer DBMS_DATA_ACCESS.CREATE_FEDERATED_TABLE auf, um eine lokale föderierte Tabelle zu erstellen, die mit der Tabelle oder View eines Remoteproviders verknüpft ist (z.B. SALES_DATA im Schema ANALYTICS), wobei JSON db_ocids verwendet wird, um Providerdatenbank OCIDs und Regionen für nahtlose Abfragen als lokal anzugeben.

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;

Syntaxreferenz finden Sie unter Federierte Tabelle erstellen.

Wenn der föderierte Zugriff nicht mehr erforderlich ist, ruft der Consumer-Benutzer DBMS_DATA_ACCESS.DROP_FEDERATED_TABLE auf, um die föderierte Tabelle zu entfernen.

Diese Prozedur bereinigt das Consumer-seitige Objekt und beendet effektiv den jeweiligen föderierten Zugriffspfad, während die zugrunde liegenden Providergeltungsbereiche und Berechtigungen unter Providerkontrolle bleiben.

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

Im obigen Beispiel wird die Tabelle SALES_FED gelöscht.

Syntaxreferenz finden Sie unter Federierte Tabelle löschen.