Utilizza condivisione

Informazioni sui profili JSON

Delta Sharing Profiles consente di connettersi a un provider di condivisione e accedere a un server di condivisione Delta. Le informazioni sul profilo vengono memorizzate in un file zip contenente le credenziali client in formato JSON. Per accedere ai dati di condivisione, è necessario registrare gli oggetti condivisi utilizzando un profilo JSON autorizzato. È quindi possibile utilizzare il profilo JSON per l'autenticazione con un server di condivisione Delta e accedere alle condivisioni di dati disponibili.

Scarica profili JSON

Quando lo strumento di condivisione crea un oggetto di condivisione, il destinatario riceve una notifica e-mail con un collegamento per scaricare i profili di condivisione Delta. È inoltre possibile scaricare i profili JSON dalla console Database Actions:

1. Nella pagina Fornisci condivisione, fare clic sui tre punti accanto a un destinatario e selezionare Copia collegamento attivazione profilo negli Appunti.

2. Aprire il collegamento in un browser Web per accedere alla pagina di download del profilo Delta.

3. Fare clic su Recupera informazioni profilo per scaricare un file zip contenente i profili JSON di condivisione Delta.

Tipi di profilo JSON

L'immagine illustra i profili JSON e mostra come utilizzare Delta Share utilizzando bearerToken e OIDC per Databricks.

Descrizione dell'illustrazione adp-databricks-delta-share-oidc.eps

Delta Sharing supporta i seguenti profili:

• Versione profilo 1 con bearerToken

  Questo file JSON può includere tokenEndpoint, clientID e clientSecret in modo che il token possa essere aggiornato.

• Profilo versione 2 che utilizza OIDC (solo PL/SQL) per la condivisione delle aree dati

  Questo file JSON contiene le credenziali client OpenID Connect (OIDC) e OAuth, ad esempio clientId, clientSecret e tokenEndpoint. I profili OIDC delle aree dati utilizzano shareCredentialsVersion 2 e type oauth_client_credentials, ma non supportano bearerToken. Autonomous Database utilizza tokenEndpoint per ottenere i token di accesso con validità più breve e li aggiorna automaticamente.

  La versione 2 del profilo offre una maggiore sicurezza a causa del fatto che non ci sono token portatori di lunga durata da distribuire, ha una rotazione più semplice dei segreti e fornisce maggiore automazione.

Quando si esegue la sottoscrizione a un provider di condivisione delta in Condivisione consumo, è possibile utilizzare il file JSON versione 1 o versione 2 oppure caricare il file zip direttamente nel campo JSON di condivisione provider.

{
        "shareCredentialsVersion": 1, 
        "endpoint": "https://myhost.us.example.com/ords/prov/_delta_sharing/", 
        "tokenEndpoint": "http://myhost.us.example.com:1234/ords/pdbdba/oauth/token", 
        "bearerToken": "-xxxxxxxxxxxxxxxxxxxxx", 
        "expirationTime": "20XX-01-13T07:53:11.073Z", 
        "clientID": "xxxxxxxxxxxxxxxxxxxxxx..", 
        "clientSecret": "xxxxxxxxxxxxxxxxxxxx.."
}

{
        "shareCredentialsVersion": 2, 
        "endpoint": "https://myhost.us.example.com/ords/prov/_delta_sharing/", 
        "tokenEndpoint": "http://myhost.us.example.com:1234/ords/pdbdba/oauth/token", 
        "type": "oauth_client_credentials",
        "clientId": "xxxxxxxxxxxxxxxxxxxxxx..", 
        "clientSecret": "xxxxxxxxxxxxxxxxxxxx..",
        "tokenScope": "xxxxxxxxxx"
}

Si noti la differenza in caso di ID client in entrambi i profili. Il profilo 1 include clientID e il profilo 2 include clientId.

Miglioramenti alla sicurezza

In qualità di destinatario della condivisione, è necessario impostare una lista di controllo dell'accesso (ACL) sul computer del provider della condivisione utilizzando la procedura APPEND_HOST_ACE come utente ADMIN o un altro utente con privilegi. Ciò consente di accedere alla condivisione tramite Internet.

Ad esempio, se si desidera consentire a un utente del database, A_SHARE_USER, di accedere agli endpoint su un host (provider di condivisione) denominato, ecco un esempio di procedura PL/SQL che sarà necessario eseguire nell'editor del foglio di lavoro SQL come amministratore. Come prerequisito, estrarre il nome host dalla proprietà dell'endpoint nel profilo JSON di condivisione delta, come indicato nell'esempio precedente. Il nome host dell'esempio è myhost.us.example.com.

BEGIN 
        dbms_network_acl_admin.append_host_ace(    
        host =>'myhost.us.example.com', 
        lower_port=>443,    
        upper_port=>443,
        ace => xs$ace_type(      
        privilege_list => xs$name_list('http', 'http_proxy'),      
        principal_name =>'A_SHARE_USER',
        principal_type => xs_acl.ptype_db)); 
        COMMIT;
        END;        
/

Di seguito sono riportati i parametri con la relativa descrizione.

• host: specifica il nome o l'indirizzo IP dell'host. Per il nome host o dominio non viene fatta distinzione tra maiuscole e minuscole.
• porta inferiore: specifica la porta inferiore di un intervallo di porte TCP opzionale.
• porta superiore: specifica la porta superiore di un intervallo di porte TCP opzionale.
• ace: voce di controllo dell'accesso.
• elenco dei privilegi: specifica la lista dei privilegi di rete da concedere o negare.
• principal_name- È il principal (utente o ruolo del database) a cui viene concesso o negato il privilegio. Fa distinzione tra maiuscole e minuscole.
• principal_type- Specifica il tipo di principal da utilizzare.

Per ulteriori informazioni sui sottoprogrammi del package DBMS_NETWORK_ACL_ADMIN, consultare il documento PL/SQL Packages and Types Reference.

PRIV_ORDS_ACL             CONSTANT PLS_INTEGER := 8;

Caricare un profilo JSON per creare una sottoscrizione provider condivisione

In questo processo verrà caricato il profilo JSON del provider per la configurazione e le credenziali per abilitare l'accesso ai destinatari.

1. Aprire la pagina Consuma condivisione e fare clic su + Sottoscrivi a provider condivisione per selezionare Sottoscrivi a provider di condivisione Delta dall'elenco a discesa. Viene visualizzata la finestra Sottoscrivi provider condivisione.
   Descrizione dell'immagine subscri-share-provider-version-providersettings.png
2. Specificare quanto segue nelle impostazioni del provider:

   • Origine condivisione: selezionare JSON del provider di condivisione delta.

   • Condividi JSON del provider: è possibile condividere il profilo JSON utilizzando le opzioni riportate di seguito.

     Da file: selezionare questa opzione e fare clic su JSON profilo di condivisione delta per sfogliare e caricare il profilo JSON nel sistema. In alternativa, è anche possibile caricare il file zip contenente i profili JSON direttamente nel campo JSON di condivisione provider.

     JSON: selezionare questa opzione per incollare il contenuto di un file JSON nello spazio fornito. Assicurarsi di copiare l'intero contenuto, comprese le parentesi graffe di inizio e fine.

   • In Dettagli provider condivisione immettere un valore in Nome provider e, facoltativamente, aggiungere una descrizione.

   Fare clic su Avanti per passare alla scheda Aggiungi condivisioni.
3. Nella scheda Aggiungi condivisioni della finestra di dialogo, verrà visualizzato l'elenco delle condivisioni disponibili. Fare clic sulla condivisione che si desidera utilizzare dalle condivisioni disponibili e selezionare una delle opzioni disponibili:
   Descrizione dell'immagine subscri-share-provider-version-addshares.png
   • >: questa opzione consente di spostare la condivisione disponibile nelle condivisioni selezionate.
   • <: selezionare questa opzione per rimuovere la condivisione selezionata dalle condivisioni selezionate.
   • >>: questa opzione consente di spostare tutte le condivisioni nelle condivisioni selezionate.
   • <<: selezionare questa opzione per rimuovere tutte le condivisioni selezionate dalle condivisioni selezionate.

4. Fare clic su Sottoscrivi per aggiungere la condivisione. Quando il provider viene creato correttamente, viene visualizzato un prompt di conferma. Dopo la creazione riuscita del provider, ora sarà possibile visualizzare la schermata Collega oggetto cloud della pagina Caricamento dati.

5. È possibile visualizzare il nome del provider nel campo Posizione storage cloud. La condivisione viene visualizzata nella posizione del file di origine con i file aggiunti alla condivisione.
   Descrizione dell'immagine link-cloud-object.png

   Espandere il carrello della cartella Condividi, trascinare e rilasciare il file condiviso dall'origine al carrello del collegamento dati.

   Selezionare Avvia nel carrello collegamenti dati per eseguire il job di collegamento dati.

6. Visualizzare le tabelle create da Database Actions.
   • Fare clic su Database Actions, nell'indicatore di percorso, per tornare al launchpad di Database Actions.
   • Fare clic sulla casella SQL.
   • Selezionare la tabella esterna, trascinarla nel foglio di lavoro.

     Viene visualizzata l'istruzione SQL Select per la tabella. Questa istruzione SQL può essere eseguita per utilizzare i dati condivisi.

     
     Descrizione dell'immagine xt_sql.png

ORA-29913: error while processing ODCIEXTTABLEFETCH routine

I provider di databricks possono condividere le tabelle Delta quando Autonomous AI Database è un consumer Delta Sharing nei seguenti scenari:

• Scenario 1 - Eliminazione dei vettori di eliminazione dalla tabella

• Scenario 2 - Creare una vista e condividerla

• Scenario 3 - Disabilita vettori di eliminazione nelle impostazioni dell'area di lavoro per le tabelle future

Scenario 1 - Eliminazione dei vettori di eliminazione dalla tabella

Utilizzare questa opzione se si è pronti a interrompere l'utilizzo di deletionVectors in una tabella specifica.

1. Eseguire questa operazione in Databricks.

   ALTER TABLE table_name 
   DROP FEATURE deletionVectors

2. Aggiungere la tabella table_name alla condivisione Delta e configurare Autonomous AI Database come consumer.

Questa opzione applica tutte le eliminazioni in sospeso e rimuove la funzione deletionVectors dalla tabella. La tabella si comporta come una normale tabella Delta senza deletionVectors.

Scenario 2 - Creare una vista e condividere la vista

Utilizzare questa opzione per mantenere deletionVectors nella tabella di base.

1. Eseguire questa operazione in Databricks.

   CREATE VIEW view_name AS 
   SELECT * FROM table_name;

2. Aggiungere la vista view_name alla condivisione Delta anziché alla tabella.

   I consumer di Autonomous AI Database possono eseguire questa query:

   SELECT * 
   FROM "MY_SHARE"."MY_SCHEMA"."view_name";

In questo scenario, la tabella di base Databricks continua a utilizzare i vettori di eliminazione. Databricks risolve i vettori di eliminazione durante l'esecuzione della vista, pertanto Autonomous AI Database non li visualizza. Per i destinatari non di Databricks, come Autonomous AI Database, Databricks potrebbe materializzare la vista e addebitare al provider computazione e storage. Il provider può configurare un TTL di materializzazione in Databricks per controllare il saldo tra il costo e l'aggiornamento dei dati, un TTL più breve o inferiore per i nuovi dati o un TTL più lungo o più alto per un costo effettivo.

Scenario 3 - Disabilita i vettori di eliminazione nelle impostazioni dell'area di lavoro per le tabelle future

Utilizzare questa opzione per impedire alle nuove tabelle di utilizzare i vettori di eliminazione per impostazione predefinita.

1. Aprire Impostazioni area di lavoro o la console di amministrazione come utente amministratore Databricks e passare a Avanzate.

2. Trovare Abilitazione automatica dei vettori di eliminazione e impostarlo su Disabilitato.

3. Salvare le modifiche e riavviare la computazione in esecuzione.

ALTER TABLE table_name 
SET TBLPROPERTIES ('delta.enableDeletionVectors' = FALSE);

In questo scenario, per tutte le nuove tabelle create dopo questa modifica i vettori di eliminazione non saranno abilitati per impostazione predefinita. Tuttavia, le tabelle esistenti che già utilizzano i vettori di eliminazione richiederebbero gli scenari spiegati in precedenza.

Verifica se i vettori di eliminazione sono abilitati nei data mart

Per verificare se i vettori di eliminazione sono abilitati per una tabella specifica in Databricks, eseguire questo comando:

SHOW TBLPROPERTIES table_name ('delta.enableDeletionVectors');