连接到 Email

概念信息

ACCESSDATA 命令

使用 Email 数据连接器时，可使用标准邮件协议 IMAP 或 POP 为单个账户导入电子邮件。当您连接到您的电子邮件服务器时，每个表名称都表示服务器上的一个邮箱文件夹，而每个记录都表示一个电子邮件。

说明

您不能独立于 Analytics 使用此连接器。您可以使用 Windows ODBC 数据源管理器为连接器驱动程序配置一个 DSN，但是您必须从 Analytics 内部而不是从连接器的 Windows DSN 配置对话框中测试 DSN 连接。

此连接器仅为存储在邮件服务器上的单个账户检索电子邮件。它不会连接到某些电子邮件客户端附带的聊天或待办事项等功能。

开始之前

要连接到 Email，您必须收集以下信息：

  • 电子邮件服务器的域名或 IP 地址
  • 正确的连接端口
  • 进行连接的用户账户，包括用户名和密码

说明

您的电子邮件服务器必须使用 IMAP 或 POP 协议。

有关收集连接必备信息的帮助，请联系您组织中的 电子邮件 管理员。如果您的管理员不能帮助您，您或者您的管理员应该联系电子邮件支持人员。

创建 Email 连接

  1. 从 Analytics 主菜单中选择导入 > 数据库和应用程序Analytics。
  2. 从新建连接选项卡中，在 ACL 连接器部分中，选择 电子邮件。

    提示

    您可以通过在过滤连接框中输入搜索字符串来过滤可用连接器的列表。连接器按字母顺序排列。

  3. 在数据连接设置面板中，输入连接设置，然后在面板底部单击保存并连接。

    您可以接受默认的连接名称，也可以输入一个新的名称。

电子邮件的连接被保存到现有连接选项卡。将来，您可以从已保存的连接重新连接到电子邮件。

一旦连接被建立，“数据访问”窗口将打开到暂存区域，并且您可以开始导入数据。有关从电子邮件导入数据的帮助，请参见使用数据访问窗口。

连接设置

基本设置

设置 描述 示例
协议

要连接到的电子邮件服务器的类型：

  • IMAP
  • POP
 IMAP
用户 用来进行认证的 Email 账户的用户。此域和密码一起被用来向电子邮件服务器进行认证。 recipient@example.com
密码

用来进行认证的 Email 账户的密码。此域和用户一起被用来向电子邮件服务器进行认证。

  
服务器

电子邮件服务器的名称或地址。

此属性指定邮件服务器的 IP 地址或域名。它必须在尝试连接之前设置，而一旦建立连接后，就不能进行更改。

 imap.gmail.com
端口

邮件服务器的端口。默认值是：

  • IMAP 143（非 SSL）或 993 (SSL)
  • POP 110（非 SSL）或 995 (SSL)

要建立连接，需要一个有效的端口号（一个介于 1 和 65535 之间的值）。该属性必须在尝试连接之前设置，而一旦建立连接后，就不能进行更改。

 993

高级设置

设置 描述 示例
将日期时间转换为 GMT

在导入过程中将日期时间域转换至 GMT 时区。如果为假，则该日期时间值被转换为运行 Analytics 的计算机的操作系统时区。

 真
电子邮件服务

您所使用的邮件服务的名称。

优化您正在使用的服务的 IMAP 连接。您可以使用下列选项之一：

  • AOL
  • Gmail
  • Outlook
  • Yahoo
  • 其他

说明

使用 Email 连接器，您不能从 Outlook 365 账户检索任务或日历邮箱的主题域的内容。如果您要连接到 Outlook 365 账户，请考虑改而使用 Exchange 连接器。有关详细信息，请参见 连接到 Exchange

 其他
包括消息

是否要包括消息主体内容和附件数据。

注意

此设置会影响性能，并且如果您正在处理许多记录，则可能导致您的查询超时。

 假
是 HTML

确定消息正文是 HTML 还是纯文本。

 真
持久连接

确定是否跨实例使连接保持活动。

 真
列出邮箱

是列出所有邮箱还是仅列出所订阅的 IMAP 邮箱。仅 IMAP：

  • 全部
  • 已订阅
 全部
密钥大小限制

主键列的最大长度。将大小设置为 0 会使键长度恢复到原始长度。

此属性使连接器覆盖所有主键列的报告长度。

 255
映射到 Long Varchar

控制一个列是否被作为 SQL_LONGVARCHAR 返回。

使用此设置可映射任何大于指定大小的列，以便使它们被报告为 SQL_LONGVARCHAR 而不是 SQL_VARCHAR。

 -1
映射到 WVarchar

控制字符串类型是否映射到 SQL_WVARCHAR 而不是 SQL_VARCHAR。它在默认情况下被设置。

必须将字符串列映射到 SQL_WVARCHAR 以适应各种国际字符集，因此 MapToWVarchar 默认情况下被设置为真。您可以将其设置为假以改而使用 SQL_VARCHAR。

 真
最大项数

要返回的最大项数。

默认值是 -1。此值可确保所有条目都被返回。

 -1
伪列

指示是否将伪列作为列包括在表中。

此设置在 Entity Framework 中特别有用，它不允许您为伪列设置值，除非该列是表列。

此连接设置的值的格式为 "Table1=Column1, Table1=Column2, Table2=Column3"。您可以使用“*”字符包括所有表和所有列。

 MyTable=*
SSL 服务器证书

要在使用 TLS/SSL 连接时从服务器接受的证书。您可以指定下列任一选项：

  • 完整的 PEM 证书
  • 包含证书的本地文件的路径
  • 公钥
  • MD5 指纹（还可以用空格或冒号分隔十六进制值）
  • SHA1 指纹（还可以用空格或冒号分隔十六进制值）

如果使用 TLS/SSL 连接，则此属性可被用来指定要从服务器接受的 TLS/SSL 证书。不被该计算机信任的任何其他证书都将被拒绝。

 C:\cert.cer
支持增强的 SQL

通过启用内存客户端处理，增强 SQL 功能以超越可以通过 API 直接支持的功能：

  • 真 连接器将尽可能多的 SELECT 语句处理卸载到 IMAP，然后在内存中处理该查询的其余部分。这样，驱动程序就可以执行不受支持的谓词、联接和聚合
  • 假 连接器将 SQL 执行限制到 IMAP API 所支持的范围

谓词的执行

连接器确定哪些子句受到数据源的支持，然后将它们推送到数据源，以获取可满足查询的最小行超集。然后，它在本地过滤其余行。过滤器操作被简化，从而使驱动程序能够有效地对超大型数据集进行过滤。

联接的执行

连接器使用各种技巧在内存中联接。驱动程序以牺牲内存利用率为代价，避免了多次读取相同表。

聚合的执行

连接器检索在内存中处理聚合所需的所有行。

  
UID 模式 如果为真，则使用永久性消息 ID 而不是默认的临时 ID。 假
大写标识符 请用大写报告所有标识符（包括表和列名称）。 假
代理认证方案

用来向 ProxyServer 代理进行认证的认证类型。

此值指定用来向由 ProxyServer 和 ProxyPort 指定的 HTTP 代理进行认证的认证类型。

说明

连接器默认情况下将使用系统代理设置，而无需进一步的配置；如果您想要连接到另一代理，则除了设置 ProxyServer 和 ProxyPort 以外，您还需要将 ProxyAutoDetect 设置为假。要进行认证，请设置 ProxyAuthScheme，并且根据需要设置 ProxyUser 和 ProxyPassword。

认证类型可以是下列类型之一：

  • BASIC 驱动程序执行 HTTP BASIC 认证
  • DIGEST 驱动程序执行 HTTP DIGEST 认证。
  • NEGOTIATE 驱动程序基于适用于认证的协议检索 NTLM 或 Kerberos 令牌
  • PROPRIETARY 驱动程序不生成 NTLM 或 Kerberos 令牌。您必须在 HTTP 请求的授权标头中提供此令牌
 BASIC
代理自动检测 指示是否使用系统代理设置。将 ProxyAutoDetect 设置为假可使用自定义代理设置。这将优先于其他代理设置。 真
代理用户

要用来向 ProxyServer 代理进行认证的用户名。

ProxyUser 和 ProxyPassword 选项被用来连接 ProxyServer 中指定的 HTTP 代理以及向其进行认证。

您可以在 ProxyAuthScheme 中选择可用的认证类型之一。如果您使用 HTTP 认证，请将此属性设置为 HTTP 代理所识别的用户的用户名。如果您使用 Windows 或 Kerberos 认证，请将此属性设置为采用下列格式之一的用户名：

  • 用户@域
  • 域\用户
 john_doe@example.com
代理密码

要用来向 ProxyServer 代理进行认证的密码。

此属性被用来向支持 NTLM (Windows)、Kerberos 或 HTTP 认证的 HTTP 代理服务器进行认证。要指定 HTTP 代理，您可以设置 ProxyServer 和 ProxyPort。要指定认证类型，请设置 ProxyAuthScheme。

如果您使用 HTTP 认证，请另外将 ProxyUser 和 ProxyPassword 设置为 HTTP 代理。

如果您使用 NTLM 认证，请将 ProxyUser 和 ProxyPassword 设置为您的 Windows 密码。您还可能需要使用它们来完成 Kerberos 认证

  
代理服务器

要通过其路由 HTTP 流量的代理的主机名或 IP 地址。

要通过其路由 HTTP 流量的代理的主机名或 IP 地址。驱动程序可使用 HTTP、Windows (NTLM) 或 Kerberos 认证类型向 HTTP 代理进行认证。

默认情况下，驱动程序使用系统代理。如果您需要使用其他代理，请将 ProxyAutoDetect 设置为假。

 206.174.193.115
代理端口 运行 ProxyServer 代理的 TCP 端口。 80
代理 SSL 类型

要在连接到 ProxyServer 代理时使用的 SSL 类型：

  • AUTO 如果 URL 是 HTTPS URL，则连接器将使用 TUNNEL 选项。如果 URL 是 HTTP URL，则连接器将使用 NEVER 选项（默认选项）
  • ALWAYS 连接始终支持 SSL
  • NEVER 连接不支持 SSL
  • TUNNEL 连接通过隧道代理完成：代理服务器打开到远程主机的连接，并且通过代理传输流量
 AUTO

检索消息体和附件

默认情况下，仅当您从表中选择一个记录时，才会返回消息体和任何附件。如果返回一个以上的记录，则这些域被保留空白。

如果您想要为一个以上的记录检索消息体和附件，则必须在高级设置中设置包括消息选项。返回这些域会耗费资源，并且为许多记录这样做会影响性能。如果您需要检查消息体或附件，请尝试使用其他域来识别您想要详细分析的消息。然后，分别查询此消息子集，以便检查消息体和附件。

数据连接器更新

当您升级 Analytics 或机器人代理时，应该使用一个 Analytics 数据连接器（ACCESSDATA 命令）测试用于导入数据的脚本。

由第三方数据源或 ODBC 驱动程序供应商进行的更改可能要求更新一个或多个数据连接器。脚本化数据连接可能需要更新以便继续正确工作。

  • 重新运行导入更新连接的最轻松方式是使用 Analytics 升级版本中的数据访问窗口手动执行导入。从日志复制 ACCESSDATA 命令并使用它更新您的脚本。

    说明

    在连接到数据源并重新运行导入之前，请清除连接器缓存以冲刷现有的表名称集。

    在数据访问窗口的现有连接选项卡中，在连接器名称旁边选择 > 清除缓存。

  • 更新域规范您还可能需要更新脚本主体中的域规范以匹配数据源或 ODBC 驱动程序中的表架构更改。可能的更改包括域名称、域数据类型、域和记录长度。
  • 检查任何过滤的结果您还应该检查您在数据导入过程中应用的任何过滤的结果。您还应该检查您在数据导入过程中应用的任何过滤的结果。

Email 数据连接器更改

下面列出了对 Email 数据连接器进行的具体更改。

Analytics 版本 更改

14.2

现有域To和From现在仅包含电子邮件地址。

新域 FullTo 和 FullFrom 包含电子邮件地址和电子邮件别名。
15.0

该连接器中的最大条目数域的默认值是 -1。指定此值后，该连接器会在导入过程中返回所有条目。

升级至 15.0 后，如果最大条目数的值被指定为 100 或者任何其他值，则该连接器只会从指定数量的记录中返回条目。

如果您使用过以前版本 Analytics 中的 ACCESSDATA 命令，则在升级至 15.0 时，要返回所有条目，请打开该脚本，将 maxitems 的值更新为 -1，然后重新运行该脚本。