Das Connector-Dialogfeld für Google Sheets

Hinweis: Die Google Sheets-API unterstützt nur Tabellenkalkulationen, die in Google Sheets erstellt wurden, und unterstützt keine in das System importierten Excel-Dateien.

 

Das Google Sheets-Connector-Dialogfeld enthält die folgenden Felder und Einstellungen:

Feld

Beschreibung

Verbindung

Authentifizierungsmethode

Die Authentifizierungsmethode, die während der Sitzung verwendet werden soll.

Wählen Sie die Methode aus der Dropdown-Liste aus.

  • Servicekonto. Wenn Sie diese Methode auswählen, müssen Sie einen Schlüsseldatei-Pfad angeben.

  • OAuth2.0: Wenn Sie diese Methode auswählen, müssen Sie eine Client-ID und ein Client-Geheimnisangeben.

Schlüsseldatei-Pfad

Der Pfad zu einer Datei, die die Schlüssel Ihres Servicekontos enthält.

Diese Einstellung ist erforderlich, wenn Sie Servicekonto als Authentifizierungsmethode auswählen.

Geben Sie den Pfad zur Schlüsseldatei für das Servicekonto (im JSON-Format), die die erforderlichen Anmeldeinformationen enthält, in das vorgesehene Feld ein. Sie können die Schaltfläche Durchsuchen verwenden, um das Dialogfeld „Öffnen“ zu öffnen und diese Datei zu suchen.

Kunden-ID

Der Client-ID-Schlüssel für Ihre Anwendung, wenn Sie sich an REST-Endpunkten mit aktiviertem OAuth 2.0 authentifizieren (AuthenticationMethod=OAuth2).

HINWEIS: In manchen Fällen ist der Wert dieser Option gleich Ihrem Benutzernamen oder Ihrer Authentifizierungsadresse. In anderen Fällen wird dieser Wert mit Ihrem Client-Geheimnis angegeben. Wenn Sie einen Authentifizierungsfehler feststellen, überprüfen Sie, ob Sie den richtigen Wert verwenden.

Client-Geheimnis

Das Client-Geheimnis für Ihre Anwendung, wenn Sie sich bei REST-Endpunkten mit aktiviertem OAuth 2.0 authentifizieren.

WICHTIG: Das Client-Geheimnis ist ein vertraulicher Wert, der für die Authentifizierung der Anwendung gegenüber dem Dienst verwendet wird. Um unbefugten Zugriff zu verhindern, muss dieser Wert sicher verwaltet werden.

Bereich

Eine durch Leerzeichen getrennte Liste von OAuth-Bereichen, die die durch ein Zugriffs-Token zum Zeitpunkt der Verbindung gewährten Berechtigungen einschränken

Die Standardwerte sind:

https://www.googleapis.com/auth/spreadsheets https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.readonly

FileQuery

Die Abfragezeichenfolge zum Filtern der zurückzugebenden Dateien.

Um nach einer bestimmten Gruppe von Dateien oder Ordnern zu suchen, verwenden Sie das Feld „q“ der Abfragezeichenfolge mit der Methode „files.list“, um die zurückzugebenden Dateien durch die Kombination eines oder mehrerer Suchbegriffe zu filtern.

Eine Abfragezeichenfolge enthält die folgenden drei Teile:

query_term operator values

Wo:

  • query_term der Abfragebegriff oder das Feld ist, nach dem gesucht werden soll,
  • operator die Bedingung für den Abfragebegriff angibt,
  • values die spezifischen Werte sind, die Sie zum Filtern Ihrer Suchergebnisse verwenden möchten.

Beispiel:

Die folgende Abfragezeichenfolge filtert die Suche so, dass nur Ordner zurückgegeben werden, indem der MIME-Typ wie folgt festgelegt wird:
q: mimeType = 'application/vnd.google-apps.folder'

Auf dieser Seite finden Sie weitere Einzelheiten.

Bereichsspaltenbeginn

Die Nummer der Anfangsspalte des Bereichs.

Dies ist eine erforderliche Einstellung.

Bereichsspaltenende

Die Nummer der Endspalte des Bereichs.

Dies ist eine erforderliche Einstellung.

Bereichszeilenbeginn

Die Nummer der Anfangszeile des Bereichs. Wenn kein Wert angegeben wird, wird der Zeilenanfang auf 0 festgelegt.

Dies ist eine optionale Einstellung.

Bereichszeilenende

Die Endzeilennummer des Bereichs. Wenn kein Wert angegeben wird, wird der Zeilenanfang auf 1000 festgelegt.

Dies ist eine optionale Einstellung.

Erste Zeile ist Kopfzeile

Wenn diese Einstellung auf True festgelegt wird, wird die erste Zeile des Blattes in eine Spaltenüberschrift umgewandelt.

Der Standardwert ist True.

Zurücksetzen

Wenn diese Einstellung auf True festgelegt wird, wird die Sitzung zurückgesetzt.

Der Standardwert ist False.

Anwendungsname

Der Name der Anwendung.

Der Standardwert ist Monarch Google Sheets.

Tabellen und Ansichten

Tabellen und Ansichten

Hier können Sie Tabellen aus Ihrer Datenbank laden und dann manuell aus einer Liste auswählen.

 

So laden Sie Tabellen und Ansichten anhand von Such- und Auswahlfunktionen.

  1. Wählen Sie die Registerkarte Tabellen und Ansichten aus.

  2. Klicken Sie auf Tabellen laden, um eine Liste vordefinierter Tabellen oder Ansichten zu laden. Diese werden in der Tabellenliste (linke Seite des Dialogfelds) angezeigt.

  3. Wählen Sie eine Tabelle aus der Tabellenliste aus.

    Die Tabellenspalten werden in der Liste Spalten (neben der Tabellenliste) angezeigt.

  4. Wählen Sie die Spalten aus, die zu Ihrer Datentabelle hinzugefügt werden sollen, indem Sie die Spaltenkästchen aktivieren.

Hinweis: Wenn Sie das Duplikat einer Spalte hinzufügen möchten, wählen Sie die entsprechende Spalte in der Dropdown-Liste Doppelte Spalte hinzufügen aus.

 

So wählen Sie eine Spalte aus:

Markieren Sie die Kästchen neben den gewünschten Spalten. Markieren Sie in der Kopfzeile das Kästchen Spalte, wenn alle Spalten verwendet werden sollen.

 

So aggregieren Sie Spalten:

Wenn die zurückgegebenen Daten aggregiert werden sollen, markieren Sie in der Kopfzeile das Kästchen Aggregieren und wählen Sie anschließen die Aggregationsmethode für jede Spalte aus.

 

Folgende Aggregationsmethoden stehen für die einzelnen Datentypen zur Verfügung:

 

So filtern Sie Spalten:

Wenn die zurückgegebenen Daten gefiltert werden sollen, markieren Sie in der Kopfzeile das Kästchen Filter anwenden. Wählen Sie dann für jede Spalte eine Filtermethode aus der Dropdown-Liste aus und geben Sie den Wert in das Feld Filterwert ein.

 

Hinweise:

  • Wenn Sie nicht sicher sind, was das Format des Filterwerts für das Datumsfeld ist, bewegen Sie den Mauszeiger über das Textfeld Filterwert, um eine QuickInfo mit einem Hinweis anzuzeigen:

 

  • Bei einigen Datenquellen muss bei den Filterwerten die Groß- und Kleinschreibung beachtet werden. In dieser Liste können Sie ermitteln, welche Datenquellen Filter haben, bei denen die Groß-/Kleinschreibung zu beachten ist.

  • Wählen Sie die Registerkarte Abfrage aus, um Tabellen und Ansichten mithilfe einer SQL-Abfrage zu laden.

  • Wenn Sie Änderungen an den Spalten der zu ladenden Tabelle vornehmen (d. h. die Einstellungen Bereichsspaltenanfang und Bereichsspaltenende ändern), müssen Sie auf Tabellen laden klicken, um die (neu) angegebenen Spalten in der Spaltenliste zu sehen.

Daten voranzeigen

Hier klicken, um Daten anhand der festgelegten Zugangsdaten und Kriterien abzurufen. Dies ermöglicht das Bestätigen der Verbindung: Stellen Sie sicher, dass die Verbindung mit der richtigen Tabelle hergestellt wurde, prüfen Sie die Abfrage und überprüfen Sie die Informationen, die geladen werden.

Hinweise:

  • Es werden nur zehn Datensätze angezeigt, damit Sie die Auswahl der korrekten Daten überprüfen können. Dies verhindert eine Verlangsamung des Systems.

  • Die Schaltfläche ist nur aktiv, wenn die Verbindung aktiv und die Abfrage richtig ist. Prüfen Sie die Verbindung oder Abfrage, wenn eine der Schaltflächen deaktiviert ist.

Abfrage

Abfrage

Hier können Sie die Tabellen aus Ihrer Datenbank laden und dann durch Eingabe einer SQL-Anweisung auswählen.

Wenn Sie Tabellen und Ansichten bereits ausgewählt haben, wird dieses Feld aktualisiert und zeigt die entsprechende Abfrage „SELECT * FROM TABLE“ an.

 

Wenn Sie die Abfrage definieren möchten, geben Sie die Anweisungen SELECT, EXEC und/oder WITH zum Ausführen ein.

Hinweise:

  • Zur Minimierung von Sicherheitsrisiken und Verhinderung von SQL-Einschleusungsattacken:

    • Es sind nur die Anweisungen Select, Exec, und/oder With zulässig.

    • Folgende sind NICHT zulässig:

      • Kommentarzeichen ( -- )

      • Semikolons ( ; )

  • Sollte eine Serie von SQL-Anweisungen mit oder ohne Kommentare verwendet werden müssen, empfehlen wir die Verwendung gespeicherter Verfahren zum Einfassen dieser Anweisungen. Das gespeicherte Verfahren kann dann aus dem Formular ausgeführt werden.

  • Die Schaltflächen Daten voranzeigen und OK sind nur aktiv, wenn die Verbindung aktiv und die Abfrage richtig ist. Prüfen Sie die Verbindung oder Abfrage, wenn eine der Schaltflächen deaktiviert ist.

Daten voranzeigen

Hier klicken, um Daten anhand der festgelegten Zugangsdaten und Kriterien abzurufen. Dies ermöglicht das Bestätigen der Verbindung: Stellen Sie sicher, dass die Verbindung mit der richtigen Tabelle hergestellt wurde, prüfen Sie die Abfrage und überprüfen Sie die Informationen, die geladen werden.

Hinweise:

  • Es werden nur zehn Datensätze angezeigt, damit Sie die Auswahl der korrekten Daten überprüfen können. Dies verhindert eine Verlangsamung des Systems.

  • Die Schaltfläche ist nur aktiv, wenn die Verbindung aktiv und die Abfrage richtig ist. Prüfen Sie die Verbindung oder Abfrage, wenn eine der Schaltflächen deaktiviert ist.

OK/ABBRECHEN

Wählen Sie OK aus, um die Verbindung herzustellen und Daten abzurufen, oder wählen Sie Abbrechen aus, um das Dialogfeld zu schließen.

Der Zustand der Schaltflächen OK und VORSCHAU zeigt Ihnen auf einen Blick den Status der Verbindung an:

  • Die Schaltflächen OK und DATEN VORANZEIGEN werden aktiviert, sobald Eingaben in die erforderlichen Felder erfolgt sind und sie überprüft wurden. Dies bedeutet in der Regel, dass eine Verbindung zur Datenquelle hergestellt und eine Tabelle ausgewählt wurde.

  • Die Schaltfläche OK ist deaktiviert, wenn ein Update vorgenommen wird, dass zu einem ungültigen Ergebnis führen kann (Bespiel: Der Benutzername oder das Passwort ist ungültig, oder die SQL-Anweisung auf der Registerkarte „Abfrage“ ist ungültig). Verwenden Sie in solchen Fällen DATEN VORANZEIGEN, um sicherzustellen, dass die Daten abgerufen werden können. Wenn dies fehlschlägt, überprüfen Sie die Verbindungsinformationen, oder führen Sie die Abfrage so lange durch, bis Daten abgerufen werden.

 

Hinweise:

  • Optionale Felder. Andere Felder sind optional, aber möglicherweise müssen Sie Ihren Datenquellenadministrator nach weiteren Feldwerten fragen, die Sie für die Verbindung eingeben müssen.

  • Verbindungszeichenfolgen, die 1020 Zeichen überschreiten: Für Verbindungszeichenfolgen, die 1020 Zeichen überschreiten, wird vorübergehend ein Datei-DSN erstellt. Auf dieser Seite erhalten Sie weitere Informationen zur Implementierung.

  • Unterstützung von Kurznamen: Diese Version von Monarch Data Prep Studio unterstützt Progress-Kurznamen, genauer gesagt im Feld Andere Verbindungsoptionen. Auf dieser Seite erhalten Sie weitere Informationen zur Implementierung.

 

 

 

 

© 2025 Altair Engineering Inc. All Rights Reserved.

Intellectual Property Rights Notice | Technical Support