GetTableDDL
Gibt Tabelleninformationen im DDL-Format (Data Definition Language) für eine Liste von Tabellenvorkommen zurück, die als JSON-Array angegeben sind.
Format
GetTableDDL ( TabellenVorkommnisNamen ; FehlerIgnorieren )
Parameter
TabellenVorkommnisNamen – ein Textausdruck für ein JSON-Array mit den zurückzugebenden Tabellenvorkommen.
FehlerIgnorieren – wenn auf Wahr gesetzt, werden DDL-Informationen für die Tabellenvorkommen zurückgegeben, die keinen Fehler verursachen. Falls Falsch, werden DDL-Informationen zurückgegeben, wenn keine Tabellenvorkommen einen Fehler verursachen; andernfalls wird „?“ zurückgegeben, um einen Fehler anzuzeigen und die Tabellenvorkommen, die den Fehler verursacht haben, im KI-Aufruf-Protokoll zu protokollieren (siehe Scriptschritt „KI-Aufruf-Protokollierung festlegen“).
Zurückgegebener Datentyp
Text
Ursprung in Version
21.0
Beschreibung
Diese Funktion gibt eine DDL-Darstellung der angegebenen Tabellenauftreten zurück. Die DDL besteht aus SQL-Befehlen, die zur Definition des Datenbankschemas (Tabellen, Felder und Beziehungen) verwendet werden können. Sie können die von dieser Funktion zurückgebene DDL in einer Anfrage an ein KI-Modell bereitstellen, um SQL-Abfragen zu erstellen, mit denen Sie Ihre FileMaker Pro-Datenbank abfragen können. Genau das tut der SQL-Abfrage in natürlicher Sprache ausführen, der dieselbe Logik wie diese Funktion verwendet, um die DDL zu generieren.
Um die Qualität der von dieser Funktion zurückgegebenen DDL zu verbessern, befolgen Sie die Empfehlungen in Bewährte Methoden für Datenbankschemata bei der Generierung von DDL- und SQL-Abfragen.
Beispiel 1
GetTableDDL ( "[\"Meetings\", \"Themen\"]"; Wahr) gibt für eine FileMaker Pro-Datei mit den Tabellenvorkommen „Meetings“ und „Themen“ Folgendes zurück:
CREATE TABLE "Meetings" (
"Titel" varchar(255),
"Standort" varchar(255),
"Datum" datetime,
"Startzeit" datetime,
"Endzeit" datetime,
"Dauer" varchar(255),
"Notiz" varchar(255),
"Primärschlüssel" varchar(255), /*Eindeutige ID für jeden Datensatz in dieser Tabelle*/
"ErstelltVon" varchar(255), /*Kontoname des Benutzers, der die einzelnen Datensätze erstellt hat*/
"GeändertVon" varchar(255), /*Kontoname des Benutzers, der die einzelnen Datensätze zuletzt geändert hat*/
"Erstellungszeitstempel" datetime, /*Datum und Uhrzeit der Erstellung der einzelnen Datensätze*/
"Änderungszeitstempel" datetime, /*Datum und Uhrzeit der letzten Änderung der einzelnen Datensätze*/
"Notiz_Einbettung" varbinary(4096),
PRIMARY KEY (Primärschlüssel)
);
CREATE TABLE "Themen" (
"Fremdschlüssel" varchar(255), /*Eindeutige ID für jeden Datensatz in der Bezugstabelle*/
"Primärschlüssel" varchar(255), /*Eindeutige ID für jeden Datensatz in dieser Tabelle*/
"GeändertVon" varchar(255), /*Kontoname des Benutzers, der die einzelnen Datensätze zuletzt geändert hat*/
"Änderungszeitstempel" datetime, /*Datum und Uhrzeit der letzten Änderung der einzelnen Datensätze*/
PRIMARY KEY (Primärschlüssel),
FOREIGN KEY (Fremdschlüssel) REFERENCES Meetings(Primärschlüssel)
);
In der Tabelle „Meetings“ wurden keine Feldanmerkungen festgelegt, sodass alle Felder enthalten sind. Bei Feldern mit Kommentaren ist der Text der Kommentare enthalten.
In der Tabelle „Themen“ wurden Feldanmerkungen für vier Felder festgelegt, sodass nur diese Felder zusammen mit ihren Anmerkungen enthalten sind.
Beispiel 2
Aktiviert die KI-Aufruf-Protokollierung und prüft dann für ein Array von Namen von Tabellenauftreten, ob GetTableDDL einen Fehler zurückgibt, wenn der Parameter FehlerIgnorieren auf Falsch gesetzt ist.
KI-Aufruf-Protokollierung festlegen [ Ein ; Dateiname: "ai-call.log" ; Ausführlich: Aus ]
Variable setzen [ $tableDDL ; Wert:
GetTableDDL ( JSONMakeArray ( "Meetings,Mitarbeiter,Kontaktinfo" ; "," ; JSONString ) ;
Falsch ) ]
If [ $tableDDL = "?" ]
Eigenes Dialogfeld anzeigen [ "Ein Fehler ist aufgetreten. Siehe ai-call.log im Dokumente-Ordner". ]
Sonst
Eigenes Dialogfeld anzeigen [ $tableDDL ]
Ende (wenn)