Oracle Autonomous Database für Google Sheets

Mit dem Oracle Autonomous Database-Add-on In dieser Abbildung wird das Oracle Autonomous Database for Google Sheets-Add-on beschrieben. können Sie Tabellen mit SQL- oder Analyseansichten mit einem Assistenten direkt aus Google Sheets zur Analyse abfragen.

Die aus der Autonomous Database abgerufenen Daten sind zur weiteren Analyse lokal in Google Sheets verfügbar. Die Ergebnisse werden in der lokalen Kopie gespeichert und können nicht in die Autonomous Database zurückgeschrieben werden. Sie können direkte SQL-Abfragen ausführen oder analytische Views abfragen und ihre Ergebnisse im Arbeitsblatt anzeigen. Mit dem Add-on können Sie die Abfrageergebnisse filtern und Tabellenverknüpfungen und Berechnungen ausführen.
Hinweis

Das Oracle Autonomous Database-Add-on für Google Sheets muss der Datenschutzrichtlinie entsprechen. Informationen zu Details der Datenschutzrichtlinie finden Sie unter Oracle Autonomous Database for Google Sheets - Details zur Datenschutzrichtlinie.

Wie funktioniert das Add-on für Google Sheets?

Um eine Analyse-View oder Tabellen aus Autonomous Database abzufragen, müssen Sie eine Analyse-View oder -Tabelle auswählen, mit der Sie arbeiten möchten. Beim Abrufen von Daten aus der Analyse-View können Sie die Abfrage entsprechend Ihren Anforderungen konfigurieren. Sie können bestimmte Hierarchien auswählen und benutzerdefinierte Berechnungen im Assistenten erstellen. Das Add-on konfiguriert Ihre Anfrage und gibt das Ergebnis an die Google Sheets zurück. Sie können die Ergebnisse Ihrer Abfragen lokal im Google-Blatt speichern. Das Add-on kann das Schema auch direkt abfragen, auf das Sie Zugriff haben. In der Web-UI können Sie auch Berichte und Analysen anzeigen, die Sie im Data Studio-Tool im Menü "Datenanalyse" erstellen.

Um das Add-on zu verwenden, müssen Sie Web Access für den Autonomous Database-Account aktivieren. Sie müssen die Rollen CONNECT, DWROLE, RESOURCE und ADPUSER im SQL-Arbeitsblatt haben, um auf das Google Sheets-Add-on zugreifen zu können.

Hinweis

  • Das Add-in Microsoft Excel/Google Sheets herunterladen steht Ihnen nur dann im Menü Downloads Ihrer Database Actions-Instanz zur Verfügung, wenn Sie über die Rolle ADPUSER verfügen.
  • Das Oracle Autonomous Database-Add-on für Google Sheets wird im Safari-Webbrowser nicht unterstützt.

Verbindungsdatei herunterladen

Um eine Verbindung zu Autonomous Database herzustellen, können Sie eine Verbindungsdatei aus der Database Actions-Instanz herunterladen und in das Google Sheet-Add-on importieren, das Sie eingerichtet haben.

Führen Sie die unten angegebenen Schritte aus, um die Verbindungsdatei herunterzuladen.
  1. Navigieren Sie zum Launchpad der Database Actions-Instanz, und wählen Sie die Karte MICROSOFT EXCEL/GOOGLE SHEETS ADD-IN HERUNTERLADEN. Klicken Sie auf der Seite Downloads in der Registerkarte "Google Sheets" auf die Schaltfläche Verbindungsdatei herunterladen, um die Verbindungsdatei in das Google-Add-in zu importieren.
  2. Mit dieser Verbindungsdatei können Sie eine Verbindung zu Autonomous Database mit dem angemeldeten Benutzer herstellen. Sie können nur die Verbindungsdateien in Google-Add-ins importieren, die Sie von der aktuellen Autonomous Database-Instanz herunterladen.
    Beschreibung von download-connection-file.png folgt
    Beschreibung der Abbildung download-connection-file.png

  3. Wenn Sie auf die Schaltfläche "Verbindungsdatei herunterladen" klicken, wird der Assistent "Verbindungsdatei herunterladen" geöffnet. Geben Sie die folgenden Feldwerte im Assistenten an:
    • Umleitungs-URL für Google-Blatt: Dies ist die Deployment-URL für Webanwendung, die Sie aus Schritt neun des Abschnitts Google-Skript als Webanwendung bereitstellen kopiert haben.
    • Wählen Sie einen Antworttyp aus:
      • Explizite Verbindung

        Mit den Werten für OAuth-Client-ID und OAuth-Client Secret können Sie Google Sheets authentifizieren und autorisieren, Autonomous Database zu verwenden. Verwenden Sie diese Option, wenn Sie CODE als Antworttyp beim Herunterladen der Verbindungsdatei von der Seite "Datenbankaktionen" verwenden. Dies ist die sicherere Methode und wird bevorzugt verwendet, wenn die autonome Datenbank öffentlichen Zugriff hat.

      • Implizite Verbindung

        Sie benötigen eine OAuth-Client-ID, um implizit auf Autonomous Database zuzugreifen. Verwenden Sie diese Option, wenn Sie "Token" als Antworttyp beim Herunterladen der Verbindungsdatei von der Seite "Datenbankaktionen" verwenden. Verwenden Sie diese Option, wenn sich die autonome Datenbank in einem privaten Subnetz oder innerhalb einer Kundenfirewall befindet.

Client-ID und Client-Secret mit UI generieren

In diesem Abschnitt verwenden Sie die Web-UI, um client_id und client_secret abzurufen.

Sie generieren die Clientschlüssel, indem Sie auf die Autonomous Database-Instanz-URL zugreifen, die mit oauth/clients angehängt wird.

Beispiel: Wenn Ihre Instanz "https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/ords/<schema Name>/_sdw/" ist, müssen Sie sich mit dem Link "https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/ords/<schema Name>/oauth/clients/" anmelden. Achten Sie darauf, den abschließenden Schrägstrich aufzunehmen.

  1. Melden Sie sich mit dem Link "https://machinename.oraclecloudapps.com/ords/SchemaName/oauth/clients/" bei Database Actions an. Sie können eine OAuth-Clientseite unter dem Link "https://localhost:port/ords/schemaName/_sdw/?nav=rest-workshop&rest-workshop=oauth-clients" anzeigen.
  2. Klicken Sie auf die Schaltfläche +Create OAuth Client, um einen neuen Client zu erstellen.
    Beschreibung von create-client.png folgt
    Beschreibung der Abbildung create-client.png
  3. Wählen Sie in der Dropdown-Liste "Berechtigungstyp" den gewünschten Clientverbindungstyp aus. Sie können zwischen folgenden Optionen wählen:
    • AUTH_CODE: Wählen Sie diese Option für eine implizite Verbindung aus. Verwenden Sie diesen Antworttyp, wenn sich die autonome Datenbank in einem privaten Subnetz oder innerhalb einer Kundenfirewall befindet.
    • IMPLICIT: Wählen Sie diese Option für eine explizite Verbindung. Dies ist die sicherere Methode und wird bevorzugt verwendet, wenn die autonome Datenbank öffentlichen Zugriff hat.
  4. Geben Sie die folgenden Felder ein. Die Felder mit einem Sternchen (*) sind Pflichtfelder:
    • Name: Name des Clients.
    • Beschreibung: Beschreibung des Zwecks des Clients.
    • Umleitungs-URI: Webanwendungs-Deployment-URL, die Sie aus Schritt 10 von Google-Skript als Webanwendung bereitstellen kopiert haben
    • Support-URI: Geben Sie die URI ein, über die Endbenutzer den Client kontaktieren können, um Unterstützung zu erhalten. Beispiel: https://script.google.com/
    • Support-E-Mail: Geben Sie die E-Mail-Adresse ein, über die Endbenutzer den Client für Support kontaktieren können.
    • Logo: Wählen Sie optional ein Bild aus dem lokalen System aus, um ein Logo für den neuen Client einzufügen.
    Navigieren Sie zur Registerkarte Rollen, um die Rollen des Clients auszuwählen. Dies ist kein Pflichtfeld.
  5. Fahren Sie mit der Registerkarte Zulässige Ursprünge fort. Geben Sie die Liste der URL-Präfixe an, und fügen Sie sie in das Textfeld ein. Dies ist kein Pflichtfeld.
  6. Gehen Sie zur Registerkarte Berechtigungen, um eine beliebige Berechtigung hinzuzufügen. Sie benötigen keine Berechtigungen zum Erstellen eines OAuth-Clients.
  7. Klicken Sie auf Erstellen, um den neuen OAuth-Client zu erstellen. Dadurch wird der OAuth-Client registriert, den Sie auf der Seite "OAuth-Clients" anzeigen können.
    Beschreibung von new-client.png folgt
    Beschreibung der Abbildung new-client.png
  8. Klicken Sie auf das Symbol "Anzeigen", um die Felder Client ID und Client Secret anzuzeigen.

Wie verbinde ich mich manuell?

Die folgenden Abschnitte zeigen, wie Sie eine Verbindung mit impliziten und expliziten Verbindungen herstellen. Google Sheets benötigt eine Berechtigung für den Zugriff auf die Autonomous Database. Sie müssen zuerst die Autorisierung abschließen, um eine Verbindung zur autonomen Datenbank herzustellen. Das Add-on erfordert eine einmalige Authentifizierung für das Setup.

  1. Klicken Sie im Google-Blatt auf Oracle Autonomous Database, und wählen Sie Verbindungen aus.
    Die Auswahl von Verbindungen erfordert eine einmalige Google-Authentifizierung.
    • Wenn Sie auf Verbindungen klicken, wird ein Popup-Fenster geöffnet, in dem Sie zur Ausführung der Autorisierung aufgefordert werden. Klicken Sie auf Fortfahren.
      Beschreibung von auth-continue.png folgt
      Beschreibung der Abbildung auth-continue.png
    • Sie sehen nun ein Fenster, das Sie darüber informiert, dass die Anwendung Zugriff auf sensible Informationen in Ihrem Google-Konto anfordert.
    • Klicken Sie auf Erweitert, und wählen Sie den Link Gehe zu Projekt ohne Titel (unsicher). Wenn Sie den Link auswählen, wird ein neues Fenster geöffnet, um sicherzustellen, dass Sie der Anwendung vertrauen. Klicken Sie auf Zulassen, um fortzufahren. Sie haben das Setup abgeschlossen.
  2. Klicken Sie im Verbindungsassistenten im Dropdown-Menü Verbindungen verwalten auf Verbindung hinzufügen, um eine Verbindung hinzuzufügen.
    Beschreibung von add-connection.png folgt
    Beschreibung der Abbildung add-connection.png
  3. Wenn Sie "Verbindung hinzufügen" auswählen, wird ein Assistent Verbindung hinzufügen im Verbindungslistenbereich des Verbindungsassistenten des Verbindungsassistenten geöffnet.
    Beschreibung von add-connection-fields.png folgt
    Beschreibung der Abbildung "add-connection-fields.png"
  4. Geben Sie die folgenden Feldwerte im Assistenten an:

    Verbindungsname: Geben Sie den Namen der Verbindung ein. Beispiel: TestConnection.

    Autonomous Database-URL: Geben Sie die URL der Autonomous Database ein, zu der Sie eine Verbindung herstellen möchten. Beispiel: "https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/"

    Wählen Sie im Feld OAuth Clientzugriffsberechtigungstyp eine der beiden Optionen basierend auf dem gewünschten Verbindungstyp aus. Weitere Informationen finden Sie im Abschnitt Client-ID und Client Secret mit der UI generieren.

    Diese Option variiert mit impliziten und expliziten Verbindungen.

    Implizit: Wählen Sie diese Option für eine implizite Verbindung aus. Verwenden Sie diesen Antworttyp, wenn sich die autonome Datenbank in einem privaten Subnetz oder innerhalb einer Kundenfirewall befindet.

    AUTH_CODE: Wählen Sie diese Option für eine explizite Verbindung aus. Dies ist die sicherere Methode und wird bevorzugt verwendet.

    Wenn Sie die Option "Implizit" auswählen, können Sie die folgenden Felder anzeigen:
    Beschreibung von implicit.png folgt
    Beschreibung der Abbildung implicit.png

    OAuth Client-ID: client_id, die Sie mit dem Assistenten Neuen Client erstellen in der UI generieren. Weitere Informationen finden Sie im Abschnitt Client-ID und Client Secret mit der UI generieren.

    Schemaname: Geben Sie den Namen des Schemas ein.

    Wenn Sie AUTH_CODE auswählen, können Sie die folgenden Felder anzeigen:


    Beschreibung von explicit.png folgt
    Beschreibung der Abbildung explicit.png

    OAuth Client-ID: client_id, die Sie mit dem Assistenten "Neuen Client erstellen" in der UI generieren. Weitere Informationen finden Sie im Abschnitt Client-ID und Client Secret mit der UI generieren.

    OAuth Client Secret: client_secret, die Sie mit dem Assistenten "Neuen Client erstellen" in der UI generieren. Weitere Informationen finden Sie im Abschnitt Client-ID und Client Secret mit der UI generieren.

    Schemaname: Geben Sie den Namen des Schemas ein.

    Klicken Sie auf Speichern.

    Nachdem Sie auf Speichern geklickt haben, können Sie die neue Verbindung im Bereich "Verbindungsliste" anzeigen. In der Verbindungsliste werden der Name der Verbindung, der Schemaname und der Typ OAuth angezeigt, den Sie erteilen. Sie befindet sich jedoch immer noch in einem getrennten Zustand.

  5. Klicken Sie auf die drei vertikalen Punkte neben dem Verbindungsnamen, und führen Sie die folgenden Vorgänge aus:

    Verbindung herstellen: Wählen Sie Verbindung herstellen zu Autonomous Database aus, und ändern Sie den Verbindungsstatus in "Aktiv". Wenn Sie Verbinden auswählen, wird die Anmeldeseite der autonomen Datenbank geöffnet. Nach der Anmeldung wird eine Seite angezeigt, auf der angezeigt wird, dass Ihnen der Datenbankzugriff erteilt wurde. Schließen Sie das Fenster, und kehren Sie zu Google Sheets zurück. Sie sehen nun, dass die Verbindung aktiv ist.

    Bearbeiten: Wählen Sie Bearbeiten aus, um einen beliebigen Wert der Verbindung zu aktualisieren. Klicken Sie auf Speichern, um die bearbeiteten Werte zu aktualisieren.

    Duplizieren: Wählen Sie Duplizieren aus, um eine doppelte Verbindung zu erstellen.

    Entfernen: Wählen Sie Entfernen aus, um die Verbindung aus der Verbindungsliste zu entfernen.

Verbindungen werden exportiert

  1. Klicken Sie im Dropdown-Menü Verbindungen verwalten auf Verbindung exportieren, um die ausgewählte Verbindung zu exportieren.
  2. Wählen Sie die zu exportierende Verbindung aus, und klicken Sie auf Exportieren.
    Beschreibung von export.png folgt
    Beschreibung der Abbildung export.png
  3. Klicken Sie auf Exportieren.
  4. Die exportierte Verbindung wird in Ihrem lokalen System heruntergeladen. Die Verbindungsdatei wird als spreadsheet_addin_connections.json gespeichert.

Google Sheets für die Verwendung von Autonomous Database autorisieren

Nachdem Ihre Identität mit der OAuth-Authentifizierung bestimmt wurde, benötigt Google Sheets die Berechtigung für den Zugriff auf die Autonomous Database.

Die Werte client_id und client_secret, die Sie bei der OAuth-Authentifizierung generieren, werden für die Autorisierung verwendet.

  1. Klicken Sie im Google-Blatt, an dem Sie arbeiten, auf das Menü Oracle Autonomous Database, und wählen Sie Registrieren aus. Dies erfordert eine einmalige Google-Authentifizierung.
  2. Wenn Sie auf "Registrieren" klicken, wird ein Popup-Fenster geöffnet, in dem Sie zur Ausführung der Autorisierung aufgefordert werden. Klicken Sie auf Weiter. Wenn Sie Weiter auswählen, werden Sie zur Seite "Google-Konten" weitergeleitet, auf der Sie Ihr Gmail-Konto auswählen müssen.
  3. Sie sehen nun ein Fenster, das Sie darüber informiert, dass die Anwendung Zugriff auf sensible Informationen in Ihrem Google-Konto anfordert. Klicken Sie auf "Erweitert", und wählen Sie den Link "Gehe zu Projekt ohne Titel (unsicher)" aus.
  4. Wenn Sie den Link auswählen, wird ein neues Fenster geöffnet, um sicherzustellen, dass Sie der Anwendung vertrauen. Klicken Sie auf Zulassen, um fortzufahren.
  5. Sie haben das Setup abgeschlossen. Wählen Sie im Google-Blatt im Oracle Autonomous Database-Menü die Option Registrieren aus.
    Dadurch wird ein Oracle Autonomous Database-Assistent im Google-Blatt geöffnet. Geben Sie die folgenden Felder an:
    • ADB-URL: Geben Sie die ADB-URL ein. Beispiel: "https://<hostname>-<databasename>.adb.<region>.oraclecloudapps.com/ords/<Schemaname>".
    • OAuth-Client-ID: client_id, die Sie während der Authentifizierung generieren.
    • OAuth Client Secret: client_secret, das Sie während der Authentifizierung generieren. Weitere Informationen finden Sie im Abschnitt "Verbindungen mit der Google-Tabelle erstellen".

    Beschreibung von adb-google-wizard.png folgt
    Beschreibung der Abbildung adb-google-wizard.png
  6. Wählen Sie Autorisieren aus.

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.