Fogli Oracle Autonomous Database per Google

Per connettersi ad Autonomous Database, è possibile scaricare un file di connessione dall'istanza Database Actions e importarlo nel componente aggiuntivo Google Sheet configurato.

In questa sezione si utilizza l'interfaccia utente Web per ottenere client_id e client_secret .

Per generare le chiavi client, accedere all'URL dell'istanza di Autonomous Database che si aggiunge con oauth/client.

Ad esempio, se l'istanza è "https://<nomehost>-<nomebas>.adb.<regione>.oraclecloudapps.com/ords/<nome schema>/_sdw/", è necessario accedere al collegamento "https://<nomehost>-<nomebase>.adb.<regione>.oraclecloudapps.com/ords/<nome schema>/oauth/clients/". Accertarsi di includere la barra finale.

1. Accedere a Database Actions utilizzando il collegamento "https://machinename.oraclecloudapps.com/ords/SchemaName/oauth/clients/". È possibile visualizzare una pagina client OAuth nel collegamento "https://localhost:port/ords/schemaName/_sdw/?nav=rest-workshop&rest-workshop=oauth-clients".
2. Fare clic sul pulsante +Create Client OAuth per creare un nuovo client.
   
   Descrizione dell'immagine create-client.png
   
3. Dall'elenco a discesa Tipo di privilegio, selezionare il tipo di connessione client desiderata. È possibile selezionare le opzioni riportate di seguito:
   • AUTH_CODE: selezionare questa opzione per la connessione implicita. Utilizza questo tipo di risposta quando il database autonomo si trova in una subnet privata o all'interno di un firewall del cliente.
   • IMPLICIT: selezionare questa opzione per una connessione esplicita. Si tratta del metodo più sicuro da utilizzare se Autonomous database dispone di accesso pubblico.
4. Immettere i campi seguenti. I campi contrassegnati con un asterisco (*) sono obbligatori:
   • Nome: il nome del client.
   • Descrizione: descrizione dello scopo del client.
   • URI reindirizzamento: URL di distribuzione dell'applicazione Web copiato dal passo 10 di Distribuire lo script Google come applicazione Web
   • URI supporto: immettere l'URI in cui gli utenti finali possono contattare il client per il supporto. Esempio: https://script.google.com/
   • E-mail di supporto: immettere il messaggio di posta elettronica in cui gli utenti finali possono contattare il client per il supporto.
   • Logo: facoltativamente, selezionare un'immagine dal sistema locale per inserire un logo per il nuovo client.
   Andare alla scheda Ruoli per selezionare i ruoli del client. Questo campo non è obbligatorio.
5. Avanzamento alla scheda Origini consentite. Specificare e aggiungere la lista di prefissi URL nel campo di testo. Questo campo non è obbligatorio.
6. Avanzamento alla scheda Privilegi per aggiungere qualsiasi privilegio. Non è necessario disporre di privilegi per creare un client OAuth.
7. Fare clic su Crea per creare il nuovo client OAuth. Registra il client OAuth che è possibile visualizzare nella pagina Client OAuth.
   
   Descrizione dell'illustrazione new-client.png
   
8. Fare clic sull'icona Mostra per visualizzare i campi Client ID e Client Secret.

Come posso connettermi manualmente?

Nelle sezioni seguenti viene illustrato come connettersi utilizzando connessioni implicite ed esplicite. I fogli Google devono disporre dell'autorizzazione per accedere ad Autonomous Database. È innanzitutto necessario completare l'autorizzazione per connettersi all'Autonomous Database. Il componente aggiuntivo richiede l'autenticazione una tantum per la configurazione.

1. Nel foglio Google, fare clic su Oracle Autonomous Database e selezionare Connessioni.
   La selezione delle connessioni richiede l'autenticazione una tantum di Google.

   • Se si fa clic su Connessioni, viene visualizzata una finestra popup che richiede l'autorizzazione per l'esecuzione dell'autorizzazione. Fare clic su Continua.
     
     Descrizione dell'immagine auth-continue.png
     
   • Ora vedrai una finestra che ti informa che l'applicazione richiede l'accesso alle informazioni sensibili nel tuo account Google.
   • Fare clic su Avanzate e selezionare il collegamento Vai a progetto senza titolo (non sicuro). Selezionando il collegamento si apre una nuova finestra, assicurandosi che l'applicazione sia affidabile. Fare clic su Consenti per continuare. L'impostazione è stata completata.
2. Nella procedura guidata Connessioni, fare clic su Aggiungi connessione nel menu a discesa Gestisci connessioni per aggiungere una connessione.
   
   Descrizione dell'immagine add-connection.png
   
3. Se si seleziona Aggiungi connessione, viene aperta una procedura guidata Aggiungi connessione nel pannello dell'elenco di connessioni della procedura guidata Connessioni.
   
   Descrizione dell'immagine add-connection-fields.png
   

4. Specificare i valori di campo riportati di seguito nella procedura guidata.

   Nome connessione: immettere il nome della connessione, ad esempio TestConnection.

   URL di Autonomous Database: immettere l'URL dell'Autonomous Database a cui si desidera connettersi. Ad esempio, "https://<nomehost>-<nomebase>.adb.<regione>.oraclecloudapps.com/"

   Nel campo Tipo di concessione client OAuth, selezionare una delle due opzioni in base al tipo di connessioni desiderato. Fare riferimento alla sezione Genera ID client e segreto client utilizzando l'interfaccia utente.

   Questa opzione varia con connessioni implicite ed esplicite.

   Implicito: selezionare questa opzione per la connessione implicita. Utilizza questo tipo di risposta quando il database autonomo si trova in una subnet privata o all'interno di un firewall del cliente.

   AUTH_CODE: selezionare questa opzione per una connessione esplicita. Questo è il metodo più sicuro ed è preferito da usare.

   Quando si seleziona l'opzione Implicito, è possibile visualizzare i seguenti campi:
   
   Descrizione dell'illustrazione implicit.png
   

   OAuth ID client: client_id viene generato utilizzando la procedura guidata Crea nuovo client nell'interfaccia utente. Fare riferimento alla sezione Genera ID client e segreto client utilizzando l'interfaccia utente.

   Nome schema: specificare il nome dello schema.

   Quando si seleziona AUTH_CODE, è possibile visualizzare i campi riportati di seguito.

   
   
   Descrizione dell'immagine explicit.png
   

   OAuth ID client: client_id viene generato utilizzando la procedura guidata Crea nuovo client nell'interfaccia utente. Fare riferimento alla sezione Genera ID client e segreto client utilizzando l'interfaccia utente.

   OAuth Segreto client: client_secret viene generato utilizzando la procedura guidata Crea nuovo client nell'interfaccia utente. Fare riferimento alla sezione Genera ID client e segreto client utilizzando l'interfaccia utente.

   Nome schema: specificare il nome dello schema.

   Fare clic su Salva.

   Dopo aver fatto clic su Salva, è possibile visualizzare la nuova connessione nel pannello dell'elenco delle connessioni. La lista di connessioni visualizza il nome della connessione, il nome dello schema e il tipo OAuth concesso. Tuttavia, è ancora in uno stato disconnesso.

5. Fare clic sui tre punti verticali accanto al nome della connessione ed eseguire le operazioni riportate di seguito.

   Connetti: selezionare Connetti ad Autonomous Database e modificare lo stato della connessione impostandolo su Attivo. Se si seleziona Connetti, viene visualizzata la pagina di connessione di Autonomous Database. Dopo aver eseguito il login, verrà visualizzata una pagina che mostra che l'accesso al database è stato concesso all'utente. Chiudere la finestra e tornare a Fogli Google. Ora vedrai che la connessione è attiva.

   Modifica: selezionare Modifica per aggiornare qualsiasi valore della connessione. Per aggiornare i valori modificati, fare clic su Salva.

   Duplica: selezionare Duplica per creare una connessione duplicata.

   Rimuovi: selezionare Rimuovi per rimuovere la connessione dall'elenco delle connessioni.

Esportazione delle connessioni

1. Fare clic su Esporta connessione nel menu a discesa Gestisci connessioni per esportare la connessione selezionata.
2. Selezionare la connessione che si desidera esportare e fare clic su Esporta.
   
   Descrizione dell'immagine export.png
   
3. Fare clic su Esporta.

4. La connessione esportata viene scaricata nel sistema locale. Il file di connessione viene salvato come spreadsheet_addin_connections.json.

Dopo che la tua identità è stata determinata utilizzando l'autenticazione OAuth, Google Sheets deve disporre dell'autorizzazione per accedere ad Autonomous Database.

I valori client_id e client_secret generati durante l'autenticazione OAuth vengono utilizzati per l'autorizzazione.

1. Fare clic sul menu Oracle Autonomous Database nel foglio Google su cui si sta lavorando e selezionare Registrati. Ciò richiede l'autenticazione unica di Google.
2. Facendo clic su Registra viene visualizzata una finestra popup che richiede l'autorizzazione per l'esecuzione dell'autorizzazione. Fare clic su Continua. Selezionando Continua si verrà reindirizzati alla pagina Account Google, in cui è necessario selezionare l'account Gmail.
3. Ora vedrai una finestra che ti informa che l'applicazione richiede l'accesso alle informazioni sensibili nel tuo account Google. Fare clic su Avanzate e selezionare il collegamento Vai a progetto senza titolo (non sicuro).
4. Selezionando il collegamento viene visualizzata una nuova finestra, che garantisce la sicurezza dell'applicazione. Fare clic su Consenti per continuare.
5. L'impostazione è stata completata. Selezionare Registrati dal menu di Oracle Autonomous Database nel foglio di Google.
   Viene visualizzata una procedura guidata Oracle Autonomous Database nel foglio di Google. Specificare i campi riportati di seguito.

   • URL ADB: immettere l'URL ADB. Ad esempio, "https://<nomehost>-<nomebase>.adb.<regione>.oraclecloudapps.com/ordini/<nome schema>".
   • OAuth ID client: client_id generato durante l'autenticazione.
   • OAuth Segreto client: client_secret generato durante l'autenticazione. Per ulteriori dettagli, fare riferimento alla sezione Crea connessioni con il foglio di calcolo di Google.
   
   
   Descrizione dell'illustrazione adb-google-wizard.png
   
6. Selezionare Autorizza.

After successfully authorizing the credentials, you can view Connections, Direct SQL, Data Analysis, Analyses and Reports Clear Sheet, Delete All Sheets, About Autonomous Database, and Sign Out menu items under Oracle Autonomous Database.