Wie man sich mit einer SQL-Datenbank verbindet
Bevor Sie beginnen
- Überprüfen Sie, ob Ihre Datenbank ordnungsgemäß läuft.
- Stellen Sie sicher, dass Ihre Datenbank von einer öffentlichen IP-Adresse aus erreichbar ist.
- Überprüfen Sie, ob Ihre Datenbank Verbindungen von der Octoboard-IP-Adresse akzeptiert: 173.255.226.233
Um Ihre erste Verbindung zu konfigurieren und ein Widget hinzuzufügen, verwenden Sie die rote Schaltfläche unten rechts und wählen Sie ADD WIDGET aus (wenn Sie Widgets zu einem Bericht hinzufügen, stellen Sie sicher, dass Sie zuerst den BEARBEITEN-Modus eingeben).
Sobald Sie auf ADD WIDGET klicken, gelangen Sie zum Standard-Verbindung-Assistenten. Auf der ersten Seite wählen Sie die Datenbank aus, mit der Sie sich verbinden möchten. Scrollen Sie nach unten, um Ihre bevorzugte Datenbank zu finden. Wählen Sie sie aus und klicken Sie auf WEITER.
Sie werden aufgefordert, Ihre Datenbankverbindungsdetails einzugeben. Das Erstellen einer SQL-Datenbankverbindung ist ein sehr ähnlicher Vorgang für alle unterstützten Datenbanken. In diesem Tutorial verwenden wir Oracle als Beispiel:
Sie werden aufgefordert, Verbindungsdetails für Ihre Datenbank einzugeben. Klicken Sie auf die Schaltfläche "TEST CONNECTION". Octoboard teilt Ihnen mit, ob Ihre Verbindung erfolgreich ist. Klicken Sie auf "APPLY", um den Vorgang abzuschließen.
Sobald Ihre Datenbankverbindung hergestellt ist, können Sie SQL-Abfragen ausführen und Informationen in Datenbank-Widgets anzeigen. Sie können komplexe SQL-Anweisungen erstellen, aber Ihre SELECT-Felder müssen den Anforderungen jedes Widget-Typs entsprechen.
Um mit der Erstellung eines Datenbank-Widgets fortzufahren, klicken Sie bitte auf WEITER im Verbindung-Assistenten.
Der Vorgang zum Hinzufügen von Datenbank-Widgets zu Ihren Dashboards und Berichten wird in diesem Knowledge Base-Tutorial abgedeckt.
Gibt es Einschränkungen oder Anforderungen an SQL-Abfragen?
- Nur SELECT-Anweisungen sind erlaubt.
- Beenden Sie Ihre Abfragen nicht mit einem Semikolon (;).
- Verwenden Sie keine Kommentare in Ihren SQL-Abfragen.
- Spaltenanzahlen sollten dem angeforderten Widget-Typ entsprechen. Dies wird in den vorherigen Absätzen dieses Tutorials behandelt.
- Die Abfrageergebnisse sind auf 1000 Zeilen begrenzt. Dies sollte für die meisten Fälle ausreichend sein. Wenn Sie diese Grenze erreichen, versuchen Sie, Ihre Ausgabe zu optimieren, indem Sie (a) zurückgegebene Datensätze aggregieren (verwenden Sie die GROUPBY-Anweisung) und (b) Daten in absteigender Reihenfolge zurückgeben (verwenden Sie "SORT BY field DESC")
- Abfragen sollten in weniger als 10 Sekunden ausgeführt werden. Nach dieser Zeit werden die Widgets abgebrochen. Wenn dies passiert, versuchen Sie, Ihre Abfragen zu vereinfachen.
Zuerst stellen Sie sicher, dass Ihre Datenbank online erreichbar ist. Führen Sie den folgenden Befehl von einem öffentlichen Computer aus (von einer öffentlichen IP-Adresse, nicht in Ihrem privaten Netzwerk). Ersetzen Sie your_db_host und your_db_port durch den Host und den Port Ihrer Datenbank:
f:Unix OS: nc -v your_db_host your_db_port
f:Windows OS: telnet your_db_host your_db_port
Bitte kontaktieren Sie Ihren Datenbankadministrator und stellen Sie sicher, dass Ihre Datenbank Verbindungen von der folgenden Octoboard IP-Adresse akzeptiert: 173.255.226.233
