SQL

Verfügbare Servertypen

Mit unserer SQL-Integration können Sie alles anzeigen, das durch SQL ausgedrückt werden kann. Plecto unterstützt die folgenden SQL-Servertypen:

• MySQL

• PostgreSQL

• Microsoft SQL Server 2005 oder später (einschließlich Azure SQL)

• Oracle

• Snowflake

• BigQuery*

• AWS Athena*

• AWS Redshift*

*serverspezifischer Konfigurationsprozess

Technische Details

• Update-Häufigkeit: Benutzerdefiniert (von alle 1 Minute bis einmal pro Tag)

• Unterstützt benutzerdefinierte Felder? Ja

• Unterstützt gelöschte Einträge? Nein

Update-Häufigkeiten

Unser System erhöht die SQL-Update-Häufigkeit einer Datenquelle automatisch, je nachdem wie lange der Import von Ihrem Server dauert. Beispiele:

• Wenn die Update-Häufigkeit auf 1 Minute eingestellt ist, aber der Import zwischen 30-120 Sekunden dauert, wird Plecto die Update-Häufigkeit auf 5 Minuten anpassen.

• Wenn die Update-Häufigkeit auf 1 oder 5 Minuten eingestellt ist, aber der Import zwischen 120-180 Sekunden dauert, wird Plecto die Update-Häufigkeit auf 15 Minuten anpassen.

• Wenn die Update-Häufigkeit auf 1, 5 oder 15 Minuten eingestellt ist, aber der Import zwischen 180-360 Sekunden dauert, wird Plecto die Update-Häufigkeit auf 1 Stunde anpassen.

Schritt 1: Firewall konfigurieren

Bevor Sie versuchen, Daten von Ihrem SQL-Server zu importieren, konfigurieren Sie bitte Ihre Firewall so, dass nur Datenverkehr aus folgender Quelle zugelassen wird:

• 51.159.130.44

Am 28.-29. Juni 2025 führte Plecto eine Migration zu einem europäischen Hosting-Anbieter durch, daher ersetzt die oben aufgeführte IP-Adresse die alten Plecto IP-Adressen. Die oben genannte Adresse ersetzt die alten IP-Adressen für den Datenverkehr. Bitte aktualisieren Sie Ihre Konfiguration, wenn Sie dies noch nicht getan haben.

Folgende Plecto IP-Adressen werden nach dem 28. Juni 2025 eingestellt:

• 54.76.22.100

• 54.76.22.43

• 52.210.249.227

Schritt 2: SQL-Server mit Plecto verbinden

Es wird empfohlen, einen neuen Benutzernamen und ein neues Passwort zu erstellen, die speziell zum Verbinden Ihrer Datenbank mit Plecto bestimmt sind. So vermeiden Sie, dass Sie das gleiche Passwort für mehrere Datenbanken verwenden. Es ermöglicht Ihnen auch, die Berechtigungen für den erstellten Benutzer auf nur Lesezugriff zu beschränken.

1. Gehen Sie zu Data sources > New data source und wählen Sie Ihre Datenbank.

   Wenn Sie Amazon Athena/Redshift-Datenbanken konfigurieren möchten, lesen Sie bitte die entsprechenden Integrationsleitfäden.

2. Füllen Sie die Anmeldedaten aus. Wenn Sie Zugriff auf die Datenbank haben, sollten Sie Ihre Anmeldedaten sammeln können.

   1. Hinweis zu Hostname: Sie müssen eine öffentliche IP-Adresse angeben. Wenn Sie eine lokale IP-Adresse hinzufügen, funktioniert die Verbindung nicht. Weitere Informationen.

   2. Hinweis zu Username beim Verbinden mit Azure: Wenn Sie SQL-Server auf Azure verwenden, sollten Sie username@[hostname] in das Benutzernamensfeld einfügen. Wenn der Hostname beispielsweise plecto.database.windows.net ist, sollten Sie username@plecto.database.windows.net in das Benutzernamensfeld schreiben.

   3. Wenn Sie den SSH Tunnel verwenden möchten: SSH ermöglicht es Ihnen, Daten über eine sichere und verschlüsselte Verbindung zu transportieren. Wenden Sie sich bitte an den technischen Support Ihrer Organisation, wenn Sie Ihre Datenbank mit Plecto über einen SSH-Tunnel verbinden möchten, aber nicht wissen, wie es geht.

      RSA Private Key. Plecto verwendet einen RSA-Privatschlüssel (PEM-Format), um auf Ihre Datenbank zuzugreifen. Sie sollten den Schlüssel im verwendeten System generieren und er sollte in Plecto wie folgt formatiert werden:

      -----BEGIN RSA PRIVATE KEY----- *Schlüssel hier einfügen *-----END RSA PRIVATE KEY-----

3. Klicken Sie auf Continue und gehen Sie zu Schritt 3, in dem Sie eine SQL-Anweisung schreiben müssen.

Schritt 3: SQL-Anweisung schreiben

Wenn Sie Plecto mit der Datenbank verbinden, müssen Sie eine SELECT-Anweisung schreiben, in der Sie die folgenden Standardfelder einfügen:

• member_id (erforderlich zum Erstellen des Benutzers, falls die ID nicht gefunden wird)

• member_name (erforderlich zum Zuordnen von Daten zu Mitgliedern in Plecto)

• date (erforderliches Datum im Zusammenhang mit diesem Datensatz (immer in UTC!))

• reference (erforderlicher eindeutiger Identifikator; kann zum Aktualisieren von Einträgen verwendet werden)

• team_name (optional; wir werden es in der Plecto-Datenquelle mit einem Upsert einfügen)

Gespeicherte Prozeduren. Plecto kann auch gespeicherte Prozeduren anstelle von SELECT-Anweisungen verwenden. Diese sollten mit einer EXEC-Anweisung verwendet werden. Beachten Sie, dass die gespeicherten Prozeduren immer noch die oben genannten Standardfelder enthalten sollten.

So begrenzen Sie die SQL-Anweisung

Bei jedem Import importiert und aktualisiert Plecto alle Daten, einschließlich der Zeilen, die bereits importiert wurden, sich aber seit dem letzten Importlauf nicht geändert haben. Beachten Sie daher, wie viele Daten Sie tatsächlich importieren müssen – je optimaler Ihre Einrichtung ist, desto schneller kann Plecto Ihre Daten verarbeiten.

Um die Updates zu beschleunigen und die Belastung Ihrer Server zu reduzieren, begrenzen Sie Ihre Anweisung so, dass sie nur die zuletzt geänderten Daten zurückgibt. Sie können die Variable {{ last_update_time }} verwenden, um nach Elementen zu filtern, die nicht seit dem letzten Durchlauf importiert wurden.

• Wenn Sie ein Datumsfeld haben, können Sie die folgende Funktion der Klausel hinzufügen, und die Variable wird durch das aktuellste Datum und die Uhrzeit ersetzt, wann die Datenquelle aktualisiert wurde: date field >= {{ last_update_time }}

• Sie können auch eine obere Datumsgrenze hinzufügen, die Plecto daran hindert, Daten zu importieren, die neuer als die angegebene Grenze sind. Verwenden Sie die folgende Funktion: date field <= {{ upper_date_limit }}

• Sie können auch eine Top 100 in der SELECT-Funktion verwenden. Denken Sie daran, DESC (absteigend) zu verwenden, um die neuesten Datensätze auszuwählen.

last_update_time und upper_date_limit

Wenn Sie eine SQL-Anweisung schreiben, können Sie ein Startdatum (last_update_time) und ein Enddatum (upper_date_limit) hinzufügen, das dazu führt, dass Ihre Datenbank nur Daten aus diesem Zeitraum importiert.

Sie können eine Testabfrage ausführen, um zu sehen, wie viele Zeilen es während des angegebenen Zeitraums gibt.

Mitglieds-ID-Quelle

Mitglieds-ID-Quelle teilt Plecto mit, welches System der Datenlieferant ist. Die Mitglieds-ID-Quelle sollte der gleiche Systemname sein, den Sie in der Spalte Data suppliers unter Settings > Employees sehen. Sowohl Mitglieds-ID-Quelle als auch Datenlieferanten beziehen sich auf das gleiche System.

Wenn beide Stellen unterschiedliche Systemnamen haben, erstellt Plecto bei jedem Datenimport neue Mitarbeiter, was zu doppelten Mitarbeiterprofilen führen kann. Daher empfehlen wir, den gleichen Namen für die Mitglieds-ID-Quelle zu verwenden wie den Namen Ihres Datenlieferanten.

SQL-Dateneimport

• Die Abfrage: Schreiben Sie eine SQL-Anweisung, die eine Anzahl von Zeilen zurückgibt, die jeweils einem Eintrag in unserem System entsprechen. Jede Zeile kann eine beliebige Anzahl von Spalten haben, die im Eintrag gespeichert werden.

• Historische Daten: Plecto kann historische Daten einmal importieren. Dann halten wir die Daten aktuell, indem wir alle [x] Minuten importieren, aber nur die Zeilen, die sich geändert haben.

• Importlogs: Sie können alle Importlogs, sowohl automatische als auch manuelle, anzeigen, indem Sie in den Datenquellen-Einstellungen auf die Schaltfläche View logs in der oberen rechten Ecke klicken.

• Neue Daten: Bei jedem Import importiert Plecto alle Daten. Wenn Sie nur die neuen/aktualisierten Daten sehen möchten, können Sie Ihre SQL-Anweisung begrenzen (siehe unten). Durch Begrenzen der Anweisung importiert Plecto nur Zeilen, die sich geändert haben, beispielsweise in den letzten 5 Minuten.

• Rohdaten: Plecto funktioniert am besten, wenn Sie Rohdaten importieren. Das bedeutet, dass eine Zeile ein Element darstellen sollte. Importieren Sie nicht bereits berechnete Metriken. Plecto kann diese Metriken aus den Rohdaten mit Formeln berechnen.

Importlimit für Einträge auf SQL

Plecto begrenzt die Anzahl der Einträge, die pro Abfrage importiert werden können, basierend auf der Update-Häufigkeit.

Manueller Dateneimport

Seit Juli 2022 unterstützen unsere SQL-Integrationen einen manuellen Datenimport.

1. Öffnen Sie die Datenquellen-Einstellungen und klicken Sie auf Import historical data.

2. Wählen Sie Start- und Enddatum und klicken Sie auf Start import.

Beachten Sie, dass Sie, wenn Sie viele historische Daten importieren möchten, den Datenimport in mehrere Sitzungen aufteilen sollten. Wenn Sie viele alte Daten auf einmal importieren, kann die Datenbank den Import möglicherweise nicht abschließen.

Start- und Enddatum werden in der Anweisung enthalten sein. Wenn Sie Start- und Enddatum für den manuellen Datenimport auswählen, werden diese an last_update_time und upper_date_limit in der Vorlage Ihrer Anweisung übergeben.