TQuery verwenden (Anleitung)

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu So arbeiten Sie mit Datenbanken

TQuery ist eine abfragebasierte Datenmenge, die eine SQL-Anweisung kapselt und es Anwendungen ermöglicht, auf die Ergebnis-Datenmenge zuzugreifen.

So verwenden Sie TQuery:

  1. Wählen Sie Datei > Neu > Weitere. Das Dialogfeld Objektgalerie wird geöffnet.
  2. Wählen Sie im Dialogfeld Objektgalerie die Kategorie Delphi-Projekte, und doppelklicken Sie dann auf VCL-Formularanwendung. Der Designer wird angezeigt.
  3. Verknüpfen Sie die Datenmenge mit einer Datenbank und einer Sitzung.
  4. Erstellen Sie heterogene Abfragen.
  5. Rufen Sie eine bearbeitbare Ergebnismenge ab.
  6. Aktualisieren Sie schreibgeschützte Ergebnismengen.

So verknüpfen Sie eine Datenmenge mit einer Datenbank und einer Sitzung:

  1. Ziehen Sie aus der Kategorie BDE der Tool-Palette eine TDatabase-Komponente in das Formular.
  2. Ziehen Sie eine TSession-Komponente in das Formular.
  3. Weisen Sie die Eigenschaft DatabaseName der TDatabase-Komponente zu, um die Datenbank mit einer BDE-basierten Datenmenge zu verknüpfen. Für die TDatabase-Komponente ist der Datenbankname der Wert der Eigenschaft DatabaseName der Datenbankkomponente.
  4. Wenn Sie mit einer impliziten Datenbankkomponente arbeiten möchten und für die Datenbank ein BDE-Alias definiert wurde, können Sie als Wert für DatabaseName den BDE-Alias angeben.

    Anmerkung:  Ein BDE-Alias steht stellvertretend für eine Datenbank und ihre Konfigurationsinformationen. Diese Konfigurationsinformationen differieren je nach Datenbanktyp (Oracle, Sybase, InterBase, Paradox, dBASE usw.).

  5. Wenn Sie eine implizite Datenbankkomponente für eine Paradox- oder dBASE-Datenbank verwenden möchten, weisen Sie im Objektinspektor der Eigenschaft DatabaseName das Verzeichnis zu, in dem sich die Datenbanktabellen befinden.
  6. Steuern Sie alle Datenbankverbindungen in der Anwendung über die Standardsitzung.
  7. Weisen Sie die Eigenschaft SessionName der TSession-Komponente zu, um die Datenmenge mit einer explizit erstellten Sitzungskomponente zu verknüpfen.

Anmerkung:  Unabhängig davon, ob Sie die Standardsitzung verwenden oder in der Eigenschaft SessionName die zu verwendende Sitzung explizit angeben, können Sie auf die mit einer Datenmenge verknüpfte Sitzung zugreifen, indem Sie den Wert für die Eigenschaft DBSession abrufen. Beachten Sie, dass bei der Verwendung einer Sitzungskomponente der Wert der Eigenschaft SessionName der Datenmenge mit dem Wert der Eigenschaft SessionName der Datenbankkomponente übereinstimmen muss, mit der die Datenmenge verknüpft ist.

So erstellen Sie gemischte Abfragen:

  1. Definieren Sie separate BDE-Aliasnamen für jede Datenbank, auf die in der Abfrage zugegriffen werden soll. Verwenden Sie hierzu das Dienstprogramm zur BDE-Verwaltung oder den SQL-Explorer.
  2. Geben Sie für die Eigenschaft DatabaseName der TQuery-Komponente keinen Wert ein. Die Namen der Datenbanken werden in der SQL-Anweisung angegeben.
  3. Weisen Sie der Eigenschaft SQL die SQL-Anweisung zu, die ausgeführt werden soll.
  4. Stellen Sie jedem Tabellennamen in der Anweisung den BDE-Alias für die Datenbank voran, aus der die Tabelle stammt. Diese Angabe muss in Doppelpunkte eingeschlossen werden.Die gesamte Referenz steht in Anführungszeichen.
  5. Weisen Sie der Eigenschaft Params die Parameter für die Abfrage zu.
  6. Schreiben Sie eine Prepare-Methode, um die Abfrage vor ihrer ersten Ausführung vorzubereiten.
  7. Schreiben Sie eine Open- oder ExecSQL-Methode, je nachdem, zu welchem Typ die auszuführende Abfrage gehört.
  8. In einer gemischten Abfrage können Sie zur Angabe der Datenbank anstelle eines BDE-Alias auch eine TDatabase-Komponente verwenden.
  9. Konfigurieren Sie die TDatabase-Komponente so, dass sie auf die Datenbank zeigt, weisen Sie der Eigenschaft Bde.DBTables.TDatabase DatabaseName einen eindeutigen Wert zu, und verwenden Sie diesen in der SQL-Anweisung anstelle eines BDE-Aliasnamens.

So rufen Sie eine bearbeitbare Ereignismenge ab:

  1. Setzen Sie die Eigenschaft RequestLive der TQuery-Komponente auf True.
  2. Wenn die Abfrage verknüpfte Felder enthält, behandeln Sie die Ergebnismenge als Nur-Lesen-Ergebnismenge und aktualisieren sie.

Wenn eine Anwendung eine bearbeitbare Ergebnismenge anfordert, was aber aufgrund der Syntax der SELECT-Anweisung nicht möglich ist, gibt die BDE bei Abfragen über Paradox- oder dBASE-Tabellen eine Nur-Lesen-Ergebnismenge bzw. bei SQL-Abfragen über einen externen Server einen Fehlercode aus.

So aktualisieren Sie Nur-Lesen-Ergebnismengen:

  1. Wenn sich alle Aktualisierungen auf eine einzige Datenbanktabelle beziehen, können Sie die zugrunde liegende Tabelle in einer Ereignisbehandlungsroutine für OnGetTableName angeben.
  2. Weisen Sie der Eigenschaft UpdateObject der Abfrage das verwendete TUpdateSQL-Objekt zu, um die durchzuführenden Aktualisierungen genauer steuern zu können.
  3. Weisen Sie den Eigenschaften DeleteSQL, InsertSQL und ModifySQL des Aktualisierungsobjekts die SQL-Anweisungen zu, mit denen die entsprechenden Aktualisierungen an den Daten der Abfrage durchgeführt werden.

Wenn Sie die Aktualisierungen mit Hilfe der BDE zwischenspeichern, müssen Sie ein Aktualisierungsobjekt verwenden.

Siehe auch