Documentação do Oracle Cloud Infrastructure

Planilhas do Oracle Autonomous Database para Google

O complemento Esta imagem descreve o complemento do Oracle Autonomous Database for Google Sheets. do Oracle Autonomous Database permite que você consulte tabelas usando Views SQL ou Analíticas usando um assistente diretamente do Google Sheets para análise.

Os dados recuperados do Autonomous Database estão disponíveis localmente nas Planilhas do Google para análise adicional. Os resultados são armazenados na cópia local e não podem ser gravados de volta no Autonomous Database. Você pode executar consultas SQL diretas ou consultar Views Analíticas e exibir seus resultados na planilha. O complemento permite filtrar os resultados da consulta e executar junções e cálculos de tabela.
Observação

O complemento do Oracle Autonomous Database para o Google Sheets deve estar em conformidade com a Política de Privacidade. Para obter informações sobre detalhes da política de privacidade, consulte Detalhes da Política de Privacidade do Oracle Autonomous Database for Google Sheets.

Como funciona o complemento do Google Sheets?

Para consultar uma View Analítica ou Tabelas no Autonomous Database, você deve selecionar uma View Analítica ou uma Tabela com a qual trabalhar. Ao recuperar dados da View Analítica, você pode configurar a consulta de acordo com seus requisitos. Você pode selecionar hierarquias específicas e criar cálculos personalizados no assistente. O complemento configura a sua consulta e retorna o resultado para as Planilhas Google. Você pode salvar os resultados de suas consultas localmente na Planilha do Google. O complemento também pode consultar o esquema diretamente ao qual você tem acesso. Usando a IU da Web, você também pode exibir relatórios e análises criados no menu Análise de Dados na ferramenta Data Studio.

Para usar o complemento, você deve ativar o Web Access na conta do Autonomous Database. Você deve ter as atribuições CONNECT, DWROLE, RESOURCE e ADPUSER concedidas na planilha SQL para acessar o complemento do Google Sheets.

Observação

  • O complemento Fazer Download do Microsoft Excel/Google Sheets só estará disponível para você no menu Downloads da sua instância do Database Actions se você tiver a atribuição ADPUSER.
  • O complemento do Oracle Autonomous Database para o Google Sheets não é suportado no web browser do Safari.

Tópico principal: A Ferramenta de Análise de Dados

Fazer Download do Arquivo de Conexão

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 Google Sheet que você configurou.

Siga as etapas mostradas abaixo para fazer download do arquivo de conexão.
  1. Navegue até o inicializador da instância do Database Actions e selecione a Placa DOWNLOAD MICROSOFT EXCEL/GOOGLE SHEETS ADD-IN. Clique no botão Fazer Download do Arquivo de Conexão na guia Planilhas do Google da página Downloads para importar o arquivo de conexão para o Google Add-in.

  2. Esse arquivo de conexão permitirá que você se conecte ao Autonomous Database com o usuário conectado. Você só pode importar esses arquivos de conexão para os Add-ins do Google que você faz download da instância atual do Autonomous Database.
    Segue a descrição da ilustração download-connection-file.png
    Descrição da ilustração download-connection-file.png

  3. A seleção do botão Fazer Download do Arquivo de Conexão abre um assistente de Download do Arquivo de Conexão. Especifique os seguintes valores de campo no assistente:
    • URL de Redirecionamento da Planilha do Google: Este é o URL de implantação de aplicativo Web copiado da etapa nove da seção Implantar o Script do Google como um aplicativo Web.
    • Escolha um Tipo de Resposta:
      • Conexão Explícita

        Você usa o ID do Cliente OAuth e os valores de Segredo do Cliente OAuth para autenticar e autorizar o Google Sheets a usar o Autonomous Database. Use essa opção quando usar CODE como o Tipo de Resposta durante o download do arquivo de conexão na página Database Actions. Este é o método mais seguro e é preferível usá-lo se o Autonomous database tiver acesso público.

      • Conexão Implícita

        Você precisará de um ID de Cliente OAuth para acessar implicitamente o Autonomous Database. Use essa opção quando usar Token como o Tipo de Resposta durante o download do arquivo de conexão na página Database Actions. Use essa opção quando o banco de dados autônomo estiver em uma sub-rede privada ou dentro de um firewall de cliente.

Gerar ID do Cliente e Segredo do Cliente usando a Interface de Usuário

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

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

Por exemplo, se a 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/". Não se esqueça de incluir a barra à direita.

  1. Acesse o Database Actions com o link "https://machinename.oraclecloudapps.com/ords/SchemaName/oauth/clients/". Você pode ver uma página de 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 criação-client.png a seguir
    Descrição da ilustração create-client.png
  3. No menu suspenso Tipo de concessão, selecione o tipo de conexão de cliente desejado. Você pode selecionar as seguintes opções:
    • AUTH_CODE: Selecione esta opção de conexão implícita. Use esse tipo de resposta quando o banco de dados autônomo estiver em uma sub-rede privada ou em um firewall de cliente.
    • IMPLICIT: Selecione esta opção na conexão explícita. Este é o método mais seguro e é preferível usá-lo 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 sistema local para inserir um logotipo para o novo cliente.
    Navegue até a guia Atribuições para selecionar as atribuições do cliente. Este campo não é obrigatório.
  5. Progresso 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. Progresso 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 New-client.png a seguir
    Descrição da ilustração new-client.png
  8. Clique no ícone mostrar para exibir os campos Client ID e Client Secret.

Como faço para conectar manualmente?

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

  1. Na Planilha do Google, clique em Oracle Autonomous Database e selecione Conexões.
    Selecionar 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 auth-continue.png a seguir
      Descrição da ilustração auth-continue.png
    • Agora você verá uma janela que informa que o aplicativo solicita acesso a informações confidenciais na sua conta do Google.
    • Clique em Avançado e selecione o link Ir para o projeto sem título (não seguro). Selecionar o link abre uma nova janela, garantindo que você confie no aplicativo. Clique em Permitir para continuar. Você concluiu a configuração.
  2. No assistente Conexões, clique em Adicionar Conexão no menu drop-down Gerenciar Conexões para adicionar uma conexão.
    Descrição da adição-connection.png a seguir
    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 adição-conexão-fields.png a seguir
    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 Tipo de Concessão do Cliente OAuth, 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 IU.

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

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

    AUTH_CODE: Selecione essa opção de 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 implicit.png a seguir
    Descrição da ilustração implicit.png

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

    Nome do Esquema: Especifique o nome do esquema.

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


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

    ID do Cliente OAuth: 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 IU.

    Segredo do Cliente OAuth: client_secret você gera usando o assistente Criar Novo Cliente na IU. Consulte a seção Generate Client ID and Client Secret using the 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ê verá 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 export.png a seguir
    Descrição da ilustração export.png
  3. Clique em Exportar.

  4. Os downloads de conexão exportados no sistema local. O arquivo de conexão é salvo como spreadsheet_addin_connections.json.

Autorizar Planilhas Google a usar o Autonomous Database

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 que você gera durante a autenticação OAuth são usados para autorização.

  1. Clique no menu Oracle Autonomous Database na Planilha do Google na qual você está trabalhando e selecione Registrar. Isso requer uma 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 na sua conta do Google. Clique em Avançado e selecione o link Ir para projeto sem título (não seguro).
  4. Selecionar o link abre uma nova janela, garantindo que você confie 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>".
    • ID do Cliente OAuth: client_id gerado durante a autenticação.
    • Segredo do Cliente OAuth: client_secret gerado durante a autenticação. Consulte a seção Criar Conexões com a planilha do Google para obter mais detalhes.

    Segue a descrição da adb-google-wizard.png
    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.