Cataloghi esterni

I cataloghi esterni sono cataloghi in cui i dati provengono da una posizione esterna a Oracle AI Data Platform Workbench.

Icona Esercitazione Sprint LiveLabs

I cataloghi esterni si connettono a origini come Oracle Autonomous AI Lakehouse, Oracle AI Database e Oracle Autonomous AI Transaction Processing per estrarre i dati nel tuo AI Data Platform Workbench. I cataloghi esterni utilizzano le credenziali fornite durante la creazione del catalogo esterno per eseguire query sull'origine esterna. Per ulteriori informazioni sulle origini dati, vedere Origini interne.

Ad esempio, se si crea un catalogo esterno per un'istanza di Autonomous AI Lakehouse in cui le credenziali utente Autonomous AI Lakehouse utilizzate hanno accesso allo schema1, ma non allo schema2, nel catalogo esterno viene visualizzato solo lo schema1. Gli utenti con autorizzazioni per il catalogo esterno possono eseguire query solo sullo schema a cui l'utente di Autonomous AI Lakehouse ha accesso.

Nota

AI Data Platform Workbench non supporta la raccolta di dati da schemi e tabelle condivisi tra pluggable database (PDB) o da schemi e tabelle gestiti da Oracle.

Autorizzazioni richieste per Autonomous AI Lakehouse e Autonomous AI Transaction Processing

Quando si crea un catalogo esterno in AI Data Platform Workbench, le credenziali utente utilizzate per la connessione devono disporre almeno delle autorizzazioni riportate di seguito.
  • CREATE SESSION per la connessione al database
  • SELECT accesso agli oggetti richiesti (tabelle/viste/tabelle esterne) tramite privilegi minimi o un ruolo di lettura dedicato
  • LEGGI, SCRIVI SU DIRECTORY DATA_PUMP_DIR
Se si stanno inserendo dati o creando una nuova tabella nel catalogo esterno, assicurarsi che l'utente faccia parte di DWROLE. Per ulteriori informazioni, consultare la documentazione di Oracle Autonomous AI Transaction Processing, Gestire i privilegi utente su Autonomous AI Database - Connessione a uno strumento client.

Limitazioni

I cataloghi esterni supportano query e DML. DDL non supportato anche quando le credenziali utilizzate per creare il catalogo esterno dispongono delle autorizzazioni per eseguire le istruzioni DDL.

Creare un catalogo esterno

È possibile connettere un catalogo dal workbench di AI Data Platform a un'origine esterna.

  1. Fare clic su Crea nel riquadro di navigazione a sinistra e selezionare Catalogo. È inoltre possibile accedere al catalogo principale e fare clic su Icona Crea catalogo Crea catalogo nel catalogo principale.
  2. Compilare i campi del nome e della descrizione.
  3. Dall'elenco a discesa Tipo catalogo, selezionare Catalogo esterno.
  4. Selezionare il tipo di origine esterna.
    • Per Oracle Autonomous AI Lakehouse, fornire un file wallet o la configurazione dell'istanza.
    • Per Oracle Autonomous AI Transaction Processing, fornire un file wallet o la configurazione dell'istanza.
    • Per Oracle AI Database, fornire un file wallet o la configurazione dell'istanza.
    • Per Kafka, fornire il server bootstrap. Separare più server con una virgola. (Disponibile a breve)
  5. Compilare nome utente e password.
  6. SSL è abilitato per impostazione predefinita. Deselezionare la casella per disabilitare SSL.
  7. Fare clic su Crea.
    Nei cataloghi esterni che estraggono dati da un'origine esterna viene visualizzata un'icona a forma di cerchio rotante.
    Vista struttura catalogo principale con l'icona in corso di rotazione accanto al catalogo evidenziato

    È inoltre possibile monitorare l'avanzamento da Esecuzioni job.

Creare un catalogo esterno per le reti private

È possibile creare un catalogo esterno che accede alle origini dati in una rete privata.

  1. Fare clic su Crea nel riquadro di navigazione a sinistra e selezionare Catalogo. È inoltre possibile accedere al catalogo principale e fare clic su Icona Crea catalogo Crea catalogo nel catalogo principale.
  2. Compilare i campi del nome e della descrizione.
  3. Dall'elenco a discesa Tipo catalogo, selezionare Catalogo esterno.
  4. Selezionare il tipo di origine esterna.
    • Per Oracle Autonomous AI Lakehouse, fornire un file wallet o la configurazione dell'istanza.
    • Per Oracle Autonomous AI Transaction Processing, fornire un file wallet o la configurazione dell'istanza.
    • Per Oracle AI Database, fornire un file wallet o la configurazione dell'istanza.
    • Per Oracle Exadata Database Service, fornire host, porta e nome servizio (SID).
    • Per Kafka, fornire il server bootstrap. Separare più server con una virgola. (Disponibile a breve)
  5. Compilare nome utente e password.
  6. SSL è abilitato per impostazione predefinita. Deselezionare la casella per disabilitare SSL.
  7. Selezionare Abilita rete privata.
  8. Selezionare l'area di lavoro con la configurazione di rete privata desiderata.
    Per informazioni sull'impostazione di un'area di lavoro configurata per le reti private, vedere Creare un'area di lavoro con accesso alla rete privata abilitato.
  9. Fare clic su Crea.
    Nei cataloghi esterni che estraggono dati da un'origine esterna viene visualizzata un'icona a forma di cerchio rotante.
    Vista struttura catalogo principale con l'icona in corso di rotazione accanto al catalogo evidenziato

    È inoltre possibile monitorare l'avanzamento da Esecuzioni job.

Aggiorna cataloghi dati esterni

È possibile attivare un aggiornamento di tutti i cataloghi esterni per aggiornarne il contenuto dall'origine.

  1. Nella home page, fare clic su Catalogo principale.
  2. Selezionare il catalogo esterno che si desidera aggiornare.
  3. Fai clic su Icona Aggiorna Aggiorna.
    Quando si fa clic su Aggiorna, i flussi di lavoro iniziano in background per estrarre e aggiornare i metadati dai cataloghi esterni. Nei cataloghi che estraggono dati da un'origine esterna viene visualizzata un'icona a forma di cerchio rotante.
    Vista struttura catalogo principale con l'icona in corso di rotazione accanto al catalogo evidenziato

    È inoltre possibile monitorare l'avanzamento da Esecuzioni job.

Modifica descrizione catalogo esterno

È possibile modificare la descrizione dei cataloghi esterni dopo la creazione se il loro contenuto o scopo è stato modificato.

  1. Nella home page, fare clic su Catalogo principale.
  2. Accanto al catalogo esterno, fare clic su Icona a tre punti Azioni Azioni e fare clic su Modifica descrizione.

    Menu a tre punti Azioni per un catalogo aperto con Modifica descrizione evidenziata

  3. Apportare le modifiche alla descrizione del catalogo, quindi fare clic su Salva.

Rinomina catalogo esterno

È possibile rinominare i cataloghi esterni per fornire un'etichetta descrittiva quando il contenuto o lo scopo del catalogo è stato modificato.

Impossibile rinominare il catalogo predefinito.
  1. Nella home page, fare clic su Catalogo principale.
  2. Accanto al catalogo, fare clic su Icona a tre punti Azioni Azioni e fare clic su Rinomina.

    Menu a tre punti Azioni aperto per il catalogo con Rename evidenziato

  3. Apportare le modifiche al nome del catalogo, quindi fare clic su Salva.

Modifica configurazione catalogo esterno

È possibile modificare la configurazione di un catalogo esterno per aggiornare la password richiesta.

  1. Nella home page, fare clic su Catalogo principale.
  2. Accanto al catalogo, fare clic su Icona a tre punti Azioni Azioni e fare clic su Modifica configurazione.
  3. Immettere la nuova password per il catalogo esterno e fare clic su Salva.

Accedi a tabelle catalogo esterne nel notebook

È possibile accedere alle tabelle dai cataloghi esterni nei notebook utilizzando nomi in tre parti.

Il push down è abilitato per impostazione predefinita e le operazioni quali aggregazioni, proiezione, filtri, eliminazione delle colonne, topN, limite, offset, booleano, logico e relazionale vengono spinte verso il basso verso l'origine.
  1. Passare all'interfaccia del codice del notebook.
  2. Per leggere i dati dalla tabella del catalogo esterno, utilizzare:
    df = spark.read.table("<<catalog_name>>.<<schema_name>>.<<table_name>>")
  3. Per scrivere i dati nel catalogo esterno, sono disponibili quattro opzioni:
    Option#1
df.write.saveAsTable("<<catalog_name>>.<<schema_name>>.<<table_name>>")

Option#2
df.write.mode("append").insertInto("<<catalog_name>>.<<schema_name>>.<<table_name>>")

Option#3
df.write.mode("overwrite").saveAsTable("<<catalog_name>>.<<schema_name>>.<<table_name>>")

Option#4
df.write.option('write.mode', 'MERGE').option('write.merge.keys','merge column(s)').insertInto('<<catalog_name>>.<<schema_name>>.<<table_name>>')

Elimina un catalogo esterno

È possibile eliminare cataloghi esterni per rimuovere tutti i metadati memorizzati localmente.

L'eliminazione di un catalogo esterno elimina solo i metadati memorizzati localmente. I dati nell'origine dati non sono interessati.

  1. Nella home page, fare clic su Catalogo principale.
  2. Accanto al catalogo, fare clic su Icona a tre punti Azioni Azioni, quindi su Elimina.

    Menu a tre punti Azioni aperto per il catalogo con eliminazione evidenziata

  3. Selezionare Conferma eliminazione dei cataloghi.
  4. Fare clic su Elimina.