使用 Azure 数据工厂或 Synapse Analytics 从 Azure Database for MariaDB 复制数据
适用于:Azure 数据工厂 Azure Synapse Analytics
重要
此连接器将于 2024 年 12 月 31 日弃用。 请不晚于该日期迁移到 Azure Database for MySQL 连接器。 还可以参阅本文以获取 Azure Database for MariaDB 迁移指导。
本文概述如何使用 Azure 数据工厂或 Synapse Analytics 管道中的复制活动从 Azure Database for MariaDB 复制数据。 它是基于概述复制活动总体的复制活动概述一文。
支持的功能
此 Azure Database for MariaDB 连接器支持以下功能:
支持的功能 | IR | 托管专用终结点 |
---|---|---|
复制活动(源/-) | ① ② | ✓ |
Lookup 活动 | ① ② | ✓ |
① Azure 集成运行时 ② 自承载集成运行时
可将数据从 Azure Database for MariaDB 复制到任何支持的接收器数据存储。 有关复制活动支持作为源/接收器的数据存储列表,请参阅支持的数据存储表。
该服务提供内置的驱动程序用于启用连接,因此使用此连接器无需手动安装任何驱动程序。
入门
若要使用管道执行复制活动,可以使用以下工具或 SDK 之一:
使用 UI 创建到 Azure Database for MariaDB 的链接服务
使用以下步骤在 Azure 门户 UI 中创建一个到 Azure Database for MariaDB 的链接服务。
浏览到 Azure 数据工厂或 Synapse 工作区中的“管理”选项卡,并选择“链接服务”,然后单击“新建”:
搜索“Maria”并选择 Azure Database for MariaDB 连接器。
配置服务详细信息、测试连接并创建新的链接服务。
连接器配置详细信息
对于特定于 Azure Database for MariaDB 连接器的数据工厂实体,以下部分提供有关用于定义这些实体的属性的详细信息。
链接服务属性
Azure Database for MariaDB 链接服务支持以下属性:
属性 | 描述 | 必需 |
---|---|---|
type | Type 属性必须设置为:AzureMariaDB | 是 |
connectionString | 连接到 Azure Database for MariaDB 的连接字符串。 可以从“Azure 门户”->“Azure Database for MariaDB”->“连接字符串”->“ADO.NET”中找到它。 还可以将密码放在 Azure 密钥保管库中,并从连接字符串中拉取 pwd 配置。 有关更多详细信息,请参阅以下示例和在 Azure 密钥保管库中存储凭据一文。 |
是 |
connectVia | 用于连接到数据存储的集成运行时。 如果未指定,则使用默认 Azure Integration Runtime。 | 否 |
示例:
{
"name": "AzureDatabaseForMariaDBLinkedService",
"properties": {
"type": "AzureMariaDB",
"typeProperties": {
"connectionString": "Server={your_server}.mariadb.database.chinacloudapi.cn; Port=3306; Database={your_database}; Uid={your_user}@{your_server}; Pwd={your_password}; SslMode=Preferred;"
},
"connectVia": {
"referenceName": "<name of Integration Runtime>",
"type": "IntegrationRuntimeReference"
}
}
}
示例:在 Azure 密钥保管库中存储密码
{
"name": "AzureDatabaseForMariaDBLinkedService",
"properties": {
"type": "AzureMariaDB",
"typeProperties": {
"connectionString": "Server={your_server}.mariadb.database.chinacloudapi.cn; Port=3306; Database={your_database}; Uid={your_user}@{your_server}; SslMode=Preferred;",
"pwd": {
"type": "AzureKeyVaultSecret",
"store": {
"referenceName": "<Azure Key Vault linked service name>",
"type": "LinkedServiceReference"
},
"secretName": "<secretName>"
}
},
"connectVia": {
"referenceName": "<name of Integration Runtime>",
"type": "IntegrationRuntimeReference"
}
}
}
数据集属性
有关可用于定义数据集的各部分和属性的完整列表,请参阅数据集一文。 本部分提供 Azure Database for MariaDB 数据集支持的属性列表。
若要从 Azure Database for MariaDB 复制数据,需要支持以下属性:
属性 | 描述 | 必需 |
---|---|---|
type | 数据集的 type 属性必须设置为:AzureMariaDBTable | 是 |
tableName | 表的名称。 | 否(如果指定了活动源中的“query”) |
示例
{
"name": "AzureDatabaseForMariaDBDataset",
"properties": {
"type": "AzureMariaDBTable",
"typeProperties": {},
"schema": [],
"linkedServiceName": {
"referenceName": "<Azure Database for MariaDB linked service name>",
"type": "LinkedServiceReference"
}
}
}
复制活动属性
有关可用于定义活动的各部分和属性的完整列表,请参阅管道一文。 本部分提供 Azure Database for MariaDB 源支持的属性列表。
Azure Database for MariaDB 作为源
若要从 Azure Database for MariaDB 复制数据,复制活动的 source 节需要支持以下属性:
属性 | 描述 | 必需 |
---|---|---|
type | 复制活动源的 type 属性必须设置为:AzureMariaDBSource | 是 |
query | 使用自定义 SQL 查询读取数据。 例如:"SELECT * FROM MyTable" 。 |
否(如果指定了数据集中的“tableName”) |
示例:
"activities":[
{
"name": "CopyFromAzureDatabaseForMariaDB",
"type": "Copy",
"inputs": [
{
"referenceName": "<Azure Database for MariaDB input dataset name>",
"type": "DatasetReference"
}
],
"outputs": [
{
"referenceName": "<output dataset name>",
"type": "DatasetReference"
}
],
"typeProperties": {
"source": {
"type": "AzureMariaDBSource",
"query": "SELECT * FROM MyTable"
},
"sink": {
"type": "<sink type>"
}
}
}
]
查找活动属性
若要了解有关属性的详细信息,请查看 Lookup 活动。
相关内容
有关复制活动支持作为源和接收器的数据存储的列表,请参阅支持的数据存储。