使用 Azure 数据工厂或 Azure Synapse Analytics 从/向 Oracle 复制数据

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

本文概述如何在 Azure 数据工厂中使用复制活动从/向 Oracle 数据库复制数据。 本文是在复制活动概述的基础上编写的。

此 Oracle 连接器支持以下功能：

① Azure 集成运行时 ② 自承载集成运行时

有关复制活动支持作为源或接收器的数据存储列表，请参阅支持的数据存储表。

具体而言，此 Oracle 连接器支持：

• 适用于版本 2.0 的 Oracle 数据库的以下版本：
  • Oracle Database 19c 或更高版本
• 适用于版本 1.0 的 Oracle 数据库的以下版本：
  • Oracle 19c R1 (19.1) 和更高版本
  • Oracle 18c R1 (18.1) 和更高版本
  • Oracle 12c R1 (12.1) 和更高版本
  • Oracle 11g R1 (11.1) 和更高版本
  • Oracle 10g R1 (10.1) 和更高版本
  • Oracle 9i R2 (9.2) 和更高版本
  • Oracle 8i R3 (8.1.7) 和更高版本
  • Oracle 数据库云 Exadata 服务
• 从 Oracle 源进行并行复制。 有关详细信息，请参阅从 Oracle 进行并行复制部分。

如果数据存储位于本地网络、Azure 虚拟网络或 Amazon Virtual Private Cloud 内部，则需要配置自承载集成运行时才能连接到该数据存储。

如果数据存储是托管的云数据服务，则可以使用 Azure Integration Runtime。 如果访问范围限制为防火墙规则中允许的 IP，你可以选择将 Azure Integration Runtime IP 添加到允许列表。

此外，还可以使用 Azure 数据工厂中的托管虚拟网络集成运行时功能访问本地网络，而无需安装和配置自承载集成运行时。

要详细了解网络安全机制和数据工厂支持的选项，请参阅数据访问策略。

集成运行时提供内置的 Oracle 驱动程序。 因此，在从/向 Oracle 复制数据时不需要手动安装驱动程序。

若要使用管道执行复制活动，可以使用以下工具或 SDK 之一：

• 复制数据工具
• Azure 门户
• .NET SDK
• Python SDK
• Azure PowerShell
• REST API
• Azure 资源管理器模板

使用以下步骤在 Azure 门户 UI 中创建一个到 Oracle 的链接服务。

1. 浏览到 Azure 数据工厂或 Synapse 工作区中的“管理”选项卡，并选择“链接服务”，然后单击“新建”：

   • Azure 数据工厂
   • Azure Synapse

   

2. 搜索“Oracle”并选择 Oracle 连接器。

   

3. 配置服务详细信息、测试连接并创建新的链接服务。

   

对于特定于 Oracle 连接器的实体，以下部分提供了有关用于定义这些实体的属性的详细信息。

Oracle 连接器版本 2.0 支持 TLS 1.3。 请参阅本 部分 ，从版本 1.0 升级 Oracle 连接器版本。 关于属性详情，请参阅对应部分。

• 版本 2.0
• 版本 1.0

应用版本 2.0 时，Oracle 链接服务支持以下属性：

可以按案例在链接服务中设置的更多连接属性：

示例：

{
    "name": "OracleLinkedService",
    "properties": {
        "type": "Oracle",
        "version": "2.0",
        "typeProperties": {
            "server": "<server name>", 
            "username": "<user name>", 
            "password": "<password>", 
            "authenticationType": "<authentication type>"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

示例：在 Azure 密钥保管库中存储密码

{
    "name": "OracleLinkedService",
    "properties": {
        "type": "Oracle",
        "version": "2.0",
        "typeProperties": {
            "server": "<server name>", 
            "username": "<user name>", 
            "authenticationType": "<authentication type>",
            "password": { 
                "type": "AzureKeyVaultSecret", 
                "store": { 
                    "referenceName": "<Azure Key Vault linked service name>", 
                    "type": "LinkedServiceReference" 
                }, 
                "secretName": "<secretName>" 
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

对于 server 属性，可以使用以下三种格式之一指定它：

以下列表显示 server 支持的参数。 如果使用的参数不在以下列表中，则连接将失败。

• 使用 Azure 集成运行时时：

  主机
  端口
  协议
  服务名称
  SID
  INSTANCE_NAME
  服务器
  连接超时
  RETRY_COUNT
  重试延迟
  SSL版本
  SSL_SERVER_DN_MATCH
  SSL_SERVER_CERT_DN

• 当使用自承载集成运行时：

  主持人
  端口
  协议
  启用
  过期时间
  故障转移
  负载均衡
  RECV_BUF_SIZE
  山东大学 (SDU)
  SEND_BUF_SIZE
  SOURCE_ROUTE
  服务类型
  COLOCATION_TAG
  CONNECTION_ID_PREFIX
  故障转移模式
  GLOBAL_NAME
  HS
  INSTANCE_NAME
  泳池边界
  POOL_CONNECTION_CLASS
  泳池名称
  游泳池纯度
  RDB_DATABASE
  分片键
  分片键ID (SHARDING_KEY_ID)
  超级分片键
  服务器
  服务名称
  SID
  隧道服务名称
  SSL_客户端认证
  SSL_CERTIFICATE_ALIAS
  SSL_CERTIFICATE_THUMBPRINT
  SSL版本
  SSL_SERVER_DN_MATCH
  SSL_SERVER_CERT_DN
  钱包位置
  连接超时
  重试次数
  重试延迟
  传输连接超时
  RECV_TIMEOUT
  压缩
  压缩级别

应用版本 1.0 时，Oracle 链接服务支持以下属性：

如果有多个 Oracle 实例用于故障转移方案，则可以创建 Oracle 链接服务并填充主要主机、端口、用户名、密码等，并添加新的“其他连接属性”，其属性名称为 AlternateServers，值为 (HostName=<secondary host>:PortNumber=<secondary port>:ServiceName=<secondary service name>) - 不要遗漏括号，并注意作为分隔符的冒号 (:)。 例如，以下备用服务器值定义用于连接故障转移的两台备用数据库服务器：(HostName=AccountingOracleServer:PortNumber=1521:SID=Accounting,HostName=255.201.11.24:PortNumber=1522:ServiceName=ABackup.NA.MyCompany)。

可以根据自己的情况在连接字符串中设置更多连接属性：

若要在 Oracle 连接上启用加密，你有两种选择：

• 若要使用三重 DES 加密 (3DES) 和高级加密标准 (AES) ，请在 Oracle 服务器端，转到“Oracle 高级安全性 (OAS)”并配置加密设置。 有关详细信息，请参阅 Oracle 文档。 Oracle 应用程序开发框架 (ADF) 连接器会自动协商加密方法，以便在建立与 Oracle 的连接时使用在 OAS 中配置的加密方法。

• 要使用 TLS，请应用以下三种方法之一，为 SSL 服务器身份验证设置 truststore：

  • 方法 1（建议）：

    1. 通过将 TLS/SSL 证书导入本地证书存储来安装该证书。 内置的 Oracle 驱动程序可以从证书存储中加载所需的证书。

    2. 在服务中，使用 EncryptionMethod=1 配置 Oracle 连接字符串。

  • 方法 2：

    1. 获取 TLS/SSL 证书信息。 获取 TLS/SSL 证书的可辨别编码规则 (DER) 编码或隐私增强邮件 (PEM) 编码证书信息。

       openssl x509 -inform (DER|PEM) -in [Full Path to the DER/PEM Certificate including the name of the DER/PEM Certificate] -text
       

    2. 在服务中，使用 EncryptionMethod=1 和相应的 TrustStore 值配置 Oracle 连接字符串。 例如： Host=<host>;Port=<port>;Sid=<sid>;User Id=<username>;Password=<password>;EncryptionMethod=1;TrustStore= data:// -----BEGIN CERTIFICATE-----<certificate content>-----END CERTIFICATE-----

       备注

       • TrustStore 字段的值应以 data:// 为前缀。
       • 为多个证书指定内容时，请在 -----BEGIN CERTIFICATE----- 和 -----END CERTIFICATE----- 之间指定每个证书的内容。 短划线 (-----) 的数量在 BEGIN CERTIFICATE 和 END CERTIFICATE 前后应相同。 例如：
         -----BEGIN CERTIFICATE-----<certificate content 1>-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----<certificate content 2>-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----<certificate content 3>-----END CERTIFICATE-----
       • TrustStore 字段支持长度高达 8192 个字符的内容。

  • 方法 3：

    1. 使用强密码（如 AES256）创建 truststore 文件。

       openssl pkcs12 -in [Full Path to the DER/PEM Certificate including the name of the DER/PEM Certificate] -out [Path and name of TrustStore] -passout pass:[Keystore PWD] -keypbe AES-256-CBC -certpbe AES-256-CBC -nokeys -export
       

    2. 将 truststore 文件放置在自承载集成运行时计算机上。 例如，将该文件放在 C:\MyTrustStoreFile。

    3. 在服务中，使用 EncryptionMethod=1 和相应的 TrustStore/TrustStorePassword 值配置 Oracle 连接字符串。 例如，Host=<host>;Port=<port>;Sid=<sid>;User Id=<username>;Password=<password>;EncryptionMethod=1;TrustStore=C:\\MyTrustStoreFile;TrustStorePassword=<trust_store_password>。

示例：

{
    "name": "OracleLinkedService",
    "properties": {
        "type": "Oracle",
        "typeProperties": {
            "connectionString": "Host=<host>;Port=<port>;Sid=<sid>;User Id=<username>;Password=<password>;"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

示例：在 Azure 密钥保管库中存储密码

{
    "name": "OracleLinkedService",
    "properties": {
        "type": "Oracle",
        "typeProperties": {
            "connectionString": "Host=<host>;Port=<port>;Sid=<sid>;User Id=<username>;",
            "password": { 
                "type": "AzureKeyVaultSecret", 
                "store": { 
                    "referenceName": "<Azure Key Vault linked service name>", 
                    "type": "LinkedServiceReference" 
                }, 
                "secretName": "<secretName>" 
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

本部分提供 Oracle 数据集支持的属性列表。 有关可用于定义数据集的各个部分和属性的完整列表，请参阅数据集。

若要从/向 Oracle 复制数据，请将数据集的 type 属性设置为 OracleTable。 支持以下属性。

示例：

{
    "name": "OracleDataset",
    "properties":
    {
        "type": "OracleTable",
        "schema": [],
        "typeProperties": {
            "schema": "<schema_name>",
            "table": "<table_name>"
        },
        "linkedServiceName": {
            "referenceName": "<Oracle linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

本部分提供 Oracle 源和接收器支持的属性列表。 有关可用于定义活动的各个部分和属性的完整列表，请参阅管道。

要从 Oracle 复制数据，请将复制活动中的源类型设置为 OracleSource。 复制活动的 source 节支持以下属性。

示例：使用基本查询但不使用分区复制数据

"activities":[
    {
        "name": "CopyFromOracle",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Oracle input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "OracleSource",
                "convertDecimalToInteger": false,
                "oracleReaderQuery": "SELECT * FROM MyTable"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

若要向 Oracle 复制数据，请将复制活动中的汇接点类型设置为 OracleSink。 复制活动“接收器”部分支持以下属性。

示例：

"activities":[
    {
        "name": "CopyToOracle",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<Oracle output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "<source type>"
            },
            "sink": {
                "type": "OracleSink"
            }
        }
    }
]

Oracle 连接器提供内置的数据分区，用于从 Oracle 并行复制数据。 可以在复制活动的“源”表中找到数据分区选项。

启用分区复制后，服务将对 Oracle 源运行并行查询，按分区加载数据。 可通过复制活动中的 parallelCopies 设置控制并行度。 例如，如果将 parallelCopies 设置为 4，该服务会根据指定的分区选项和设置并行生成并运行 4 个查询，每个查询从 Oracle 数据库检索一部分数据。

建议同时启用并行复制和数据分区，尤其是从 Oracle 数据库加载大量数据时。 下面是适用于不同方案的建议配置。 将数据复制到基于文件的数据存储中时，建议将数据作为多个文件写入文件夹（仅指定文件夹名称），在这种情况下，性能优于写入单个文件。

示例：使用物理分区进行查询

"source": {
    "type": "OracleSource",
    "query": "SELECT * FROM <TABLENAME> PARTITION(\"?AdfTabularPartitionName\") WHERE <your_additional_where_clause>",
    "partitionOption": "PhysicalPartitionsOfTable",
    "partitionSettings": {
        "partitionNames": [
            "<partitionA_name>",
            "<partitionB_name>"
        ]
    }
}

示例：使用动态范围分区进行查询

"source": {
    "type": "OracleSource",
    "query": "SELECT * FROM <TABLENAME> WHERE ?AdfRangePartitionColumnName <= ?AdfRangePartitionUpbound AND ?AdfRangePartitionColumnName >= ?AdfRangePartitionLowbound AND <your_additional_where_clause>",
    "partitionOption": "DynamicRange",
    "partitionSettings": {
        "partitionColumnName": "<partition_column_name>",
        "partitionUpperBound": "<upper_value_of_partition_column>",
        "partitionLowerBound": "<lower_value_of_partition_column>"
    }
}

当你从/向 Oracle 复制数据时，服务中会使用以下临时数据类型映射。 若要了解复制活动如何将源架构和数据类型映射到接收器，请参阅架构和数据类型映射。

若要了解有关属性的详细信息，请查看 Lookup 活动。

下面是帮助你升级 Oracle 连接器的步骤：

1. 在“编辑链接服务”页中，在“版本”下选择 2.0，并通过引用链接服务属性版本 2.0 配置链接服务。

   对于身份验证相关属性（包括用户名和密码），请在版本 2.0 中的相应字段中指定原始值。 版本 1.0 中的其他连接属性（例如主机、端口和 Oracle 服务名称/Oracle SID）现在是版本 2.0 中属性的参数server。

   例如，如果将版本 1.0 的连接服务配置如下：

   

   { 
       "name": "OracleLinkedService", 
       "properties": { 
           "type": "Oracle", 
           "typeProperties": { 
               "connectionString": "host=oraclesample.com;port=1521;servicename=db1" 
           }, 
           "connectVia": { 
               "referenceName": "<name of Integration Runtime>", 
               "type": "IntegrationRuntimeReference" 
           } 
       } 
   }
   

   使用 Easy Connect （Plus） 命名 的相同版本 2.0 链接服务配置为：

   

   { 
       "name": "OracleLinkedService", 
       "properties": { 
           "type": "Oracle", 
           "version": "2.0", 
           "typeProperties": { 
               "server": "oraclesample.com:1521/db1",  
               "username": "<user name>",  
               "password": "<password>",  
               "authenticationType": "<authentication type>" 
           }, 
           "connectVia": { 
               "referenceName": "<name of Integration Runtime>", 
               "type": "IntegrationRuntimeReference" 
           } 
       } 
   } 
   

   使用 连接器描述符 的相同版本 2.0 链接服务配置为：

   

   { 
       "name": "OracleLinkedService", 
       "properties": { 
           "type": "Oracle", 
           "version": "2.0", 
           "typeProperties": { 
               "server": "(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST= oraclesample.com)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=db1)))",  
               "username": "<user name>",  
               "password": "<password>",  
               "authenticationType": "<authentication type>" 
           }, 
           "connectVia": { 
               "referenceName": "<name of Integration Runtime>", 
               "type": "IntegrationRuntimeReference" 
           } 
       } 
   } 
   

   提示

   Azure Key Vault 支持 server 属性。 可以编辑链接服务 JSON 以添加 Azure Key Vault 引用，如下所示：
   

   请注意：

   • 如果在版本 1.0 中使用 Oracle 服务名称 ，则可以使用 Easy Connect （Plus） 命名 或 连接器描述符 作为版本 2.0 中的服务器格式。

   • 如果在版本 1.0 中使用 Oracle SID ，则需要使用 连接器描述符 作为版本 2.0 中的服务器格式。

   • 对于版本 1.0 中的一些附加连接属性，我们在版本 2.0 中的 server 属性中提供替代属性或参数。 可以参考下表来升级版本 1.0 属性。

     展开表

     版本 1.0	版本 2.0
     加密方法	协议（参数在server中）
     tnsnamesfile	TNS_ADMIN（自承载集成运行时支持的环境变量）
     服务器名称	服务器
     启用批量加载 值：1、0	enableBulkLoad 值：true、false
     fetchtswtzastimestamp 值：1、0	fetchTswtzAsTimestamp 值：true、false
     备用服务器	DESCRIPTION_LIST（server中的参数）
     数组大小	fetchSize （获取大小）
     缓存游标限制	声明缓存大小
     连接重试计数	RETRY_COUNT（server中的参数）
     初始化字符串	初始化字符串
     loginTimeout	CONNECT_TIMEOUT（server中的参数）
     加密协议版本	SSL_VERSION （参数位于 server 中）
     truststore	WALLET_LOCATION（server 中的参数）

     例如，如果在 alternateservers 版本 1.0 中使用，则可以在版本 2.0 的服务器属性中设置 DESCRIPTION_LIST 参数：

     使用 alternateservers 的 1.0 版链接服务：

     {
         "name": "OracleV1",
         "properties": {
             "type": "Oracle",
             "typeProperties": {
                 "connectionString": "host=oraclesample.com;port=1521;servicename=db1;alternateservers=(HostName= oraclesample2.com:PortNumber=1521:SID=db2,HostName=255.201.11.24:PortNumber=1522:ServiceName=db3)"
             }
         }
     }
     

     在“连接器描述符”中使用 DESCRIPTION_LIST 参数的相同 2.0 版本链接服务：

     {
         "name": "OracleV2",
         "properties": {
             "type": "Oracle",
             "version": "2.0",
             "typeProperties": {
                 "server": "(DESCRIPTION_LIST=(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=oraclesample.com)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=db1)))(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=oraclesample2.com)(PORT=1521))(CONNECT_DATA=(SID=db2)))(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=255.201.11.24)(PORT=1522))(CONNECT_DATA=(SERVICE_NAME=db3))))",
                 "username": "<user name>",  
                 "password": "<password>",  
                 "authenticationType": "<authentication type>" 
             }
         }
     }
     

2. Oracle 链接服务版本 2.0 的数据类型映射不同于版本 1.0 的数据类型映射。 若要了解最新的数据类型映射，请参阅 Oracle 的数据类型映射。

   版本 2.0 中的其他连接属性 supportV1DataTypes 可以减少数据类型更改导致的升级困难。 设置此属性可确保 true 版本 2.0 中的数据类型与版本 1.0 保持一致。

Oracle 连接器版本 2.0 提供新功能，并与版本 1.0 的大多数功能兼容。 下表显示了版本 2.0 和版本 1.0 之间的功能差异。