Gehostete Zeitreihen-Datenbank

Der Collectu Hub stellt vollständig verwaltete, dedizierte Zeitreihendatenbank-Instanzen bereit, mit denen Sie Ihre Zeitreihendaten speichern und abfragen können, ohne einen eigenen Datenbankserver betreiben zu müssen.

Konzept

Jede Instanz ist eine dedizierte Datenbankbereitstellung, die ausschließlich für Sie oder Ihre Organisation bestimmt ist.

  • Jede Instanz erhält eine eigene Subdomain (z. B. <deployment_name>.tsdb.collectu.de) und ist über den Port 5432 erreichbar.
  • Alle Verbindungen sind TLS-verschlüsselt.
  • Sie authentifizieren sich mit Ihrem Collectu-API-Zugriffstoken als Passwort – es gibt keine separaten Datenbankpasswörter. Gelöschte Token oder entfernte Organisationsmitglieder verlieren sofort den Zugriff.

Jetzt loslegen

  1. Melden Sie sich bei Ihrem Collectu Hub-Profil an und navigieren Sie zu Gehostete Zeitreihen-DB.
  2. Klicken Sie Instanz erstellen.
  3. Erstellen Sie einen API-Zugriffstoken (oder nutzen Sie einen existierenden).
  4. Verbinden Sie sich mithilfe der Verbindungsangaben aus der Instanztabelle mit jedem PostgreSQL-Client.

Verbinden

Nutzen Sie die folgenden Verbindungsparameter:

  • Host: der in der Instanztabelle angegebene Host (z. B. <deployment_name>.tsdb.collectu.de)
  • Port: 5432
  • Datenbank: collectu
  • Benutzername: eine der generischen Rollen admin, readwrite oder read (siehe unten)
  • Passwort: Ihr API-Zugriffstoken
  • SSL-Modues: verify-ca

Beispiel mit psql: psql "host=<deployment_name>.tsdb.collectu.de port=5432 dbname=collectu user=read password=<api access token> sslmode=verify-ca sslrootcert=/etc/ssl/certs/ca-certificates.crt"

Info
Verwenden Sie sslmode=verify-ca (überprüft die Zertifikatskette). verify-full funktioniert nicht, da das Wildcard-Zertifikat die pro-Instanz spezifischen Subdomains nicht abdeckt. Einige Clients (z. B. psql) benötigen zusätzlich einen expliziten Stammzertifikatspeicher über sslrootcert; die meisten Tools (z. B. Grafana oder JDBC-basierte Clients) verwenden den System-Zertifikatsspeicher automatisch.

Rollen

Sie verbinden sich als eine der drei generischen Datenbank-Rollen. The angeforderte Rolle nur gewährt, wenn Ihr API-Zugriffstoken und (bei Organisationen) Ihre Mitgliedschaftsberechtigungen dies zulassen:

  • admin: gehört die Datenbank. Für den Eigentümer selbst oder Organisationsadministratoren mit Berechtigungen zum Erstellen, Bearbeiten und Löschen.
  • readwrite: Vollständiger Lese- und Schreibzugriff, Tabellen können erstellt werden sowie Schemata. Erfordert Berechtigungen zum Erstellen, Bearbeiten und Löschen.
  • read: Lesezugriff (SELECT). Jedes gültige Token des Eigentümers oder eines Mitglieds der Organisation.

Speicherlimit

Jede Instanz hat ein Speicherlimit. Die aktuelle Auslastung und das Limit werden in der Instanztabelle des Collectu Hub angezeigt. Wenn Sie auf eine Instanzzeile klicken, werden zusätzlich die Schemata und Tabellender Datenbank mit ihrer ungefähren Zeilenzahl angezeigt.

Vorsicht
Wenn das Speicherlimit einer Instanz überschritten wird, erhalten Sie eine Meldung und die ältesten Daten werden automatisch gelöscht bis die Größe wieder deutlich unter dem Limit liegt. Achten Sie darauf, alte Daten regelmäßig zu löschen oder zu komprimieren, wenn Sie sich dem Limit nähern.

Queries ausführen

Neben der Verbindung mit einem Datenbank-Client können Sie SQL-Queries direkt über die Collectu Hub-API (POST /tsdb/query) ausführen – beispielsweise aus Skripten oder über die MCP-Integration. Es gilt dieselbe Rollenzuordnungwie bei direkten Datenbankverbindungen.

Beispiel-Queries

  • Alle Schemas auflisten: SELECT schema_name FROM information_schema.schemata;
  • Alle Tabellen mit ihrer Größe auflisten: SELECT schemaname, relname, pg_size_pretty(pg_total_relation_size(relid)) FROM pg_catalog.pg_statio_user_tables;
  • Alle Hypertabellen auflisten: SELECT hypertable_schema, hypertable_name FROM timescaledb_information.hypertables;
  • Ein Schema erstellen (erfordert die admin oder readwrite Rolle): CREATE SCHEMA sensors;
Zurück
Vpn
Weiter
Introduction