连接到 SharePoint

概念信息

ACCESSDATA 命令

Microsoft SharePoint 是用于共享和管理组织内容和应用程序的 Web 协同平台。使用 SharePoint 数据连接器导入您的组织的 SharePoint 数据。

导入之前

仅表格式数据

Analytics 只能查询采取表格形式的 SharePoint 数据。下列条目无法从 Analytics 查询,因为它们未采取表格形式。

  • 附件
  • FileVersions
  • GetValidTerms
  • 权限
  • 视图

不支持多因素认证

SharePoint 数据连接器无法从要求多因素认证的 SharePoint 账户访问数据。

已知问题:就日期时间域过滤

如果您在选中将日期时间转换至 GMT 选项的情况下导入您的数据,则不能就日期时间域进行过滤。如果您需要基于日期时间域进行过滤,请在导入之前清除此选项。

创建 SharePoint 连接

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

    提示

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

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

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

Sharepoint的连接被保存到现有连接选项卡。将来,您可以从已保存的连接重新连接到Sharepoint

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

连接设置

基本设置

设置 描述 示例
连接名称 您想要在 Analytics 中给予此连接的名称。 Sharepoint
主机

您要连接到的 SharePoint 站点。

将 URL 设置为站点集合可使用所有嵌套子站点中的所有列表和文档。将 URL 设置为特定站点只能使用该站点中的列表和文档。

https://teams.example.com/teamA
用户

您的 SharePoint 用户名。

说明
如果您的公司通过 AD FS、OneLogin 或 OKTA 等 SSO 工具访问 SharePoint,您可以输入您的 SharePoint 凭据以通过 Analytics 而不是您的 SharePoint 凭据连接。

jgibbons
密码

您的 SharePoint 密码。

说明
如果您的公司通过 AD FS、OneLogin 或 OKTA 等 SSO 工具访问 SharePoint,您可以输入您的 SharePoint 凭据以通过 Analytics 而不是您的 SharePoint 凭据连接。

MyStrongPasswordExample
SharePoint 版本 所使用的 SharePoint 的版本。或者是 SharePoint Online,或者是 SharePoint On-Premise。 Sharepoint Online
使用 SSO

当被设置为真时,将使用单点登录 (SSO) 以及通过用户和密码指定的账户向 SharePoint Online 进行认证。支持 Active Directory Federation Services (AD FS)、OneLogin 和 OKTA SSO。

如果在 SSO 域上配置的域不同于用户的域,则可能需要 SSO。

SSO 仅在使用 SharePoint Online 时适用。对于 SharePoint 的 On-Premise 版本,不支持 SSO。

认证方案

此域和密码及用户一起被用来向服务器进行认证。NTLM 是默认选项。请使用以下选项来选择您的认证方案:

  • NTLM 设置此选项可使用您的 Windows 凭据进行认证。
  • NEGOTIATE 如果将认证方案设置为 NEGOTIATE,则驱动程序将与服务器协商认证机制。如果您想要使用 Kerberos 认证,请将认证方案设置为 NEGOTIATE。
  • KERBEROSDELEGATION 设置此选项可通过 Kerberos 协议使用委派。设置您想要模拟的账户的用户和密码。
  • NONE 设置此选项可使用匿名认证;例如,为了访问公共站点。
  • FORMS 如果您的 SharePoint 实例通过 Web 表单使用自定义认证方法,请设置此选项。
  • DIGEST 设置此选项可使用 HTTP 摘要认证。
  • BASIC 设置此选项可使用 HTTP 基本认证。
NTLM

高级设置

设置 描述 示例
SSO 域

仅当使用单点登录(“使用 SSO”被设置为真)并且用户的域(例如,user@mydomain.com)不同于在 SSO 服务内配置的域(例如,user@myssodomain.com)时,此属性才适用。

使用 AD FS、OneLogin 或 OKTA SSO 时,可能需要此属性。

myssodomain.com
将日期时间转换为 GMT 在导入过程中将日期时间域转换至 GMT 时区。如果为假,则该日期时间值被转换为运行 Analytics 的计算机的操作系统时区。
限制密钥大小

在某些 ODBC 工具(例如,Microsoft Access)中,主键列的长度不能大于特定值。此属性使 ODBC 驱动程序覆盖所有主键列的报告长度。当使用 ODBC 驱动程序作为 Microsoft Access 链接数据源时,它尤其有用。

将“限制密钥大小”设置为 0 会使键长度恢复到原始长度。

255
映射到 Long Varchar

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

某些应用程序要求将所有大于特定字符数的文本数据报告为 SQL_LONGVARCHAR。使用此设置可映射任何大于指定大小的列,以便使它们被报告为 SQL_LONGVARCHAR 而不是 SQL_VARCHAR。

-1
映射到 WVarchar

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

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

伪列

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

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

您可以使用一个星号 (*) 来包括所有表和所有列。

  • Table1=Column1, Table2=Column3
  • *=*
大写标识符

设置此属性可以用大写形式报告所有标识符(包括表名称和列名称)。对于 Oracle 数据库而言,这是默认的,因而可以更好地与 Oracle 数据库网关之类的 Oracle 工具集成。例如,您可以使用此属性来避免引用标识符。

代理认证方案

用来向代理服务器进行认证的认证类型。

此值指定用来向由代理服务器和代理端口指定的 HTTP 代理进行认证的认证类型。

请注意,该驱动程序默认情况下将使用系统代理设置,而无需进一步的配置。如果您想要连接到另一代理,则除了设置代理服务器和代理端口以外,您还需要将“代理自动检测”设置为假。要进行认证,请设置代理认证方案,并且根据需要设置代理用户和代理密码。

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

  • BASIC 该驱动程序执行 HTTP BASIC 认证。
  • DIGEST 驱动程序执行 HTTP DIGEST 认证。
  • NEGOTIATE 该驱动程序基于适用于认证的协议检索 NTLM 或 Kerberos 令牌。
  • PROPRIETARY 驱动程序不生成 NTLM 或 Kerberos 令牌。您必须在 HTTP 请求的授权标头中提供此令牌。
BASIC
代理自动检测

这指示是否使用系统代理设置。将“代理自动检测”设置为假可使用自定义代理设置。这将优先于其他代理设置。

默认情况下,驱动程序使用系统 HTTP 代理。如果您想要连接到另一代理,请将此选项设置为假。

要连接到 HTTP 代理,请参见“代理服务器”。

代理用户

要用来向代理服务器进行认证的用户名。

代理用户和代理密码选项被用来连接在代理服务器中指定的 HTTP 代理以及向其进行认证。

您可以在代理认证方案中选择可用的认证类型之一。

如果您使用 HTTP 认证,请将此属性设置为 HTTP 代理所识别的用户的用户名。

如果您使用 Windows 或 Kerberos 认证,请将此属性设置为采用下列格式之一的用户名:

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

要用来向代理服务器进行认证的密码。

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

如果您使用 HTTP 认证,请另外将代理用户和代理密码设置为 HTTP 代理。

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

默认情况下,驱动程序使用系统代理。如果您想要连接到另一代理,请将“代理自动检测”设置为假。

MyStrongPasswordExample
代理服务器

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

默认情况下,驱动程序使用系统代理。如果您需要使用另一代理,请将“代理自动检测”设置为假。

127.168.192.10
代理端口 在其上运行 HTTP 代理以及您想要通过其重定向 HTTP 流量的端口。请在代理服务器中指定 HTTP 代理。 80
代理 SSL 类型

此属性确定何时对到代理服务器所指定的 HTTP 代理的连接使用 SSL。此值可以是 AUTO、ALWAYS、NEVER 或 TUNNEL。

自动默认设置。如果 URL 是 HTTPS URL,则该驱动程序将使用 TUNNEL 选项。如果 URL 是 HTTP URL,则该组件将使用 NEVER 选项。

ALWAYS 连接始终支持 SSL。

NEVER 连接不支持 SSL。

TUNNEL 连接是通过隧道代理建立的。代理服务器打开到远程主机的连接,并且通过代理传输流量。

自动
代理异常

将被免于通过代理服务器连接的主机或 IP 的分号分隔列表。

该代理服务器将被用于所有地址,但在此属性中定义的地址除外。

127.168.189.10; 127.168.188.11