Para estabelecer conexão com o Autonomous Database, você pode fazer download de um arquivo de conexão da instância do Database Actions e importá-lo para o complemento do Google Sheet configurado.

Nesta seção, você usa a IU da Web para obter client_id e client_secret.

Você gera as chaves do cliente acessando o URL da instância do Autonomous Database anexado com oauth/clients.

Por exemplo, se sua instância for " https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/ords/<schema Name>/_sdw/", você precisará acessar o link " https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/ords/<schema Name>/oauth/clients/". Certifique-se de incluir a barra final.

1. Acesse o Database Actions com o link "https://machinename.oraclecloudapps.com/ords/SchemaName/oauth/clients/". Você pode exibir uma página Clientes OAuth no link "https://localhost:port/ords/schemaName/_sdw/?nav=rest-workshop&rest-workshop=oauth-clients".
2. Clique no botão +Create OAuth Client para criar um novo cliente.
   
   Descrição da ilustração create-client.png
   
3. No menu suspenso Tipo de concessão, selecione o tipo de conexão do cliente desejado. Você pode selecionar as seguintes opções:
   • AUTH_CODE: Selecione esta opção para conexão implícita. Use esse tipo de resposta quando o banco de dados autônomo estiver em uma sub-rede privada ou dentro de um firewall do cliente.
   • IMPLICIT: Selecione esta opção para conexão explícita. Este é o método mais seguro e é preferível usar se o Autonomous database tiver acesso público.
4. Insira os seguintes campos. Os campos com um asterisco (*) são obrigatórios:
   • Nome: Nome do cliente.
   • Descrição: Descrição da finalidade do cliente.
   • URI de Redirecionamento: URL de implantação do aplicativo Web que você copiou da etapa 10 de Implantar o Script do Google como um aplicativo Web
   • URI de Suporte: Informe o URI no qual os usuários finais podem entrar em contato com o cliente para obter suporte. Exemplo: https://script.google.com/
   • E-mail de Suporte: Informe o e-mail no qual os usuários finais podem entrar em contato com o cliente para obter suporte.
   • Logotipo: Opcionalmente, selecione uma imagem do seu sistema local para inserir um logotipo para seu novo cliente.
   Navegue até a guia Atribuições para selecionar as atribuições do cliente. Este campo não é obrigatório.
5. Avance para a guia Origens Permitidas. Especifique e adicione a lista de prefixos de URL no campo de texto. Este campo não é obrigatório.
6. Avance para a guia Privilégios para adicionar qualquer privilégio. Você não precisa ter privilégios para criar um Cliente OAuth.
7. Clique em Criar para criar o novo Cliente OAuth. Isso registra o Cliente OAuth que você pode exibir na página Clientes OAuth.
   
   Descrição da ilustração new-client.png
   
8. Clique no ícone mostrar para exibir os campos Client ID e Client Secret.

Como estabeleço conexão manualmente?

As seções a seguir demonstram como conectar usando conexões implícitas e explícitas. O Google Sheets precisa de permissão para acessar o Autonomous Database. Primeiro você deve concluir a autorização para estabelecer conexão com o banco de dados autônomo. A extensão requer autenticação única para configuração.

1. Na Planilha do Google, clique em Oracle Autonomous Database e selecione Conexões.
   A seleção de Conexões requer autenticação única do Google.

   • Clicar em Conexões abre uma janela pop-up que solicita sua permissão para executar a autorização. Clique em Continuar.
     
     Descrição da ilustração auth-continue.png
     
   • Agora você verá uma janela que informa que o aplicativo solicita acesso a informações confidenciais em sua conta do Google.
   • Clique em Avançado e selecione o link Ir para Projeto sem título (inseguro). Selecionar o link abre uma nova janela, garantindo que você confia no aplicativo. Clique em Permitir para continuar. Você concluiu a configuração.
2. No assistente de Conexões, clique em Adicionar Conexão no menu drop-down Gerenciar Conexões para adicionar uma conexão.
   
   Descrição da ilustração add-connection.png
   
3. A seleção de Adicionar Conexão abre um assistente Adicionar Conexão no painel da lista de conexões do assistente de Conexões.
   
   Descrição da ilustração add-connection-fields.png
   

4. Especifique os seguintes valores de campo no assistente:

   Nome da Conexão: Informe o nome da conexão, por exemplo, TestConnection.

   URL do Autonomous Database: Informe o URL do Autonomous Database ao qual você deseja se conectar. Por exemplo, "https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/"

   No campo OAuth Tipo de Concessão do Cliente, selecione uma das duas opções com base no tipo de conexões desejado. Consulte a seção Gerar ID do Cliente e Segredo do Cliente usando a UI.

   Essa opção varia com conexões implícitas e explícitas.

   Implícito: Selecione esta opção para conexão implícita. Use esse tipo de resposta quando o banco de dados autônomo estiver em uma sub-rede privada ou dentro de um firewall do cliente.

   AUTH_CODE: Selecione esta opção para conexão explícita. Este é o método mais seguro e é preferível usar.

   Ao selecionar a opção Implícito, você pode exibir os seguintes campos:
   
   Descrição da ilustração implicit.png
   

   OAuth ID do Cliente: client_id você gera usando o assistente Criar Novo Cliente na IU. Consulte a seção Gerar ID do Cliente e Segredo do Cliente usando a UI.

   Nome do Esquema: Especifique o nome do esquema.

   Ao selecionar AUTH_CODE, você pode exibir os seguintes campos:

   
   
   Descrição da ilustração explicit.png
   

   OAuth ID do Cliente: client_id você gera usando o assistente Criar Novo Cliente na IU. Consulte a seção Gerar ID do Cliente e Segredo do Cliente usando a UI.

   OAuth Segredo do Cliente: client_secret você gera usando o assistente Criar Novo Cliente na IU. Consulte a seção Gerar ID e Segredo do Cliente usando a UI.

   Nome do Esquema: Especifique o nome do esquema.

   Clique em Salvar.

   Depois de clicar em Salvar, você poderá exibir a nova conexão no painel da lista de conexões. A lista de conexões exibe o nome da conexão, o nome do esquema e o tipo OAuth que você concede. No entanto, ainda está em um estado desconectado.

5. Clique nos três pontos verticais ao lado do nome da conexão e execute as seguintes operações:

   Conectar: Selecione Conectar ao Autonomous Database e altere o status da conexão para ativo. A seleção de Conectar abre a página de acesso do Autonomous database. Depois de fazer log-in, você exibirá uma página que mostra que o acesso ao banco de dados foi concedido a você. Feche a janela e retorne ao Google Sheets. Agora você verá que a conexão está ativa.

   Editar: Selecione Editar para atualizar qualquer valor da conexão. Clique em Salvar para atualizar os valores editados.

   Duplicar: Selecione Duplicar para criar uma conexão duplicada.

   Remover: Selecione Remover para remover a conexão da lista de conexões.

Exportando Conexões

1. Clique em Exportar Conexão no menu drop-down Gerenciar Conexões para exportar a conexão selecionada.
2. Selecione a conexão que você deseja exportar e clique em Exportar.
   
   Descrição da ilustração export.png
   
3. Clique em Exportar.

4. A conexão exportada é baixada no sistema local. O arquivo de conexão é salvo como spreadsheet_addin_connections.json.

Depois que sua identidade for determinada usando a autenticação OAuth, o Google Sheets precisará de permissão para acessar o Autonomous Database.

Os valores client_id e client_secret gerados durante a autenticação OAuth são usados para autorização.

1. Clique no menu Oracle Autonomous Database na Planilha do Google em que você está trabalhando e selecione Inscrever-se. Isso requer autenticação única do Google.
2. Clicar em Registrar abre uma janela pop-up que solicita sua permissão para executar a autorização. Clique em Continuar. Ao selecionar Continuar, você será redirecionado para a página Contas do Google, onde deverá selecionar sua conta do Gmail.
3. Agora você verá uma janela que informa que o aplicativo solicita acesso a informações confidenciais em sua conta do Google. Clique em Avançado e selecione o link Ir para projeto sem título (inseguro).
4. Selecionar o link abre uma nova janela, garantindo que você confia no aplicativo. Clique em Permitir para continuar.
5. Você concluiu a configuração. Selecione Registrar no menu do Oracle Autonomous Database na planilha do Google.
   Isso abre um assistente do Oracle Autonomous Database na planilha do Google. Especifique os seguintes campos:

   • URL do ADB: Informe o URL do ADB. Por exemplo, "https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/ords/<Schema Name>".
   • OAuth ID do Cliente: client_id gerado durante a autenticação.
   • OAuth Segredo do Cliente: client_secret gerado durante a autenticação. Para obter mais detalhes, consulte a seção Criar Conexões com a planilha do Google.
   
   
   Descrição da ilustração adb-google-wizard.png
   
6. Selecione 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.