Oracle Cloud Infrastructure-Dokumentation

Oracle Autonomous Database für Google Sheets

Mit dem Oracle Autonomous Database-Add-on Diese Abbildung beschreibt das Add-on Oracle Autonomous Database für Google Sheets. können Sie Tabellen mit SQL- oder Analyse-Views mit einem Assistenten direkt aus Google Sheets zur Analyse abfragen.

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

Das Oracle Autonomous Database-Add-on für Google Sheets muss die Datenschutzerklärung einhalten. Weitere Informationen zu Datenschutzrichtlinien finden Sie unter Oracle Autonomous Database für 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 für die Arbeit auswählen. 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 Abfrage 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. Über die 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 im Autonomous Database-Account aktivieren. Sie müssen über die Rollen CONNECT, DWROLE, RESOURCE und ADPUSER im SQL-Arbeitsblatt verfügen, 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.
  • Installieren und einrichten Sie das Add-on für Google Sheets
    Bevor Sie das Oracle Autonomous Database-Add-on für Google Sheets installieren, laden Sie die ZIP-Datei oracleGoogleAddin aus Ihrer Database Actions-Instanz herunter.
  • Verbindungsdatei herunterladen
    Um eine Verbindung zu Autonomous Database herzustellen, können Sie eine Verbindungsdatei aus der Database Actions-Instanz herunterladen und in das von Ihnen eingerichtete Google Sheet-Add-on importieren.
  • Verbindung zu Autonomous Database herstellen
    Mit dem Oracle Autonomous Database-Add-on für Google Sheets können Sie mit dem Verbindungsfeature eine Verbindung zu mehreren autonomen Datenbanken mit einem einzelnen Add-on herstellen. Das Add-on stellt über die Authentifizierung bei Google eine Verbindung zu Google Sheets her. Mehrere Benutzer oder Datenbanken können sich gleichzeitig mit dem Add-on verbinden. Es kann jedoch nur eine Verbindung aktiv bleiben.
  • Client-ID und Client Secret mit UI generieren
    In diesem Abschnitt verwenden Sie die Web-UI, um die client_id und client_secret abzurufen.
  • Google Sheets zur Verwendung von Autonomous Database autorisieren
    Nachdem Ihre Identität mit der OAuth-Authentifizierung bestimmt wurde, benötigt Google Sheets eine Berechtigung für den Zugriff auf Autonomous Database.
  • Natürliche Sprache in Google Sheets
    Sie können Natural Language Query verwenden, um die Oracle Autonomous Database über das Menü Natürliche Sprache im "Add-on" von Oracle Autonomous Database für Google Sheets abzufragen.
  • Datenanalyse in Google Sheets
    Wenn Sie Datenanalyse auswählen, wird ein Oracle Autonomous Database-Assistent im Google-Blatt geöffnet.
  • Direkte SQL-Abfragen ausführen
    Mit dem Oracle Autonomous Database-Add-on für Google Sheets können Sie SQL-Abfragen ausführen, um mit Ihren Daten in einem Google-Blatt zu arbeiten. Mit dem Add-on können Sie Ihren SQL-Code in den SQL-Editorbereich eingeben und auf Ausführen klicken, um den Befehl auszuführen.
  • Berichte und Analysen in Google Sheets
    Sie können Berichte und Analyseansichten anzeigen oder Daten zu Analysezwecken visualisieren.
  • Blatt löschen
    Sobald das Add-on die Abfrage ausführt und die Daten in das Arbeitsblatt abruft, können Sie den Zeitstempel, den Benutzer, die AV-Abfrage und die SQL-Abfrage der Analyse-View in den automatisch generierten Abfrageergebnissen anzeigen.
  • Alle Blätter löschen
    Mit dieser Option können Sie alle Blätter löschen, die in der Tabelle vorhanden sind.
  • Menü "Oracle Autonomous Database"
    Mit dieser Option können Sie Details zum Add-in anzeigen
  • Teilen oder veröffentlichen
    Nachdem Sie die Abfrageergebnisse im Google-Blatt generiert haben, können Sie sie für andere Benutzer freigeben. Mit der Freigabe wird eine Kopie des Arbeitsblattes erstellt und mit ausgeblendeten Designtools und aktiviertem Arbeitsblattschutz gesendet.
  • Datenschutzrichtlinien für Oracle Autonomous Database für Google – Details
    Gültigkeitsdatum: 10/4/2024
  • Oracle Autonomous Database für Google Sheets-Support
    Willkommen auf der Supportseite für die Oracle Autonomous Database für Google Sheets. Diese Ressource soll Sie bei Problemen oder Fragen unterstützen, die Sie während der Verwendung des Add-ons haben könnten.

Übergeordnetes Thema: Datenanalysetool

Verbindungsdatei herunterladen

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

Führen Sie die unten aufgeführten 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 aus. 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 aus 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 Webanwendungen, die Sie aus Schritt neun des Abschnitts Google-Skript als Webanwendung bereitstellen kopiert haben.
    • Wählen Sie einen Antworttyp aus:
      • Explizite Verbindung

        Sie verwenden die Werte für OAuth-Client-ID und OAuth-Client Secret zur Authentifizierung und Autorisierung von Google Sheets zur Verwendung von Autonomous Database. Verwenden Sie diese Option, wenn Sie beim Herunterladen der Verbindungsdatei von der Seite "Datenbankaktionen" CODE als Antworttyp 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 beim Herunterladen der Verbindungsdatei von der Seite "Datenbankaktionen" Token als Antworttyp 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 an oauth/clients angehängt wird.

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

  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 im 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 aus. 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 * sind obligatorisch:
    • Name: Name des Clients.
    • Description: Beschreibung des Zwecks des Clients.
    • Umleitungs-URI: Deployment-URL der Webanwendung, 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 um Unterstützung bitten können. Beispiel: https://script.google.com/
    • Support-E-Mail: Geben Sie die E-Mail ein, in der Endbenutzer den Client um Unterstützung bitten können.
    • Logo: Wählen Sie optional ein Bild aus Ihrem 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. Gehen Sie zur Registerkarte Zulässige Ursprünge. 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 Berechtigungen 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?

In den folgenden Abschnitten wird gezeigt, wie Verbindungen mit impliziten und expliziten Verbindungen hergestellt werden. Google Sheets benötigt die Berechtigung für den Zugriff auf 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 die Einrichtung.

  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 Weiter.
      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) aus. Wenn Sie den Link auswählen, wird ein neues Fenster geöffnet, in dem sichergestellt wird, dass Sie der Anwendung vertrauen. Klicken Sie auf Zulassen, um fortzufahren. Sie haben das Setup jetzt 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 im Verbindungslistenbereich des Verbindungsassistenten ein Assistent Verbindung hinzufügen 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 über die 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 über die UI generieren.

    Schemaname: Geben Sie den Namen des Schemas an.

    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 an.

    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. Es befindet sich jedoch 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:

    Verbinden: Wählen Sie Verbinden mit Autonomous Database aus, und ändern Sie den Verbindungsstatus in "Aktiv". Wenn Sie Verbinden auswählen, wird die Anmeldeseite der autonomen Datenbank geöffnet. Nachdem Sie sich angemeldet haben, zeigen Sie eine Seite an, auf der angezeigt wird, dass Ihnen der Datenbankzugriff erteilt wurde. Schließen Sie das Fenster und kehren Sie zu Google Sheets zurück. Jetzt wird angezeigt, 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 Verbindung aus, die Sie exportieren möchten, 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 Ihr lokales System heruntergeladen. Die Verbindungsdatei wird als spreadsheet_addin_connections.json gespeichert.

Google Sheets zur Verwendung von Autonomous Database autorisieren

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

Die Werte client_id und client_secret, die Sie bei der Authentifizierung OAuth generieren, werden zur Autorisierung verwendet.

  1. Klicken Sie im gerade bearbeiteten Google-Blatt 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 Unbenanntem Projekt (unsicher).
  4. Wenn Sie den Link auswählen, wird ein neues Fenster geöffnet, in dem sichergestellt wird, dass Sie der Anwendung vertrauen. Klicken Sie auf Zulassen, um fortzufahren.
  5. Sie haben das Setup jetzt 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/<Schema Name>".
    • OAuth-Client-ID: client_id, die Sie bei der Authentifizierung generieren.
    • OAuth-Client Secret: client_secret, die Sie bei 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.