读者指令

列出的后缀以当前前缀< ReaderKeyword >在映射文件中。默认情况下,< ReaderKeyword >Microsoft SQL Server reader的MSSQL_ADO

数据集

要求/可选:要求

这是数据库名称。

例子:

MSSQL_ADO_DATASET citySource

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

服务器

Microsoft SQL Server的主机名。

必需的/可选

要求

MSSQL_ADO_SERVER军情六处

工作台参数

服务器

对于SQL Azure,当处于Bulk Insert模式(WRITER ONLY的默认模式)时,需要特殊的语法。详情请参阅大容量插入部分。

USER_NAME

必需的/可选

可选

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

MSSQL_ADO_USER_NAME bond007

工作台参数

用户名

对于SQL Azure,当处于Bulk Insert模式(WRITER ONLY的默认模式)时,需要特殊的语法。详情请参阅大容量插入部分。

密码

要求/可选:可选

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

MSSQL_ADO_PASSWORD钱眼

工作台参数:密码

COMMAND_TIMEOUT

对数据库的查询超时,以秒为单位。如果设置为0,则没有超时。默认为30。

必需的/可选

可选

0 =无超时

默认值:30

映射文件的语法

MSSQL_ADO_COMMAND_TIMEOUT 15

工作台参数

命令超时

USE_SSPI

要求/可选:可选

它指定是否应该使用Windows身份验证对数据库服务器进行身份验证。这个指令应该设置为yes或no。默认为no。

如果USE_SSPI被设置为是的,则使用Windows身份验证,然后USER_NAME密码指令将被忽略。

MSSQL_ADO_USE_SSPI是的

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

ENCRYPT_CONNECTION

必需的/可选

可选

映射文件的语法

MSSQL_ADO_ENCRYPT_CONNECTION是的

工作台参数

加密连接

DEF

要求/可选:要求

定义的语法是:

MSSQL_ADO_DEF  \ [mssql_where_clause ] \ [ ] + . MSSQL_ADO_DEF  \ [mssql_where_clause ] \ [ ] +

MSSQL_ADO_DEF  \ [mssql_sql_statement ] \

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

<fieldType>必须给出每个字段的值,但不根据字段的数据库定义进行验证。实际上,它被忽略了。

该定义允许为每个表指定单独的搜索参数。如果给定了每个表的任何配置参数,它们将覆盖该表中由reader关键字(如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阅读器允许使用mssql_sql_statement参数在DEF行上指定任意的SQL SELECT查询。如果指定了该参数,FME将执行查询,并使用查询返回的每一行数据定义至少一个特性。每个特性都将被赋予在DEF行中命名的特性类型,并将包含由SELECT返回的每个列的属性。在本例中,忽略与WHERE子句或空间查询相关的所有DEF行参数,因为可以直接将该信息嵌入到的文本中。

在下面的示例中,将从供应商表中读取ID小于5的所有记录:

MSSQL_ADO_DEF supplier \ mssql_where_clause "id < 5" \ id integer \ NAME char(100) \ CITY char(50)

在本例中,连接的结果员工城市表返回。两个表中的所有属性都将出现在每个返回的特性上。特性类型将被设置为complex。

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

WHERE_CLAUSE

必需的/可选

可选

这个可选规范用于限制读取器从每个表中读取的行。如果给定的表没有mssql_where_clausemssql_sql_statement指定的DEF行,全球< ReaderKeyword > _WHERE_CLAUSE值,如果存在,将作为在哪里用于生成结果的查询的说明符。如果一个表的DEF行包含它自己的mssql_where_clausemssql_sql_statement,它将覆盖全局在哪里条款。

这个子句的语法是:

MSSQL_ADO_WHERE_CLAUSE whereClause > <

请注意,<whereClause>不包括“在哪里.”

下面的例子只选择长度大于2000的特性:

Mssql_ado_where_clause长度> 2000

工作台参数

Where子句

id

要求/可选:可选

这个可选规范用于限制将要读取的可用的和已定义的数据库表。如果没有id,则不读取任何表。的语法id关键字:

MSSQL_ADO_IDs  \ …\ < featuretypeen > . 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 Objects应用程序中检索模式时适用。

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

当设置为没有(或失踪),如果RETRIEVE_ALL_TABLE_NAMES类似地设置为没有(或丢失)时,只返回id参数请求的模式。

必需的/可选

可选

YES | NO(默认)

没有:读取器将返回id中指定的特性类型的模式。如果id中没有指定特性,那么FME将返回所有表的模式特性。

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

是的:指示读取器返回数据库中所有表的模式。

映射文件的语法

不适用。

FME对象应用程序将包括RETRIEVE_ALL_SCHEMAS在参数数组中后跟“YES”IFMEUniversalReader:: open ()

工作台参数

不适用

RETRIEVE_ALL_TABLE_NAMES

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

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

注意:如果RETRIEVE_ALL_SCHEMAS也设置为Yes, thenRETRIEVE_ALL_SCHEMAS优先。

必需的/可选

可选

YES | NO(默认)

映射文件的语法

不适用。

FME对象应用程序将包括RETRIEVE_ALL_TABLE_NAMES在参数数组中后跟“YES”IFMEUniversalReader:: open ()

工作台参数

不适用(当您浏览表列表时使用)

EXPOSED_ATTRS

该指令允许将格式属性的选择显式地添加到阅读器特性类型中。

这类似于在阅读器特性类型生成后,在其上公开格式属性;然而,它甚至更加强大,因为它使除Workbench之外的模式驱动的应用程序能够访问和利用这些属性,就像它们显式地作为用户属性出现在模式上一样。

选择属性列表的结果是一个以逗号分隔的属性名称和类型列表,这些属性名称和类型将被添加到模式特性中。目前,对于阅读器的给定实例,所有阅读器特性类型都将接收相同的附加模式属性集。

必需的/可选

可选

映射文件的语法

不适用。

虽然FME对象应用程序可以调用该指令,但没有记录所需的格式。

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

工作台参数

要公开的其他属性