Das Connector-Dialogfeld für Google Sheets

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

Geben Sie Werte in das Dialogfeld ein, um eine Verbindung herzustellen und Daten aus Ihrer Google Sheets-Datenquelle abzurufen. Wählen Sie eine bestimmte Registerkarte, um bestimmte Optionen anzuzeigen.
Bewegen Sie den Mauszeiger im Dialogfeld Konnektor über den Feldnamen, um eine Beschreibung oder Hilfe zu diesem Feld anzuzeigen.

Registerkarte Verbindung

Füllen Sie die folgenden Felder aus, um eine erfolgreiche Verbindung herzustellen. Fett gedruckte Felder sind erforderlich.

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 für kurze Namen: Diese Version des Monarch Data Prep Studio unterstützt Progress-Kurznamen, genauer gesagt im Feld Andere Verbindungsoptionen . Auf dieser Seite erhalten Sie weitere Informationen zur Implementierung.

Feld

Beschreibung

Authentifizierungsmethode:

Legt die Authentifizierungsmethode fest, 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 den Schlüsseldatei-Pfad. eingeben.

  • OAuth2.0. Wenn Sie diese Methode auswählen, müssen Sie die Client-Id und Client-Geheimnis eingeben.

Schlüsseldatei-Pfad

Dies ist ein Pflichtfeld, wenn Sie „Servicekonto“ als Authentifizierungsmethode ausgewählt haben.

Geben Sie die Servicekonto-Schlüsseldatei (im JSON-Format) mit den Zugangsdaten ein.

Kunden-ID

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

Hinweis: In einigen Fällen entspricht der Wert dieser Option Ihrem Benutzernamen oder Ihrer Authentifizierungsadresse. In anderen Fällen wird dieser Wert mit Ihrem Client-Geheimnis bereitgestellt. Wenn ein Authentifizierungsfehler auftritt, überprüfen Sie, ob Sie den korrekten Wert verwenden.

Client-Geheimnis

Geben Sie das Client-Geheimnis für Ihre Anwendung ein, 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

Geben Sie eine durch Leerzeichen getrennte Liste von OAuth-Bereichen ein, die die von einem Zugriffstoken gewährten Berechtigungen zum Zeitpunkt der Verbindung einschränken.

Der Standardwert ist:

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

Geben Sie die Abfragezeichenfolge ein, um die zurückzugebenden Dateien zu filtern.

Für die Suche nach bestimmten Dateien oder Ordnern verwenden Sie das Abfragezeichenfolgenfeld q mit der Methode files.list, um die zurückzugebenden Dateien zu filtern, indem Sie einen oder mehrere Suchbegriffe kombinieren.

Eine Abfragezeichenfolge enthält die folgenden drei Teile:

Abfrage_Begriff Operator Werte

Wo:

  • Abfrage_Begriff ist der Abfragebegriff oder das Feld, nach dem gesucht wird.
  • Operator gibt die Bedingung für den Abfragebegriff an.
  • Werte sind die spezifischen Werte, nach denen Sie die Suchergebnisse filtern möchten.

Beispiel

Der folgende Abfrage-Zeichenfolge filtert die Suche, um nur Ordner zurückzugeben, indem der MIME-Typ festgelegt wird:
q: mimeType = 'application/vnd.google-apps.folder'

Weitere Details finden Sie auf dieser Seite.

Bereichsspaltenbeginn

Erforderlich. Gibt die Startspaltennummer des Bereichs an.

Bereichsspaltenende

Erforderlich. Gibt die Endspaltennummer des Bereichs an.

Bereichszeilenbeginn

Optional. Gibt die Startzeilennummer des Bereichs an. Wenn kein Wert angegeben ist, wird der Zeilenanfang auf 0 gesetzt.

Bereichszeilenende

Optional. Gibt die Endzeilennummer des Bereichs an. Wenn kein Wert angegeben ist, wird das Zeilenende auf 1000 gesetzt.

Erste Zeile ist Kopfzeilen

Gibt an, ob die erste Zeile in der Tabelle in Spaltenkopfzeilen konvertiert wird.

Standard ist True.

Zurücksetzen

Wählen Sie True, um die Sitzung zurückzusetzen.

Standard ist False.

Anwendungsname

Name der Anwendung.

Standardwert ist Monarch Google Sheets

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

Daten voranzeigen

Hier klicken, um Daten anhand der festgelegten Anmeldeinformationen 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.

Registerkarte 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. Überprüfen Sie Ihre Verbindung oder Ihre Abfrage, wenn eine der Schaltflächen deaktiviert ist.

Daten voranzeigen

Hier klicken, um Daten anhand der festgelegten Anmeldeinformationen 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, um die Verbindung herzustellen und Daten abzurufen, oder wählen Sie Abbrechen, 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.

 

 

© 2024 Altair Engineering Inc. All Rights Reserved.

Intellectual Property Rights Notice | Technical Support