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, utilice la interfaz de usuario web para obtener client_id y client_secret.

Puede generar las claves de cliente accediendo a la URL de instancia de Autonomous Database agregando oauth/clients.

Por ejemplo, si la instancia es " https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/ords/<schema Name>/_sdw/", debe conectarse al 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 Cliente +Create OAuth para crear un nuevo cliente.
   
   Descripción de la ilustración create-client.png
   
3. En la lista desplegable Grant type, seleccione el tipo de conexión de cliente que desea. Puede seleccionar las opciones siguientes:
   • AUTH_CODE: seleccione esta opción para 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 de cliente.
   • IMPLICITAR: seleccione esta opción para la conexión explícita. Este es el método más seguro y se prefiere utilizar 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 del script de Google 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: opcionalmente, 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. Vaya 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. Vaya 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. 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 de visualización 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. Google Sheets necesita permiso para acceder a Autonomous Database. Primero debe completar la autorización para conectarse a la base de datos autónoma. El complemento requiere autenticación puntual 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 una autenticación única de Google.

   • Al hacer clic en Conexiones, se abre una ventana emergente que 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 a proyecto sin título (no seguro). Al seleccionar el enlace se abre una nueva ventana, asegurándose de que confía en la aplicación. Haga clic en Permitir para continuar. Ha finalizado 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 de Agregar conexión en el panel de lista de conexiones del asistente de 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://<hostname>-<databasename>.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 Generar ID de cliente y secreto de cliente mediante la interfaz de usuario.

   Esta opción varía en función de las conexiones implícitas y explícitas.

   Implícito: seleccione esta opción para 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 de cliente.

   AUTH_CODE: seleccione esta opción para una 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
   

   ID de cliente OAuth: client_id se genera mediante el asistente Crear nuevo cliente de 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.

   Al seleccionar AUTH_CODE, puede ver los siguientes campos:

   
   
   Descripción de la ilustración explicit.png
   

   ID de cliente OAuth: 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.

   Secreto de cliente OAuth: 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, sigue en estado desconectado.

5. Haga clic en los tres puntos verticales junto al nombre de 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. La conexión exportada se descarga 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 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 Registrar. Esto requiere una autenticación única de Google.
2. Al hacer clic en Register, se abre una ventana emergente que solicita permiso para ejecutar la autorización. Haga clic en Continuar. Al seleccionar Continuar, se le redirigirá a la página Cuentas de Google, donde debe 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 Advanced y seleccione el enlace Go to Untitled project (unsafe).
4. Al seleccionar el enlace se abre una nueva ventana, asegurándose de que confía en la aplicación. Haga clic en Permitir para continuar.
5. Ha finalizado la configuración. Seleccione Registrar en el menú 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://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/ords/<Schema Name>".
   • ID de cliente OAuth: client_id se genera durante la autenticación.
   • Secreto de cliente OAuth: client_secret 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.