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

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 aggiunto con oauth/clients.

Ad esempio, se l'istanza è " https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/ords/<schema Name>/_sdw/", è necessario collegarsi al collegamento " https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/ords/<schema Name>/oauth/clients/". Includere la barra finale.

1. Accedere a Database Actions con il collegamento "https://machinename.oraclecloudapps.com/ords/SchemaName/oauth/clients/". È possibile visualizzare una pagina Client di OAuth nel collegamento "https://localhost:port/ords/schemaName/_sdw/?nav=rest-workshop&rest-workshop=oauth-clients".
2. Fare clic sul pulsante +Create OAuth Client per creare un nuovo client.
   
   Descrizione della figura create-client.png
   
3. Dall'elenco a discesa Tipo di privilegio, selezionare il tipo di connessione client desiderato. È possibile selezionare le opzioni riportate di seguito:
   • AUTH_CODE: selezionare questa opzione per la connessione implicita. Utilizzare questo tipo di risposta quando il database autonomo si trova in una subnet privata o all'interno di un firewall del cliente.
   • IMPLICITO: selezionare questa opzione per una connessione esplicita. Questo è il metodo più sicuro ed è preferibile utilizzarlo se Autonomous Database dispone dell'accesso pubblico.
4. Immettere i campi riportati di seguito. I campi con l'asterisco (*) sono obbligatori:
   • Nome: nome del client.
   • Descrizione: descrizione dello scopo del client.
   • URI di reindirizzamento: l'URL di distribuzione dell'applicazione Web copiato dal passo 10 di Distribuisci lo script Google come applicazione Web
   • URI di 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 l'e-mail in cui gli utenti finali possono contattare il client per ricevere assistenza.
   • Logo: è possibile selezionare un'immagine dal sistema locale per inserire un logo per il nuovo client.
   Passare alla scheda Ruoli per selezionare i ruoli del client. Questo campo non è obbligatorio.
5. Andare alla scheda Origini consentite. Specificare e aggiungere la lista di prefissi URL nel campo di testo. Questo campo non è obbligatorio.
6. Per aggiungere qualsiasi privilegio, passare alla scheda Privilegi. Non è necessario disporre di privilegi per creare un client OAuth.
7. Fare clic su Crea per creare il nuovo client OAuth. In questo modo viene registrato il client OAuth che è possibile visualizzare nella pagina Client OAuth.
   
   Descrizione della figura new-client.png
   
8. Fare clic sull'icona Mostra per visualizzare i campi Client ID e Client Secret.

Come faccio a connettermi manualmente?

Le sezioni seguenti illustrano come connettersi utilizzando connessioni implicite ed esplicite. I fogli Google hanno bisogno dell'autorizzazione per accedere ad Autonomous Database. È innanzitutto necessario completare l'autorizzazione per connettersi al database autonomo. Il componente aggiuntivo richiede l'autenticazione una tantum per l'impostazione.

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

   • Se si fa clic su Connessioni, viene visualizzata una finestra popup in cui viene richiesta l'autorizzazione per eseguire l'autorizzazione. Fare clic su Continua.
     
     Descrizione dell'immagine auth-continue.png
     
   • Ora vedrai una finestra che ti informa che l'applicazione richiede l'accesso a informazioni sensibili nel tuo account Google.
   • Fare clic su Avanzate e selezionare il collegamento Vai a progetto senza titolo (non sicuro). Se si seleziona il collegamento, viene aperta una nuova finestra che garantisce l'affidabilità dell'applicazione. Fare clic su Consenti per continuare. L'impostazione è stata completata.
2. Nella procedura guidata Connessioni, fare clic su Aggiungi connessione dal 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 con l'elenco delle 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 Autonomous Database: immettere l'URL dell'Autonomous Database a cui si desidera connettersi. Ad esempio, "https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/"

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

   Questa opzione varia con connessioni implicite ed esplicite.

   Implicito: selezionare questa opzione per la connessione implicita. Utilizzare 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 la connessione esplicita. Questo è il metodo più sicuro ed è preferito da usare.

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

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

   Nome dello 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 generato mediante la procedura guidata Crea nuovo client nell'interfaccia utente. Fare riferimento alla sezione Genera ID client e segreto client mediante l'interfaccia utente.

   OAuth Segreto client: client_secret generato mediante la procedura guidata Crea nuovo client nell'interfaccia utente. Consultare la sezione Generate Client ID and Client Secret using the UI.

   Nome dello schema: specificare il nome dello schema.

   Fare clic suSalva.

   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 in Attivo. Se si seleziona Connetti, viene visualizzata la pagina di collegamento di Autonomous Database. Dopo aver eseguito il login, verrà visualizzata una pagina che mostra che l'accesso al database è stato concesso all'utente. Chiudi la finestra e torna a Google Sheets. Ora vedrai che la connessione è attiva.

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

   Duplica: selezionare Duplica per creare una connessione duplicata.

   Rimuovi: selezionare Rimuovi per rimuovere la connessione dalla lista di 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 della figura 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 aver determinato l'identità utilizzando l'autenticazione OAuth, i fogli Google devono 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. Questo richiede l'autenticazione una tantum di Google.
2. Fare clic su Registra per aprire una finestra popup che richiede l'autorizzazione per eseguire l'autorizzazione. Fare clic su Continua. Selezionando Continua verrai reindirizzato alla pagina Account Google, dove dovrai selezionare il tuo account Gmail.
3. Ora vedrai una finestra che ti informa che l'applicazione richiede l'accesso a informazioni sensibili nel tuo account Google. Fare clic su Avanzate e selezionare il collegamento Vai a progetto senza titolo (non sicuro).
4. Se si seleziona il collegamento, viene aperta una nuova finestra che garantisce l'affidabilità dell'applicazione. Per continuare, fare clic su Consenti.
5. L'impostazione è stata completata. Selezionare Registrati dal menu Oracle Autonomous Database nel foglio di Google.
   Viene aperta una procedura guidata Oracle Autonomous Database nel foglio Google. Specificare i campi riportati di seguito.

   • URL ADB: immettere l'URL ADB. Ad esempio, "https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/ords/<Schema Name>".
   • 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'immagine 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.