Pour vous connecter à Autonomous Database, vous pouvez télécharger un fichier de connexion à partir de l'instance Database Actions et l'importer dans le module d'extension Google Sheet que vous avez configuré.

Dans cette section, vous allez utiliser l'interface utilisateur Web pour obtenir client_id et client_secret.

Vous générez les clés client en accédant à l'URL d'instance Autonomous Database à laquelle vous ajoutez oauth/clients.

Par exemple, si votre instance est " https ://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/ords/<schema Name>/_sdw/", vous devez vous connecter au lien " https ://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/ords/<schema Name>/oauth/clients/". Veillez à inclure la barre oblique de fin.

1. Connectez-vous à Database Actions avec le lien "https://machinename.oraclecloudapps.com/ords/SchemaName/oauth/clients/". Vous pouvez afficher une page Clients OAuth dans le lien "https ://localhost:port/ords/schemaName/_sdw/ ?nav=rest-workshop&rest-workshop=oauth-clients".
2. Cliquez sur le bouton +Create OAuth Client pour créer un client.
   
   Description de l'illustration create-client.png
   
3. Dans la liste déroulante Type d'octroi, sélectionnez le type de connexion client souhaité. Vous pouvez sélectionner les options suivantes 
   • AUTH_CODE : sélectionnez cette option pour la connexion implicite. Utilisez ce type de réponse lorsque la base de données autonome se trouve dans un sous-réseau privé ou dans un pare-feu client.
   • IMPLICIT : sélectionnez cette option pour une connexion explicite. Il s'agit de la méthode la plus sécurisée et est préférable d'utiliser si la base de données autonome dispose d'un accès public.
4. Entrez les informations suivantes . Les champs avec un astérisque (*) sont obligatoires :
   • Nom : nom du client.
   • Description : description de l'objectif du client.
   • URI de redirection : URL de déploiement d'application Web que vous avez copiée à l'étape 10 de Déploiement du script Google en tant qu'application Web
   • URI de support : entrez l'URI où les utilisateurs finaux peuvent contacter le client pour obtenir de l'aide. Exemple : https://script.google.com/
   • Courriel du support technique : entrez le courriel dans lequel les utilisateurs finaux peuvent contacter le client pour obtenir de l'aide.
   • Logo : sélectionnez éventuellement une image à partir du système local afin d'insérer un logo pour le nouveau client.
   Accédez à l'onglet Rôles pour sélectionner les rôles du client. Ce champ n'est pas obligatoire.
5. Avancement de l'onglet Origines autorisées. Indiquez et ajoutez la liste des préfixes d'URL dans le champ de texte. Ce champ n'est pas obligatoire.
6. Passez à l'onglet Privilèges pour ajouter n'importe quel privilège. Vous n'avez pas besoin de disposer de privilèges pour créer un client OAuth.
7. Cliquez sur Créer pour créer le client OAuth. Enregistre le client OAuth que vous pouvez visualiser sur la page Clients OAuth.
   
   Description de l'illustration new-client.png
   
8. Cliquez sur l'icône d'affichage pour afficher les champs Client ID et Client Secret.

Comment se connecter manuellement ?

Les sections suivantes montrent comment vous connecter à l'aide de connexions implicites et explicites. Google Sheets a besoin d'une autorisation pour accéder à Autonomous Database. Vous devez d'abord terminer l'autorisation de connexion à la base de données autonome. Le module nécessite une authentification unique pour la configuration.

1. Dans la feuille Google, cliquez sur Oracle Autonomous Database et sélectionnez Connexions.
   La sélection des connexions nécessite une authentification Google unique.

   • Cliquez sur Connexions pour ouvrir une fenêtre contextuelle dans laquelle vous êtes autorisé à exécuter l'autorisation. Cliquez sur Continuer.
     
     Description de l'illustration auth-continue.png
     
   • Vous allez maintenant voir une fenêtre qui vous informe que l'application demande l'accès à des informations sensibles dans votre compte Google.
   • Cliquez sur Avancé et sélectionnez le lien Accéder au projet sans titre (non sécurisé). La sélection du lien ouvre une nouvelle fenêtre pour vous assurer que vous faites confiance à l'application. Cliquez sur Autoriser pour continuer. La configuration est maintenant terminée.
2. Dans l'assistant Connexions, cliquez sur Ajouter une connexion dans le menu déroulant Gérer les connexions pour ajouter une connexion.
   
   Description de l'illustration add-connection.png
   
3. Si vous sélectionnez Ajouter une connexion, un assistant Ajouter une connexion apparaît dans le panneau de liste des connexions de l'assistant Connexions.
   
   Description de l'illustration add-connection-fields.png
   

4. Dans l'assistant, indiquez les valeurs de champ suivantes :

   Nom de connexion : entrez le nom de la connexion, par exemple, TestConnection.

   URL d'Autonomous Database : saisissez l'URL de l'instance Autonomous Database à laquelle se connecter. Par exemple, "https ://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/"

   Dans le champ OAuth Type d'octroi client, sélectionnez l'une des deux options en fonction du type de connexion souhaité. Reportez-vous à la section Générer un ID client et une clé secrète client à l'aide de l'interface utilisateur.

   Cette option varie en fonction des connexions implicites et explicites.

   Implicite : sélectionnez cette option pour la connexion implicite. Utilisez ce type de réponse lorsque la base de données autonome se trouve dans un sous-réseau privé ou dans un pare-feu client.

   AUTH_CODE : sélectionnez cette option pour la connexion explicite. Il s'agit de la méthode la plus sécurisée et est préférable d'utiliser.

   Lorsque vous sélectionnez l'option Implicite, vous pouvez afficher les champs suivants :
   
   Description de l'illustration implicit.png
   

   OAuth ID client : client_id que vous générez à l'aide de l'assistant Créer un client de l'interface utilisateur. Reportez-vous à la section Générer un ID client et une clé secrète client à l'aide de l'interface utilisateur.

   Nom de schéma : indiquez le nom du schéma.

   Lorsque vous sélectionnez AUTH_CODE, vous pouvez afficher les champs suivants :

   
   
   Description de l'illustration explicit.png
   

   OAuth ID client : client_id que vous générez à l'aide de l'assistant Créer un client dans l'interface utilisateur. Reportez-vous à la section Générer un ID client et une clé secrète client à l'aide de l'interface utilisateur.

   OAuth Clé secrète client : client_secret que vous générez à l'aide de l'assistant Créer un client dans l'interface utilisateur. Reportez-vous à la section Générer un ID client et une clé secrète client à l'aide de l'interface utilisateur.

   Nom de schéma : indiquez le nom du schéma.

   Cliquez sur Enregistrer.

   Une fois que vous avez cliqué sur Enregistrer, vous pouvez visualiser la nouvelle connexion dans le panneau de liste des connexions. La liste des connexions affiche le nom de la connexion, le nom du schéma et le type OAuth que vous accordez. Cependant, il est toujours dans un état déconnecté.

5. Cliquez sur les trois points verticaux en regard du nom de la connexion et effectuez les opérations suivantes :

   Connexion : sélectionnez Connexion à l'instance Autonomous Database et définissez le statut de connexion sur Actif. La sélection de Connexion ouvre la page de connexion de la base de données autonome. Une fois connecté, vous visualisez une page indiquant que l'accès à la base de données vous a été accordé. Fermez la fenêtre et revenez à Google Sheets. Vous allez maintenant voir que la connexion est active.

   Modifier : sélectionnez Modifier pour mettre à jour la valeur de la connexion. Cliquez sur Enregistrer pour mettre à jour les valeurs modifiées.

   Dupliquer : sélectionnez Dupliquer pour créer une connexion en double.

   Enlever : sélectionnez Enlever pour enlever la connexion de la liste des connexions.

Export de connexions

1. Cliquez sur Exporter la connexion dans le menu déroulant Gérer les connexions pour exporter la connexion sélectionnée.
2. Sélectionnez la connexion à exporter, puis cliquez sur Exporter.
   
   Description de l'illustration export.png
   
3. Cliquez sur Exporter.

4. La connexion exportée est téléchargée dans votre système local. Le fichier de connexion est enregistré en tant que spreadsheet_addin_connections.json.

Une fois votre identité déterminée à l'aide de l'authentification OAuth, Google Sheets a besoin d'un droit d'accès à Autonomous Database.

Les valeurs client_id et client_secret que vous générez lors de l'authentification OAuth sont utilisées pour l'autorisation.

1. Cliquez sur le menu Oracle Autonomous Database dans la feuille Google sur laquelle vous travaillez et sélectionnez S'inscrire. Cela nécessite une authentification Google unique.
2. Cliquez sur Inscrire pour ouvrir une fenêtre contextuelle dans laquelle vous êtes autorisé à exécuter l'autorisation. Cliquez sur Continuer. Si vous sélectionnez Continuer, vous serez redirigé vers la page Comptes Google, où vous devez sélectionner votre compte Gmail.
3. Vous allez maintenant voir une fenêtre qui vous informe que l'application demande l'accès à des informations sensibles dans votre compte Google. Cliquez sur Advanced et sélectionnez le lien Go to Untitled project (unsafe).
4. La sélection du lien ouvre une nouvelle fenêtre pour vous assurer que vous avez confiance en l'application. Cliquez sur Autoriser pour continuer.
5. La configuration est maintenant terminée. Sélectionnez S'inscrire dans le menu Oracle Autonomous Database de la feuille Google.
   Cela ouvre un assistant Oracle Autonomous Database dans la feuille Google. Remplissez les champs suivants :

   • URL de base de données autonome : entrez l'URL de base de données autonome. Par exemple, "https ://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/ords/<Schema Name>".
   • OAuth ID client : client_id que vous générez lors de l'authentification.
   • Clé secrète client OAuth : client_secret que vous générez lors de l'authentification. Pour plus de détails, reportez-vous à la section Créer des connexions avec la feuille de calcul Google.
   
   
   Description de l'image adb-google-wizard.png
   
6. Sélectionnez Autoriser.

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.