阅读器指令

列出的后缀以当前前缀在一个映射文件。默认情况下,对于Microsoft SQL Server阅读器是MSSQL_ADO

数据集

要求/可选:需要

这是数据库名称。

例:

MSSQL_ADO_DATASET citySource

工作台参数:来源Microsoft SQL Server的非空间名称

服务器

微软SQL服务器的主机名。

必需/可选

需要

MSSQL_ADO_SERVER MI6

工作台参数

服务器

对于SQL Azure,当处于批量插入模式(仅为写入器的默认模式)时,需要特殊的语法。有关详细信息,请参阅大容量插入部分。

USER_NAME

必需/可选

可选

将访问数据库的用户名。如果使用Windows身份验证,则忽略此选项。

MSSQL_ADO_USER_NAME bond007

工作台参数

用户名

对于SQL Azure,当处于批量插入模式(仅为写入器的默认模式)时,需要特殊的语法。有关详细信息,请参阅大容量插入部分。

密码

要求/可选:可选

用户访问数据库的密码。如果使用Windows身份验证,则忽略此选项。

MSSQL_ADO_PASSWORD钱眼

工作台参数:密码

COMMAND_TIMEOUT

对于数据库查询超时秒数。如果设置为零,没有超时。默认值是30。

必需/可选

可选

0 =无超时

默认值:30

映射文件语法

MSSQL_ADO_COMMAND_TIMEOUT 15

工作台参数

命令超时

USE_SSPI

要求/可选:可选

这是否指定Windows身份验证,应使用验证到数据库服务器。该指令应设置为yes或no。默认为无。

如果USE_SSPI设定为,然后使用Windows身份验证,以及USER_NAME密码指令被忽略。

MSSQL_ADO_USE_SSPI是

工作台参数:使用Windows身份验证

ENCRYPT_CONNECTION

必需/可选

可选

映射文件语法

MSSQL_ADO_ENCRYPT_CONNECTION是

工作台参数

加密连接

DEF

要求/可选:需要

定义的语法为:

MSSQL_ADO_DEF  \ [mssql_whereclause >] \ [ ] +

要么

MSSQL_ADO_DEF  \ [mssql_sql_statement <的SQLQuery>] \

<的表>必须与数据库中现有的Microsoft SQL Server表的名称匹配。这将用作从表中读取的所有特性的特性类型。这个规则的例外是在使用mssql_sql_statement关键字在这种情况下,DEF名称可以是任何有效的字母标识符;它不必是现有的表名 - 更确切地说,它是自定义的SQL查询的标识符。所有从SQL查询返回的功能特征类型给出的查询名称。

<fieldType>每个字段必须给予,但它不是针对该字段的数据库定义验证。实际上,它被忽略。

所述定义允许的每个表单独的搜索参数规范。如果有任何的每个表中给出的配置参数,它们将覆盖,该表,不管全球价值已经被读者的关键字,如指定WHERE_CLAUSE。如果没有指定这些参数中的任何一个,将使用全局值。

下表概括了定义行配置参数:

参数

内容

mssql_where_clause

这指定SQL WHERE子句应用到的图层的要素属性,限制设定的返回功能。如果没有指定,那么所有的行返回。如果mssql_sql_statement存在这个关键字会被忽略。

mssql_sql_statement

这将指定一个SQL SELECT查询用作结果的源。如果指定了这一点,Microsoft SQL Server阅读器将执行查询,并使用结果行作为特性,而不是从表中读取。所有返回的特性都具有的特性类型,以及查询所选择的所有列的属性。如果提供了mssql_sql_statement,则mssql_where_子句将被忽略。此表单允许将复杂连接的结果返回给FME。

如果不<whereClause>被指定,表中的所有行都将被读取并返回作为单独的功能。如果一个<whereClause>被指定时,仅由该条款选定的那些行会被读出。请注意,whereClause > <不包括字在哪里

Microsoft SQL Server reader允许使用mssql_sql_statement参数在DEF行上指定一个任意的SQL选择查询。如果指定了这一点,FME将执行查询,并使用查询返回的每一行数据定义至少一个特性。这些特性中的每一个都将被赋予DEF行中命名的特性类型,并且将包含SELECT返回的每一列的属性。在本例中,所有关于WHERE子句或空间查询的DEF line参数都被忽略,因为可以将此信息直接嵌入的文本中。

在下面的例子中,所有的记录,其ID是小于5会从供应商表中读取:

MSSQL_ADO_DEF supplier \ mssql_where_子句"id < 5" \ id整数\ NAME char(100) \城市char(50)

在这个例子中,在加入的结果雇员表返回。所有来自这两个表的属性将出现在每个返回的功能。特征类型将被设置为复杂。

MSSQL_ADO_DEF complex \ mssql_sql_statement \ "SELECT * FROM EMPLOYEE, CITY WHERE EMPLOYEE。城市= CITY.NAME”

WHERE_CLAUSE

必需/可选

可选

这个可选的规范被用来限制通过从每个表中的读取器读取的行。如果给定的表没有mssql_where_clause要么mssql_sql_statement指定的DEF线,全球 _WHERE_CLAUSE值,如果存在的话,将被应用为在哪里查询指定中使用产生的结果。如果一个表是DEF行包含它自己的mssql_where_clause要么mssql_sql_statement,它将覆盖全球在哪里条款。

这个子句的语法是:

MSSQL_ADO_WHERE_CLAUSE 

请注意,<whereClause>不包括单词“在哪里。”

下面仅选择其长度超过2000的特征的例子:

MSSQL_ADO_WHERE_CLAUSE长度> 2000

工作台参数

Where子句

id

要求/可选:可选

这个可选的规格是用来限制将被读取,并提供定义的数据库表。如果不id,则不读取任何表。的语法id关键字:

MSSQL_ADO_IDs  \  \ 

该功能类型必须使用那些在匹配DEF线。

只有下面的选择示例历史转换过程中的输入表:

MSSQL_ADO_IDs历史

READ_CACHE_SIZE

要求/可选:可选

这个关键字控制阅读器如何从数据库检索行。这必须是一个大于0的数值。

READ_CACHE_SIZE用于确定一次从数据源检索到本地内存的行数。例如,如果READ_CACHE_SIZE设定为10,读取器打开后,读取器将读取10行到本地内存中。当FME处理特征时,读取器从本地内存缓冲区返回数据。当您移动到本地内存中可用的最后一行时,读取器将从数据源检索接下来的10行。

该关键字会影响读取器的性能,如果设置不当,将导致性能显著下降。该关键字的最佳值主要取决于单个记录的特征以及数据库与客户端机器之间的传输。它受要检索的行数量的影响较小。

默认情况下,READ_CACHE_SIZE设定为10。此值已经确定为平均数据集的最佳值。

工作台参数:每次要获取的记录数

RETRIEVE_ALL_SCHEMAS

生成只有当映射文件,生成一个工作区,或在检索FME模式时对象应用该参数是适用的。

当设置为时,将返回数据库中所有表和特性类的模式。

当设置为没有(或丢失),并且如果RETRIEVE_ALL_TABLE_NAMES类似地设置为没有(或失踪),只有通过架构返回参数的ID请求。

必需/可选

可选

YES |NO(默认值)

没有:读者将返回架构中的ID指定的地物类型。如果ID是没有指定的功能,然后FME返回所有表的模式特征。

如果未指定此值,则假定该值为No。

是的:表示给读者以返回数据库中的表的所有模式。

映射文件语法

不适用。

FME Objects应用程序将包括RETRIEVE_ALL_SCHEMAS其次是“YES”,在参数数组传递到IFMEUniversalReader ::打开()

工作台参数

不适用

RETRIEVE_ALL_TABLE_NAMES

此参数仅在生成映射文件、生成工作区或在FME对象应用程序中检索模式时适用。

当设置为yes,如果RETRIEVE_ALL_SCHEMAS如果设置为no(或missing),则返回数据库中所有表和特性类的名称。当设置为no(或missing)时,以及如果RETRIEVE_ALL_SCHEMAS如果同样设置为no(或missing),则返回IDs指令请求的模式。

注意:如果RETRIEVE_ALL_SCHEMAS也被设置为Yes,然后RETRIEVE_ALL_SCHEMAS优先。

必需/可选

可选

YES |NO(默认值)

映射文件语法

不适用。

FME Objects应用程序将包括RETRIEVE_ALL_TABLE_NAMES其次是“YES”,在参数数组传递到IFMEUniversalReader ::打开()

工作台参数

不适用(当你浏览一个表列表中)

EXPOSED_ATTRS

该指令允许格式的选择属性被显式添加到阅读器的功能类型。

这类似于在一旦已生成的读取器功能型曝光格式属性;但是,它更是如虎添翼,因为它能够比其他工作台模式驱动的应用程序来访问和,如果他们明确的架构为用户属性利用这些属性。

采摘的属性列表的结果是用逗号分隔的将被添加到架构的功能属性名称和类型的列表。目前,所有的读者特征类型将收到同一组的其他架构属性为读者的给定实例。

必需/可选

可选

映射文件语法

不适用。

虽然FME对象应用程序可以调用这个指令,但没有文档说明所需的格式。

此指令仅用于我们的GUI应用程序(例如工作台)。

工作台参数

要公开的其他属性