共用方式為

连接器升级指南

适用于：Azure 数据工厂 Azure Synapse Analytics

本文提供有关在 Azure 数据工厂中升级连接器的指南。

如何在 Azure 服务运行状况门户中接收通知

定期向你发送通知，帮助你升级相关连接器或通知你 EOS 和移除的关键日期。 可以在“服务运行状况门户 - 运行状况公告”选项卡下找到通知。

下面是帮助你查找通知的步骤：

  1. 导航到 服务运行状况门户 ，也可以在 Azure 门户仪表板上选择 “服务运行状况 ”图标。

  2. 转到 “运行状况公告 ”选项卡，可以在列表中看到与连接器相关的通知。 您还可以转到健康历史选项卡来查看历史通知。

    服务运行状况的屏幕截图。

若要了解有关服务运行状况门户的详细信息，请参阅 本文。

如何从数据工厂门户查找受影响的对象

下面是获取仍依赖于支持日期精确结束的已弃用连接器或连接器的对象的步骤。 建议在支持日期结束前将这些对象升级到新的连接器版本。

  1. 打开 Azure 数据工厂。
  2. 转到“管理 - 链接服务”页。
  3. 应会看到 V1 上仍存在警报的链接服务。
  4. 单击“相关”列下的编号将显示使用此链接服务的相关对象。
  5. 若要详细了解升级指南以及 V1 和 V2 之间的比较情况，可以导航到每个连接器页面内的连接器升级部分。

链接服务页的屏幕截图。

如何以编程方式查找受影响的对象

用户可以运行 PowerShell 脚本，以编程方式提取使用集成运行时的 Azure 数据工厂或 Synapse 链接服务列表。这些集成运行时运行的版本要么已不受支持，要么即将终止支持。 可以自定义该脚本以查询指定租户或订阅下的每个数据工厂、枚举指定链接服务的列表，以及检查配置属性，例如连接类型、连接器版本。 然后，它可以针对已知版本 EOS 时间线交叉引用这些详细信息，使用不受支持的或即将不受支持的连接器版本标记任何链接服务。 这种自动化方法使用户能够主动识别和修正过时的组件，以确保持续支持、安全合规性和服务可用性。

可以找到脚本的示例，并根据需要对其进行自定义：

自动连接器升级

除了提供工具和最佳做法来帮助用户手动升级其连接器之外，该服务现在还提供更简化的升级过程，在某些情况下（如果适用）。 这旨在帮助用户采用最可靠且受支持的连接器版本，且中断最少。

以下部分概述了服务用于自动升级的一般方法。 虽然这提供了高级别概述，但强烈建议查看特定于每个连接器的文档，以了解哪些方案受支持，以及升级过程如何应用于工作负荷。

如果某些在最新 GA 连接器版本上运行的方案与以前的版本完全向后兼容，该服务将自动将现有工作负载（如复制、查找和脚本活动）升级到保留早期版本行为的兼容模式。

这些自动升级的工作负载不受较旧版本的宣布删除日期的影响，为用户提供额外的时间来评估和过渡到最新的 GA 版本，而不会面临即时故障。

可以通过检查活动输出来识别哪些活动已自动升级，其中记录了相关的升级信息。 以下示例显示了各种活动输出中的已升级信息。

示例：

复制活动输出

"source": {
    "type": "AmazonS3",
    "autoUpgrade": "true"
} 

"sink": {
    "type": "AmazonS3",
    "autoUpgrade": "true"
}

查找活动输出

"source": {
    "type": "AmazonS3",
    "autoUpgrade": "true"
}

脚本活动输出

"source": {
    "type": "AmazonS3",
    "autoUpgrade": "true"
}

注释

虽然兼容性模式提供了灵活性，但我们强烈建议用户尽快升级到最新的 GA 版本，以受益于正在进行的改进、优化和完全支持。

可以在计划自动升级的连接器列表中找到下表的更多详细信息。

连接器 情景
Amazon RDS for Oracle 不依赖于 Oracle（版本 1.0）中的以下功能的方案：

• 使用 procedureRetResults、batchFailureReturnsError、truststore 和 truststorepassword 作为连接属性。
• 使用以分号结尾的查询。

如果管道在自承载集成运行时上运行，则它需要 SHIR 5.56 或更高版本。
Amazon Redshift 不依赖于 Amazon Redshift（版本 1.0）中的以下功能的方案：

• 使用 Azure Integration Runtime 的链接服务。
• 使用 UNLOAD。

仅当在安装自承载集成运行时的计算机上安装了驱动程序时，自动升级才适用。

有关详细信息，请转到 安装版本 2.0 的 Amazon Redshift ODBC 驱动程序。
Google BigQuery Google BigQuery V1 中不依赖于以下功能的方案：

• 使用trustedCertsPath、additionalProjectsrequestgoogledrivescope连接属性。
• 将 useSystemTrustStore 连接属性设置为 false。
• 使用 STRUCT 和 ARRAY 数据类型。

如果管道在自承载集成运行时上运行，则需要 SHIR 5.55 或更高版本。
Greenplum 如果管道在自承载集成运行时上运行，则它需要 SHIR 5.56 或更高版本。
Hive 不依赖于 Hive 中以下功能的方案（版本 1.0）：

• 身份验证类型：
  • 用户名
• Thrift 传输协议：
  • HiveServer1
• 服务发现模式：True
• 使用原生查询：True

如果管道在自承载集成运行时上运行，则需要 SHIR 5.55 或更高版本。
高角羚 在受 Impala（版本 1.0）中以下功能的方案：

• 身份验证类型：
  • SASL 用户名

如果管道在自承载集成运行时上运行，则需要 SHIR 5.55 或更高版本。
MariaDB 如果管道在自承载集成运行时上运行，则它需要 SHIR 5.56 或更高版本。
MySQL 如果管道在自承载集成运行时上运行，则它需要 SHIR 5.56 或更高版本。
Oracle 不依赖于 Oracle（版本 1.0）中的以下功能的方案：

• 使用 procedureRetResults、batchFailureReturnsError、truststore 和 truststorepassword 作为连接属性。
• 将 Oracle 连接器用作接收器。
• 使用以分号结尾的查询。
• 在脚本活动中使用 PL/SQL 命令
• 在脚本活动中使用脚本参数

如果管道在自承载集成运行时上运行，则它需要 SHIR 5.56 或更高版本。
PostgreSQL 如果管道在自承载集成运行时上运行，则它需要 SHIR 5.56 或更高版本。
Presto 在 Presto 中不依赖于以下功能的方案（版本 1.0）：

• 使用 MAP、ARRAY 或 ROW 数据类型。
• trustedCertPath/allowSelfSignedServerCert/allowSelfSignedServerCert（即将支持）

如果管道在自承载集成运行时上运行，则需要 SHIR 5.57 或更高版本。
Salesforce 不依赖于 Salesforce V1 中以下功能的方案：

• 使用以下内容的 SOQL 查询：
  • TYPEOF 子句
  • 复合地址/地理位置字段
• 所有 SQL-92 查询
• 报表查询 {调用“<报表名称>”}
• 使用自承载集成运行时（需要支持）
Salesforce 服务云 不依赖于 Salesforce Service Cloud V1 中以下功能的方案：

• 使用以下内容的 SOQL 查询：
  • TYPEOF 子句
  • 复合地址/地理位置字段
• 所有 SQL-92 查询
• 报表查询 {调用“<报表名称>”}
• 使用自承载集成运行时（需要支持）
Snowflake 不依赖于 Snowflake V1 中以下功能的方案：

• 使用以下任一项
  属性：connection_timeout、disableocspcheck、enablestaging、on_error、query_tag、quoted_identifiers_ignore_case、skip_header、stage、table、timezone、token、validate_utf8、no_proxy、nonproxyhosts、noproxy。
• 在脚本活动或查找活动中使用多语句查询。

如果管道在自承载集成运行时上运行，则它需要 SHIR 5.56 或更高版本。
Spark 不依赖于 Spark 中以下功能的方案（版本 1.0）：

• 身份验证类型：
  • 用户名
• Thrift 传输协议：
  • SASL
  • 二进制
• Thrift 传输协议：
  • SharkServer
  • SharkServer2

如果管道在自承载集成运行时上运行，则需要 SHIR 5.55 或更高版本。
Teradata Teradata 中不依赖于以下功能的方案（版本 1.0）：

• 为 CharacterSet 设置以下值：
  • BIG5 （TCHBIG5_1R0）
  • EUC （Unix 兼容，KANJIEC_0U）
  • GB（SCHGB2312_1T0）
  • IBM 大型机（KANJIEBCDIC5035_0I）
  • NetworkKorean （HANGULKSC5601_2R4）
  • Shift-JIS（Windows、DOS 兼容、KANJISJIS_0S）
Vertica 不依赖于 Vertica 中以下功能的方案（版本 1.0）：

• 使用 Azure Integration Runtime 的链接服务。

只有在安装了驱动程序的计算机上，同时该计算机还安装了自托管集成运行时（版本 5.55 或更高版本），自动升级才适用。

有关详细信息，请转到 安装版本 2.0 的 Vertica ODBC 驱动程序。

相关内容