Para conectarse a Autonomous Database, puede descargar un archivo de conexión de la instancia de Database Actions e importarlo al complemento de Google Sheet que haya configurado.

En esta sección, utilizará la interfaz de usuario web para obtener client_id y client_secret.

Para generar las claves de cliente, acceda a la URL de instancia de Autonomous Database y agregue oauth/clients.

Por ejemplo, si la instancia es " https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/ords/<schema Name>/_sdw/", debe iniciar sesión en el enlace " https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/ords/<schema Name>/oauth/clients/". Asegúrese de incluir la barra final.

1. Conéctese a Database Actions con el enlace "https://machinename.oraclecloudapps.com/ords/SchemaName/oauth/clients/". Puede ver una página de clientes de OAuth en el enlace "https://localhost:port/ords/schemaName/_sdw/?nav=rest-workshop&rest-workshop=oauth-clients".
2. Haga clic en el botón +Create OAuth Client para crear un nuevo cliente.
   
   Descripción de la ilustración create-client.png
   
3. En la lista desplegable Otorgar tipo, seleccione el tipo de conexión de cliente que desee. Puede seleccionar las opciones siguientes:
   • AUTH_CODE: seleccione esta opción de conexión implícita. Utilice este tipo de respuesta cuando la base de datos autónoma esté en una subred privada o dentro de un firewall del cliente.
   • IMPLICIT: seleccione esta opción de conexión explícita. Se trata del método más seguro y se prefiere utilizarlo si la base de datos autónoma tiene acceso público.
4. Introduzca los siguientes campos. Los campos con un asterisco (*) son obligatorios:
   • Nombre: nombre del cliente.
   • Descripción: descripción de la finalidad del cliente.
   • URI de redirección: URL de despliegue de aplicación web que ha copiado del paso 10 de Despliegue de Google Script como aplicación web
   • URI de soporte: introduzca el URI en el que los usuarios finales pueden ponerse en contacto con el cliente para obtener soporte. Ejemplo: https://script.google.com/
   • Correo electrónico de soporte: introduzca el correo electrónico en el que los usuarios finales pueden ponerse en contacto con el cliente para obtener soporte.
   • Logotipo: si lo desea, seleccione una imagen del sistema local para insertar un logotipo para el nuevo cliente.
   Vaya al separador Roles para seleccionar los roles del cliente. Este no es un campo obligatorio.
5. Progreso al separador Orígenes permitidos. Especifique y agregue la lista de prefijos de URL en el campo de texto. Este no es un campo obligatorio.
6. Progreso al separador Privilegios para agregar cualquier privilegio. No es necesario que tenga privilegios para crear un cliente OAuth.
7. Haga clic en Crear para crear el nuevo cliente OAuth. Esto registra el cliente OAuth que puede ver en la página Clientes OAuth.
   
   Descripción de la ilustración new-client.png
   
8. Haga clic en el icono Mostrar para ver los campos Client ID y Client Secret.

¿Cómo me conecto manualmente?

En las siguientes secciones se muestra cómo conectarse mediante conexiones implícitas y explícitas. Las hojas de Google necesitan permiso para acceder a Autonomous Database. Primero debe completar la autorización para conectarse a la base de datos autónoma. El complemento requiere una autenticación única para la configuración.

1. En la hoja de Google, haga clic en Oracle Autonomous Database y seleccione Conexiones.
   La selección de Conexiones requiere autenticación única de Google.

   • Al hacer clic en Conexiones, se abre una ventana emergente que le solicita permiso para ejecutar la autorización. Haga clic en Continuar.
     
     Descripción de la ilustración auth-continue.png
     
   • Ahora verá una ventana que le informa de que la aplicación solicita acceso a información confidencial en su cuenta de Google.
   • Haga clic en Avanzado y seleccione el enlace Ir al proyecto sin título (no seguro). Al seleccionar el enlace se abre una nueva ventana, lo que garantiza la confianza de la aplicación. Haga clic en Permitir para continuar. Ahora ha completado la configuración.
2. En el asistente Conexiones, haga clic en Agregar conexión en el menú desplegable Gestionar conexiones para agregar una conexión.
   
   Descripción de la ilustración add-connection.png
   
3. Al seleccionar Agregar conexión, se abre un asistente Agregar conexión en el panel de la lista de conexiones del asistente Conexiones.
   
   Descripción de la ilustración add-connection-fields.png
   

4. Especifique los siguientes valores de campo en el asistente:

   Nombre de conexión: introduzca el nombre de la conexión, por ejemplo, TestConnection.

   URL de Autonomous Database: introduzca la URL de la instancia de Autonomous Database a la que desea conectarse. Por ejemplo, "https://<nombre_host>-<nombre_databas>.adb.<region>.oraclecloudapps.com/"

   En el campo Tipo de permiso de cliente OAuth, seleccione una de las dos opciones según el tipo de conexiones que desee. Consulte la sección Generate Client ID and Client Secret using the UI (Generar ID de cliente y secreto de cliente mediante la IU).

   Esta opción varía con las conexiones implícitas y explícitas.

   Implícito: seleccione esta opción en la conexión implícita. Utilice este tipo de respuesta cuando la base de datos autónoma esté en una subred privada o dentro de un firewall del cliente.

   AUTH_CODE: seleccione esta opción de conexión explícita. Este es el método más seguro y se prefiere utilizar.

   Al seleccionar la opción Implícito, puede ver los siguientes campos:
   
   Descripción de la ilustración implicit.png
   

   OAuth ID de cliente: client_id se genera mediante el asistente Crear nuevo cliente en la interfaz de usuario. Consulte la sección Generate Client ID and Client Secret using the UI (Generar ID de cliente y secreto de cliente mediante la IU).

   Nombre de esquema: especifique el nombre del esquema.

   Al seleccionar AUTH_CODE, puede ver los siguientes campos:

   
   
   Descripción de la ilustración explicit.png
   

   OAuth ID de cliente: client_id se genera mediante el asistente Crear nuevo cliente en la interfaz de usuario. Consulte la sección Generar ID de cliente y secreto de cliente mediante la interfaz de usuario.

   OAuth Secreto de cliente: client_secret se genera mediante el asistente Crear nuevo cliente en la interfaz de usuario. Consulte la sección Generar ID de cliente y secreto de cliente mediante la interfaz de usuario.

   Nombre de esquema: especifique el nombre del esquema.

   Haga clic en Guardar.

   Después de hacer clic en Guardar, puede ver la nueva conexión en el panel de lista de conexiones. La lista de conexiones muestra el nombre de la conexión, el nombre del esquema y el tipo OAuth que otorga. Sin embargo, todavía está en un estado desconectado.

5. Haga clic en los tres puntos verticales junto al nombre de la conexión y realice las siguientes operaciones:

   Conectar: seleccione Conectar a Autonomous Database y cambie el estado de conexión a Activo. Al seleccionar Conectar, se abre la página de conexión de la base de datos autónoma. Después de conectarse, verá una página que muestra que se le ha otorgado acceso a la base de datos. Cierre la ventana y vuelva a Google Sheets. Ahora verá que la conexión está activa.

   Editar: seleccione Editar para actualizar cualquier valor de la conexión. Haga clic en Guardar para actualizar los valores editados.

   Duplicar: seleccione Duplicar para crear una conexión duplicada.

   Eliminar: seleccione Eliminar para eliminar la conexión de la lista de conexiones.

Exportación de conexiones

1. Haga clic en Exportar conexión en el menú desplegable Gestionar conexiones para exportar la conexión seleccionada.
2. Seleccione la conexión que desea exportar y haga clic en Exportar.
   
   Descripción de la ilustración export.png
   
3. Haga clic en Exportar.

4. Las descargas de conexión exportadas en el sistema local. El archivo de conexión se guarda como spreadsheet_addin_connections.json.

Después de determinar su identidad mediante la autenticación OAuth, Google Sheets necesita permiso para acceder a la instancia de Autonomous Database.

Los valores client_id y client_secret que genera durante la autenticación OAuth se utilizan para la autorización.

1. Haga clic en el menú Oracle Autonomous Database de la hoja de Google en la que está trabajando y seleccione Registrarse. Esto requiere una única autenticación de Google.
2. Al hacer clic en Registrar, se abre una ventana emergente que le pide permiso para ejecutar la autorización. Haga clic en Continuar. Si selecciona Continuar, se le redirigirá a la página de cuentas de Google, donde deberá seleccionar su cuenta de Gmail.
3. Ahora verá una ventana que le informa de que la aplicación solicita acceso a información confidencial en su cuenta de Google. Haga clic en Avanzado y seleccione el enlace Ir a proyecto sin título (no seguro).
4. Al seleccionar el enlace se abre una nueva ventana, lo que garantiza la confianza de la aplicación. Haga clic en Permitir para continuar.
5. Ahora ha completado la configuración. Seleccione Registrarse en el menú de Oracle Autonomous Database de la hoja de Google.
   Esto abre un asistente de Oracle Autonomous Database en la hoja de Google. Especifique los siguientes campos:

   • URL de ADB: introduzca la URL de ADB. Por ejemplo, "https://<nombre_host>-<nombre_databas>.adb.<region>.oraclecloudapps.com/ords/<Nombre de esquema>".
   • OAuth ID de cliente: client_id que genera durante la autenticación.
   • Secreto de cliente OAuth: client_secret que se genera durante la autenticación. Consulte la sección Crear conexiones con la hoja de cálculo de Google para obtener más información.
   
   
   Descripción de la ilustración adb-google-wizard.png
   
6. Seleccione Autorizar.

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.