• Deutsch

      • Doris

      Data source: External DorisEnterprise Edition+

      Einführung

      Doris kann als externe Datenbank an NocoBase angebunden werden. Nach der Anbindung liest NocoBase die Tabellen, Felder und Ansichten aus Doris und verwendet sie als Datentabellen in der externen Datenquelle.

      Doris eignet sich besonders für analytische Abfragen, Detaildaten in breiten Tabellen, Kennzahlen und Berichtsdarstellungen. Im Gegensatz zu transaktionalen Datenbanken eignet sich Doris nicht als Datenquelle für häufiges Anlegen, Bearbeiten und Löschen von Geschäftsdaten in NocoBase.

      KonfigurationselementBeschreibung
      Unterstützte VersionDoris >= 2.1.0.
      Kommerzielle VersionWird von der Enterprise Edition unterstützt.
      Zugehöriges Plugin@nocobase/plugin-data-source-external-doris.
      VerbindungsmethodeVerwendung des MySQL-kompatiblen Ports von Doris, also des FE query_port.
      VerwendungsempfehlungHauptsächlich zum Anzeigen, Filtern, Aggregieren und Darstellen von Berichten.

      Geeignete Einsatzszenarien für eine externe Doris-Datenquelle:

      • Anbindung von Detailtabellen, Aggregationstabellen, breiten Tabellen oder Kennzahlentabellen aus dem Data Warehouse
      • Erstellung von Betriebs-Dashboards, Statistikberichten oder Abfrageseiten in NocoBase
      • Bereitstellung eines schreibgeschützten Abfragezugangs für Fachanwender, um den direkten Zugriff über Datenbank-Clients zu reduzieren
      • Steuerung von Berechtigungen und visuelle Darstellung vorhandener Doris-Daten
      Hinweis

      Doris sollte in NocoBase als schreibgeschützte Analysedatenquelle verwendet werden. Verwenden Sie sie nicht als Datenquelle zum Schreiben in reguläre Geschäftstabellen. Außerdem wird empfohlen, auf Seiten keine Vorgänge zum Anlegen, Bearbeiten oder Löschen zu konfigurieren.

      Plugin installieren

      Dieses Plugin ist ein kommerzielles Plugin. Ausführliche Informationen zur Aktivierung finden Sie unter: Leitfaden zur Aktivierung kommerzieller Plugins

      Datenquelle hinzufügen

      Klicken Sie in der „Datenquellenverwaltung“ auf „Add new“, wählen Sie Doris aus und geben Sie anschließend die Verbindungsinformationen ein. 20260709211333

      Häufig verwendete Verbindungseinstellungen:

      EinstellungBeschreibung
      Data source nameDer Bezeichner der Datenquelle, der zur Referenzierung in Seitenbereichen, Berechtigungen, Workflows und APIs verwendet wird. Nach der Erstellung kann er nicht mehr geändert werden.
      Data source display nameDer in der Benutzeroberfläche angezeigte Name der Datenquelle. Es wird empfohlen, einen für Fachanwender verständlichen Namen zu verwenden, z. B. „Doris Data Warehouse“ oder „Kennzahlen-Datenbank“.
      Host / PortDie Adresse des Doris-FE und der MySQL-kompatible Port, also query_port. Geben Sie nicht den HTTP-Port ein.
      DatabaseDer Name der zu verbindenden Doris-Datenbank.
      Username / PasswordBenutzername und Passwort für die Verbindung mit Doris. NocoBase kann nur auf Objekte zugreifen, für die dieses Konto über Berechtigungen verfügt. Es werden weder Berechtigungen erteilt noch private Objekte anderer Konten gelesen.
      Table prefixPräfix der Tabellennamen. Nach der Konfiguration liest NocoBase nur Tabellen, die diesem Präfix entsprechen, und erstellt in NocoBase Tabellennamen ohne Präfix.
      Enabled the data sourceGibt an, ob diese Datenquelle aktiviert ist. Nach der Deaktivierung bleibt die Konfiguration erhalten, aber Seitenbereiche, Berechtigungen, Workflows und APIs können ihre Daten nicht mehr lesen.
      Hinweis

      Das Doris-Plugin stellt die Verbindung über das MySQL-kompatible Protokoll her. Vergewissern Sie sich vor der Konfiguration, dass query_port des Doris-FE von NocoBase aus erreichbar ist und das Konto über Leseberechtigungen für die Metadaten der Zieldatenbank, -tabellen und -spalten verfügt.

      Umfang der Anbindung

      Die Doris-Seite bietet keine Tabelle zur Auswahl von „Collections“. Der Umfang der Anbindung wird hauptsächlich durch Database, die Berechtigungen des Verbindungskontos und Table prefix gesteuert.

      Wenn Doris viele Tabellen enthält, wird empfohlen, eigens für NocoBase eine Datenbank, ein Konto oder ein Tabellenpräfix einzurichten und nur die Tabellen bereitzustellen, die die aktuelle Anwendung anzeigen und auswerten muss.

      Hinweis

      Eine einzelne externe Datenquelle kann höchstens 500 Datentabellen oder Ansichten gleichzeitig anbinden. Wenn Doris viele Objekte enthält, wird empfohlen, den Umfang zunächst über die Datenbank, Kontoberechtigungen oder Table prefix einzuschränken.

      Synchronisierung und Konfiguration von Feldern

      Die Tabellenstruktur der externen Doris-Datenquelle wird auf Datenbankseite verwaltet. NocoBase erstellt in der externen Doris-Datenbank keine Felder, ändert keine Feldtypen und löscht keine realen Felder.

      Wenn sich die Tabellenstruktur auf Doris-Seite ändert, können Sie in der Datenquelle „Sync from database“ ausführen, um die Tabellen- und Feldmetadaten erneut einzulesen. Die Synchronisierung aktualisiert die in NocoBase gespeicherten Informationen zu Datentabellen, Feldern, Primärschlüsseln, eindeutigen Schlüsseln und Feldtypzuordnungen, löscht jedoch weder reale Tabellen noch Daten in Doris.

      Nach der Synchronisierung der Felder können Sie in NocoBase die Feldtitel, den Feldtyp (Field type) und die Feldkomponente (Field interface) konfigurieren. Wenn Sie NocoBase-Beziehungsfelder erstellen müssen, werden die Beziehungsmetadaten ebenfalls in NocoBase gespeichert. In der Doris-Tabelle wird dabei nicht automatisch ein reales Fremdschlüsselfeld angelegt.

      Feldtypzuordnung

      NocoBase ordnet Doris-Feldtypen anhand der MySQL-Kompatibilitätslogik und der Doris-spezifischen Typen geeigneten Field types und Field interfaces zu. Die Darstellungsweise in der Benutzeroberfläche kann in der Feldkonfiguration angepasst werden.

      Häufige Zuordnungen:

      Doris-FeldtypNocoBase Field typeVerfügbare Field interfaces
      TINYINT、SMALLINTinteger、boolean、sortInteger、Sort、Checkbox、Switch、Select、Radio group。
      INT、INTEGERinteger、unixTimestamp、sortInteger、Sort、Unix timestamp、Select、Radio group。
      BIGINTbigInt、unixTimestamp、sortInteger、Sort、Unix timestamp、Created at、Updated at。
      LARGEINTbigIntInteger。
      FLOATfloat、sortNumber、Percent、Sort。
      DOUBLEdouble、sortNumber、Percent、Sort。
      DECIMAL、DECIMALV3decimalNumber、Percent、Currency。
      BOOLEANbooleanCheckbox、Switch。
      CHARstringInput、Email、Phone。
      VARCHARstring、uuid、nanoid、encryptionInput、Email、Phone、Password、Color、Icon、Select、Radio group、UUID、Nano ID。
      TEXT、STRINGtextTextarea、Markdown、Vditor、Rich text、URL。
      DATE、DATEV2dateDate。
      DATETIME、DATETIMEV2datetimeDate、Time、Created at、Updated at。
      JSON、JSONBjsonJSON。
      HLL、BITMAP、QUANTILE_STATE、AGG_STATEjsonJSON。
      VARIANT、ARRAY、MAP、STRUCTjsonJSON。
      IPV4、IPV6stringInput。

      VARIANT ist ein dynamischer Typ, der ab Apache Doris 2.1.0 bereitgestellt wird. Bei Verwendung einer Doris-Version unter 2.1.0 können Felder dieses Typs nicht angebunden werden.

      Hinweis

      Aggregationsstatus-Typen, semi-strukturierte Typen und komplexe Typen in Doris eignen sich eher zur Anzeige oder Fehlersuche und nicht unbedingt als Eingabefelder in Formularen. Bei komplexen Typen wird empfohlen, auf Doris-Seite geeignete Ansichten oder Detailtabellen für die fachliche Anzeige bereitzustellen und diese anschließend an NocoBase anzubinden.

      Primärschlüssel und eindeutige Datensatzkennung

      Das Datenmodell und das Schlüsselmodell von Doris entsprechen nicht unbedingt der fachlichen eindeutigen Kennung. Für Datentabellen, die in Seitenbereichen angezeigt werden, wird weiterhin empfohlen, ein Feld bereitzustellen, mit dem sich Datensätze eindeutig identifizieren lassen.

      Wenn eine Tabelle oder Ansicht ohne eindeutiges Feld angebunden wird, müssen Sie in der Datenbankkonfiguration manuell „Record unique key“ festlegen. Wenn keine geeignete eindeutige Kennung vorhanden ist, können Seitenbereiche Datensatzdetails möglicherweise nicht korrekt anzeigen und eignen sich nicht für die Konfiguration von Bearbeitungs- oder Löschvorgängen.

      20260709211439 20260709211454