Claris FileMaker

ODBC- und JDBC-Handbuch© 2004-2022 Claris International Inc. Alle Rechte vorbehalten.
Claris International Inc.
One Apple Park Way
Cupertino, CA 95014, USA
Claris, Claris Connect, das Claris-Logo, FileMaker, FileMaker Cloud, FileMaker Go, FileMaker Pro, FileMaker Server,
FileMaker WebDirect und das Dateiordner-Logo sind Marken von Claris International Inc., eingetragen in den USA und anderen Ländern.
Alle anderen Marken sind Eigentum der jeweiligen Inhaber.
Die Claris-Produktdokumentation ist urheberrechtlich geschützt. Sie dürfen diese Dokumentation ohne schriftliche Genehmigung vonClaris weder vervielfältigen noch verteilen. Diese Dokumentation darf ausschließlich mit einer gültigen, lizenzierten Kopie der ClarisSoftware verwendet werden.
Alle in den Beispielen erwähnten Personen, Firmen, E-Mail-Adressen und URLs sind rein fiktiv und jegliche Ähnlichkeit mit bestehenden
Personen, Firmen, E-Mail-Adressen und URLs ist rein zufällig. Produktdanksagungen sind in den Acknowledgments-Dokumenten
aufgeführt, die mit dieser Software geliefert werden. Dokumentdanksagungen sind in den Acknowledgments-Dokumenten für
Dokumentation aufgeführt. Die Erwähnung von Produkten und URLs Dritter dient nur zur Information und stellt keine Empfehlung dar.
Claris International Inc. übernimmt keine Verantwortung für die Leistung dieser Produkte.
Weitere Informationen finden Sie auf unserer Website.
Edition: Januar 2022

Inhalt
Kapitel 1
EinführungÜber dieses Handbuch
Speicherort der FileMaker-ProduktdokumentationÜbersicht zu ODBC und JDBCVerwenden von FileMaker-Software als ODBC-Client-Anwendung
Importieren von ODBC-Daten
Hinzufügen von ODBC-Tabellen zum Beziehungsdiagramm
Verwenden einer FileMaker Pro-Datenbank als Datenquelle
Zugreifen auf eine bereitgestellte FileMaker Pro-Datenbank
Einschränkungen bei Verwendung von Tools Dritter
NetzwerkanforderungenAktualisieren von Dateien aus früheren Versionen

Kapitel 2
Zugreifen auf externe SQL-Datenquellen
Importieren von ODBC-Daten
Ausführen von SQL zur Interaktion mit Datenquellen über ODBC
Arbeiten mit ODBC-Tabellen im Beziehungsdiagramm
Unterstützte Datenquellen
Hinzufügen von ODBC-Tabellen zum Beziehungsdiagramm

Kapitel 3
Installation der FileMaker ODBC-Client-Treiber
Hardware- und Software-Anforderungen
NetzwerkanforderungenÜberblick über die ODBC-Client-Treiber-Architektur (Windows)
ODBC-Client-Treiber-Installation (Windows)
Konfigurieren der Client-Treiber (Windows)Öffnen des ODBC-Administrators (Windows)
Konfigurieren des Datenquellennamens (Windows)
ODBC-Client-Treiber-Installation (macOS)
Konfigurieren der Client-Treiber (macOS)
Die nächsten Schritte

Kapitel 4
Verwenden von ODBC zur gemeinsamen Nutzung von FileMaker-Daten
Informationen zu ODBCVerwenden des ODBC-Client-TreibersÜbersicht über den Zugriff auf eine FileMaker Pro-Datenbankdatei
Zugreifen auf eine FileMaker Pro-Datenbankdatei von einer Windows-Anwendung aus
Festlegen der ODBC-Client-Treibereigenschaften für einen FileMakerDatenquellennamen (Windows)Überprüfen des Zugriffs über ODBC (Windows)

5
5
5
5
6
6
7
7
7
8
8
8

9
9
10
11
11
11

12
12
12
12
12
13
13
14
16
16
18

19
19
20
20
21
21
21

4

InhaltZugreifen auf eine FileMaker Pro-Datenbankdatei von einer macOS-Anwendung aus
Festlegen der ODBC-Client-Treibereigenschaften für einen FileMaker-DSN (macOS)Überprüfen des Zugriffs über ODBC (macOS)

Kapitel 5
Installieren des FileMaker JDBC-Client-Treibers
Software-Anforderungen
Netzwerkanforderungen
JDBC-Client-Treiber-Installation
Verwenden des JDBC-Client-Treibers

22
22
22

24
24
24
24
25

Kapitel 6
Verwenden von JDBC zur gemeinsamen Nutzung von FileMaker-Daten

26

Informationen zu JDBCVerwenden des JDBC-Client-Treibers
Erläuterung des JDBC-Client-Treibers
Herstellen einer Verbindung zu Ihrer Datenbank mit einer JDBC-URL
Angeben von Treibereigenschaften im URL-Subnamen
Angeben eines SocketTimeout-Werts
Lösungen mit mehreren FileMaker Pro-DatenbankdateienÜberprüfen des Zugriffs über JDBC

26
26
27
27
30
30
31
31

Kapitel 7
Referenzinformationen
ODBC-Katalogfunktionen
JDBC-DatabaseMetaData-Methoden
Zuordnen von FileMaker Pro-Feldern zu ODBC-Datentypen
Zuordnen von FileMaker Pro-Feldern zu JDBC-Datentypen
Datentypen in 64-Bit-Anwendungen
ODBC- und JDBC-Fehlermeldungen
ODBC-Fehlermeldungen
JDBC-Fehlermeldungen

Index

32
32
32
32
33
33
33
33
34
35

Kapitel 1
Einführung
Dieses Handbuch beschreibt, wie Sie Claris® FileMaker®-Software als ODBC-Client-Anwendung
und als Datenquelle für ODBC- (Open Database Connectivity-) und JDBC- (Java Database
Connectivity-) Anwendungen verwenden können.

Über dieses Handbuch
Dieses Handbuch setzt voraus, dass Sie mit den Grundlagen der Verwendung von ODBC und
JDBC und der Erstellung von SQL-Abfragen vertraut sind. Dieses Handbuch beschreibt die SQLAnweisungen und -Standards, die die Claris FileMaker-Plattform unterstützt. Informationen zum
Aufbau von SQL-Abfragen finden Sie in Büchern von Fremdanbietern.

Speicherort der FileMaker-Produktdokumentation
Wenn Sie FileMaker-Produktdokumentation anzeigen oder herunterladen oder sich über die
Dokumentation informieren möchten, besuchen Sie die Produktdokumentation.

Übersicht zu ODBC und JDBCODBC und JDBC sind Schnittstellen zur Programmierung von Anwendungen (APIs). ODBC ist ein
API für Anwendungen, die in der Programmiersprache C erstellt wurden, und JDBC ist ein
vergleichbares API für Java. Diese APIs geben Client-Anwendungen eine gemeinsame Sprache
für die Interaktion mit einer Vielzahl von Datenquellen und Datenbankdiensten, einschließlich
Claris FileMaker Pro® und Claris FileMaker Server®.
Alle Anwendungen, die ODBC und JDBC unterstützen, erkennen eine gemeinsame Untergruppe
von SQL-Anweisungen (Structured Query Language). Wenn Sie mit SQL arbeiten, können Sie
andere Anwendungen (wie Tabellenkalkulationen, Textverarbeitungsprogramme und BerichtTools) verwenden, um Daten anzuzeigen, zu analysieren und zu bearbeiten.
Bei Verwendung von ODBC- oder JDBC-APIs kommuniziert eine Client-Anwendung mit einem
Treibermanager, der den Client-Treiber identifiziert, um mit einer Datenquelle zu kommunizieren.
ClientAnwendung

TreiberManager

ClientTreiber

Datenquelle

Manche FileMaker-Software kann entweder als Client-Anwendung oder als Datenquelle
fungieren.

Kapitel 1 | Einführung

6

Die folgende Tabelle bietet eine Übersicht über die Verwendungsweise von ODBC und JDBC mit
FileMaker-Software.
Was wollen Sie erledigen? Wie wollen Sie vorgehen? Produkt

Siehe

1 Verwenden von

1 FileMaker Pro
1 FileMaker Server
1 Claris FileMaker Cloud®

1 Dieses Handbuch,

1 ODBC und JDBC

1 FileMaker Pro
1 FileMaker Server

1 Dieses Handbuch,

1 SQL-Abfragen

1 FileMaker Pro
1 FileMaker Server

1 FileMaker SQL-

FileMaker-Software als
ODBC-ClientAnwendung

1 Zugriff auf ODBC-Daten,
die in einer externen
SQL-Datenquellegespeichert sind

1 Verwenden einer

FileMaker-Datenbank als
Datenquelle

1 Interaktiv über das

Beziehungsdiagramm

1 Einmalig statisch per

ODBC-Import oder Datei(Windows) bzw. Ablage(macOS) > Öffnen.
Außerdem der
Scriptschritt „Datensätze
importieren“, derScriptschritt „SQL
ausführen“ und die
Funktion „SQLAusführen“

Kapitel 2

1 FileMaker Pro Hilfe

Kapitel 3 bis 6

1 Gemeinsame Nutzung

von FileMaker Pro-Daten
mit einer ODBC-ClientAnwendung eines
anderen Anbieters

1 Verwenden einer

FileMaker-Datenbank als
Datenquelle

Referenzhandbuch

1 Gemeinsame Nutzung

von FileMaker Pro-Daten
mit einer ODBC-ClientAnwendung eines
anderen Anbieters

Verwenden von FileMaker-Software als ODBC-Client-Anwendung
Als ODBC-Client-Anwendung kann FileMaker-Software auf Daten in externen SQL-Datenquellenzugreifen. FileMaker-Software stellt mittels des Client-Treibers für die ODBC-Datenquelle eine
Verbindung zu der externen SQL-Datenquelle her und importiert ODBC-Daten oder arbeitet mit
ODBC-Tabellen im Beziehungsdiagramm.

Importieren von ODBC-Daten
Sie können ODBC-Daten auf eine der folgenden Arten importieren:

1 Über das Menü „Datei“ bzw. „Ablage“, indem Sie eine ODBC-Datenquelle angeben und SQLAnweisungen in das FileMaker Pro-Dialogfeld für die SQL Abfrage-Erstellung eingeben

1 Indem Sie ein FileMaker-Script erstellen, das den Scriptbefehl „Datensätze importieren“ oder
„SQL ausführen“ verwendet

Für beide Methoden geben Sie die SQL-Anweisungen selbst ein, also müssen Sie die
unterstützten SQL-Anweisungen und deren Syntax für Ihre ODBC-Datenquelle kennen. Und da
Sie die SQL-Anweisungen selbst schreiben, können Sie ODBC-Daten von jeder ODBCDatenquelle importieren. Weitere Informationen über SQL-Anweisungen und die von der Claris
FileMaker-Plattform unterstützte Syntax finden Sie im FileMaker SQL-Referenzhandbuch.

Kapitel 1 | Einführung

7

Hinzufügen von ODBC-Tabellen zum Beziehungsdiagramm
Wenn Sie dem Beziehungsdiagramm eine ODBC-Tabelle hinzufügen, können Sie eine
Verbindung zu externen Datenquellen herstellen und mit den dort enthaltenen Daten arbeiten,ähnlich wie Sie mit Daten in der aktuellen, aktiven FileMaker Pro-Datei arbeiten. Sie können
beispielsweise:

1 Tabellen für ODBC-Datenquellen im Beziehungsdiagramm erstellen.
1 ODBC-Tabellen Ergänzungsfelder hinzufügen, um ungespeicherte Berechnungendurchzuführen oder Daten der ODBC-Tabellen auszuwerten.

1 externe Daten interaktiv hinzufügen, ändern und löschen.
1 Beziehungen zwischen Feldern in FileMaker-Tabellen und Feldern (so genannten „Spalten“) in
ODBC-Tabellen erstellen.

Da FileMaker Pro die SQL-Anweisungen generiert, um mit einer anderen ODBC-Tabelle zu
kommunizieren, die dem Beziehungsdiagramm hinzugefügt wurde, sind Sie auf die angegebenen
Oracle-, SQL Server- und MySQL-Datenquellen beschränkt, die FileMaker Pro im
Beziehungsdiagramm unterstützt.
Hinweis Sie können das Schema externer ODBC-Datenquellen mit FileMaker Pro nicht ändern.
Kapitel 2, „Zugreifen auf externe SQL-Datenquellen“ beschreibt, wie Sie FileMaker-Software als
ODBC-Client-Anwendung verwenden.

Verwenden einer FileMaker Pro-Datenbank als Datenquelle
Als Datenquelle werden FileMaker-Daten mit ODBC- und JDBC-fähigen Anwendungengemeinsam genutzt. Die Anwendung stellt unter Verwendung des FileMaker-Client-Treibers eine
Verbindung zur FileMaker-Datenquelle her, erstellt und führt die SQL-Abfragen mittels ODBC oder
JDBC aus und verarbeitet die aus der FileMaker Pro-Datenbanklösung abgerufenen Daten.
Hinweis Die Verwendung von FileMaker Pro-Datenbanken als Datenquelle wird fürDatenbanken, die von FileMaker Cloud bereitgestellt werden, nicht unterstützt.

Zugreifen auf eine bereitgestellte FileMaker Pro-Datenbank
Sie können FileMaker Server oder FileMaker Pro verwenden, um eine FileMaker ProDatenbankdatei als Datenquelle bereitzustellen und Ihre Daten mit anderen Anwendungenauszutauschen, die ODBC und JDBC verwenden. Die folgende Tabelle beschreibt, welche
Funktionen die einzelnen FileMaker-Produkte unterstützen.
Dieses FileMaker-Produkt unterstützt
FileMaker Server

Unbegrenzte Verbindungen, lokale Zugriffe (auf demselben Computer) und RemoteZugriffe (sowohl für Middleware wie Web-Server als auch für den Remote-Client-Zugriffüber Desktop-Anwendungen)

FileMaker Pro

Bis zu fünf Verbindungen und nur den lokalen Zugriff (auf demselben Computer)

Wenn Ihre FileMaker Pro-Datenbanklösung mehr als eine FileMaker Pro-Datenbankdatei
verwendet, müssen sich alle Datenbankdateien auf dem gleichen Computer befinden.
Um auf eine bereitgestellte FileMaker Pro-Datenbankdatei zuzugreifen, müssen Sie die
entsprechenden ODBC- oder JDBC-Client-Treiber installieren. Installieren Sie den Client-Treiber
auf dem Rechner, auf dem auch die Anwendung des Drittherstellers installiert ist.

Kapitel 1 | Einführung

8

Dieses Handbuch dokumentiert, wie die ODBC- und JDBC-Client-Treiber bei Verwendung mit
FileMaker Pro und FileMaker Server den Industriestandard für ODBC und JDBC unterstützen.
Weitere Informationen über die von ODBC- und JDBC-Client-Treibern unterstützten SQLAnweisungen bei der Verwendung mit FileMaker Pro und FileMaker Server finden Sie im
FileMaker SQL-Referenzhandbuch.
Wichtig Wenn Sie ODBC/JDBC-Sharing deaktivieren, nachdem es bereits aktiviert war, stehen
von FileMaker Server oder FileMaker Pro zur Verfügung gestellte Daten ab dem Zeitpunkt der
Deaktivierung nicht mehr zur Verfügung. Der Datenbankadministrator kann ODBC- und JDBCClient-Anwendungen nicht über die Verfügbarkeit der Datenquelle unterrichten (der Administrator
kann nur mit Clients von FileMaker Pro-Datenbankdateien kommunizieren). Es werden keine
Fehler gemeldet und die Client-Anwendung sollte Benutzern mitteilen, dass die Datenquelle nicht
verfügbar ist und Transaktionen nicht beendet werden können. Falls eine Client-Anwendung eine
Verbindung zu einer nicht verfügbaren FileMaker Pro-Datenbankdatei herstellen möchte, wird das
Fehlschlagen der Verbindung durch eine Meldung angezeigt.

Einschränkungen bei Verwendung von Tools Dritter
Microsoft Access: Wenn Sie Microsoft Access verwenden, um Daten in einer FileMakerDatenquelle anzuzeigen, verwenden Sie nicht die Daten aus einem Statistikfeld. Die Daten desStatistikfelds dürfen nicht in Microsoft Access bearbeitet werden und der in Microsoft Accessangezeigte Datenwert könnte auch falsch sein.

NetzwerkanforderungenSie benötigen ein TCP/IP-Netzwerk, um mithilfe von FileMaker Server eine FileMaker ProDatenbankdatei über ein Netzwerk als Datenquelle bereitzustellen. FileMaker Pro unterstützt nur
den lokalen Zugriff (auf demselben Computer).

Aktualisieren von Dateien aus früheren Versionen
Wenn Sie einen Treiber von früheren Versionen von FileMaker Pro oder FileMaker Server
installiert haben, müssen Sie den Treiber für die aktuelle Version installieren. Der Treiber deraktuellen FileMaker-Software-Version ist nicht mit früheren Versionen kompatibel.
Weitere Informationen hierzu finden Sie unter Kapitel 3, „Installation der FileMaker ODBC-ClientTreiber“, und Kapitel 5, „Installieren des FileMaker JDBC-Client-Treibers“.
Hinweise

1 Sie müssen für jede FileMaker Pro-Datenbankdatei, auf die Sie als Datenquelle zugreifen

möchten, einen eigenen Datenquellennamen erstellen. Falls Sie den Zugriff vorher über eineneinzelnen Datenquellennamen eingerichtet haben, der es ermöglicht, Tabellen auf mehrere
FileMaker Pro-Datenbankdateien zu verteilen, müssen Sie diese Tabellen jetzt in einer
einzigen Datenbankdatei zusammenfassen (oder mehrere Datenquellennamen erstellen).

1 Informationen über die Verwendung von ODBC und JDBC mit früheren Versionen von
FileMaker Pro finden Sie in der Produktdokumentation.

Kapitel 2
Zugreifen auf externe SQL-Datenquellen
Als ODBC-Client-Anwendung kann FileMaker-Software auf Daten in externen SQL-Datenquellenzugreifen. FileMaker-Software stellt mittels des Client-Treibers für die ODBC-Datenquelle eine
Verbindung zu der externen SQL-Datenquelle her und importiert ODBC-Daten oder arbeitet mit
ODBC-Tabellen im Beziehungsdiagramm.
Ob Sie ODBC-Daten importieren oder mit ODBC-Tabellen im Beziehungsdiagramm arbeiten, Sie
müssen einen Treiber für die verwendete ODBC-Datenquelle konfigurieren. Um z. B. auf
Datensätze aus einer Oracle-Datenbank zuzugreifen, konfigurieren Sie einen Oracle-ClientTreiber.

Importieren von ODBC-Daten
Wenn Sie ODBC-Daten importieren, benötigen Sie einen ODBC-Client-Treiber für die auf dem
Client-Rechner konfigurierte externe SQL-Datenquelle.

FileMaker Pro

TreiberManager

ClientTreiber

SQL-Datenquelle

Nach der Konfiguration eines ODBC-Client-Treibers können Sie mit Datensätzen interagieren,
Datensätze in eine bestehende FileMaker Pro-Datenbankdatei importieren oder eine neue
FileMaker Pro-Datenbankdatei aus einer ODBC-Datenquelle (z. B. Oracle- oder Microsoft
Access-Datenbanken) erstellen.
Zuerst greifen Sie auf die Datenquelle zu, aus der Sie importieren wollen. Dann konstruieren Sieeine Abfrage für die Datensätze, die Sie aus der Datenquelle importieren wollen. Wenn Sie Datenin eine bestehende Datei importieren, ordnen Sie schließlich Felder aus Ihrer Datenquelle den
Feldern in Ihrer FileMaker Pro-Datenbankdatei zu.
Sie können über das Menü „Datei“ bzw. „Ablage“, über den Scriptschritt „Datensätze importieren“oder den Scriptschritt „SQL ausführen“ auf Ihre ODBC-Datenquelle zugreifen.
Um ODBC-Daten zu importieren, gehen Sie wie folgt vor:
1. Installieren und konfigurieren Sie spezifische ODBC-Treiber für die externen Datenquellen, auf
die Sie zugreifen wollen.
2. Definieren Sie auf dem Computer, der den ODBC-Import ausführen wird, einen System-DSN
für jede ODBC-Datenquelle, auf die Sie zugreifen wollen.
3. Legen Sie Optionen für die ODBC-Datenquellen fest, auf die Sie zugreifen wollen (zumBeispiel, ob Benutzer nach einem Benutzernamen und einem Passwort gefragt werden).

Kapitel 2 | Zugreifen auf externe SQL-Datenquellen10

4. Führen Sie in FileMaker Pro einen der folgenden Schritte aus:

1 Um in eine bestehende FileMaker Pro-Datei zu importieren, wählen Sie Datei (Windows)
bzw. Ablage (macOS) > Datensätze importieren > ODBC-Datenquelle.

1 Um eine FileMaker Pro-Datei aus den Datensätzen der Datenquelle anzulegen, wählen Sie
Datei (Windows) bzw. Ablage (macOS) > Öffnen. Wählen Sie dann ODBC-Datenquelle
für Dateityp (Windows) bzw. Anzeigen (macOS).

5. Wählen Sie Ihre Datenquelle, geben Sie Benutzername und Passwort (falls erforderlich) ein
und klicken Sie auf OK, um das Dialogfeld „FileMaker Pro SQL Abfrage-Erstellung“ zu öffnen.
6. Über das Dialogfeld „FileMaker Pro SQL Abfrage-Erstellung“ können Sie eine Abfrage
aufbauen. Wählen Sie die Tabelle, aus der Sie importieren möchten, und wählen Sie dannbestimmte Spalten, die Sie in Ihrer SQL-Abfrage verwenden möchten. Verwenden Sie das
WHERE-Register, um Suchkriterien aufzubauen, und das ORDER BY-Register, um eine
Sortierfolge anzugeben.
Sie können eine SQL-Anweisung auch direkt in das Feld „SQL-Abfrage“ schreiben.
Sie können die Abfrage direkt ausführen oder Sie können die Scriptschritte „Datensätze
importieren“ oder „SQL ausführen“ verwenden, um eine Abfrage als Teil eines FileMakerScripts auszuführen.
Hinweis ODBC-Import, der Scriptschritt „SQL ausführen“ und externe SQL-Datenquellen
werden nicht in Runtime-Lösungen unterstützt, die mit FileMaker Pro erstellt wurden.
Weitere Informationen zum Importieren von Daten, dem Verwenden des Dialogfelds zum
Erstellen von SQL-Abfragen und der Erstellung von FileMaker-Scripts finden Sie in der FileMaker
Pro Hilfe. Weitere Informationen über SQL-Anweisungen und die von der FileMaker-Plattform
unterstützte Syntax finden Sie im FileMaker SQL-Referenzhandbuch.

Ausführen von SQL zur Interaktion mit Datenquellen über ODBC
Zusätzlich zum Importieren von Daten in eine FileMaker Pro-Datenbankdatei über ODBC können
Sie mit Datenquellen über SQL-Anweisungen über den Scriptschritt „SQL ausführen“ oder die
Funktion „SQLAusführen“ arbeiten. Der Scriptschritt „SQL ausführen“ kann eine beliebige SQLAnweisung verwenden, die von der Datenquelle unterstützt wird, z. B. INSERT, UPDATE und
DELETE. Die Funktion „SQLAusführen“ unterstützt nur die Anweisung SELECT.

Sie können auch SQL-Anweisungen nutzen, die über den einfachen Datenimport in eine
FileMaker Pro-Datenbankdatei hinausgehen. Sie können z. B. SQL-Anweisungen ausführen, dieeiner Datenbanktabelle in SQL Server Datensätze mit Informationen aus einer FileMaker ProDatenbankdatei hinzufügen.
Weitere Informationen über das Erstellen von FileMaker-Scripts, die den Scriptschritt „SQL
ausführen“ und die Funktion „SQLAusführen“ verwenden, finden Sie in der FileMaker Pro Hilfe.
Weitere Informationen über SQL-Anweisungen und die von der FileMaker-Plattform unterstützte
Syntax finden Sie im FileMaker SQL-Referenzhandbuch.

Kapitel 2 | Zugreifen auf externe SQL-Datenquellen

11Arbeiten mit ODBC-Tabellen im Beziehungsdiagramm
Wenn Sie dem Beziehungsdiagramm eine ODBC-Tabelle hinzufügen, können Sie eine
Verbindung zu externen Datenquellen herstellen und mit den dort enthaltenen Daten arbeiten,ähnlich wie Sie mit Daten in der aktuellen, aktiven FileMaker Pro-Datei arbeiten.
Wenn Sie FileMaker Pro, FileMaker Server oder FileMaker Cloud als Host für eine Lösung
verwenden, die ODBC-Tabellen im Beziehungsdiagramm enthält, konfigurieren Sie den ODBCClient-Treiber für die externe SQL-Datenquelle auf dem Host-Rechner.
FileMaker ProBenutzer

FileMaker ProBenutzer

FileMaker Pro-,
Server- oder
Cloud-ProduktHost

TreiberManager

ClientTreiber

SQL-Datenquelle

FileMaker ProBenutzer

Unterstützte Datenquellen
Als ODBC-Client-Anwendung unterstützt FileMaker Pro externe SQL-Datenquellen wie Oracle,
Microsoft SQL Server und MySQL Community Edition als ODBC-Tabellen im Beziehungsdiagramm.
Informationen über die unterstützten externen SQL-Datenquellen finden Sie in der Knowledge Base.

Hinzufügen von ODBC-Tabellen zum Beziehungsdiagramm
So richten Sie eine FileMaker Pro-Datenbank für den Zugriff auf Daten in unterstützten ODBCDatenquellen ein:
1. Installieren und konfigurieren Sie spezifische ODBC-Treiber für die externen Datenquellen, auf
die Sie zugreifen wollen.
2. Definieren Sie auf dem Computer, der die aktuelle FileMaker Pro-Datei bereitstellt, einen
System-DSN für jede ODBC-Datenquelle, auf die Sie zugreifen wollen.
3. Legen Sie Optionen für die ODBC-Datenquellen fest, auf die Sie zugreifen wollen (zumBeispiel, ob Benutzer nach einem Benutzernamen und einem Passwort gefragt werden).
4. Fügen Sie dem Beziehungsdiagramm in der aktuellen FileMaker Pro-Datei eine oder mehrere
Tabellen aus der ODBC-Datenquelle hinzu.
5. Fügen Sie den Layouts in der FileMaker Pro-Datei Felder hinzu, um externe Daten anzuzeigen.
6. Fügen Sie externen Tabellen und Layouts optional Ergänzungsfelder hinzu, um Formel- und
Statistikergebnisse basierend auf Daten anzuzeigen, die in externen ODBC-Datenquellengespeichert sind.
Detaillierte Schritte und weitere Informationen über die Konfiguration eines ODBC-Client-Treibers, die
Verbindung zu ODBC-Datenquellen, das Bearbeiten von ODBC-Datenquellen und das Einrichten
einer ODBC-Tabelle in einem Beziehungsdiagramm finden Sie in der FileMaker Pro Hilfe.

Kapitel 3
Installation der FileMaker ODBC-Client-Treiber
Um auf eine bereitgestellte FileMaker Pro-Datenbankdatei als ODBC-Datenquelle zuzugreifen,
müssen Sie den ODBC-Client-Treiber installieren. Diese Anweisungen helfen Ihnen bei derInstallation des ODBC-Client-Treibers für den Zugriff auf FileMaker-Daten von Anwendungen
Dritter und eigenen Anwendungen über ODBC. Installieren Sie den Client-Treiber auf dem
Rechner, auf dem auch die Anwendung des Drittherstellers installiert ist.
Der ODBC-Client-Treiber steht, wie nachfolgend beschrieben, über ein eigenes
Installationsprogramm auf dem FileMaker-Produkt-Installationsdatenträger oder imelektronischen Download im Ordner „xDBC“ zur Verfügung.
Suchen Sie auf der Seite Downloads und Ressourcen nach Updates für die Client-Treiber.
Falls Sie eine FileMaker Pro-Datenbankdatei mithilfe von FileMaker Server bereitstellen, müssen
Sie den Remote-Anwendern die Client-Treiber zur Verfügung stellen.
Nach Installation des benötigten Client-Treibers können Sie den Treiber konfigurieren, um auf
FileMaker-Daten zuzugreifen und SQL-Abfragen für die Arbeit mit Daten aufzubauen.

Hardware- und Software-Anforderungen
Um die ODBC-Client-Treiber zu installieren und zu verwenden, müssen die in den
Systemanforderungen beschriebenen Mindestanforderungen an Hard- und Software erfüllt sein:

NetzwerkanforderungenWenn Sie auf eine FileMaker-Datenquelle zugreifen werden, die auf einem anderen Computer
bereitgestellt wird, benötigen Sie einen Netzwerkzugriff über TCP/IP.

Überblick über die ODBC-Client-Treiber-Architektur (Windows)
FileMaker-Software liefert 32- und 64-Bit-Client-Treiber für Windows mit, um sowohl 32- als auch
64-Bit-ODBC-Anwendungen zu unterstützen.
Sie müssen den Client-Treiber installieren, der Ihrer ODBC-Anwendung, nicht Ihrem
Betriebssystem entspricht.

1 Wenn Ihre ODBC-Anwendung eine 32-Bit-Anwendung ist, dann installieren Sie den 32-BitClient-Treiber.

1 Wenn Ihre ODBC-Anwendung eine 64-Bit-Anwendung ist, dann installieren Sie den 64-BitClient-Treiber.

ODBC-Client-Treiber-Installation (Windows)
Windows 32-Bit- und 64-Bit-Client-Treiber werden als separate Libraries installiert. Auf einer
32-Bit-Version des Windows-Betriebssystems können Sie nur den 32-Bit-Client-Treiber
installieren. Auf einer 64-Bit-Version des Windows-Betriebssystems können Sie sowohl den
32-Bit- als auch den 64-Bit-Client-Treiber installieren.

Kapitel 3 | Installation der FileMaker ODBC-Client-Treiber

13

So installieren Sie den ODBC-Client-Treiber:
1. Sie haben folgende Möglichkeiten:

1 Wenn Sie Ihre Software elektronisch erhalten haben, doppelklicken Sie auf das
Installationssymbol (.exe-Datei).

1 Wenn Sie über eine Installationsdiskette verfügen, legen Sie die Diskette in das Laufwerk ein.
2. Doppelklicken Sie im FileMaker Pro- oder FileMaker Server-Fenster auf den Ordner „Extras“.
3. Doppelklicken Sie auf den Ordner „xDBC“.
4. Doppelklicken Sie im Ordner xDBC auf den Ordner „ODBC Client Driver Installer“.
5. Doppelklicken Sie im ODBC-Client-Treiber-Installationsordner auf die
Installationsprogrammdatei für den Treiber, den Sie installieren möchten.

1 Um den 32-Bit-Client-Treiber (fmodbc32.dll) zu installieren, verwenden Sie die 32-BitInstallationsprogrammdatei: FMODBC_Installer_Win32.msi

1 Um den 64-Bit-Client-Treiber (fmodbc64.dll) zu installieren, verwenden Sie die 64-BitInstallationsprogrammdatei: FMODBC_Installer_Win64.msi

6. Installieren Sie den ODBC-Client-Treiber, indem Sie den Bildschirmanweisungen folgen.
7. Wenn die Installation abgeschlossen ist, klicken Sie auf Schließen.
Standardmäßig wird der ODBC-Client-Treiber in diesem Ordner installiert:

1 Auf einem 32-Bit-Windows-Betriebssystem wird der 32-Bit-Client-Treiber (fmodbc32.dll) im
Ordner C:\Windows\System32 installiert.

1 Auf einem 64-Bit-Windows-Betriebssystem wird der 32-Bit-Client-Treiber (fmodbc32.dll) im
Ordner C:\Windows\SysWOW64 installiert.

1 Auf einem 64-Bit-Windows-Betriebssystem wird der 64-Bit-Client-Treiber (fmodbc64.dll) im
Ordner C:\Windows\System32 installiert.

Der ODBC-Client-Treiber FileMaker ODBC steht jetzt für die Konfiguration für den Zugriff auf
FileMaker-Daten bereit.

Konfigurieren der Client-Treiber (Windows)
Bevor Sie eine ODBC-Client-Anwendung verwenden können, um auf FileMaker-Datenzuzugreifen, müssen Sie einen Client-Treiber für die Datenquelle konfigurieren. Die
Konfigurationseinstellungen identifizieren den verwendeten Client-Treiber, den Speicherort derDatenquelle und Details zur Verbindung.
Wichtig Wenn Sie einen FileMaker-Client-Treiber verwenden, müssen Sie Port 2399 reservieren.

Öffnen des ODBC-Administrators (Windows)
Um den ODBC-Administrator zu öffnen, verwenden Sie die Systemsteuerung Verwaltung in derKategorie System und Sicherheit.
So öffnen Sie den 32-Bit-ODBC-Administrator auf einem 32-Bit-Windows-Betriebssystem:Öffnen Sie in der Windows-Systemsteuerung Verwaltung > Datenquellen (ODBC).

Kapitel 3 | Installation der FileMaker ODBC-Client-Treiber

14

So öffnen Sie den 32-Bit-ODBC-Administrator auf einem 64-Bit-Windows-Betriebssystem:Öffnen Sie in der Windows-Systemsteuerung Verwaltung > ODBC-Datenquellen (32-Bit).
So öffnen Sie den 64-Bit-ODBC-Administrator auf einem 64-Bit-Windows-Betriebssystem:Öffnen Sie in der Windows-Systemsteuerung Verwaltung > ODBC-Datenquellen (64-Bit).

Konfigurieren des Datenquellennamens (Windows)
So konfigurieren Sie den ODBC-Client-Treiber:
1. Wählen Sie im ODBC Data Source Administrator das Register System-DSN oder BenutzerDSN. Erstellen Sie für jede FileMaker Pro-Datenbankdatei, auf die Sie als Datenquellezugreifen möchten, einen eigenen Datenquellennamen.
2. Klicken Sie auf Hinzufügen.
3. Wählen Sie FileMaker ODBC und klicken Sie auf Fertigstellen.
4. Klicken Sie auf Weiter.
5. Geben Sie für Name einen Namen ein, der für andere Benutzer eine Bedeutung hat, die auf die
FileMaker-Datenquelle zugreifen. Geben Sie für Beschreibung eine optionale Beschreibung
für die FileMaker-Datenquelle ein. Klicken Sie auf Weiter.
6. Für Host:

1 Falls Sie eine Verbindung zu einer Datenbankdatei herstellen, die von FileMaker Pro auf

Ihrem lokalen Rechner bereitgestellt wird, geben Sie localhost (oder 127.0.0.1) ein.

1 Falls Sie eine Verbindung zu einer Datenbankdatei herstellen, die von FileMaker Server überein Netzwerk bereitgestellt wird, geben Sie den Domänennamen ein, der durch das SSLZertifikat des Servers angegeben ist.

Wenn Sie die gemeinsame Nutzung über ODBC/JDBC in der Host-Anwendung aktiviert haben,können Sie Mit Host verbinden, um die Namen der verfügbaren Datenbanken abzurufen
wählen.
Der FileMaker XDBC Listener verwendet das im Ordner CStore auf dem Server installierte
SSL-Zertifikat, falls ein Zertifikat verfügbar ist. Geben Sie aus Sicherheitsgründen an, ob eine
Verbindung hergestellt werden soll, wenn das SSL-Zertifikat nicht verifiziert werden kann.

1 Wählen Sie Verbinden, damit der ODBC-Prozess immer eine Verbindung herstellt.
1 Wählen Sie Mit Warnung verbinden, damit der ODBC-Prozess eine Verbindung herstellen
kann, aber auch eine Warnmeldung ausgegeben wird.

1 Wählen Sie Nicht verbinden, damit die Verbindung fehlschlägt und eine Fehlermeldung
zurückgegeben wird.

Klicken Sie auf Weiter.
Klicken Sie andernfalls auf Fertigstellen, um Ihre Datenquelleninformationen zu sichern.

Kapitel 3 | Installation der FileMaker ODBC-Client-Treiber

15

7. Wählen Sie für Datenbank eine Datenbank aus der Liste der verfügbaren Datenbanken odergeben Sie den Dateinamen der FileMaker Pro-Datenbankdatei ein, die Sie als Datenquelleverwenden.
Hinweis Für Datenbankdateien, die von FileMaker Server bereitgestellt werden, könnte die
Liste der Datenbanken basierend auf der Einstellung Datenbanken filtern gefiltert sein.
Weitere Informationen finden Sie in der FileMaker Server Hilfe. Die Beispieldatei
FMServer_Sample kann nicht verwendet werden, um ODBC-Verbindungen zu testen. Um
ODBC-Verbindungen zu testen, laden Sie Ihre eigene Datenbank hoch.

1 Wenn Sie eine spezielle Handhabung internationaler Sprachen erfordern, klicken Sie auf
Sprache erweitert.

Um die Spracheinstellungen automatisch zu erkennen, wählen Sie die Option
Spracheinstellungen für Anwendung automatisch erkennen. Um die Spracheinstellung
anzugeben, deaktivieren Sie die Option Spracheinstellungen für Anwendung
automatisch erkennen und wählen Sie die gewünschte Systemeinstellung.
Wählen Sie für die Option Multibyte-Textkodierung die Kodierung System oder UTF-8
aus. Manche Anwendungen wie z. B. Microsoft Excel setzen voraus, dass Text mithilfe derKodierung System kodiert wird, während Web-Anwendungen voraussetzen, dass Text
mithilfe der Kodierung UTF-8 kodiert wird. Falls die Anwendung eine spezielle Kodierung
voraussetzt, diese Option jedoch eine andere Kodierung angibt, dann werden unter
Umständen in der Anwendung bestimmte Zeichen nicht korrekt dargestellt. FileMakerSoftware unterstützt UTF-8-Multibyte-Zeichen aus bis zu drei Byte.

1 Wählen Sie die Option Textfelder als Long Varchar beschreiben, um Probleme mit langen
Feldwerten zu beheben wie Feldern, die keine Maximallänge für den Serienbriefimport in
Microsoft Word angegeben haben, oder Feldwerten in PHP-Anwendungen, die länger als
255 Zeichen sind. Wenn Sie diese Option nicht für Feldwerte verwenden, die länger als
255 Zeichen sind, kann Ihre Anwendung eine leere Zeichenfolge (Windows) oder nur
255 Zeichen (macOS) abrufen.

1 Wenn Sie eine Protokolldatei für lang laufende Abfragen erstellen möchten, wählen Sie die
Option Lang laufende Abfragen in eine Protokolldatei speichern und geben Sie den
Namen für die Protokolldatei ein.

Klicken Sie auf Fertig, um Ihre Datenquelleninformationen zu sichern.
8. Prüfen Sie die Angaben über Ihren FileMaker-DSN.

1 Klicken Sie auf Testen, um zu überprüfen, ob Sie den ODBC-Client-Treiber korrekt
konfiguriert haben, um auf die FileMaker-Datenquelle zugreifen zu können.

Wenn Sie eine Fehlermeldung erhalten, können Sie die Verbindungsinformationen
korrigieren. Eventuell müssen Sie auch sicherstellen, dass die FileMaker ProDatenbankdatei bereitgestellt und verfügbar ist, dass das angegebene FileMaker-DateiKonto Berechtigungen mit dem erweiterten Zugriffsrecht fmxdbc für Zugriff überODBC/JDBC verwendet und dass die Host-Anwendung für FileMaker Server, FileMaker Pro
oder FileMaker Cloud für die gemeinsame Nutzung über ODBC/JDBC eingerichtet wurde.

1 Klicken Sie auf Fertig, um Ihre Datenquelleninformationen zu sichern.

Kapitel 3 | Installation der FileMaker ODBC-Client-Treiber

16

ODBC-Client-Treiber-Installation (macOS)
Der Client-Treiber wird im Ordner /Library/ODBC installiert.
So installieren Sie den ODBC-Client-Treiber:
1. Sie haben folgende Möglichkeiten:

1 Wenn Sie Ihre Software elektronisch erhalten haben, doppelklicken Sie auf das DiskimageSymbol (.dmg-Datei).

1 Wenn Sie über eine Installationsdiskette verfügen, legen Sie die Diskette in das Laufwerk ein.
2. Doppelklicken Sie im FileMaker Pro- oder FileMaker Server-Fenster auf den Ordner „Extras“.
3. Doppelklicken Sie auf den Ordner „xDBC“.
4. Doppelklicken Sie im Ordner xDBC auf den Ordner „ODBC Client Driver Installer“.
5. Doppelklicken Sie im Ordner „ODBC Client Driver Installer“ auf FileMaker ODBC.pkg.
6. Installieren Sie den ODBC-Client-Treiber, indem Sie den Bildschirmanweisungen folgen.
7. Wenn die Installation abgeschlossen ist, klicken Sie auf Schließen.
Der ODBC-Client-Treiber wird in diesem Ordner installiert: /Library/ODBC
Hinweis Sie können den Installationsordner für den ODBC-Client-Treiber nicht ändern.
Der ODBC-Client-Treiber FileMaker ODBC steht jetzt für die Konfiguration für den Zugriff auf
FileMaker-Daten bereit.

Konfigurieren der Client-Treiber (macOS)
Bevor Sie eine ODBC-Client-Anwendung verwenden können, um auf FileMaker-Datenzuzugreifen, müssen Sie einen Client-Treiber für die Datenquelle konfigurieren. Die
Konfigurationseinstellungen identifizieren den verwendeten Client-Treiber, den Speicherort derDatenquelle und Details zur Verbindung.
Diese Anweisungen gehen davon aus, dass Sie den ODBC Manager von Actual Technologies
installiert haben, ein Freeware-Produkt, für das von Claris® kein Support angeboten wird.
Wichtig Wenn Sie einen FileMaker-Client-Treiber verwenden, müssen Sie Port 2399 reservieren.
So konfigurieren Sie den ODBC-Client-Treiber:
1. Starten Sie das ODBC Manager-Dienstprogramm. (Der ODBC Manager ist im Ordner„Dienstprogramme“ im Ordner „Programme“ installiert.)
2. Klicken Sie auf das Register System-DSN oder Benutzer-DSN. Erstellen Sie für jede
FileMaker Pro-Datenbankdatei, auf die Sie als Datenquelle zugreifen möchten, einen eigenen
Datenquellennamen.
3. Klicken Sie auf Hinzufügen.
4. Wählen Sie FileMaker ODBC und klicken Sie auf OK.
5. Klicken Sie auf Weiter.

Kapitel 3 | Installation der FileMaker ODBC-Client-Treiber

17

6. Geben Sie für Name einen Namen ein, der für andere Benutzer eine Bedeutung hat, die auf die
FileMaker-Datenquelle zugreifen. Geben Sie für Beschreibung eine optionale Beschreibung
für die FileMaker-Datenquelle ein. Klicken Sie auf Weiter.
7. Für Host:

1 Falls Sie eine Verbindung zu einer Datenbankdatei herstellen, die von FileMaker Pro auf

Ihrem lokalen Rechner bereitgestellt wird, geben Sie localhost (oder 127.0.0.1) ein.

1 Falls Sie eine Verbindung zu einer Datenbankdatei herstellen, die von FileMaker Server überein Netzwerk bereitgestellt wird, geben Sie den Domänennamen ein, der durch das SSLZertifikat des Servers angegeben ist.

Wenn Sie die gemeinsame Nutzung über ODBC/JDBC in der Host-Anwendung aktiviert haben,können Sie Mit Host verbinden, um die Namen der verfügbaren Datenbanken abzurufen
wählen.
Der FileMaker XDBC Listener verwendet das im Ordner CStore auf dem Server installierte
SSL-Zertifikat, falls ein Zertifikat verfügbar ist. Geben Sie aus Sicherheitsgründen an, ob eine
Verbindung hergestellt werden soll, wenn das SSL-Zertifikat nicht verifiziert werden kann.

1 Wählen Sie Verbinden, damit der ODBC-Prozess immer eine Verbindung herstellt.
1 Wählen Sie Mit Warnung verbinden, damit der ODBC-Prozess eine Verbindung herstellen
kann, aber auch eine Warnmeldung ausgegeben wird.

1 Wählen Sie Nicht verbinden, damit die Verbindung fehlschlägt und eine Fehlermeldung
zurückgegeben wird.

Klicken Sie auf Weiter.
Klicken Sie andernfalls auf Fertigstellen, um Ihre Datenquelleninformationen zu sichern.
8. Wählen Sie für Datenbank eine Datenbank aus der Liste der verfügbaren Datenbanken odergeben Sie den Dateinamen der FileMaker Pro-Datenbankdatei ein, die Sie als Datenquelleverwenden.
Hinweis Für Datenbankdateien, die von FileMaker Server bereitgestellt werden, könnte die
Liste der Datenbanken basierend auf der Einstellung Datenbanken filtern gefiltert sein.
Weitere Informationen finden Sie in der FileMaker Server Hilfe. Die Beispieldatei
FMServer_Sample kann nicht verwendet werden, um ODBC-Verbindungen zu testen. Um
ODBC-Verbindungen zu testen, laden Sie Ihre eigene Datenbank hoch.

1 Wenn Sie eine spezielle Handhabung internationaler Sprachen erfordern, klicken Sie auf
Sprache erweitert.

Um die Spracheinstellungen automatisch zu erkennen, wählen Sie die Option
Spracheinstellungen für Anwendung automatisch erkennen. Um die Spracheinstellung
anzugeben, deaktivieren Sie die Option Spracheinstellungen für Anwendung
automatisch erkennen und wählen Sie die gewünschte Systemeinstellung.
Wenn Ihre Anwendung ODBC-Funktionen mit Zeichenpuffern mit 4-Byte-Zeichen
verwendet, wählen Sie die Option Anwendung verwendet das „Wide“ ODBC API.
Wenn der Texttyp SQL_C_CHAR von dem Treiber als Texttyp SQL_C_WCHAR interpretiert
werden soll, wählen Sie die Option Texttypen als Unicode behandeln.

Kapitel 3 | Installation der FileMaker ODBC-Client-Treiber

18

Wählen Sie für die Option Multibyte-Textkodierung die Kodierung System (MacRoman)oder UTF-8 aus. Manche Anwendungen wie z. B. Microsoft Excel setzen voraus, dass Text
mithilfe der Kodierung System kodiert wird, während Web-Anwendungen voraussetzen,
dass Text mithilfe der Kodierung UTF-8 kodiert wird. Falls die Anwendung eine spezielle
Kodierung voraussetzt, diese Option jedoch eine andere Kodierung angibt, dann werden
unter Umständen in der Anwendung bestimmte Zeichen nicht korrekt dargestellt. FileMakerSoftware unterstützt UTF-8-Multibyte-Zeichen aus bis zu drei Byte.

1 Wählen Sie die Option Textfelder als Long Varchar beschreiben, um Probleme mit langen
Feldwerten zu beheben, wie Feldern, die keine Maximallänge angegeben haben und für den
Serienbriefimport in Microsoft Word verwendet werden, oder Feldwerte in PHPAnwendungen, die länger als 255 Zeichen sind.

1 Wenn Sie eine Protokolldatei für lang laufende Abfragen erstellen möchten, wählen Sie die
Option Lang laufende Abfragen in eine Protokolldatei speichern und geben Sie den
Namen für die Protokolldatei ein. Sie können auch den Wert Lange Abfragezeit ändern.

Klicken Sie auf Fertig, um Ihre Datenquelleninformationen zu sichern.
9. Prüfen Sie die Angaben über Ihren FileMaker-DSN.

1 Klicken Sie auf Testen, um zu überprüfen, ob Sie den ODBC-Client-Treiber korrekt
konfiguriert haben, um auf die FileMaker-Datenquelle zugreifen zu können.

Wenn Sie eine Fehlermeldung erhalten, können Sie die Verbindungsinformationen
korrigieren. Eventuell müssen Sie auch sicherstellen, dass die FileMaker ProDatenbankdatei bereitgestellt und verfügbar ist, dass das angegebene FileMakerDateikonto Berechtigungen mit dem erweiterten Zugriffsrecht fmxdbc für Zugriff überODBC/JDBC verwendet und dass die Host-Anwendung FileMaker Server oder FileMaker
Pro für die gemeinsame Nutzung über ODBC/JDBC eingerichtet wurde.

1 Klicken Sie auf Fertig, um Ihre Datenquelleninformationen zu sichern.

Die nächsten Schritte
Nach Installation und Konfiguration eines Client-Treibers können Sie SQL-Abfragen aufbauen
und ausführen, um auf FileMaker-Daten zuzugreifen.
Client-Anwendungen verwenden für den Zugriff auf Datenquellen über ODBC gelegentlich eine
andere Terminologie. Viele Anwendungen verfügen über Menüeinträge mit Namen wie Holeexterne Daten oder SQL-Abfrage. Detaillierte Informationen hierzu finden Sie in der
Dokumentation oder der Hilfe Ihrer Anwendung.
Siehe Kapitel 4, „Verwenden von ODBC zur gemeinsamen Nutzung von FileMaker-Daten“.

Kapitel 4
Verwenden von ODBC zur gemeinsamen
Nutzung von FileMaker-Daten
Verwenden Sie den ODBC-Client-Treiber, um von einer anderen Anwendung aus eine
Verbindung zu FileMaker-Daten herzustellen. Die Anwendung, die den ODBC-Client-Treiber
verwendet, kann direkt auf die Daten in einer FileMaker Pro-Datenbankdatei zugreifen.
Der FileMaker ODBC-Client-Treiber ist FileMaker ODBC.
Hinweis Sie können auch FileMaker Pro als ODBC-Client-Anwendung verwenden, die mithilfe
von SQL über ODBC mit den Datensätzen einer anderen Datenquelle interagiert. Weitere
Informationen über den Zugriff auf eine externe SQL-Datenquelle über ODBC finden Sie in
Kapitel 2, „Zugreifen auf externe SQL-Datenquellen“.

Informationen zu ODBCODBC ist ein API, das Anwendungen den Zugriff auf Daten aus vielen Datenbankmanagementsystemen ermöglicht. ODBC gibt Client-Anwendungen eine gemeinsame Sprache für die Interaktion mit Datenquellen und Datenbankdiensten.
Alle Anwendungen, die ODBC unterstützen, erkennen eine gemeinsame Untergruppe von SQLAnweisungen (Structured Query Language). Mithilfe von SQL können Sie andere Anwendungen(wie Tabellenkalkulationen, Textverarbeitungsprogramme und Bericht-Tools) verwenden, um
FileMaker-Daten anzuzeigen, zu analysieren und zu bearbeiten. Weitere Informationen zu den
vom ODBC-Client-Treiber unterstützten SQL-Anweisungen, -Funktionen und -Ausdrücken finden
Sie im FileMaker SQL-Referenzhandbuch.
Ihre Anwendung kann über den ODBC-Client-Treiber auf Daten in einer FileMaker ProDatenbankdatei zugreifen. Ihre SQL-Anweisungen werden an den FileMaker-Host derDatenbankdatei übergeben und die Ergebnisse dieser Anweisungen werden an Ihre Anwendung
zurückgesendet. Wenn Sie FileMaker Server verwenden, um eine FileMaker Pro-Datenbankdatei
als Datenquelle bereitzustellen, kann sich die Datenbankdatei auf einem anderen an Ihr Netzwerk
angeschlossenen Rechner (dem Server) befinden, während sich die Client-Anwendung auf Ihrem
Rechner (dem Client) befindet. Diese Verteilung wird als Client/Server-Konfiguration bezeichnet.
ClientAnwendung

TreiberManager

OracleODBC-Treiber

SQL ServerODBC-Treiber

FileMaker
ODBC-ClientTreiber

OracleMicrosoft
SQL Server

FileMaker Pro

Kapitel 4 | Verwenden von ODBC zur gemeinsamen Nutzung von FileMaker-Daten

20

Verwenden des ODBC-Client-Treibers
Der ODBC-Client-Treiber unterstützt ODBC 3.0 Level 1. Sie können den ODBC-Client-Treiber mit
jeder ODBC-kompatiblen Anwendung verwenden. Wenn Sie Ihre FileMaker Pro-Datenbankdatei
gemeinsam als Datenquelle verwenden, können Sie:

1
1
1
1

Serienbriefe mit Microsoft Word erstellen
Diagramme mit Microsoft Excel erstellen
FileMaker-Daten zu einer DBMS wie Microsoft SQL Server verschieben
Ihre FileMaker-Daten mit Abfrage- oder Bericht-Tools weiter analysieren, um Diagramme zu
erstellen, Ad-hoc-Abfragen aufzubauen und Tiefenanalysen durchzuführen

1 eine Microsoft Visual Basic-Anwendung entwickeln, die Informationen gemeinsam mit
FileMaker Pro benutzt

Wenn Sie eine FileMaker Pro-Datenbankdatei als Datenquelle gemeinsam nutzen möchten,
verwenden Sie FileMaker Pro, um Konten zu definieren, die auf die Datenbankdatei Zugriff habensollen. Steuern Sie den Zugriff auf die Datenbankdatei, indem Sie den Konten Berechtigungenzuweisen, die das erweiterte Zugriffsrecht fmxdbc für den Zugriff über ODBC/JDBC mit
einschließen. Abschließend müssen Sie die Host-Anwendung aktivieren, um Daten überODBC/JDBC austauschen zu können. Siehe die Produktdokumentation für Details in
der FileMaker Pro Hilfe oder der FileMaker Server Hilfe.
Wichtig Frühere Versionen des FileMaker ODBC-Client-Treibers sind nicht kompatibel mit deraktuellen Version der FileMaker-Software. Um eine Verbindung zu einer FileMaker ProDatenbankdatei herzustellen, müssen Sie den ODBC-Client-Treiber installieren und
konfigurieren, der der von Ihnen verwendeten FileMaker-Software-Version entspricht.
Hinweis Um zu bestätigen, dass der FileMaker XDBC Listener aktuell läuft, können Sie unter
macOS den Aktivitätsmonitor und unter Windows den Task-Manager verwenden, um den Status
des XDBC Listener-Prozesses zu prüfen. Wenn der Prozess gestartet wurde, heißt er
fmxdbc_listener und Ereignisse werden mit diesem Namen protokolliert.

Übersicht über den Zugriff auf eine FileMaker Pro-Datenbankdatei
In einer ODBC-kompatiblen Anwendung können Sie SQL-Abfragen erstellen, um auf eine
FileMaker Pro-Datenbankdatei zuzugreifen. Der ODBC-Client-Treiber muss auf dem Computer
installiert sein, der die SQL-Abfrage generiert.
So greifen Sie auf eine FileMaker Pro-Datenbankdatei zu:
1. Überprüfen Sie in FileMaker Pro die Berechtigungen, die Sie Konten für den Zugriff auf die
Datenbankdatei zugewiesen haben.
Konten, die Zugriff benötigen, müssen Berechtigungen mit dem erweiterten Zugriffsrecht
fmxdbc für Zugriff über ODBC/JDBC verwenden.
2. Aktivieren Sie die FileMaker Server- oder FileMaker Pro-Host-Anwendung, um Daten überODBC/JDBC gemeinsam nutzen zu können. In der Produktdokumentation finden Sie die
FileMaker Pro Hilfe und die FileMaker Server Hilfe.

Kapitel 4 | Verwenden von ODBC zur gemeinsamen Nutzung von FileMaker-Daten

21

3. Vergewissern Sie sich, dass die FileMaker Pro-Datenbankdatei, auf die Sie zugreifen möchten,
bereitgestellt und verfügbar ist.
Wenn Ihre FileMaker Pro-Datenbanklösung mehr als eine FileMaker Pro-Datenbankdatei
verwendet, müssen sich alle Datenbankdateien auf dem gleichen Computer befinden.
4. Stellen Sie eine Verbindung zu den FileMaker-Daten her.
5. Erstellen Sie in der Client-Anwendung eine SQL-Abfrage und führen Sie sie aus.
Jede geöffnete und für den Zugriff eingerichtete FileMaker Pro-Datenbankdatei ist eine
separate Datenquelle (für jede FileMaker Pro-Datenbankdatei, auf die Sie als Datenquellezugreifen möchten, erstellen Sie einen DSN).
Jede Datenbank kann über eine oder mehrere Tabellen verfügen. FileMaker Pro-Felder
werden als Spalten dargestellt. Der vollständige Feldname einschließlich etwaiger
Sonderzeichen wird als Spaltenname angezeigt.

Zugreifen auf eine FileMaker Pro-Datenbankdatei von einer WindowsAnwendung aus
Festlegen der ODBC-Client-Treibereigenschaften für einen FileMakerDatenquellennamen (Windows)
Erstellen Sie für jede FileMaker Pro-Datenbankdatei, auf die Sie als Datenquelle zugreifen möchten,
einen eigenen Datenquellennamen. Der Datenquellenname identifiziert den FileMaker ODBCClient-Treiber, den Ort der FileMaker-Host-Anwendung und die FileMaker Pro-Datenbankdatei, auf
die Sie als Datenquelle zugreifen.
Informationen zum Erstellen eines DSN finden Sie unter „Konfigurieren der Client-Treiber(Windows)“ auf Seite 13.

Überprüfen des Zugriffs über ODBC (Windows)
So überprüfen Sie, ob Sie den ODBC-Client-Treiber korrekt konfiguriert haben, um auf die
FileMaker-Daten zugreifen zu können:
1. Öffnen Sie den „ODBC-Datenquellenadministrator“. Siehe „Öffnen des ODBC-Administrators(Windows)“ auf Seite 13.
2. Wählen Sie das Register System-DSN bzw. Benutzer-DSN (Wählen Sie das Register, das Siebei der vorherigen Konfiguration verwendet haben.)
3. Wählen Sie die FileMaker-Datenquelle, die Sie zuvor konfiguriert haben.
Der ursprünglich eingegebene DSN wird unter Name angezeigt und FileMaker ODBC wird als
Treiber angezeigt.
4. Klicken Sie auf Konfigurieren.
5. Klicken Sie auf Weiter, bis Sie zur Seite Ergebnis gelangen.
6. Klicken Sie auf Testen.
Geben Sie Ihren FileMaker-Datei-Kontonamen (unter Datenbankbenutzername) und Ihr
Passwort (unter Datenbankpasswort) ein.

Kapitel 4 | Verwenden von ODBC zur gemeinsamen Nutzung von FileMaker-Daten

22

Wenn die Verbindung erfolgreich hergestellt wurde, wird die Meldung Test erfolgreichabgeschlossen angezeigt.
Falls die Verbindung fehlschlägt:

1 Vergewissern Sie sich, dass die FileMaker Pro-Datenbankdatei bereitgestellt und verfügbar ist.
1 Aktualisieren oder korrigieren Sie die Verbindungsinformationen.
1 Vergewissern Sie sich, dass Ihr FileMaker-Datei-Konto über das erweiterte Zugriffsrecht
fmxdbc für Zugriff über ODBC/JDBC verfügt.

1 Stellen Sie sicher, dass die FileMaker Server- oder FileMaker Pro-Host-Anwendung für Sharingüber ODBC/JDBC eingerichtet wurde.

Zugreifen auf eine FileMaker Pro-Datenbankdatei von einer macOSAnwendung aus
Festlegen der ODBC-Client-Treibereigenschaften für einen FileMaker-DSN(macOS)
Erstellen Sie für jede FileMaker Pro-Datenbankdatei, auf die Sie als Datenquelle zugreifen
möchten, einen eigenen Datenquellennamen. Der Datenquellenname identifiziert den FileMaker
ODBC-Client-Treiber, den Ort der FileMaker-Host-Anwendung und die FileMaker ProDatenbankdatei, auf die Sie als Datenquelle zugreifen.
Informationen zum Erstellen eines DSN finden Sie unter „Konfigurieren der Client-Treiber(macOS)“ auf Seite 16.

Überprüfen des Zugriffs über ODBC (macOS)
So überprüfen Sie, ob Sie den ODBC-Client-Treiber korrekt konfiguriert haben, um auf die
FileMaker-Datenquelle zugreifen zu können:
1. Starten Sie das ODBC Manager-Dienstprogramm. (Der ODBC Manager befindet sich im
Ordner „Dienstprogramme“ im Ordner „Programme“.)
2. Wählen Sie das Register System-DSN bzw. Benutzer-DSN (Wählen Sie das Register, das Siebei der vorherigen Konfiguration verwendet haben.)
3. Wählen Sie die FileMaker-Datenquelle, die Sie zuvor konfiguriert haben.
Der ursprünglich eingegebene DSN wird unter Name angezeigt und FileMaker ODBC wird als
Treiber angezeigt.
4. Klicken Sie auf Konfigurieren.
5. Klicken Sie auf Weiter, bis Sie zur Seite Ergebnis gelangen.
6. Klicken Sie auf Testen.
Geben Sie Ihren FileMaker-Datei-Kontonamen (unter Datenbankbenutzername) und Ihr
Passwort (unter Datenbankpasswort) ein.

Kapitel 4 | Verwenden von ODBC zur gemeinsamen Nutzung von FileMaker-Daten

23

Wenn die Verbindung erfolgreich hergestellt wurde, wird die Meldung Test erfolgreichabgeschlossen angezeigt.
Falls die Verbindung fehlschlägt:

1 Vergewissern Sie sich, dass die FileMaker Pro-Datenbankdatei bereitgestellt und verfügbar ist.
1 Aktualisieren oder korrigieren Sie die Verbindungsinformationen.
1 Vergewissern Sie sich, dass Ihr FileMaker-Datei-Konto über das erweiterte Zugriffsrecht
fmxdbc für Zugriff über ODBC/JDBC verfügt.

1 Stellen Sie sicher, dass die FileMaker Server- oder FileMaker Pro-Host-Anwendung für Sharingüber ODBC/JDBC eingerichtet wurde.

Kapitel 5
Installieren des FileMaker JDBC-Client-Treibers
Um auf eine bereitgestellte FileMaker Pro-Datenbankdatei als JDBC-Datenquelle zuzugreifen,
müssen Sie den JDBC-Client-Treiber installieren. Diese Anweisungen helfen Ihnen bei derInstallation des Client-Treibers für den Zugriff auf FileMaker-Daten von Anwendungen Dritter undeigenen Anwendungen über JDBC. Installieren Sie den Client-Treiber auf dem Rechner, auf dem
auch die Anwendung des Drittherstellers installiert ist.
Suchen Sie auf der Seite FileMaker-Downloads nach Updates für die Client-Treiber.
Falls Sie eine FileMaker Pro-Datenbankdatei mithilfe von FileMaker Server bereitstellen, müssen
Sie den Remote-Anwendern die Client-Treiber zur Verfügung stellen.
Nach Installation des benötigten Client-Treibers können Sie den Treiber konfigurieren, um auf
FileMaker-Daten zuzugreifen und SQL-Abfragen für die Arbeit mit Daten aufzubauen.
Der JDBC-Client-Treiber ist der Treiberbestandteil der FileMaker-Software, die es Anwendungen
Dritter oder eigenen Anwendungen ermöglicht, auf FileMaker-Dateien als JDBC-Datenquelle
zuzugreifen.

Software-Anforderungen
Um die JDBC-Client-Treiber zu installieren und zu verwenden, benötigen Sie JDK 1.6 oder höher.
Um festzustellen, welche Java-Version Sie verwenden, öffnen Sie ein Befehlsfenster (Windows)
bzw. Terminalfenster (macOS) und geben Sie java -version ein.

NetzwerkanforderungenWenn Sie auf FileMaker-Daten zugreifen werden, die auf einem anderen Computer bereitgestellt
werden, benötigen Sie einen Netzwerkzugriff über TCP/IP.

JDBC-Client-Treiber-Installation
Sie benötigen Schreibzugriff für den Ordner, in dem Sie den JDBC-Client-Treiber installieren.
So installieren Sie den JDBC-Client-Treiber:
1. Sie haben folgende Möglichkeiten:

1 Windows: Wenn Sie Ihre Software elektronisch erhalten haben, doppelklicken Sie auf das
Installationssymbol (.exe-Datei).

1 macOS: Wenn Sie Ihre Software elektronisch erhalten haben, doppelklicken Sie auf das
Diskimage-Symbol (.dmg-Datei).

1 Wenn Sie über eine Installationsdiskette verfügen, legen Sie die Diskette in das Laufwerk ein.
2. Doppelklicken Sie im FileMaker Pro- oder FileMaker Server-Fenster auf den Ordner „Extras“.
3. Doppelklicken Sie auf den Ordner „xDBC“.
4. Doppelklicken Sie im Ordner xDBC auf den Ordner „JDBC Client Driver Installer“.

Kapitel 5 | Installieren des FileMaker JDBC-Client-Treibers

25

5. Kopieren Sie die Datei fmjdbc.jar in den entsprechenden Ordner für Ihr Betriebssystem:

1 Windows: Kopieren Sie die Datei fmjdbc.jar in den Ordner, der Ihre ausführbare Java-Datei(java.exe) enthält, oder einen anderen Ordner, der im ClassPath Ihrer Java-Anwendung
enthalten ist.

1 macOS: Kopieren Sie die Datei fmjdbc.jar in den Ordner /Library/Java/Extensions odereinen anderen Ordner, der im ClassPath Ihrer Java-Anwendung enthalten ist.

Sie können jetzt den JDBC-Client-Treiber verwenden, um auf FileMaker-Daten zuzugreifen.

Verwenden des JDBC-Client-Treibers
Ihre Java-Anwendung bzw. das Java-Applet muss den JDBC-Client-Treiber beim JDBC-TreiberManager registrieren und Sie müssen in der Anwendung bzw. im Applet den korrekten JDBC-URL(Uniform Resource Locator) angeben.
Wichtig Sie müssen Port 2399 für den FileMaker JDBC-Client-Treiber reservieren. Die PortNummer ist immer 2399. Sie können das JDBC-Sharing nicht auf einen anderen Port legen.
Siehe Kapitel 6 „Verwenden von JDBC zur gemeinsamen Nutzung von FileMaker-Daten“.

Kapitel 6
Verwenden von JDBC zur gemeinsamen
Nutzung von FileMaker-Daten
Wenn Sie ein Java-Programmierer sind, können Sie den JDBC-Client-Treiber mit jedem RAD(Rapid Application Development) Tool verwenden, um Java-Anwendungen oder -Applets visuellzu erstellen, die eine Verbindung zu einer FileMaker-Datenquelle herstellen. Die JavaAnwendungen oder -Applets, die den JDBC-Client-Treiber verwenden, können direkt auf die
Daten in einer FileMaker Pro-Datenbankdatei zugreifen.

Informationen zu JDBCJDBC ist eine Java-API zur Ausführung von SQL-Anweisungen, der Standardsprache für den
Zugriff auf relationale Datenbanken. JDBC ist als Low Level Interface (einfache Schnittstelle)ausgelegt, d. h., SQL-Befehle werden direkt über die Schnittstelle aufgerufen. Darüber hinaus
dient es als Basis für Higher Level Interfaces (Schnittstellen mit mehr Bedienkomfort) und Tools.
Ihre Java-Applets oder -Anwendungen können über den JDBC-Client-Treiber direkt auf Daten in
einer FileMaker Pro-Datenbankdatei zugreifen. Ihre SQL-Anweisungen werden an den
FileMaker-Host der Datenbankdatei übergeben, und die Ergebnisse dieser Anweisungen werden
an Ihre Anwendung zurückgesendet. Wenn Sie FileMaker Server verwenden, um eine FileMaker
Pro-Datenbankdatei als Datenquelle bereitzustellen, kann sich die Datenbankdatei auf einem
anderen an Ihr Netzwerk angeschlossenen Rechner (dem Server) befinden, während sich die
Java-Applets oder -Client-Anwendungen auf Ihrem Rechner (dem Client) befinden. Diese
Verteilung wird als Client/Server-Konfiguration bezeichnet.
Java-Anwendung
JDBC-Treiber

FileMaker

Client-Computer

Datenbank-Server

Verwenden des JDBC-Client-Treibers
Der JDBC-Client-Treiber kann mit einem Java-Compiler bzw. RAD-Tool eine Verbindung zu Ihrer
Datenbank herstellen, während Sie den Code für Ihre Java-Anwendung bzw. Ihr Java-Applet
erstellen. Nachdem die Java-Anwendungen bzw. -Applets erstellt worden sind, muss der JDBCClient-Treiber zusammen mit den Dateien zur Verfügung stehen oder in den Code integriert
werden, damit die Anwendungen bzw. Applets mit der Datenbank kommunizieren können.
Um den JDBC-Client-Treiber nutzen zu können, muss die Java-Anwendung bzw. das Java-Applet
den Treiber beim JDBC-Treiber-Manager registrieren und Sie müssen in der Anwendung bzw. im
Applet die korrekte JDBC-URL angeben. Die JDBC-URL wird benötigt, um die Verbindung zur
Datenbank herstellen zu können.

Kapitel 6 | Verwenden von JDBC zur gemeinsamen Nutzung von FileMaker-Daten

27

Erläuterung des JDBC-Client-Treibers
Der JDBC-Client-Treiber unterstützt teilweise die JDBC-3.0-Spezifikation. Folgende Funktionen
werden von der FileMaker-Plattform nicht unterstützt:

1
1
1
1
1
1
1
1
1
1

SAVEPOINT-Anweisungen
Abruf von automatisch erstellten SchlüsselnÜbergabe von Parametern an ein aufrufbares Anweisungsobjekt nach Name
Haltbare Cursor
Abruf und Aktualisierung des von einem REF-Objekt referenzierten Objekts
Aktualisierung von Spalten mit CLOB-, ARRAY- und REF-Datentypen
Boolescher Datentyp
DATALINK-Datentyp
Umwandlung von Gruppen und Zuordnung von Typen
Beziehung zwischen JDBC SPI und der Connector-Architektur

Der JDBC-Client-Treiber wurde mit dem Java Development Kit (JDK) 1.6, 1.7 und 1.8 getestet. Es
handelt sich um einen Treiber vom Typ 4, einen Native Protocol All-Java-Treiber, der JDBCAufrufe direkt in das von FileMaker Pro verwendete Netzwerkprotokoll konvertiert. Dieser
Treibertyp bietet alle Vorteile von Java, u. a. automatische Installation (z. B. Herunterladen des
JDBC-Treibers mit einem Applet, das den Treiber nutzt).
Die Treiberklasse und Haupteinstiegsfunktion des Treibers:com.filemaker.jdbc.Driver
Wichtig Der JDBC-Client-Treiber ersetzt den FileMaker JDBC-Treiber der vorherigen Version
von FileMaker-Software. Falls Sie den Zugriff auf eine FileMaker-Datenquelle zuvor mit dem alten
Treiber eingerichtet haben, müssen Sie den Zugriff neu definieren, indem Sie den neuen Treiber
verwenden und konfigurieren.
Hinweis Um zu bestätigen, dass der FileMaker XDBC Listener aktuell läuft, können Sie unter
macOS die Aktivitätsanzeige und unter Windows den Task-Manager verwenden, um den Status
des XDBC Listener-Prozesses zu prüfen. Wenn der Prozess gestartet wurde, heißt er
fmxdbc_listener und Ereignisse werden mit diesem Namen protokolliert. Der XDBC ListenerProzess läuft getrennt vom FileMaker Server-Prozess. Sie können FileMaker Server Admin
Console verwenden, um den XDBC Listener-Prozess zu starten und zu stoppen. Weitere
Informationen finden Sie in der FileMaker Server Hilfe.

Herstellen einer Verbindung zu Ihrer Datenbank mit einer JDBC-URL
In Java erfolgt der Zugriff auf Ressourcen meist über URLs. Eine JDBC-URL kennzeichnet die
Datenbank, sodass der JDBC-Client-Treiber die Datenbank erkennen und eine Verbindung mit ihr
herstellen kann.
Die JDBC-URL besteht aus drei Hauptkomponenten, die durch Doppelpunkt getrennt sind.
jdbc:<Subprotokoll>:<Subname>Kapitel 6 | Verwenden von JDBC zur gemeinsamen Nutzung von FileMaker-Daten

28

Die erste Komponente der JDBC-URL ist immer das JDBC-Protokoll (jdbc). Das Subprotokoll
ist der Name des Treibers oder der Mechanismus, der mehrere Treiber unterstützt. Für den JDBCClient-Treiber lautet das Subprotokoll filemaker. Der Subname ist die IP-Adresse desComputers, auf dem sich die FileMaker-Datenquelle befindet.
Registrieren des JDBC-Client-Treibers und Herstellen einer Verbindung zu einer FileMakerDatenquelle (Beispiel)Hier sehen Sie einen Ausschnitt einer JDBC-Client-Anwendung, die:1. den JDBC-Client-Treiber beim JDBC-Treiber-Manager registriert.
2. eine Verbindung mit der FileMaker-Datenquelle herstellt; die JDBC-URL lautet:
jdbc:filemaker://192.168.1.1/database
3. Fehlercodes ausgibt.

Kapitel 6 | Verwenden von JDBC zur gemeinsamen Nutzung von FileMaker-Daten

Beispiel:
import java.sql.*;
class FMPJDBCTest{
public static void main(String[ ] args){// Registrieren des JDBC-Client-Treibers
try {Driver d =(Driver)Class.forName("com.filemaker.jdbc.Driver").newInstance();} catch(Exception e) {System.out.println(e);}// eine Verbindung mit FileMaker herstellen
Connection con;
try {
con =
DriverManager.getConnection("jdbc:filemaker://192.168.1.1/mydatabase","Benutzername", "Passwort");} catch(Exception e) {System.out.println(e);}// Verbindungswarnungen holen
SQLWarning warning = null;try {warning = con.getWarnings();
if (warning == null) {System.out.println("Keine Warnungen");return;}while (warning != null) {System.out.println("Warnung: "+warning);
warning = warning.getNextWarning();}} catch (Exception e) {Sysem.out.println(e);}}}Hinweis Dieses Beispiel ist nicht für die Kompilierung vorgesehen.

29Kapitel 6 | Verwenden von JDBC zur gemeinsamen Nutzung von FileMaker-Daten

30

Angeben von Treibereigenschaften im URL-Subnamen
Geben Sie im Subnamen der JDBC-URL die user- und password-Treibereigenschaften an. Diese
Eigenschaften könnten auch an die Verbindung übergeben werden, wenn die Methode„DriverManager.getConnection“ über den Parameter „Properties“ aufgerufen wird.

1 user: Ein Konto in der FileMaker Pro-Datenbankdatei, das Berechtigungen mit dem erweiterten
Zugriffsrecht fmxdbc für Zugriff über ODBC/JDBC verwendet

1 password: Das Passwort für das Konto in der FileMaker Pro-Datenbankdatei
JDBC-URL-Verbindung mit in der URL angegebenem Datenbanknamen
Format:jdbc:filemaker://<Filemaker-Host-IP-Adresse>/<Datenbankname>
Beispiel:
jdbc:filemaker://192.168.1.1/publications

JDBC-URL-Verbindung mit in der URL angegebenem Datenbanknamen, Benutzernamen und
Passwort
Format:jdbc:filemaker://<Filemaker-Host-IPAdresse>/<Datenbankname>?user=<Datenbankbenutzername>&password=<Datenbankpasswort>
Beispiel:
jdbc:filemaker://192.168.1.1/customers?user=Collections&password=admin

Hinweis Aufgrund der Verwendung des &-Zeichens in dieser Syntax können Sie kein &-Zeichen
in Benutzername oder Passwort verwenden.
Beispiele
Ungültiger Benutzername:jdbc:filemaker://localhost/sales_db?user=ad&min&password=admin

Ungültiges Passwort:

jdbc:filemaker://localhost/sales_db?user=admin1&password=ad&min

Angeben eines SocketTimeout-Werts
Um zu verhindern, dass der JDBC-Treiber die Verbindung unbegrenzt aufrechterhält, nehmen Sie
den SocketTimeout-Parameter mit auf, wenn Sie die JDBC-Verbindungszeichenfolge angeben,
und geben Sie den SocketTimeout-Wert in Millisekunden an.

Kapitel 6 | Verwenden von JDBC zur gemeinsamen Nutzung von FileMaker-Daten

31

Beispiel:
Connection conn = DriverManager.getConnection ("jdbc:filemaker://192.168.1.1/customers?SocketTimeout=100", "admin","admin" );Lösungen mit mehreren FileMaker Pro-Datenbankdateien
Wenn Ihre FileMaker Pro-Datenbanklösung mehrere FileMaker Pro-Datenbankdateien
verwendet, erstellen Sie eine zusätzliche Datenbankdatei, die alle notwendigen externen
Datenquellenverweise, Tabellenauftreten und Beziehungen für Ihre Lösung enthält. Definieren
Sie dann diese zusätzliche Datenbankdatei als Ihre Datenquelle in der JDBC-URL. Sämtliche
FileMaker Pro-Datenbankdateien müssen sich auf demselben Computer befinden.

Überprüfen des Zugriffs über JDBC
Hinweis Die Beispieldatei FMServer_Sample kann nicht verwendet werden, um JDBCVerbindungen zu testen. Um JDBC-Verbindungen zu testen, laden Sie Ihre eigene Datenbank hoch.
Achten Sie auf folgende Punkte, wenn Sie den Zugriff auf eine FileMaker Pro-Datenbankdateiüber JDBC überprüfen:1 Die FileMaker Pro-Datenbankdatei wird bereitgestellt und ist verfügbar.
1 Ihr FileMaker-Datei-Konto verfügt über das erweiterte Zugriffsrecht fmxdbc für Zugriff überODBC/JDBC.

1 Die FileMaker Server- oder FileMaker Pro-Host-Anwendung wurde für Sharing überODBC/JDBC eingerichtet.

Wenn Sie eine FileMaker Pro-Datenbankdatei als Datenquelle gemeinsam nutzen möchten,
verwenden Sie FileMaker Pro, um Konten zu definieren, die auf die Datenbankdatei Zugriff habensollen. Steuern Sie den Zugriff auf die Datenbankdatei, indem Sie den Konten Berechtigungenzuweisen, die das erweiterte Zugriffsrecht fmxdbc für den Zugriff über ODBC/JDBC mit
einschließen. Abschließend müssen Sie die Host-Anwendung aktivieren, um Daten überODBC/JDBC austauschen zu können. Siehe die Produktdokumentation für Details in derFileMaker Pro Hilfe oder der FileMaker Server Hilfe.

1 Die Registrierung des JDBC-Client-Treibers und die JDBC-URL sind korrekt (der Treiber kannsich innerhalb der Java-Anwendung oder auf dem Client-Computer befinden).

Kapitel 7
Referenzinformationen
ODBC-Katalogfunktionen
Der ODBC-Client-Treiber unterstützt die folgenden Katalogfunktionen:

1 SQL-Tabellen – Kataloginformationen werden gespeichert und als einzelne Bereichsnamen
gemeldet (nur Tabellenname).

1
1
1
1

SQLColumns
SQLColumnPrivileges
SQLDescribeCol
SQLGetTypeInfo

JDBC-DatabaseMetaData-Methoden
Der JDBC-Client-Treiber unterstützt die folgenden DatabaseMetaData-Methoden:

1
1
1
1

getColumns
getColumnPrivileges
getMetaData

1 getTables
1 getTableTypes
1 getVersionColumns

getTypeInfo

Zuordnen von FileMaker Pro-Feldern zu ODBC-Datentypen
Diese Tabelle veranschaulicht, wie FileMaker Pro-Feldtypen den standardmäßigen ODBCDatentypen zugeordnet werden.
FileMaker-Feldtyp

ODBC-Datentyp

Datentypinformation

Text

SQL_VARCHAR

Die maximale Spaltenlänge für Text beträgt 1 Million Zeichen, außer Sie
legen für das Textfeld in FileMaker eine kleinere Maximale Anzahl von
Zeichen fest. Gibt leere Zeichenfolgen als NULL aus.

Zahl

SQL_DOUBLE

Der FileMaker-Zahlenfeld-Typ kann positive oder negative Werte von10-308 bis 10+308 mit bis zu 15 signifikanten Stellen enthalten.

Datum

SQL_DATE

Zeit

SQL_TIME

Zeitstempel

SQL_TIMESTAMP

Container (BLOB)SQL_LONGVARBIN
ARY

FormelDer FileMaker-Feldtyp „Zeit“ kann die Tageszeit oder ein Zeitintervall
enthalten. Ein Zeitintervall wird als Tageszeit ausgegeben, außer es ist
kleiner als 0 oder größer als 24 Stunden (in beiden Fällen wird der Wert
0 ausgegeben).

Sie können Binärdaten, Dateiverweisinformationen oder Daten eines
angegebenen Dateityps von einem Containerfeld abrufen.
Verwenden Sie innerhalb einer SELECT-Anweisung die CAST()Funktion, um die Dateiverweisinformation abzurufen, und verwenden
Sie die GetAs()-Funktion, um Daten eines bestimmten Dateityps
abzurufen.
Das Ergebnis wird dem entsprechenden ODBC-Datentyp zugeordnet.

Kapitel 7 | Referenzinformationen

33

Die Länge von Zeichenfolgen in Tabellendeklarationen ist optional. Alle Zeichenfolgen werden inUnicode gespeichert und abgerufen.
Hinweis FileMaker-Wiederholfelder werden wie Arrays unterstützt.
Beispiel:
INSERT INTO mytable(repField[3]) VALUES (‘Das ist Wdhg 3’)
SELECT repField[1], repField[2] FROM mytable

Zuordnen von FileMaker Pro-Feldern zu JDBC-Datentypen
Der JDBC-Client verwendet folgende Zuordnungen, wenn FileMaker-Datentypen in JDBC SQLTypen konvertiert werden.
FileMaker-Feldtyp

JDBC SQL-Typ

Text

java.sql.Types.VARCHAR

Zahl

java.sql.Types.DOUBLE

Datum

java.sql.Types.DATE

Zeit

java.sql.Types.TIME

Zeitstempel

java.sql.Types.TIMESTAMP

Container

java.sql.Types.BLOB

Formelangegeben durch den Datentyp des Formelergebnisses

Der JDBC-Client-Treiber konvertiert den FileMaker-Datentyp Formel in den JDBC SQL-Typ, derdem Ergebnis der Formel entspricht. Beispielsweise konvertiert der JDBC-Client-Treiber das
Ergebnis einer FileMaker-Formel vom Datentyp „Zeitstempel“ in java.sql.Types.TIMESTAMP.

Datentypen in 64-Bit-AnwendungenIn der 32-Bit-Version des ODBC API verwendeten einige Funktionen Parameter, die je nach
Kontext Ganzzahl- oder Zeigerwerte übergeben konnten. Bei 64-Bit-Windows-Betriebssystemenhaben Ganzzahlen und Zeiger nicht die gleiche Größe. Die 64-Bit-Version des ODBC API
verwendet abstrakte Datentypen, die nicht als bestimmte Größe definiert sind.
Anwendungen, die 32-Bit-Werte verwenden, können abstürzen, wenn sie auf ein 64-BitBetriebssystem portiert werden. Anwendungen, die abstrakte Datentypen verwenden,
funktionieren sowohl unter 32- als auch unter 64-Bit-Betriebssystemen richtig.

ODBC- und JDBC-Fehlermeldungen
Im Folgenden sind die grundlegenden Fehlermeldungen aufgeführt, die beim Arbeiten mit
FileMaker-Daten und ODBC/JDBC auftreten können.

ODBC-FehlermeldungenFehlermeldungen werden ausgegeben wegen:

1 ODBC-Treiberfehlern
1 FileMaker-Plattform- und FileMaker XDBC Listener-Fehlern

Kapitel 7 | Referenzinformationen

34

FileMaker ODBC-FehlermeldungenEin in FileMaker XDBC Listener oder der Datenquelle auftretender Fehler enthält den DSN und
hat folgendes Format:[FileMaker] [FileMaker ODBC] Meldung
Beispiel:[FileMaker] [FileMaker ODBC] Ungültiges Konto/Passwort
Falls diese Art von Fehler angezeigt wird, haben Sie im Datenbanksystem eine unzulässige
Aktion ausgeführt. Lesen Sie hierzu in Ihrer FileMaker-Produktdokumentation nach oder wenden
Sie sich an den Datenbankadministrator.
Aufeinander folgende Meldungen, die sich auf Fehler in verschiedenen Spalten beziehen, können
manchmal einen falschen Spaltennamen anzeigen.

JDBC-Fehlermeldungen
Der FileMaker JDBC-Treiber meldet Fehler durch Ausgabe von SQLExceptions an die aufrufende
Anwendung. Fehlermeldungen werden ausgegeben wegen:

1 JDBC-Treiberfehlern
1 FileMaker-Plattform- und FileMaker XDBC Listener-Fehlern
FileMaker JDBC-FehlermeldungenEin in FileMaker XDBC Listener oder der Datenquelle auftretender Fehler enthält den DSN und
hat folgendes Format:[FileMaker] [FileMaker JDBC] Meldung
Beispiel:[FileMaker] [FileMaker JDBC] Ungültiges Konto/Passwort
Falls diese Art von Fehler angezeigt wird, haben Sie im Datenbanksystem eine unzulässige
Aktion ausgeführt. Lesen Sie hierzu in Ihrer FileMaker-Produktdokumentation nach oder wenden
Sie sich an den Datenbankadministrator.

IndexZahlen32-BitArchitektur 12
Client-Treiber (Windows) 13
ODBC Administrator (Windows) 13
64-BitArchitektur 12
Client-Treiber (Windows) 13
Datentypen 33
ODBC Administrator (Windows) 14

A

Anforderungen für die Installation 12, 24
ARRAY-Datentyp 27
Automatisch erstellte Schlüssel 27

B
Beziehungsdiagramm 7
BLOB 33
Boolescher Datentyp 27

C
CAST-Funktion 32
Client-Anwendung, Verwenden von FileMaker Pro als 6
CLOB-Datentyp 27
Containerfeld
JDBC-Datentypzuordnung 33
ODBC-Datentypzuordnung 32
Cursor in JDBC 27

D
DatabaseMetaData-Methoden 32
DATALINK-Datentyp 27
DATE 33
Dateien
Einrichten des Zugriffs auf 20
Organisation auf einem Computer 7
Datenquelle
Ein Datenquellenname für jede FileMaker ProDatenbankdatei 8
Eine gemeinsam genutzte FileMaker Pro-Datenbankdatei
deaktivieren 8
Für Zugriff über JDBC konfigurieren 30, 31
Für Zugriff über ODBC konfigurieren (macOS) 22
Für Zugriff über ODBC konfigurieren (Windows) 21
Zugriff über ODBC überprüfen (macOS) 22
Zugriff über ODBC überprüfen (Windows) 21
Datenquellennamen
einer pro Datei 8
Erstellen (macOS) 22
Erstellen (Windows) 21

Datensätze importieren (Scriptschritt) 9, 10
Datentypen zuordnen
JDBC-Client-Treiber 33
ODBC-Client-Treiber 32
Datentypzuordnung
JDBC-Client-Treiber 33
ODBC-Client-Treiber 32
Deaktivieren einer gemeinsam genutzten FileMaker ProDatenbankdatei 8
DOUBLE 33

E
Einrichten von Zugriffsrechten und Sharing 20
Erforderliche Ports
Für JDBC 25
Für ODBC (macOS) 16
Für ODBC (Windows) 13
Erweiterte Zugriffsrechte 20
Externe SQL-Datenquellen
Unterstützte Versionen 11
Zugriff 9FFehlermeldungsformate 33
FelderZuordnung zu JDBC 33
Zuordnung zu ODBC 32
FileMaker ODBC-Client-Treiber
macOS 16
Windows 13
fmxdbc, erweitertes Zugriffsrecht 20, 30
Funktion „SQLAusführen“ 10G
GetAs-Funktion 32
getColumnPrivileges-Methode 32
getColumns-Methode 32
getMetaData-Methode 32
getTables-Methode 32
getTableTypes-Methode 32
getTypeInfo-Methode 32
getVersionColumns-Methode 32

H
Haltbare Cursor in JDBC 27

I
Importieren von ODBC-Daten 9
Installationsanforderungen 12, 24

36

JJava Development Kit (JDK) 27
Java-Version 24
JDBC
Beschreibung 26
Client-Treiber, beschrieben 27
Fehlermeldungen 34
JDBC SPI 27
JDBC-Client-Treiber
beim JDBC-Treiber-Manager registrieren 28
Datentypen zuordnen 33
JDBC URL angeben 27
Treiberklasse und Haupteinstieg 27
Zugriff überprüfen 31

K
Katalogfunktion 32
Konfigurieren einer FileMaker-Datenquelle
Für ODBC (macOS) 22
Für ODBC (Windows) 21
Über JDBC 30
Konten und Zugriffsrechte 20

M
macOS
Erstellen eines DSN 16
JDBC-Client-Treiber-Anforderungen 24Überprüfen des ODBC-Zugriffs 22
Metadata-Methoden 32
Microsoft Access 8
MySQL 11

N
Netzwerkanforderungen 8
Nullwert 32O
ODBC
Beschreibung 19
Fehlermeldungen 33
Wiederholfelder 33
ODBC Administrator (macOS) 22
ODBC Data Source Administrator
Einen Datenquellennamen erstellen 14
ODBC Manager
Download 16
Erstellen eines Datenquellennamens 16
ODBC-Zugriff überprüfen 22
ODBC-Client-Treiber
Datentypen zuordnen 32
Zugriff überprüfen (macOS) 22
Zugriff überprüfen (Windows) 21
ODBC-Datenquellenadministrator
ODBC-Zugriff überprüfen 21Öffnen 13

ODBC-Katalogfunktionen 32
Oracle 11

P
Passwort
Mit JDBC 30
Mit ODBC 21, 22
Port 2399
Für JDBC erforderlich 25
für ODBC erforderlich (macOS) 16
Für ODBC erforderlich (Windows) 13

R
Rapid Application Development (RAD)-Tools 26
REF-Datentyp 27
Registrieren des JDBC-Client-Treibers 28
Remote-Zugriff 7
Runtime-Lösungen, Beschränkungen 10

S
SAVEPOINT-Unterstützung 27
Schemamodifikation 7
Sharing, Einrichten von ODBC/JDBC- 20
Spaltennamen 21
SQL ausführen (Scriptschritt) 9, 10
SQL Query Builder 6, 10
SQL Server 11
SQL_DATE 32
SQL_DOUBLE 32
SQL_LONGVARBINARY 32
SQL_TIME 32
SQL_TIMESTAMP 32
SQL_VARCHAR 32
SQLColumnPrivileges 32
SQLColumns 32
SQLDescribeCol 32
SQLExceptions 34
SQLGetTypeInfo 32
SQLTables 32
Systemanforderungen
Für JDBC-Client-Treiber 24
Für ODBC-Client-Treiber 12

T
TCP/IP-Anforderungen 8
TIME 33
TIMESTAMP 33
Treiber, kompatible Versionen 8
Treibereigenschaften
JDBC-Client-Treiber 30
ODBC-Client-Treiber (macOS) 22
ODBC-Client-Treiber (Windows) 21

37

U
URL (Uniform Resource Locator) für den JDBC-ClientTreiber 27

V
VARCHAR 33
Verwenden von ODBC und JDBC mit FileMaker-Software 6

W
Wiederholfelder 33
Windows
Erstellen eines Datenquellennamens 21
JDBC-Client-Treiber-Anforderungen 24Überprüfen des ODBC-Zugriffs 21

X
XDBC Listener
Fehlermeldungen 33
Mit JDBC verwendet 27
Mit ODBC verwendet 20

Z
Zugriff testen
JDBC-Client-Treiber 31
ODBC-Client-Treiber (macOS) 22
ODBC-Client-Treiber (Windows) 21
Zugriff über ODBC/JDBC, erweitertes Zugriffsrecht 20
Zugriff überprüfen
JDBC-Client-Treiber 31
ODBC-Client-Treiber (macOS) 22
ODBC-Client-Treiber (Windows) 21
Zugriffsrechte, erweitert 20