hilfe · migration
Datenbank sicher zu SQUERY migrieren
Diese Anleitung führt Sie unter Windows von der bestehenden PostgreSQL-Datenbank bis zur geprüften Oberfläche und zum ersten Export. Die Quelldatenbank bleibt dabei unverändert.
Ablauf
Schritt für Schritt
- 01
Node.js vorbereiten
Öffnen Sie PowerShell und prüfen Sie mit node -v, ob mindestens Version 18 installiert ist. Fehlt Node.js, installieren Sie es mit winget install OpenJS.NodeJS.LTS und öffnen PowerShell anschließend neu.
- 02
Agenten-Schlüssel erzeugen
Melden Sie sich bei SQUERY an. Öffnen Sie den Einrichtungsassistenten und erzeugen Sie einen persönlichen Agenten-Schlüssel. Dieser verbindet ausschließlich Ihren lokalen Agenten mit Ihrem Konto.
- 03
Agent herunterladen
Laden Sie squery-agent-v3.mjs herunter, legen Sie einen eigenen Ordner dafür an und führen Sie dort einmalig npm install mssql (oder den Treiber Ihrer Datenbank) aus.
- 04
Nur-Lese-Zugang einrichten
Legen Sie in PostgreSQL einen eigenen Benutzer für SQUERY an. Er benötigt nur CONNECT auf der Datenbank, USAGE auf dem gewünschten Schema und SELECT auf dessen Tabellen und Views.
- 05
Verbindungsdaten einsetzen
Tragen Sie Server, Port, Datenbank, Schema, Benutzer und Passwort in den Assistenten ein. Kopieren Sie danach den erzeugten PowerShell-Block und führen Sie ihn im Agenten-Ordner aus.
- 06
Prüflauf starten
Führen Sie node squery-agent-v3.mjs --check aus. Der Agent kontrolliert Node.js, Datenbanktreiber, Verbindung, Leserechte und die Erreichbarkeit von SQUERY, ohne Daten zu übertragen.
- 07
Ersten Abgleich ausführen
Wenn alle Prüfungen mit [OK] enden, starten Sie node squery-agent-v3.mjs. Schema, Beziehungen und die festgelegte Zahl an Datenzeilen werden an SQUERY übertragen.
- 08
Ergebnis kontrollieren und exportieren
Prüfen Sie den empfangenen Abgleich unter Aktivität. Öffnen Sie anschließend die Datenoberfläche, wählen Sie Tabelle oder View und exportieren Sie die Daten als CSV, JSON, Excel oder SQL beziehungsweise über einen Export-Schlüssel.
FAQ
Häufige Fragen
01Werden meine Datenbank-Zugangsdaten übertragen?+
Nein. Serveradresse, Benutzername und Passwort bleiben als Umgebungsvariablen auf Ihrem Windows-Rechner. Der Agent überträgt nur die gelesenen Schema-Informationen und Datenzeilen.
02Kann SQUERY meine Quelldaten verändern?+
Der empfohlene Datenbankbenutzer besitzt ausschließlich Leserechte. Damit kann der Agent weder Datensätze verändern oder löschen noch Tabellen anlegen.
03Welche Datenbanken werden unterstützt?+
Der lokale Agent ist derzeit für PostgreSQL ausgelegt. Host, Port, Datenbank und Schema können frei angegeben werden, sofern der Windows-Rechner die Datenbank erreichen kann.
04Wie viele Zeilen werden übertragen?+
Standardmäßig werden bis zu 500 Zeilen je Tabelle oder View übertragen. Im Einrichtungsassistenten können Sie diesen Wert über SQUERY_ROWS anpassen.
05Wie halte ich die Daten aktuell?+
Starten Sie den Agenten bei Bedarf erneut oder setzen Sie SQUERY_INTERVAL auf die gewünschte Anzahl Minuten. Der Agent führt dann regelmäßig einen neuen Abgleich aus.
06Was bedeuten [HINWEIS] und [FEHLER] im Prüflauf?+
Ein Hinweis zeigt meist ein Objekt ohne Leserecht, das übersprungen wird. Ein Fehler verhindert den Abgleich. Prüfen Sie dann besonders PostgreSQL-Dienst, Host, Port, Passwort, Firewall und die angezeigten GRANT-Befehle.
07Warum sehe ich noch eine alte Adresse im Agenten-Skript?+
Dann ist noch eine ältere lokale Kopie geöffnet. Laden Sie squery-agent-v3.mjs erneut über den Einrichtungsassistenten herunter und verwenden Sie ausschließlich diese Datei.