Crea tabelle federate utilizzando collegamenti ipertestuali tabella mediante la definizione dell'ambito

Un ambito di creazione in un database di provider determina quali istanze di Autonomous AI Database consumer sono autorizzate a creare collegamenti ipertestuali tabella in remoto nel database di provider.

È possibile gestire gli ambiti di creazione utilizzando il pacchetto DBMS_DATA_ACCESS_SCOPE, che fornisce procedure per la registrazione, l'annullamento della registrazione, l'aggiornamento e il recupero degli ambiti. Per ulteriori informazioni, vedere DBMS_DATA_ACCESS_SCOPE.

ADMIN (o PDB_DBA) nell'Autonomous AI Database del provider utilizza il comando DBMS_DATA_ACCESS_ADMIN.GRANT_REGISTER per decidere quali utenti locali sono autorizzati a gestire gli ambiti di creazione.

Solo questi utenti con privilegi possono registrare, aggiornare o annullare la registrazione degli ambiti, impedendo l'esposizione incontrollata delle tabelle provider.

Esempio

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

L'esempio precedente concede all'utente ANALYTICS_ADMIN l'autorizzazione per registrare i data set nell'ambito MY$COMPARTMENT.

Per informazioni sulla sintassi, vedere GRANT_REGISTER.

Un provider chiama DBMS_DATA_ACCESS_SCOPE.REGISTER_CREATION_SCOPE per registrare l'ambito consentito per tabelle specifiche o interi schemi per creare collegamenti ipertestuali tabella in tali oggetti.

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

Questo esempio registra un ambito di accesso ai dati a livello di schema per lo schema ANALYTICS, associandolo al compartimento MY$COMPARTMENT.

Esempio: Registra ambito a livello di oggetto

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

Questo esempio registra un ambito di accesso ai dati più mirato per un oggetto specifico SALES_DATA all'interno dello schema ANALYTICS, collegandolo alla tenancy MY$TENANCY. A differenza della versione a livello di schema, schema_object_name limita l'applicazione solo a questa tabella, consentendo un controllo granulare sulle autorizzazioni di creazione.

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

Questa procedura associa gli oggetti schema elencati, ovvero SALES_DATA, CUSTOMER_DATA e PRODUCT_DATA, all'ambito MY$COMPARTMENT, limitandone la creazione o l'accesso alle entità all'interno di tale compartimento.

Per informazioni sulla sintassi, vedere Registra ambito di creazione.

Se un provider deve modificare l'accesso, lo stesso utente o un altro utente autorizzato richiama UPDATE_CREATION_SCOPE per ampliare, limitare o modificare in altro modo i database AI autonomi consumer in grado di creare collegamenti ipertestuali per determinati oggetti schema.

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

Questo esempio aggiorna l'ambito di creazione per la tabella SALES_DATA nello schema ANALYTICS in MY$COMPARTMENT.

Per informazioni sulla sintassi, vedere Aggiorna ambito di creazione.

Quando un provider desidera revocare completamente la funzionalità di creazione remota (per una tabella, una lista di tabelle o uno schema), il provider chiama UNREGISTER_CREATION_SCOPE. Ciò rimuove l'ambito registrato e impedisce la creazione di nuovi collegamenti ipertestuali tabella per tali oggetti da parte dei database consumer.

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

Questo blocco di esempio rimuove un ambito di creazione registrato in precedenza per SALES_DATA nello schema ANALYTICS, in modo che i nuovi oggetti creati con tale ambito non siano più regolati dall'accesso ai dati che controlla l'ambito applicato.

Per riferimento alla sintassi, vedere Annulla registrazione ambito creazione.

In qualsiasi momento, un utente autorizzato può chiamare LIST_CREATION_SCOPES per recuperare le definizioni di ambito correnti.

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

Per riferimento alla sintassi, vedere Recupera ambito creazione.

Nell'Autonomous AI Database consumer, ADMIN (o PDB_DBA) utilizza DBMS_DATA_ACCESS_ADMIN.GRANT_READ per concedere a utenti specifici il diritto di creare tabelle federate in schemi o oggetti del provider remoto.

Esempio: concessione dell'accesso a un oggetto remoto specifico

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

Questo esempio concede all'utente BI_ANALYST l'accesso in lettura all'oggetto SALES_DATA remoto specifico nello schema ANALYTICS di un provider di dati esterno.

Per riferimento alla sintassi, vedere Concedi lettura.

La procedura REVOKE_READ rimuove il privilegio di un utente per creare tabelle federate su uno schema remoto o un oggetto schema specificato nel database del provider.

Se si omette il nome dell'oggetto remoto, viene revocato l'accesso alla tabella federata dell'utente per tutti gli oggetti nello schema remoto specificato.

Esempio

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

Per riferimento alla sintassi, vedere Revoca lettura.

Un utente consumer a cui sono stati concessi i privilegi di lettura richiama DBMS_DATA_ACCESS.CREATE_FEDERATED_TABLE per creare una tabella federata nella tabella o nella vista di ambito del provider.

La procedura utilizza gli OCID del database e le informazioni sull'area per stabilire i collegamenti ipertestuali delle tabelle in modo che il consumer possa eseguire query sui dati remoti come se si trattasse di una tabella esterna locale.

Requisiti indispensabili

• All'utente devono essere concessi i privilegi di lettura mediante la procedura GRANT_READ.
• L'utente deve esistere sia nei database consumer che nei database provider con privilegi richiesti.
• Il database consumer deve appartenere all'ambito di creazione del provider.
• Il provider deve avere un ambito di creazione registrato per gli oggetti di destinazione.
• Connettività di rete stabilita tra database consumer e provider.

Esempio: provider singolo

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

Nell'esempio precedente, un consumer chiama DBMS_DATA_ACCESS.CREATE_FEDERATED_TABLE per creare una tabella federata locale che si collega alla tabella o alla vista di un provider remoto (ad esempio, SALES_DATA nello schema ANALYTICS), utilizzando JSON db_ocids per specificare il database del provider OCIDs e le aree per eseguire query senza interruzioni come se fossero locali.

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;

Per riferimento alla sintassi, vedere Crea tabella federata.

Quando l'accesso federato non è più necessario, l'utente consumer chiama DBMS_DATA_ACCESS.DROP_FEDERATED_TABLE per rimuovere la tabella federata.

Questa procedura pulisce l'oggetto lato consumer e termina in modo efficace quel particolare percorso di accesso federato, mentre gli ambiti e i privilegi del provider di base rimangono sotto il controllo del provider.

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

Nell'esempio precedente viene eliminata la tabella SALES_FED.

Per riferimento alla sintassi, vedere Elimina tabella federata.