FileMaker ODBC and JDBC Guide

Transcription

1 FileMaker 14 ODBC 和 JDBC 指南

2 FileMaker, Inc. 保留一切权利 FileMaker, Inc Patrick Henry Drive Santa Clara, California FileMaker 和 FileMaker Go 是 FileMaker, Inc. 在美国以及其他国家和地区的注册商标 文件夹标志和 FileMaker WebDirect 是 FileMaker, Inc. 的商标 所有其他商标分别是其各自所有者的财产 FileMaker 文档受版权保护 未经 FileMaker 书面同意, 任何人无权制作文档或分发此文档 本文档仅可用于有效授权版本的 FileMaker 软件 示例中列出的所有人员 公司 电子邮件 或 URL 纯属虚构, 如有雷同, 纯属巧合 关于作者 部分列在本软件附带的 鸣谢 文档中 此处所提及的第三方产品和 URL 仅作提供信息之用, 不代表任何担保或推荐 FileMaker, Inc. 对这些产品的性能不承担任何责任 有关更多信息, 请访问我们的网站 版本 :01

3 目录 第 1 章简介 5 关于本指南 5 FileMaker 文档的位置 5 关于 ODBC 和 JDBC 5 将 FileMaker 软件用作 ODBC 客户端应用程序 6 导入 ODBC 数据 6 将 ODBC 表添加到关系图 6 将 FileMaker 数据库用作数据源 6 访问托管的 FileMaker Pro 数据库 6 第三方工具限制 7 网络要求 7 更新以前版本的文件 7 安装最新驱动程序 7 第 2 章访问外部 SQL 数据源 8 导入 ODBC 数据 8 执行 SQL 通过 ODBC 与数据源交互 9 使用关系图中的 ODBC 表 9 FileMaker 14 中支持的数据源 10 将 ODBC 表添加到关系图 10 第 3 章安装 FileMaker ODBC 客户端驱动程序 11 硬件和软件要求 11 网络要求 11 ODBC 客户端驱动程序体系结构概述 11 ODBC 客户端驱动程序安装 (Windows) 11 配置客户端驱动程序 (Windows) 12 打开 ODBC 管理器 (Windows) 12 配置 DSN (Windows) 13 ODBC 客户端驱动程序安装 (OS X) 14 配置客户端驱动程序 (OS X) 14 后续操作 16

4 4 第 4 章使用 ODBC 共享 FileMaker 数据 17 关于 ODBC 17 使用 ODBC 客户端驱动程序 18 访问 FileMaker 数据库文件概述 18 从 Windows 应用程序访问 FileMaker 数据库文件 19 指定 FileMaker DSN 的 ODBC 客户端驱动程序属性 (Windows) 19 验证通过 ODBC 访问 (Windows) 19 从 OS X 应用程序访问 FileMaker 数据库文件 20 指定 FileMaker DSN 的 ODBC 客户端驱动程序属性 (OS X) 20 验证通过 ODBC 访问 (OS X) 20 第 5 章安装 FileMaker JDBC 客户端驱动程序 21 软件要求 21 网络要求 21 JDBC 客户端驱动程序安装 21 使用 JDBC 客户端驱动程序 22 第 6 章使用 JDBC 共享 FileMaker 数据 23 关于 JDBC 23 使用 JDBC 客户端驱动程序 23 关于 JDBC 客户端驱动程序 23 使用 JDBC URL 连接到数据库 24 在 URL 子名称中指定驱动程序属性 25 具有多个 FileMaker 数据库文件的解决方案 26 验证通过 JDBC 访问 26 第 7 章参考信息 27 ODBC 目录函数 27 JDBC DatabaseMetaData 方法 27 将 FileMaker 字段映射到 ODBC 数据类型 27 将 FileMaker 字段映射到 JDBC 数据类型 位应用程序中的数据类型 28 ODBC 和 JDBC 错误消息 28 ODBC 错误消息 28 JDBC 错误消息 29 索引 30

5 第 1 章简介 本指南介绍如何使用 FileMaker 软件作为 ODBC 客户端应用程序和开放式数据库连接 (ODBC) 及 Java 数据库连接 (JDBC) 应用程序的数据源 下表提供了如何将 ODBC 和 JDBC 与 FileMaker 软件一起使用的概览 预期目标 实现方式 产品 参考资料 1. 通过关系图交互 1 FileMaker Pro 1 FileMaker Pro Advanced 1 FileMaker Server 1 将 FileMaker 软件用作 ODBC 客户端应用程序 1 访问在外部 SQL 数据源中存储的 ODBC 数据 1 将 FileMaker 数据库用作数据源 1 将 FileMaker Pro 数据与第三方 ODBC 客户端应用程序共享 2. 通过 ODBC 导入或 文件 菜单 > 打开 一次性静态访问 另外, 还可使用 导入记录 脚本步骤, 执行 SQL 脚本步骤和 ExecuteSQL 函数访问 1. ODBC 和 JDBC 2. SQL 查询 1 FileMaker Pro 1 FileMaker Pro Advanced 1 FileMaker Server 1 本指南的第 2 章 1 FileMaker Pro 帮助 1 本指南的第 3 章到第 6 章 1 FileMaker SQL 参考 关于本指南 1 本指南假定您熟悉使用 ODBC 和 JDBC, 以及构建 SQL 查询的基础知识 FileMaker SQL 参考 介绍 FileMaker 支持的 SQL 语句和标准 有关更全面的 SQL 查询构建信息, 请参阅第三方相关书籍 1 本手册使用 FileMaker Pro 表示 FileMaker Pro 和 FileMaker Pro Advanced 两者, 除非是说明特定的 FileMaker Pro Advanced 功能 FileMaker 文档的位置 1 在 FileMaker Pro 中, 选择 帮助 菜单 > 产品文档 1 在 FileMaker Server 管理控制台中, 选择 帮助 菜单 > FileMaker Server 产品文档 1 要了解 查阅或下载其他 FileMaker 文档, 请访问 关于 ODBC 和 JDBC ODBC 和 JDBC 是应用程序编程接口 (API) ODBC 是以 C 语言编写的应用程序的 API, 而 JDBC 是 Java 语言的类似 API 这些 API 为客户端应用程序提供了与各种数据源和数据库服务 ( 包括 FileMaker Pro 和 FileMaker Server) 交互的公共语言 支持 ODBC 和 JDBC 的所有应用程序都识别 SQL ( 结构化查询语言 ) 语句的基本子集 利用 SQL, 可以使用其他应用程序 ( 例如, 电子表格 文字处理程序和报表工具 ) 来查看 分析和修改数据 客户端应用程序使用 ODBC 或 JDBC API 来与驱动程序管理程序 ( 识别客户端驱动程序以与数据源通信 ) 通信 客户端应用程序 驱动程序管理程序 客户端驱动程序 数据源 FileMaker 软件可充当客户端应用程序或数据源

6 第 1 章 简介 6 将 FileMaker 软件用作 ODBC 客户端应用程序 作为 ODBC 客户端应用程序, FileMaker 软件可以访问外部 SQL 数据源中的数据 FileMaker 软件使用 ODBC 数据源的客户端驱动程序连接到外部 SQL 数据源, 并导入 ODBC 数据或使用关系图中的 ODBC 表 导入 ODBC 数据 可以通过以下方式之一导入 ODBC 数据 : 1 从 文件 菜单, 在 FileMaker Pro SQL 查询生成器 对话框中指定 ODBC 数据源并输入 SQL 语句 1 创建使用 导入记录 脚本步骤 执行 SQL 脚本步骤或 ExecuteSQL 函数的 FileMaker 脚本 对于上述任一方法, 您自己输入 SQL 语句, 所以需要了解您的 ODBC 数据源支持的 SQL 语句及其语法 因为由您编写 SQL 语句, 所以您可以从任一 ODBC 数据源导入 ODBC 数据 有关 FileMaker 支持的 SQL 语句和语法的更多信息, 请参阅 FileMaker SQL 参考 将 ODBC 表添加到关系图 将 ODBC 表添加到关系图时, 可以连接到外部 SQL 数据源中的数据并使用这些数据, 方法与使用当前活动 FileMaker 数据库文件中数据的方法大致相同 例如, 您可以 : 1 在 ODBC 数据源的关系图中创建表 1 将补充字段添加到 ODBC 表, 以执行未存储计算或汇总 ODBC 表中的数据 1 交互地添加 更改和删除外部数据 1 创建 FileMaker 表中字段和 ODBC 表中字段 ( 也称为 列 ) 之间的关系 因为 FileMaker Pro 会生成用于与 ODBC 表 ( 已经添加到关系图 ) 通信的 SQL 语句, 所以您只能使用 FileMaker Pro 在关系图中支持的特定的 Oracle SQL Server 和 MySQL 数据源 注释 您不能使用 FileMaker Pro 修改外部 ODBC 数据源的架构 第 2 章 访问外部 SQL 数据源, 介绍了如何将 FileMaker 软件用作 ODBC 客户端应用程序 将 FileMaker 数据库用作数据源 作为数据源,FileMaker 数据与兼容 ODBC 和 JDBC 的应用程序共享 应用程序使用 FileMaker 客户端驱动程序连接到 FileMaker 数据源, 使用 ODBC 或 JDBC 构建和执行 SQL 查询, 并处理从 FileMaker 数据库解决方案检索的数据 访问托管的 FileMaker Pro 数据库 使用 FileMaker Server 或 FileMaker Pro, 可以托管 FileMaker 数据库文件作为数据源, 使用 ODBC 和 JDBC 将您的数据与其他应用程序共享 下表说明了每个 FileMaker 产品允许的内容 本 FileMaker 产品 FileMaker Server 允许 无限制连接, 并支持本地访问 ( 同一计算机 ) 和远程访问 ( 适用于诸如 Web 服务器这样的中间件, 以及从桌面生产力应用程序远程访问客户端 ) FileMaker Pro 最多五个连接, 并仅支持本地访问 ( 同一计算机 ) 如果您的 FileMaker 数据库解决方案使用多个 FileMaker 数据库文件, 则所有数据库文件必须位于同一计算机上 要访问托管的 FileMaker 数据库文件, 需要安装相应的 ODBC 或 JDBC 客户端驱动程序 在安装有第三方应用程序的计算机上安装客户端驱动程序

7 第 1 章 简介 7 本指南说明在与 FileMaker Pro 和 FileMaker Server 一起使用时,ODBC 和 JDBC 客户端驱动程序如何支持 ODBC 和 JDBC 的行业标准 1 第 3 章 安装 FileMaker ODBC 客户端驱动程序, 说明如何安装使用 ODBC 访问 FileMaker 数据源所需的驱动程序文件 1 第 4 章 使用 ODBC 共享 FileMaker 数据, 说明如何使用 FileMaker ODBC 客户端驱动程序从其他应用程序连接到 FileMaker 数据源 1 第 5 章 安装 FileMaker JDBC 客户端驱动程序, 说明如何安装使用 JDBC 访问 FileMaker 数据源所需的驱动程序文件 1 第 6 章 使用 JDBC 共享 FileMaker 数据, 说明如何将 FileMaker JDBC 客户端驱动程序与连接到 FileMaker 数据源的 Java 应用程序或小程序一起使用 1 第 7 章 参考信息, 介绍了将 FileMaker 字段映射到 ODBC 和 JDBC 数据类型 要了解与 FileMaker Pro 和 FileMaker Server 一起使用时由 ODBC 和 JDBC 客户端驱动程序支持的 SQL 语句, 请参阅 FileMaker SQL 参考 重要如果在 ODBC/JDBC 共享已经启用之后禁用它, 由 FileMaker Server 或 FileMaker Pro 托管的数据源会立即不可用 数据库管理员不能向 ODBC 和 JDBC 客户端应用程序就数据源的可用性发出警告 ( 管理员只能与 FileMaker 数据库文件客户端通信 ) 不会报告错误, 并且客户端应用程序会通知用户数据源不可用, 无法完成交易 如果客户端应用程序尝试连接到不可用的 FileMaker 数据库文件, 则会显示一条消息, 说明连接失败 第三方工具限制 Microsoft Access: 使用 Microsoft Access 查看 FileMaker 数据源中的数据时, 不要使用摘要字段的数据 摘要字段的数据不应在 Microsoft Access 中编辑, 并且在 Microsoft Access 中显示的数据值可能不准确 网络要求 使用 FileMaker Server 通过网络将 FileMaker 数据库文件托管为数据源时, 需要 TCP/IP 网络 FileMaker Pro 仅支持本地访问 ( 同一计算机 ) 更新以前版本的文件 安装最新驱动程序 如果您安装的是 FileMaker Pro 或 FileMaker Server 早期版本的驱动程序, 则必须安装版本 14 的驱动程序 FileMaker 版本 14 的驱动程序与 FileMaker Pro 或 FileMaker Server 的早期版本不兼容 有关安装驱动程序的更多信息, 请参阅第 3 章 安装 FileMaker ODBC 客户端驱动程序 和第 5 章 安装 FileMaker JDBC 客户端驱动程序 注释 1 您必须为要作为数据源访问的每个 FileMaker 数据库文件创建数据源名称 (DSN) 如果先前已经通过允许在多个 FileMaker 数据库文件中分部表的 DSN 设置了访问, 则需要将这些表合并为一个数据库文件 ( 或创建多个 DSN) 1 有关将 ODBC 和 JDBC 与 FileMaker Pro 的先前版本一起使用的信息, 请参阅

8 第 2 章访问外部 SQL 数据源 作为 ODBC 客户端应用程序,FileMaker 软件可以访问外部 SQL 数据源中的数据 FileMaker 软件使用 ODBC 数据源的客户端驱动程序连接到外部 SQL 数据源, 并导入 ODBC 数据或使用关系图中的 ODBC 表 无论导入 ODBC 数据, 还是使用关系图中的 ODBC 表, 都必须为您所使用的 ODBC 数据源配置驱动程序 例如, 要访问 Oracle 数据库中的记录, 则需配置 Oracle 客户端驱动程序 导入 ODBC 数据 在导入 ODBC 数据时, 需要在客户端计算机上配置外部 SQL 数据源的 ODBC 客户端驱动程序 FileMaker Pro 驱动程序管理程序 客户端驱动程序 SQL 数据源 在配置 ODBC 客户端驱动程序后, 您可以与记录交互, 将记录导入现有 FileMaker Pro 数据库文件, 或者从 ODBC 数据源 ( 例如, Oracle 或 Microsoft Access 数据库 ) 创建新的 FileMaker Pro 数据库文件 首先, 访问要从其中进行导入的数据源 然后, 为要从数据源导入的记录构建查询 最后, 如果要将数据导入现有文件, 将数据源的字段映射到 FileMaker Pro 数据库文件中的字段 利用 导入记录 脚本步骤, 执行 SQL 脚本步骤或使用 ExecuteSQL 函数, 可以通过 文件 菜单访问 ODBC 数据源 要导入 ODBC 数据, 请执行以下一般过程 : 1. 为要访问的外部数据源安装和配置特定的 ODBC 驱动程序 2. 在托管当前 FileMaker Pro 文件的计算机上, 为要访问的每个 ODBC 数据源定义系统数据源名称 (DSN) 3. 确定要访问的 ODBC 数据源的其他考虑事项 ( 例如, 是否提示用户输入用户名和密码 ) 4. 在 FileMaker Pro 中, 执行以下某项操作 : 1 要导入到现有 FileMaker Pro 文件, 选择 文件 菜单 > 导入记录 > ODBC 数据源 1 要从数据源记录创建 FileMaker Pro 文件, 选择 文件 菜单 > 打开 在 打开 对话框中, 为 文件类型 (Windows) 或 显示 (OS X) 选择 ODBC 数据源 5. 选择您的数据源, 输入用户名和密码 ( 如果有 ), 然后单击 确定 来打开 FileMaker Pro SQL 查询生成器 对话框

9 第 2 章 访问外部 SQL 数据源 9 6. 使用 FileMaker Pro SQL 查询生成器 对话框, 可以构建查询 选择要从中导入的表, 然后选择要在 SQL 查询中使用的特定列 使用 WHERE 选项卡来构建搜索条件, 并使用 ORDER BY 选项卡来指定排序顺序 还可以将 SQL 语句直接键入 SQL 查询生成器 对话框 可以立即执行查询, 或者使用 导入记录 脚本步骤, 执行 SQL 脚本步骤或 ExecuteSQL 函数来作为 FileMaker 脚本的一部分来执行查询 注释在使用 FileMaker Pro Advanced 创建的运行时解决方案中不支持 ODBC 导入 执行 SQL 脚本步骤和外部 SQL 数据源 有关导入数据 使用 SQL 查询生成器 对话框和创建 FileMaker 脚本的更多信息, 请参阅 FileMaker Pro 帮助 有关 FileMaker 支持的 SQL 语句和语法的信息, 请参阅 FileMaker SQL 参考 执行 SQL 通过 ODBC 与数据源交互 除了通过 ODBC 将数据导入 FileMaker Pro 数据库文件之外, 还可以通过 执行 SQL 脚本步骤和 ExecuteSQL 函数使用 SQL 语句与数据源交互 执行 SQL 脚本步骤可以使用数据源支持的任何 SQL 语句, 例如 INSERT UPDATE 和 DELETE ExecuteSQL 函数只支持 SELECT 语句 还可以使用不仅仅将数据导入 FileMaker Pro 数据库文件的 SQL 语句 例如, 使用 FileMaker Pro 数据库文件中的信息, 您可以执行将记录添加到 SQL Server 中的数据库表的 SQL 语句 有关创建使用执行 SQL 脚本步骤和 ExecuteSQL 函数的 FileMaker 脚本的更多信息, 请参阅 FileMaker Pro 帮助 有关 FileMaker 支持的 SQL 语句和语法的信息, 请参阅 FileMaker SQL 参考 使用关系图中的 ODBC 表 将 ODBC 表添加到关系图时, 可以连接到外部 SQL 数据源中的数据并使用这些数据, 方法与使用当前活动 FileMaker 数据库文件中数据的方法大致相同 对于关系图中包括 ODBC 表的解决方案, 使用 FileMaker Pro 或 FileMaker Server 作为主机时, 需要在主机上配置外部 SQL 数据源的 ODBC 客户端驱动程序 FileMaker Pro 用户 FileMaker Pro 用户 FileMaker Pro 或 FileMaker Server 主机 驱动程序管理程序 客户端驱动程序 SQL 数据源 FileMaker Pro 用户

10 第 2 章 访问外部 SQL 数据源 10 FileMaker 14 中支持的数据源 作为 ODBC 客户端应用程序, FileMaker 支持以下外部 SQL 数据源作为关系图中的 ODBC 表 : 1 Oracle 1 Microsoft SQL Server 1 MySQL Community Edition ( 免费 ) 有关这些 ODBC 数据源受支持版本的信息, 请搜索 FileMaker 知识库, 网址为 将 ODBC 表添加到关系图 要将 FileMaker Pro 数据库设置为访问所支持 ODBC 数据源中的数据, 请执行以下操作 : 1. 为要访问的外部数据源安装和配置特定的 ODBC 驱动程序 2. 在托管当前 FileMaker Pro 文件的计算机上, 为要访问的每个 ODBC 数据源定义系统数据源名称 (DSN) 3. 确定要访问的 ODBC 数据源的其他考虑事项 ( 例如, 是否提示用户输入用户名和密码 ) 4. 将一个或多个表从 ODBC 数据源添加到当前 FileMaker Pro 文件中的关系图 5. 将字段添加到 FileMaker Pro 文件中的布局来显示外部数据 6. 或者, 将补充字段添加到外部表和布局, 以基于存储于外部 ODBC 数据源中的数据显示计算和汇总结果 有关配置 ODBC 客户端驱动程序 连接到 ODBC 数据源 编辑 ODBC 数据源和设置关系图中的 ODBC 表的详细步骤和其他信息, 请参阅 FileMaker Pro 帮助

11 第 3 章安装 FileMaker ODBC 客户端驱动程序 以下说明可帮助您安装从第三方应用程序和自定义应用程序通过 ODBC 访问 FileMaker 作为数据源所需的 ODBC 客户端驱动程序 ODBC 客户端驱动程序可通过在 FileMaker 安装磁盘或电子下载版的 xdbc 文件夹进行单独安装获得 在以下 URL 中检查客户端驱动程序的更新 : 如果您要使用 FileMaker Server 托管 FileMaker 数据库文件, 请使客户端驱动程序可供远程用户使用 在安装所需的客户端驱动程序之后, 可以将驱动程序配置为访问 FileMaker 数据源并构建 SQL 查询与数据交互 硬件和软件要求 安装和使用 ODBC 客户端驱动程序需要满足此 FileMaker 网站所述的最低硬件和软件要求 : 网络要求 如果您要访问在其他计算机上托管的 FileMaker 数据源, 将需要通过 TCP/IP 访问网络 ODBC 客户端驱动程序体系结构概述 FileMaker 为 Windows 和 OS X 提供了 32 位和 64 位客户端驱动程序, 以支持 32 位和 64 位 ODBC 应用程序 安装的客户端驱动程序必须与 ODBC 应用程序匹配, 而非与操作系统匹配 : 1 如果 ODBC 应用程序是 32 位应用程序, 则安装 32 位客户端驱动程序 1 如果 ODBC 应用程序是 64 位应用程序, 则安装 64 位客户端驱动程序 ODBC 客户端驱动程序安装 (Windows) Windows 32 位和 64 位客户端驱动程序作为单独的库安装 在 32 位版本的 Windows 操作系统上, 只能安装 32 位客户端驱动程序 在 64 位版本的 Windows 操作系统上, 安装 32 位和 64 位客户端驱动程序均可 要安装 ODBC 客户端驱动程序 : 1. 执行以下某项操作 : 1 如果您以电子方式收到软件, 双击安装图标 (.exe 文件 ) 1 如果您具有安装磁盘, 将磁盘插入驱动器 2. 在 FileMaker Pro 或 FileMaker Server 窗口中, 双击 xdbc 文件夹 3. 在 xdbc 文件夹中, 双击 ODBC Client Driver Installer 文件夹

12 第 3 章 安装 FileMaker ODBC 客户端驱动程序 在 ODBC Client Driver Installer 文件夹中, 双击您要安装的驱动程序的安装程序文件 1 要安装 32 位客户端驱动程序 (fmodbc32.dll), 使用 32 位安装程序文件 : FMODBC_Installer_Win32.msi 1 要安装 64 位客户端驱动程序 (fmodbc64.dll), 使用 64 位安装程序文件 : FMODBC_Installer_Win64.msi FileMaker ODBC 驱动程序安装向导 随即打开 5. 按照屏幕上的说明操作, 安装 ODBC 客户端驱动程序 6. 安装完成时, 单击 关闭 默认情况下, ODBC 客户端驱动程序将安装到此文件夹 : 1 在 32 位版本的 Windows 操作系统上, 32 位客户端驱动程序 (fmodbc32.dll) 安装在 C:\Windows\System32 1 在 64 位版本的 Windows 操作系统上, 32 位客户端驱动程序 (fmodbc32.dll) 安装在 C:\Windows\SysWOW64 1 在 64 位版本的 Windows 操作系统上, 64 位客户端驱动程序 (fmodbc64.dll) 安装在 C:\Windows\System32 现在, 您即可配置 ODBC 客户端驱动程序 FileMaker ODBC 来访问 FileMaker 数据源 配置客户端驱动程序 (Windows) 在使用 ODBC 客户端应用程序访问 FileMaker 数据源之前, 必须为数据源配置一个客户端驱动程序 配置设置会识别您使用的客户端驱动程序 数据源的位置和您打算如何连接的详细信息 重要 使用 FileMaker 客户端驱动程序时, 必须保留 2399 作为端口 打开 ODBC 管理器 (Windows) 要在 32 位 Windows 操作系统上打开 32 位 ODBC 管理器, 请执行以下操作 : 在 Windows 控制面板中, 打开 管理工具 > 数据源 (ODBC) 注释 管理工具 控制面板出现在 系统和安全 类别中 32 位 ODBC 数据源管理器随即打开 要在 32 位 Windows 操作系统上打开 64 位 ODBC 管理器, 请执行以下操作 : 在 Windows 控制面板中, 打开 管理工具 > ODBC 数据源 (32 位 ) 注释 管理工具 控制面板出现在 系统和安全 类别中 32 位 ODBC 数据源管理器随即打开 要在 64 位 Windows 操作系统上打开 64 位 ODBC 管理器, 请执行以下操作 : 在 Windows 控制面板中, 打开 管理工具 > ODBC 数据源 (64 位 ) 注释 管理工具 控制面板出现在 系统和安全 类别中 64 位 ODBC 数据源管理器随即打开

13 第 3 章 安装 FileMaker ODBC 客户端驱动程序 13 配置 DSN (Windows) 要配置 ODBC 客户端驱动程序, 请执行以下操作 : 1. 在 ODBC 数据源管理器中, 选择 系统 DSN 或 用户 DSN 选项卡 为要作为数据源访问的每个 FileMaker 数据库文件创建一个 DSN 2. 单击 添加 创建新数据源 对话框随即打开 3. 选择 FileMaker ODBC, 然后单击 完成 FileMaker DSN 配置 对话框随即打开 4. 单击 下一步 5. 对于 名称, 输入便于访问 FileMaker 数据源的其他人识别的名称 对于 说明, 输入 FileMaker 数据源的可选说明 单击 下一步 6. 对于 主机 : 1 如果您要连接到由 FileMaker Pro 在您的本地计算机上托管的数据库文件, 输入 localhost 或 IP 地址 如果要连接到由 FileMaker Server 通过网络托管的数据库文件, 输入 FileMaker Server 的 IP 地址 如果您在主机应用程序中启用了通过 ODBC/JDBC 共享, 可以选择 连接到主机以获取可用数据库的名称 单击 下一步 否则, 单击 完成 来保存您的数据源信息 7. 对于 数据库, 从可用数据库的列表中选择一个数据库, 或键入您要用作数据源的 FileMaker 数据库文件的文件名 注释对于由 FileMaker Server 托管的数据库文件, 可以基于 文件显示过滤器 设置过滤数据库的列表 有关信息, 请参阅 FileMaker Server 帮助 1 如果您需要对非英语文本进行特殊处理, 单击 高级语言 高级语言选项 对话框随即打开 要自动检测语言设置, 选择 自动检测应用程序的语言设置 选项 要指定语言设置, 清除 自动检测应用程序的语言设置 选项, 并选择您要使用的系统设置 对于 多字节文本编码 选项, 选择 系统 或选择 UTF-8 例如, 诸如 Microsoft Excel 这样的一些应用程序可能希望使用 系统 编码对文本进行编码, 但 Web 应用程序可能希望使用 UTF-8 编码对文本进行编码 如果应用程序需要特定的编码, 但此选项指定了其他编码, 则应用程序显示的一些字符可能不正确 1 选择 将文本字段描述为长 varchar 选项, 以更正长字段值的问题, 例如, 将未指定最长长度的字段用于 Microsoft Word 邮件合并 导入, 或 PHP 应用程序中长于 255 个字符的字段值 如果您不对长于 255 个字符的字段值使用此选项, 则您的应用程序检索到的可能是空字符串 (Windows) 或仅检索到 255 个字符 (OS X) 1 如果要为长时间运行的查询创建一个日志文件, 选择 将长时间运行的查询保存为日志文件 选项, 然后输入日志文件的名称 单击 完成 来保存您的数据源信息

14 第 3 章 安装 FileMaker ODBC 客户端驱动程序 查看有关 FileMaker DSN 的信息 1 单击 测试 来验证您已将 ODBC 客户端驱动程序正确地配置为访问 FileMaker 数据源 如果您收到错误消息, 可以更正连接信息 您可能还需要检查 FileMaker 数据库文件是否已托管并且可用, 指定的 FileMaker 帐户是否使用具有通过 ODBC/JDBC 访问的扩展权限的权限集, 以及是否已经将 FileMaker Server 或 FileMaker Pro 主机应用程序设置为通过 ODBC/JDBC 共享 1 单击 完成 来保存您的数据源信息 ODBC 客户端驱动程序安装 (OS X) OS X 32 位和 64 位客户端驱动程序作为单个包 (FileMaker ODBC.bundle) 安装在 /Library/ODBC 文件夹中 ODBC 客户端应用程序会自动加载正确的驱动程序 要安装 ODBC 客户端驱动程序 : 1. 执行以下某项操作 : 1 如果您以电子方式收到软件, 双击磁盘映像图标 (.dmg 文件 ) 1 如果您具有安装磁盘, 将磁盘插入驱动器 2. 在 FileMaker Pro 或 FileMaker Server 窗口中, 双击 xdbc 文件夹 3. 在 xdbc 文件夹中, 双击 ODBC Client Driver Installer 文件夹 4. 在 ODBC Client Driver Installer 文件夹中, 双击 FileMaker ODBC.pkg FileMaker ODBC 驱动程序 应用程序随即打开 5. 按照屏幕上的说明操作, 安装 ODBC 客户端驱动程序 6. 安装完成时, 单击 关闭 ODBC 客户端驱动程序将安装到此文件夹 :/Library/ODBC 注释 无法更改 ODBC 客户端驱动程序的安装文件夹 现在, 您即可配置 ODBC 客户端驱动程序 FileMaker ODBC 来访问 FileMaker 数据源 配置客户端驱动程序 (OS X) 在使用 ODBC 客户端应用程序访问 FileMaker 数据源之前, 必须为数据源配置一个客户端驱动程序 配置设置会识别您使用的客户端驱动程序 数据源的位置和您打算如何连接的详细信息 这些说明假定您已经从网址为 的 Actual Technologies 安装了 ODBC 管理程序 ( 此程序是 FileMaker 不支持的免费产品 ) 因为 32 位和 64 位客户端驱动程序只有一个安装的程序包, 所以可以将同一 ODBC 管理器用于 32 位和 64 位 ODBC 应用程序 您配置的 FileMaker DSN 可用于 32 位和 64 位 ODBC 应用程序 重要 使用 FileMaker 客户端驱动程序时, 必须保留 2399 作为端口 要配置 ODBC 客户端驱动程序, 请执行以下操作 : 1. 启动 ODBC 管理程序实用工具 (ODBC 管理程序安装在 应用程序 文件夹的 实用工具 文件夹中 ) 2. 选择 系统 DSN 或 用户 DSN 选项卡 为要作为数据源访问的每个 FileMaker 数据库文件创建一个 DSN

15 第 3 章 安装 FileMaker ODBC 客户端驱动程序 单击 添加 选择驱动程序 对话框随即打开 4. 选择 FileMaker ODBC, 然后单击 确定 FileMaker DSN 配置 对话框随即打开 5. 单击 继续 6. 对于 名称, 输入便于访问 FileMaker 数据源的其他人识别的名称 对于 说明, 输入 FileMaker 数据源的可选说明 单击 继续 7. 对于 主机 : 1 如果您要连接到由 FileMaker Pro 在您的本地计算机上托管的数据库文件, 输入 localhost 或 IP 地址 如果要连接到由 FileMaker Server 通过网络托管的数据库文件, 输入 FileMaker Server 的 IP 地址 如果您在主机应用程序中启用了通过 ODBC/JDBC 共享, 可以选择 连接到主机以获取可用数据库的名称 单击 继续 否则, 单击 完成 来保存您的数据源信息 8. 对于 数据库, 从可用数据库的列表中选择一个数据库, 或键入您要用作数据源的 FileMaker 数据库文件的文件名 注释对于由 FileMaker Server 托管的数据库文件, 可以基于 文件显示过滤器 设置过滤数据库的列表 有关信息, 请参阅 FileMaker Server 帮助 1 如果您需要对非英语文本进行特殊处理, 单击 高级语言 高级语言选项 对话框随即打开 要自动检测语言设置, 选择 自动检测应用程序的语言设置 选项 要指定语言设置, 清除 自动检测应用程序的语言设置 选项, 并选择您要使用的系统设置 如果您的应用程序对 ODBC 函数使用字符为 4 个字节宽的字符缓冲区, 选择 应用程序使用 宽 ODBC API 选项 如果需要驱动程序将 SQL_C_CHAR 文本类型解释为 SQL_C_WCHAR 文本类型, 选择 将文本类型视为 Unicode 选项 对于 多字节文本编码 选项, 选择 系统 (MacRoman) 或选择 UTF-8 例如, 诸如 Microsoft Excel 这样的一些应用程序可能希望使用 系统 编码对文本进行编码, 但 Web 应用程序可能希望使用 UTF-8 编码对文本进行编码 如果应用程序需要特定的编码, 但此选项指定了其他编码, 则应用程序显示的一些字符可能不正确 1 选择 将文本字段描述为长 varchar 选项, 以更正长字段值的问题, 例如, 将未指定最长长度的字段用于 Microsoft Word 邮件合并 导入, 或 PHP 应用程序中长于 255 个字符的字段值 1 如果要为长时间运行的查询创建一个日志文件, 选择 将长时间运行的查询保存为日志文件 选项, 然后输入日志文件的名称 也可以更改 长查询时间 值 单击 完成 来保存您的数据源信息 9. 查看有关 FileMaker DSN 的信息 1 单击 测试 来验证您已将 ODBC 客户端驱动程序正确地配置为访问 FileMaker 数据源 如果您收到错误消息, 可以更正连接信息 您可能还需要检查 FileMaker 数据库文件是否已托管并且可用, 指定的 FileMaker 帐户是否使用具有通过 ODBC/JDBC 访问的扩展权限的权限集, 以及是否已经将 FileMaker Server 或 FileMaker Pro 主机应用程序设置为通过 ODBC/JDBC 共享 1 单击 完成 来保存您的数据源信息

16 第 3 章 安装 FileMaker ODBC 客户端驱动程序 16 后续操作 在安装和配置客户端驱动程序之后, 可以构建并执行 SQL 查询来访问 FileMaker 数据源 客户端应用程序有时使用其他术语来表示通过 ODBC 访问数据源 许多应用程序具有名称诸如 获取外部数据 或 SQL 查询 的菜单项 有关详细信息, 请参阅随应用程序提供的文档或 帮助 有关将 FileMaker 用作 ODBC 数据源的更多信息, 请参阅第 4 章 使用 ODBC 共享 FileMaker 数据

17 第 4 章使用 ODBC 共享 FileMaker 数据 使用 ODBC 客户端驱动程序从其他应用程序连接到 FileMaker 数据源 使用 ODBC 客户端驱动程序的应用程序可以直接访问 FileMaker 数据库文件中的数据 FileMaker ODBC 客户端驱动程序为 FileMaker ODBC 注释还可以将 FileMaker Pro 用作 ODBC 客户端应用程序, 通过 ODBC 使用 SQL 与其他数据源的记录交互 有关通过 ODBC 访问外部 SQL 数据源的详细信息, 请参阅第 2 章 访问外部 SQL 数据源 关于 ODBC ODBC 一种 API, 可以让应用程序访问许多数据库管理系统中的数据 ODBC 为客户端应用程序提供了与多个数据源和数据库服务交互的公共语言 支持 ODBC 的所有应用程序都识别 SQL ( 结构化查询语言 ) 语句的基本子集 通过 SQL, 您可以使用其他应用程序 ( 例如, 电子表格 文字处理程序和报表工具 ) 来查看 分析和修改 FileMaker 数据 有关 ODBC 客户端驱动程序支持的 SQL 语句 函数和表达式, 请参阅 FileMaker SQL 参考 通过使用 ODBC 客户端驱动程序, 应用程序可以直接与 FileMaker 数据库文件通信 您的 SQL 语句会传送给数据库文件的 FileMaker 主机, 这些语句的结果会返回给您 如果您使用 FileMaker Server 将 FileMaker 数据库文件托管为数据源, 数据库文件可以位于连接到网络的另一台计算机 ( 服务器计算机 ) 上, 而客户端应用程序位于您的计算机 ( 客户端计算机 ) 上 我们称之为客户端 / 服务器配置 客户端应用程序 驱动程序管理程序 Oracle ODBC 驱动程序 SQL Server ODBC 驱动程序 FileMaker ODBC 客户端驱动程序 Oracle Microsoft SQL Server FileMaker

18 第 4 章 使用 ODBC 共享 FileMaker 数据 18 使用 ODBC 客户端驱动程序 可以将 ODBC 客户端驱动程序与兼容 ODBC 的应用程序一起使用 将 FileMaker 数据库文件共享为数据源, 您可以 : 1 使用 Microsoft Word 执行邮件合并 1 使用 Microsoft Excel 创建图表 1 将 FileMaker 数据移动到诸如 Microsoft SQL Server 的 DBMS 1 利用查询或报表工具进一步分析 FileMaker 数据, 以创建图表 构建临时查询并执行明细分析 1 创建与 FileMaker Pro 共享信息的 Microsoft Visual Basic 应用程序 要作为数据源共享 FileMaker 数据库文件, 使用 FileMaker Pro 定义需要访问数据库文件的帐户 然后, 通过将权限集 ( 其中包括 通过 ODBC/JDBC 访问 的扩展权限 ) 分配给帐户来控制对数据库文件的访问 最后, 启用 FileMaker Server 或 FileMaker Pro 主机应用程序通过 ODBC/JDBC 共享数据 有关详细信息, 请参阅 FileMaker Pro 帮助 或 FileMaker Server 帮助 重要 FileMaker ODBC 客户端驱动程序的先前版本不与 FileMaker 14 兼容 要连接到 FileMaker 14 数据库文件, 需要安装和配置新的 ODBC 客户端驱动程序 注释要确认 FileMaker XDBC 侦听器当前是否在运行, 可以使用 OS X 上的 活动监视器 或 Windows 中的 任务管理器 来检查 FileMaker XDBC 侦听器进程的状态 启动进程时, 其名称为 fmxdbc_listener, 并且用此名称记录事件 FileMaker XDBC 侦听器进程不同于 FileMaker Server 进程 可以使用 FileMaker Server 管理控制台 停止和启动 XDBC 侦听器进程 在 FileMaker Server 状态 窗格中, 将 ODBC/JDBC 设置为 关闭 来停止 XDBC 侦听器, 将 ODBC/JDBC 设置为 打开 来启动 XDBC 侦听器 访问 FileMaker 数据库文件概述 从与 ODBC 兼容的应用程序, 可以构建 SQL 查询来访问 FileMaker 数据库文件 ODBC 客户端驱动程序必须安装在生成 SQL 查询的计算机上 要访问 FileMaker 数据库文件, 请执行以下操作 : 1. 在 FileMaker Pro 中, 查看您已经分配给将访问数据库文件的帐户的权限集 需要访问权限的帐户必须使用具有 通过 ODBC/JDBC 访问 扩展权限的权限集 2. 启用 FileMaker Server ( 通过 FileMaker Server 管理控制台 ) 或 FileMaker Pro 主机应用程序通过 ODBC/JDBC 共享数据 FileMaker Server 管理控制台 : 选择 常规设置 > ODBC/JDBC, 然后选择 启用 ODBC/JDBC FileMaker Pro: 选择 文件 菜单 > 共享 > 启用 ODBC/JDBC, 并将 ODBC/JDBC 共享 设置为 打开 3. 请确保您要访问的 FileMaker 数据库文件已托管并且可用 如果您的 FileMaker 数据库解决方案使用多个 FileMaker 数据库文件, 则所有数据库文件必须位于同一计算机上 4. 连接到 FileMaker 数据源

19 第 4 章 使用 ODBC 共享 FileMaker 数据 在客户端应用程序中构建并执行 SQL 查询 处于打开状态并且经过访问设置的每个 FileMaker 数据库文件都是一个单独的数据源 ( 针对要作为数据源访问的每个 FileMaker 数据库文件创建一个 DSN) 每个数据库可以具有一个或多个表 FileMaker 字段以列的形式出现 完整的字段名称 ( 包括非字母数字字符 ) 显示为列名称 从 Windows 应用程序访问 FileMaker 数据库文件 指定 FileMaker DSN 的 ODBC 客户端驱动程序属性 (Windows) 为要作为数据源访问的每个 FileMaker 数据库文件创建一个 DSN DSN 识别 FileMaker ODBC 客户端驱动程序 FileMaker 主机应用程序的位置, 以及要作为数据源访问的 FileMaker 数据库文件 有关创建 DSN 的信息, 请参阅第 12 页上的 配置客户端驱动程序 (Windows) 验证通过 ODBC 访问 (Windows) 要验证您是否已将 ODBC 客户端驱动程序正确地配置为访问 FileMaker 数据源, 请执行以下操作 : 1. 在 Windows 控制面板中, 打开 管理工具 > 数据源 (ODBC) 注释 管理工具 控制面板出现在 系统和安全 类别中 ODBC 数据源管理器 随即打开 2. 选择 系统 DSN 或 用户 DSN 选项卡 ( 选择先前配置时使用的选项卡 ) 3. 选择先前配置的 FileMaker 数据源 先前输入的数据源名称显示在 名称 的下方, FileMaker ODBC 显示为 驱动程序 4. 单击 配置 FileMaker DSN 配置 对话框随即显示 5. 单击 下一步, 直到到达 结束 页面为止 6. 单击 测试 系统提示您输入 FileMaker 帐户名称 ( 在 数据库用户名 中 ) 和密码 ( 在 数据库密码 中 ) 如果连接正常, 您会收到一条消息, 显示 测试已成功完成 如果连接失败 : 1 请确保 FileMaker 数据库文件已托管并且可用 1 更新或更正连接信息 1 请确保您的 FileMaker 帐户使用具有 通过 ODBC/JDBC 访问 扩展权限的权限集 1 验证 FileMaker Server 或 FileMaker Pro 主机应用程序已经设置为通过 ODBC/JDBC 共享

20 第 4 章 使用 ODBC 共享 FileMaker 数据 20 从 OS X 应用程序访问 FileMaker 数据库文件 指定 FileMaker DSN 的 ODBC 客户端驱动程序属性 (OS X) 为要作为数据源访问的每个 FileMaker 数据库文件创建一个 DSN DSN 识别 FileMaker ODBC 客户端驱动程序 FileMaker 主机应用程序的位置, 以及要作为数据源访问的 FileMaker 数据库文件 有关创建 DSN 的信息, 请参阅第 14 页上的 配置客户端驱动程序 (OS X) 验证通过 ODBC 访问 (OS X) 要验证您是否已将 ODBC 客户端驱动程序正确地配置为访问 FileMaker 数据源, 请执行以下操作 : 1. 启动 ODBC 管理器实用工具 (ODBC 管理程序位于 应用程序 文件夹的 实用工具 文件夹中 ) 2. 选择 系统 DSN 或 用户 DSN 选项卡 ( 选择先前配置时使用的选项卡 ) 3. 选择先前配置的 FileMaker 数据源 先前输入的数据源名称显示在 名称 的下方, FileMaker ODBC 显示为 驱动程序 4. 单击 配置 FileMaker DSN 配置 对话框随即打开 5. 单击 继续, 直到到达 结束 页面为止 6. 单击 测试 系统提示您输入 FileMaker 帐户名称 ( 在 数据库用户名 中 ) 和密码 ( 在 数据库密码 中 ) 如果连接正常, 您会收到一条消息, 显示 测试已成功完成 如果连接失败 : 1 请确保 FileMaker 数据库文件已托管并且可用 1 更新或更正连接信息 1 请确保您的 FileMaker 帐户使用具有 通过 ODBC/JDBC 访问 扩展权限的权限集 1 验证 FileMaker Server 或 FileMaker Pro 主机应用程序已经设置为通过 ODBC/JDBC 共享

21 第 5 章安装 FileMaker JDBC 客户端驱动程序 以下说明可帮助您安装从第三方应用程序和自定义应用程序通过 JDBC 访问 FileMaker 作为数据源所需的客户端驱动程序 此客户端驱动程序位于 FileMaker DVD 或电子下载版的 xdbc 文件夹中 在以下 URL 中检查客户端驱动程序的更新 : 如果您要使用 FileMaker Server 托管 FileMaker 数据库文件, 请使客户端驱动程序可供远程用户使用 在安装所需的客户端驱动程序之后, 可以将驱动程序配置为访问 FileMaker 数据源并构建 SQL 查询与数据交互 JDBC 客户端驱动程序是 FileMaker 软件的驱动程序部分, 该软件允许第三方应用程序或自定义应用程序访问 FileMaker 文件作为 JDBC 数据源 软件要求 要安装和使用 JDBC 客户端驱动程序, 您需要 JDK 1.6 或更新版本 要查看您在运行的 Java 版本, 打开命令窗口 (Windows) 或 终端 窗口 (OS X), 并键入 java -version 网络要求 如果您要访问在其他计算机上托管的 FileMaker 数据源, 将需要通过 TCP/IP 访问网络 JDBC 客户端驱动程序安装 对于要在其中安装 JDBC 客户端驱动程序的文件夹, 您必须具有写入访问权限 要安装 JDBC 客户端驱动程序 : 1. 执行以下某项操作 : 1 Windows: 如果您以电子方式收到软件, 双击安装图标 (.exe 文件 ) 1 OS X: 如果您以电子方式收到软件, 双击磁盘映像图标 (.dmg 文件 ) 1 如果您具有安装磁盘, 将磁盘插入驱动器 2. 在 FileMaker Pro 或 FileMaker Server 窗口中, 双击 xdbc 文件夹 3. 在 xdbc 文件夹中, 双击 JDBC Client Driver Installer 文件夹 4. 将 fmjdbc.jar 文件复制到您的操作系统的相应文件夹中 : 1 Windows: 将 fmjdbc.jar 文件复制到包括 Java 可执行文件 (java.exe) 的文件夹, 或复制到在 Java 应用程序的 ClassPath 中包括的其他文件夹位置 1 OS X: 将 fmjdbc.jar 文件复制到 /Library/Java/Extensions 文件夹, 或复制到在 Java 应用程序的 ClassPath 中包括的其他文件夹位置 现在, 就可以通过 JDBC 客户端驱动程序访问 FileMaker 数据源了

22 第 5 章 安装 FileMaker JDBC 客户端驱动程序 22 使用 JDBC 客户端驱动程序 Java 应用程序或小程序必须在 JDBC 驱动程序管理程序注册 JDBC 客户端驱动程序, 并且必须在应用程序或小程序中指定正确的 JDBC URL 重要必须为 FileMaker JDBC 客户端驱动程序保留端口 2399 端口号始终为 2399 不能将 JDBC 共享更改至其他端口 有关使用 JDBC 客户端驱动程序的更多信息, 请参阅第 6 章 使用 JDBC 共享 FileMaker 数据

23 第 6 章使用 JDBC 共享 FileMaker 数据 如果您是 Java 编程人员, 则可以将 JDBC 客户端驱动程序与任何快速应用程序开发 (RAD) 工具一起使用, 以可视方式真实地创建连接到 FileMaker 数据源的 Java 应用程序或小程序 使用 JDBC 客户端驱动程序的 Java 应用程序或小程序可以直接访问 FileMaker 数据库文件中的数据 关于 JDBC JDBC 是用于执行 SQL 语句的 Java API, 访问关系数据库的标准语言 JDBC 是低级别接口, 这意味着它用于直接调用 SQL 命令 它还设计为用作更高级别接口和工具的基础 通过使用 JDBC 客户端驱动程序,Java 小程序或应用程序可以直接与 FileMaker 数据库文件通信 您的 SQL 语句会传送给数据库文件的 FileMaker 主机, 这些语句的结果会返回给您 如果您使用 FileMaker Server 托管, 用作数据源的 FileMaker 数据库文件可以位于连接到网络的另一台计算机 ( 服务器计算机 ) 上, 而 Java 小程序或客户端应用程序位于您的计算机 ( 客户端计算机 ) 上 我们称之为客户端 / 服务器配置 Java 应用程序 JDBC 驱动程序 FileMaker 客户端计算机 数据库服务器 使用 JDBC 客户端驱动程序 构建 Java 应用程序或小程序的代码时, 可以将 JDBC 客户端驱动程序与 Java 编译器或 RAD 工具一起使用来连接数据库 创建完 Java 应用程序或小程序之后, JDBC 客户端驱动程序与文件在一起, 或者包括在代码中, 应用程序或小程序才能与数据库通信 要使用 JDBC 客户端驱动程序, Java 应用程序或小程序必须在 JDBC 驱动程序管理程序注册该驱动程序, 并且必须在应用程序或小程序中指定正确的 JDBC URL 与数据库进行连接需要 JDBC URL 关于 JDBC 客户端驱动程序 JDBC 客户端驱动程序为 JDBC 3.0 规范提供部分支持 FileMaker 不支持以下功能 : 1 保存点 1 检索自动生成的密钥 1 按名称将参数传递给可调用语句对象 1 可保持光标 1 检索和更新由 Ref 对象引用的对象 1 更新包含 CLOB ARRAY 和 REF 数据类型的列 1 布尔数据类型 1 DATALINK 数据类型 1 转换组和类型映射 1 JDBC SPI 和连接器体系结构之间的关系

24 第 6 章 使用 JDBC 共享 FileMaker 数据 24 JDBC 客户端驱动程序经过针对 Java 开发工具包 (JDK)1.6 和 1.7 进行的测试 它是 类型 4 驱动程序 - 本地协议, 将 JDBC 调用直接转换为由 FileMaker 使用的网络协议的纯 Java 驱动程序 此类型的驱动程序可实现 Java 的所有优点, 其中包括自动安装 ( 例如, 使用此驱动程序的小程序下载 JDBC 驱动程序 ) 驱动程序的驱动器类和主入口点命名为 : com.filemaker.jdbc.driver 重要 JDBC 客户端驱动程序取代用 FileMaker 的先前版本发布的 FileMaker JDBC 驱动程序 如果您先前已经使用旧驱动程序设置了对 FileMaker 数据源的访问权限, 则需要通过使用和配置新驱动程序重新定义访问权限 注释要确认 FileMaker XDBC 侦听器当前是否在运行, 可以使用 OS X 上的 活动监视器 或 Windows 中的 任务管理器 来检查 FileMaker XDBC 侦听器进程的状态 启动进程时, 其名称为 fmxdbc_listener, 并且用此名称记录事件 FileMaker XDBC 侦听器进程不同于 FileMaker Server 进程 可以使用 FileMaker Server 管理控制台 停止和启动 XDBC 侦听器进程 在 FileMaker Server 状态 窗格中, 将 ODBC/JDBC 设置为 关闭 来停止 XDBC 侦听器, 将 ODBC/JDBC 设置为 打开 来启动 XDBC 侦听器 使用 JDBC URL 连接到数据库 在 Java 中, 通过 URL ( 统一资源定位器 ) 来访问大多数资源 JDBC URL 用于识别数据库, 以便 JDBC 客户端驱动程序识别数据库, 并与数据库建立连接 JDBC URL 由冒号分隔的三个主要部分组成 : jdbc:<subprotocol>:<subname> JDBC URL 的第一部分始终是 JDBC 协议 (jdbc) subprotocol 是支持多个驱动程序的驱动程序名称或机制 对于 JDBC 客户端驱动程序, subprotocol 为 filemaker subname 是托管 FileMaker 数据源的计算机的 IP 地址 注册 JDBC 客户端驱动程序和连接到 FileMaker 数据源 ( 一个示例 ) 以下是 JDBC 客户端应用程序的一部分, 该应用程序执行以下功能 : 1. 在 JDBC 驱动程序管理程序注册 JDBC 客户端驱动程序 2. 建立与 FileMaker 数据源的连接 JDBC URL 为 jdbc:filemaker:// /database 3. 返回错误代码 import java.sql.*; class FMPJDBCTest { public static void main(string[ ] args) { // register the JDBC client driver try { Driver d = (Driver)Class.forName("com.filemaker.jdbc.Driver").newInstance(); } catch(exception e) {

25 第 6 章 使用 JDBC 共享 FileMaker 数据 25 } 注释 } System.out.println(e); } // establish a connection to FileMaker Connection con; try { con = DriverManager.getConnection("jdbc:filemaker:// /mydatabase","username", "password"); } catch(exception e) { System.out.println(e); } // get connection warnings SQLWarning warning = null; try { warning = con.getwarnings(); if (warning == null) { System.out.println("No warnings"); return; } while (warning!= null) { } System.out.println("Warning:"+warning); warning = warning.getnextwarning(); } catch (Exception e) { Sysem.out.println(e); } 本示例不用于编译 在 URL 子名称中指定驱动程序属性 在 JDBC URL 的子名称中指定用户和密码驱动程序属性 这些是在通过 Properties 参数调用 DriverManager.getConnection 方法时可以传递给连接的属性 1 用户 :FileMaker 数据库文件中使用具有 通过 ODBC/JDBC 访问 扩展权限的权限集的帐户 1 密码 :FileMaker 数据库文件中帐户的密码 URL 中指定数据库名称的 JDBC URL 连接格式 : jdbc:filemaker://<filemaker 主机 IP 地址 >/< 数据库名称 > 示例 : jdbc:filemaker:// /publications

26 第 6 章 使用 JDBC 共享 FileMaker 数据 26 URL 中指定数据库名称 用户名和密码的 JDBC URL 连接 格式 : jdbc:filemaker://<filemaker 主机 IP 地址 >/< 数据库名称 >?user=< 数据库用户名 >&password=< 数据库密码 > 示例 : jdbc:filemaker:// /customers?user=collections&password=admin 注释 因为此语法中使用与号字符 (&), 所以您不能在用户名或密码中使用与号字符 无效用户名的示例 : jdbc:filemaker://localhost/sales_db?user=ad&min&password=admin 无效密码的示例 : jdbc:filemaker://localhost/sales_db?user=admin1&password=ad&min 具有多个 FileMaker 数据库文件的解决方案 如果 FileMaker 数据库解决方案使用许多 FileMaker 数据库文件, 请另外创建一个数据库文件, 其中包括解决方案需要的全部外部数据源引用 表出现和关系 然后, 将这个额外的数据库文件定义为 JDBC URL 中的数据源 所有 FileMaker 数据库文件必须位于同一计算机上 验证通过 JDBC 访问 验证通过 JDBC 访问 FileMaker 数据库文件时, 请确保 : 1 FileMaker 数据库文件已托管并且可用 1 您的 FileMaker 帐户使用具有 通过 ODBC/JDBC 访问 扩展权限的权限集 1 FileMaker Server 或 FileMaker Pro 主机应用程序已经设置为通过 ODBC/JDBC 共享 要作为数据源共享 FileMaker 数据库文件, 使用 FileMaker Pro 定义需要访问数据库文件的帐户 然后, 通过将权限集 ( 其中包括 通过 ODBC/JDBC 访问 的扩展权限 ) 分配给帐户来控制对数据库文件的访问 最后, 启用 FileMaker Server 或 FileMaker Pro 主机应用程序通过 ODBC/JDBC 共享数据 有关详细信息, 请参阅 FileMaker Pro 帮助 或 FileMaker Server 帮助 1 JDBC 客户端驱动程序注册和 JDBC URL 正确 ( 驱动程序可以包括在 Java 应用程序中, 或者位于客户端计算机上 )

27 第 7 章参考信息 ODBC 目录函数 ODBC 客户端驱动程序支持以下目录函数 : 1 SQLTables - 作为单个部分名称 ( 仅表名 ) 存储和报告目录信息 1 SQLColumns 1 SQLColumnPrivileges 1 SQLDescribeCol 1 SQLGetTypeInfo JDBC DatabaseMetaData 方法 JDBC 客户端驱动程序支持以下 DatabaseMetaData 方法 : 1 getcolumns 1 getcolumnprivileges 1 getmetadata 1 gettypeinfo 1 gettables 1 gettabletypes 1 getversioncolumns 将 FileMaker 字段映射到 ODBC 数据类型 下表说明如何将 FileMaker 字段类型映射到标准 ODBC 数据类型 FileMaker 字段类型转换为 ODBC 数据类型关于数据类型 文本 SQL_VARCHAR 文本列的最大长度为 1 百万个字符, 除非在 FileMaker 中为文本字段 指定更小的 最大字符数 FileMaker 将空字符串返回为 NULL 数字 SQL_DOUBLE FileMaker 数字字段类型可以包含最小 最大 的正数值 或负数值, 最多含 15 位有效数字 日期 SQL_DATE 时间 SQL_TIME FileMaker 时间字段类型可以包含时间或时间间隔 时间间隔返回为 时间, 除非时间间隔小于 0 或大于 24 小时 ( 返回值均为 0) 时间戳 SQL_TIMESTAMP 容器 (BLOB) SQL_LONGVARBINARY 您可以从容器字段检索二进制数据 文件参考信息或特定文件类型的数据 在 SELECT 语句中, 使用 CAST() 函数检索文件参考信息, 并使用 GetAs() 函数检索特定文件类型的数据 计算 结果映射到相应的 ODBC 数据类型

28 第 7 章 参考信息 28 字符串长度在表声明中是可选的 所有字符串均以 Unicode 编码存储和检索 注释支持数组等 FileMaker 重复字段 示例 : INSERT INTO mytable(repfield[3]) VALUES ('this is rep 3') SELECT repfield[1], repfield[2] FROM mytable 将 FileMaker 字段映射到 JDBC 数据类型 将 FileMaker 数据类型转换为 JDBC SQL 类型时,JDBC 客户端驱动程序使用以下映射 ( 有关这些数据类型的信息, 请访问 参阅网页版 JDK 文档 ) FileMaker 字段类型文本数字日期时间时间戳容器计算 转换为 JDBC SQL 类型 java.sql.types.varchar java.sql.types.double java.sql.types.date java.sql.types.time java.sql.types.timestamp java.sql.types.blob 由计算结果的数据类型指定 JDBC 客户端驱动程序将 FileMaker 计算数据类型转换为与计算结果匹配的 JDBC SQL 类型 例如,JDBC 客户端驱动程序将生成时间戳数据类型的 FileMaker 计算转换为 java.sql.types.timestamp 64 位应用程序中的数据类型 在 ODBC API 的 32 位版本中, 一些函数使用可以传递整数值或指针值的参数, 具体取决于上下文 但在 64 位 Windows 操作系统中, 整数和指针大小不同 ODBC API 的 64 位版本使用未定义为特定大小的抽象数据类型 使用 32 位值的应用程序安装到 64 位操作系统时可能会崩溃 使用抽象数据类型的应用程序在 32 位和 64 位操作系统上都能正确运行 ODBC 和 JDBC 错误消息 以下是在使用 FileMaker 和 ODBC/JDBC 时收到的错误消息的基本格式 ODBC 错误消息 错误消息可以来自 : 1 ODBC 驱动程序错误 1 FileMaker 和 FileMaker XDBC 侦听器错误 FileMaker ODBC 错误消息在 FileMaker 侦听器或数据源中出现的错误包括以下格式的数据源名称 : [FileMaker] [FileMaker ODBC] 消息例如, 您可能会从 FileMaker 数据源获得以下消息 : [FileMaker] [FileMaker ODBC] 用户名 / 密码无效

29 第 7 章 参考信息 29 如果您看到此类型的错误, 则表示您对数据库系统执行了错误的操作 请查阅 FileMaker 文档了解更多信息, 或咨询您的数据库管理员 不同列中多个错误的连续消息有时可能会显示错误的列名称 JDBC 错误消息 FileMaker JDBC 驱动程序会返回 SQLException, 向调用应用程序报告错误 错误消息可以来自 : 1 JDBC 驱动程序错误 1 FileMaker 和 FileMaker XDBC 侦听器错误 FileMaker JDBC 错误消息 在 FileMaker 侦听器或数据源中出现的错误包括以下格式的数据源名称 : [FileMaker] [FileMaker JDBC] 消息 例如, 您可能会从 FileMaker 数据源获得以下消息 : [FileMaker] [FileMaker JDBC] 用户名 / 密码无效如果您看到此类型的错误, 则表示您对数据库系统执行了错误的操作 请查阅 FileMaker 文档了解更多信息, 或咨询您的数据库管理员

30 索引 符号 32 位 ODBC 管理器 (OS X) 14 ODBC 管理器 (Windows) 12 客户端驱动程序 (OS X) 14 客户端驱动程序 (Windows) 12 体系结构 位 ODBC 管理器 (OS X) 14 ODBC 管理器 (Windows) 12 客户端驱动程序 (OS X) 14 客户端驱动程序 (Windows) 12 数据类型 28 体系结构 11 A ARRAY 数据类型 23 安装要求 11, 21 B BLOB 28 保存点支持 23 必需端口对于 JDBC 22 对于 ODBC (OS X) 14 对于 ODBC (Windows) 12 布尔数据类型 23 C CAST 函数 27 CLOB 数据类型 23 测试访问权限 JDBC 客户端驱动程序 26 ODBC 客户端驱动程序 (OS X) 20 ODBC 客户端驱动程序 (Windows) 19 错误消息格式 28 D DatabaseMetaData 方法 27 DATALINK 数据类型 23 DATE 28 DOUBLE 28 DSN 创建 (OS X) 20 创建 (Windows) 19 每个文件一个 7 导入 ODBC 数据 8 导入记录脚本步骤 8, 9 端口 2399 对于 JDBC 为必需 22 对于 ODBC 为必需 (OS X) 14 对于 ODBC 为必需 (Windows) 12 E ExecuteSQL 函数 8, 9 F FileMaker ODBC 客户端驱动程序 OS X 14 Windows 12 FileMaker Server 文档 5 FileMaker 产品 6 G GetAs 函数 27 getcolumnprivileges 方法 27 getcolumns 方法 27 getmetadata 方法 27 gettables 方法 27 gettabletypes 方法 27 gettypeinfo 方法 27 getversioncolumns 方法 27 共享, 设置 ODBC/JDBC 18 关系图 6 J Java 版本 21 Java 开发工具包 (JDK) 24 JDBC 错误消息 29 客户端驱动程序, 已说明 23 已说明 23 JDBC SPI 23 JDBC 客户端驱动程序驱动程序类和主入口点 24 验证访问权限 26 映射数据类型 28 在 JDBC 驱动程序管理程序注册 24 指定 JDBC URL 24 JDBC 客户端驱动程序的 URL ( 统一资源定位器 ) 24 JDBC 中的光标 23 JDBC 中的可保持光标 23 架构修改 6 将 ODBC 和 JDBC 与 FileMaker 一起使用 5 禁用共享的 FileMaker 数据库文件 7 K 客户端应用程序, 将 FileMaker 用作 5 空值 27 快速应用程序开发 (RAD) 工具 23 扩展权限 18

31 31 L 联机文档 5 列名称 19 M Microsoft Access 7 MySQL 10 密码使用 JDBC 25 使用 ODBC 19, 20 目录函数 27 O ODBC 错误消息 28 已说明 17 重复字段 28 ODBC 管理程序创建 DSN 14 下载 14 验证 ODBC 访问 20 ODBC 管理器 (OS X) 20 ODBC 客户端驱动程序验证访问权限 (OS X) 20 验证访问权限 (Windows) 19 映射数据类型 27 ODBC 目录函数 27 ODBC 数据源?? 管理器创建 DSN 13 打开 12 验证 ODBC 访问 19 Oracle 10 OS X JDBC 客户端驱动程序要求 21 创建 DSN 14 验证 ODBC 访问 20 P PDF 文档 5 配置 FileMaker 数据源对于 JDBC 25 对于 ODBC (OS X) 20 对于 ODBC (Windows) 19 Q 驱动程序, 兼容版本 7 驱动程序属性 JDBC 客户端驱动程序 25 ODBC 客户端驱动程序 (OS X) 20 ODBC 客户端驱动程序 (Windows) 19 权限, 扩展 18 R REF 数据类型 23 容器字段 JDBC 数据类型映射 28 ODBC 数据类型映射 27 S SQL Server 10 SQL 查询生成器 6, 8 SQL_DATE 27 SQL_DOUBLE 27 SQL_LONGVARBINARY 27 SQL_TIME 27 SQL_TIMESTAMP 27 SQL_VARCHAR 27 SQLColumnPrivileges 27 SQLColumns 27 SQLDescribeCol 27 SQLException 29 SQLGetTypeInfo 27 SQLTables 27 设置权限和共享 18 数据类型映射 JDBC 客户端驱动程序 28 ODBC 客户端驱动程序 27 数据源禁用共享的 FileMaker 数据库文件 7 每个 FileMaker 数据库文件的一个 DSN 7 配置通过 ODBC 访问 (OS X) 20 配置通过 ODBC 访问 (Windows) 19 验证通过 JDBC 访问 26 验证通过 ODBC 访问 (OS X) 20 验证通过 ODBC 访问 (Windows) 19 针对 JDBC 配置访问 25 T TCP/IP 要求 7 TIME 28 TIMESTAMP 28 通过 ODBC/JDBC 扩展权限访问 18 V VARCHAR 28 W Windows JDBC 客户端驱动程序要求 21 创建 DSN 19 验证 ODBC 访问 19 外部 SQL 数据源访问 8 受支持的版本 10 网络要求 7 网站, FileMaker 支持页面 5 文档 5 文件设置访问 18 在一台计算机上组织 6

32 32 X XDBC 侦听器错误消息 28 与 JDBC 配合使用 24 与 ODBC 配合使用 18 系统要求 JDBC 客户端驱动程序 21 对于 ODBC 客户端驱动程序 11 Y 验证访问权限 JDBC 客户端驱动程序 26 ODBC 客户端驱动程序 (OS X) 20 ODBC 客户端驱动程序 (Windows) 19 映射数据类型 JDBC 客户端驱动程序 28 ODBC 客户端驱动程序 27 元数据方法 27 远程访问 6 运行时解决方案, 限制 9 Z 帐户和权限 18 执行 SQL 脚本步骤 8, 9 重复字段 28 注册 JDBC 客户端驱动程序 24 字段映射到 JDBC 28 映射到 ODBC 27 自动生成的密钥 23